- Guard clauses e detecção. Saia cedo quando o Correios Automático ou o WooCommerce não estão ativos, quando o argumento não é um
WC_Orderou quando o recurso não existe na versão instalada (class_exists(),method_exists(),version_compare()). - Checkout sempre rápido. Os filtros de nota, de status e da DANFE rodam em cada linha da lista e em cada etiqueta, e o filtro de espera roda no pagamento. Responda do que já está salvo, emita a nota em segundo plano (Action Scheduler) e avise com
infixs_correios_automatico_order_invoice_ready: o cliente conclui a compra sem esperar pela SEFAZ. - Ordem certa. Grave a nota e salve o pedido antes de disparar o aviso de nota pronta.
- Encadeamento. Devolva o valor recebido quando a decisão não for sua: outro emissor, vendedor de marketplace ou nota digitada pelo lojista.
- Idempotência. O aviso de nota pronta pode chegar mais de uma vez, e o PRO não duplica a pré-postagem. No seu lado, não regrave os metas com outra nota e, ao pré-postar por código, confira antes o meta
_infixs_correios_automatico_prepost_idda linha de frete. - HPOS. Leia e grave pelo objeto do pedido (
$order->get_meta(),update_meta_data(),save()). - Logs sem segredos. Não registre senhas de aplicação, tokens nem certificados. O log de depuração do Correios Automático traz dados do destinatário, então deixe o nível Debug Log ligado só durante os testes, e use dados fictícios em exemplos e chamados (CPF 000.000.000-00).
- Teste com a depuração ligada. Em Correios Automático → Configurações → Depuração, ligue “Ativar Logs” e os níveis que quiser, e acompanhe em WooCommerce → Status → Logs. “Enviando prepostagem para os correios.” mostra o envio; “Documento fiscal da pré-postagem reversa definido.” mostra a decisão da reversa; “Os dados da DANFE simplificada foram recusados.” traz o motivo (
reason) de um bloco da DANFE. - Versões. Indique no seu plugin a versão mínima do Correios Automático para cada recurso que usa (veja Detectar o plugin e a versão).
Suporte para desenvolvedores
Está integrando um plugin de nota fiscal, um ERP ou um marketplace e quer validar o fluxo com a nossa equipe? Fale com a Infixs: ajudamos a revisar a integração, os testes e a publicação.