Primeiros passos

Detectar o plugin e a versão

O plugin grátis define a constante INFIXS_CORREIOS_AUTOMATICO_PLUGIN_VERSION (na 1.14.0, '1.14.0') ao ser carregado, e o PRO define INFIXS_CORREIOS_AUTOMATICO_PRO_PLUGIN_VERSION ('1.6.2'). A função infixs_correios_automatico() devolve o contêiner de serviços do grátis. Teste as constantes no plugins_loaded com prioridade 20: o PRO inicia nesse gancho com prioridade 11, então nesse ponto os dois já estão prontos.

add_action( 'plugins_loaded', 'meu_plugin_integrar_correios', 20 );

function meu_plugin_integrar_correios() {
	if ( ! defined( 'INFIXS_CORREIOS_AUTOMATICO_PLUGIN_VERSION' ) || ! function_exists( 'wc_get_order' ) ) {
		return; // Correios Automático ou WooCommerce inativo: nada a registrar.
	}

	if ( version_compare( INFIXS_CORREIOS_AUTOMATICO_PLUGIN_VERSION, '1.11.0', '<' ) ) {
		return; // A NF-e do pedido na pré-postagem chegou na 1.11.0.
	}

	$tem_pro = defined( 'INFIXS_CORREIOS_AUTOMATICO_PRO_PLUGIN_VERSION' );

	add_filter( 'infixs_correios_automatico_order_invoice', 'meu_plugin_nfe_do_pedido', 10, 3 );

	if ( $tem_pro ) {
		add_filter( 'infixs_correios_automatico_auto_prepost_wait_invoice', 'meu_plugin_esperar_nfe', 10, 3 );
	}
}

Para saber se um recurso existe, independentemente do número da versão, teste a classe ou o método que o oferece:

Requisitos declarados: grátis 1.14.0 com WordPress 6.0+, PHP 7.4+ e WooCommerce 7.7+; PRO 1.6.2 com WooCommerce 8.0+ e o grátis 1.14.0. Os dois declaram compatibilidade com o HPOS (tabelas de pedidos do WooCommerce).

Quando registrar os ganchos

• O grátis liga os serviços enquanto o arquivo dele é incluído e dispara infixs_correios_automatico_plugin_loaded nesse momento, antes do plugins_loaded. Como o WordPress carrega os plugins em ordem alfabética, use o plugins_loaded como ponto de entrada: ele sempre chega depois.
• O PRO inicia no plugins_loaded com prioridade 11 e dispara infixs_correios_automatico_pro_plugin_loaded logo no começo, antes de conferir o grátis. Com o grátis ausente ou anterior à 1.8.4, ele para ali, sem registrar nada; por isso, para saber se um recurso do PRO está ligado, teste a classe ou o isSupported() dele (tabela acima). Com o grátis compatível, o PRO registra os ouvintes de nota pronta e de falha em toda requisição (front, admin, REST e cron).
• Registre os filtros de NF-e no plugins_loaded (prioridade 20) ou no init. O painel confere has_filter( 'infixs_correios_automatico_order_danfe' ) para mostrar as opções da DANFE, então registre esse filtro só quando o seu plugin tiver os dados da nota.

Convenções

Estabilidade

• Ações, filtros e os metadados da NF-e são a interface pensada para integrações no mesmo WordPress. Os ganchos de NF-e trazem @since no docblock, e é por eles que integrações como SquidCore e Bling se conectam ao Correios Automático.
• As rotas REST do namespace infixs-correios-automatico/v1 (as do grátis e as que o PRO acrescenta nele) atendem o painel do plugin e integrações de fora do WordPress. Todas pedem um usuário com a capacidade manage_woocommerce, salvo as exceções públicas listadas em API REST. O namespace próprio do PRO, infixs-correios-automatico-pro/v1, é interno e fica fora desta referência.
• Licença do PRO: desde a 1.6.4, as automações, os filtros e as rotas do PRO só agem com a licença ativa, conferida no servidor da Infixs (\Infixs\CorreiosAutomaticoPro\Container::licenseService()->hasLicense()). Sem ela, os filtros do PRO devolvem o valor recebido, as automações não rodam e as rotas do PRO recusam o pedido com um erro de licença.
• Ganchos marcados interno fazem a ponte entre o grátis e o PRO ou servem ao desenvolvimento do próprio plugin. Eles aparecem nesta página para referência e podem mudar entre versões.

Classes e serviços públicos

O contêiner \Infixs\CorreiosAutomatico\Container expõe os serviços do grátis por métodos estáticos. Os mais úteis para integrações:

DeliveryServiceCode fica em \Infixs\CorreiosAutomatico\Services\Correios\Enums, DceRejection em \Infixs\CorreiosAutomatico\Services\Correios, MarketplaceRegistry em \Infixs\CorreiosAutomatico\Marketplace e OrderQuery em \Infixs\CorreiosAutomatico\Utils.