Selos usados na referência: ação filtro GET POST DELETE · Grátis PRO. Tudo o que não traz o selo PRO funciona no plugin grátis. Abaixo de cada gancho e de cada rota está o arquivo e a linha onde ele aparece no código da versão indicada, para você ler o docblock completo no código.
Ações que o plugin dispara
| Ação | Quando dispara | Argumentos | Plano |
|---|---|---|---|
infixs_correios_automatico_plugin_loadedsrc/Core/Core.php:53 | Fim da inicialização do grátis, enquanto o arquivo do plugin é incluído (antes do plugins_loaded). | — | Grátis |
infixs_correios_automatico_pro_plugin_loaded PROPRO · src/Core/Core.php:38 | Começo do construtor do PRO (no plugins_loaded com prioridade 11), antes de ele conferir se o grátis está carregado numa versão compatível. Se a conferência falha, o PRO para logo depois, sem registrar serviços nem ouvintes. A ação não garante que os recursos do PRO estejam ligados: confira com class_exists() ou isSupported(). | — | PRO |
infixs_correios_automatico_prepost_createdsrc/Services/PrepostService.php:1130 · :1387 | Toda pré-postagem criada com sucesso, de ida e de reversa, por qualquer caminho. Os metas do pedido já estão salvos; o código de rastreio é gravado depois. | int|string $order_id (o valor passado a createPrepost() ou createReversePrepost(); pela rota REST, como veio na requisição), Prepost $prepost | Grátis |
infixs_correios_automatico_reverse_prepost_createdsrc/Services/PrepostService.php:1388 | Logo depois do prepost_created de uma reversa. O plugin usa para avisar o cliente da devolução. | int|string $order_id (o valor passado a createReversePrepost(); pela rota REST, como veio na requisição), Prepost $prepost | Grátis |
infixs_correios_automatico_prepost_controller_createdsrc/Controllers/Rest/PrepostController.php:108 · :233 | Pré-postagem (ida ou reversa) criada pela rota REST do painel. O plugin usa para gravar o código de rastreio; o PRO desagenda a pré-postagem com atraso e, com o status “Preparando para envio” ligado, muda o pedido de Processando para ele. | int|string $order_id (como veio na requisição), Prepost $prepost | Grátis |
infixs_correios_automatico_after_add_tracking_codesrc/Services/TrackingService.php:141 | Código de rastreio novo gravado no pedido (pré-postagem, faixa de etiquetas, digitado, outras transportadoras, devolução). | string $code, int $order_id | Grátis |
infixs_correios_automatico_after_add_tracking_eventsrc/Services/TrackingService.php:736 | Cada evento novo de rastreio gravado na sincronização. O PRO usa para mudar o status do pedido. | TrackingCodeEvent $created_event, array $event, TrackingCode $tracking, array $object | Grátis |
infixs_correios_automatico_customer_return_confirmedsrc/Services/ReturnService.php:364 | Devolução pronta para o cliente receber os códigos, com o envio por WhatsApp ligado nas configurações de devolução (ReturnService::RETURN_TRIGGER_HOOK). | int $order_id, string $return_code (códigos separados por vírgula), array $return_codes (code, shipping_item_id) | Grátis |
infixs_correios_automatico_shipping_calculation_failedsrc/Core/Shipping/CorreiosShippingMethod.php:904 | Cotação sem taxa. $code: origin_postcode, product_code, destination_postcode, destination_country, international_service, shipping_class, discount_rules_no_match, weight_below_minimum, dimensions_exceeded, insurance_limit, filter_blocked, volume_rule_blocked ou api_error. | string $code, string $message, array $package, CorreiosShippingMethod $method | Grátis |
infixs_correios_automatico_shipping_cost_failedsrc/Services/ShippingService.php:946 · src/Services/Correios/CorreiosService.php:82 | A consulta de preço não devolveu valor. | WP_Error $error, ShippingCost $shipping_cost | Grátis |
infixs_correios_automatico_calculator_custom_stylestemplates/infixs-shipping-calculator-styles.php:123 | Fim do <style> da calculadora de frete, para acrescentar CSS. | array $calculator_styles | Grátis |
infixs_correios_automatico_notification_createdsrc/Services/NotificationService.php:90 · :111 | Notificação nova no painel, ou uma repetida que voltou a ficar não lida. | int $id, string $type (prepost_error, auth_error, general…), string $level (error, warning, info) | Grátis |
infixs_correios_automatico_register_routessrc/Routes/RestRoutes.php:743 | Fim do registro das rotas REST, no rest_api_init. O PRO acrescenta as rotas dele aqui; para rotas suas, prefira um namespace próprio. | string $namespace (infixs-correios-automatico/v1) | Grátis |
infixs_correios_automatico_prepaid_prepost_chargedsrc/Prepaid/PrepaidCorreiosApi.php:153 | Pré-postagem do Contrato pré-pago debitada do saldo (PrepaidCorreiosApi::CHARGED_ACTION). | int $order_id, ?int $charged_cents, ?int $balance_cents, array $response | Grátis 1.14.0 |
infixs_correios_automatico_prepaid_prepost_refundedsrc/Prepaid/PrepaidCorreiosApi.php:230 | Pré-postagem pré-paga cancelada e estornada ao saldo (PrepaidCorreiosApi::REFUNDED_ACTION). | string $prepost_id (id nos Correios), int $refunded_cents, ?int $balance_cents | Grátis 1.14.0 |
infixs_correios_automatico_correios_auth_failedsrc/Services/Correios/CorreiosApi.php:276 · :283 | Falha ao autenticar o cartão de postagem do Contrato Próprio. | WP_Error $error | Grátis |
infixs_correios_automatico_correios_auth_successsrc/Services/Correios/CorreiosApi.php:289 | Autenticação do Contrato Próprio bem-sucedida. | — | Grátis |
infixs_correios_automatico_pro_logplus_order_created PROPRO · src/Integrations/LogPlus/Orders/LogPlusOrderService.php:280 | Pedido criado (ou vinculado) no armazém Correios LOG+. A NF-e é emitida depois, com xPed = $correios_id. | int $order_id, string $correios_id, WC_Order $order | PRO 1.6.0 |
infixs_correios_automatico_before_save_general_settingssrc/Controllers/Rest/SettingsGeneralController.php:26 | interno Antes de salvar as configurações gerais. | array $data | Grátis |
infixs_correios_automatico_get_shipping_costsrc/Services/Correios/CorreiosService.php:44 | interno Antes de cotar pelo Contrato Próprio (o PRO pendura o cálculo dele aqui). | CorreiosService $service | Grátis |
infixs_correios_automatico_pro_bling_connected PROPRO · src/Integrations/Bling/Connection/BlingConnector.php:58 | interno Conexão com o Bling concluída (BlingConnector::CONNECTED_ACTION). | — | PRO |
Prepost é \Infixs\CorreiosAutomatico\Models\Prepost; TrackingCode e TrackingCodeEvent ficam em \Infixs\CorreiosAutomatico\Models; ShippingCost é \Infixs\CorreiosAutomatico\Services\Correios\Includes\ShippingCost; CorreiosShippingMethod é \Infixs\CorreiosAutomatico\Core\Shipping\CorreiosShippingMethod. O caminho abaixo de cada nome é relativo à pasta do plugin (grátis ou PRO).
Ações que o seu plugin dispara
Estas duas ações pertencem ao contrato de quem emite a nota: o Correios Automático as documenta, e o PRO as ouve. O PRO também as dispara para as notas da integração nativa com o Bling, então um ouvinte seu de _ready ou _failed recebe esses avisos também. Dispare _ready depois de salvar a nota.
| Ação | Quando disparar | Argumentos | Quem ouve |
|---|---|---|---|
infixs_correios_automatico_order_invoice_readysrc/Services/OrderInvoiceResolver.php:26 · PRO · src/Services/Invoice/OrderInvoicePublisher.php:149 | A NF-e do pedido ficou disponível (o filtro e os metas já a devolvem). O PRO solta a pré-postagem que aguardava e, desde a 1.6.2, adianta o XML do Correios LOG+. | int $order_id | PRO ouve e também dispara (notas do Bling) |
infixs_correios_automatico_order_invoice_failedsrc/Services/OrderInvoiceResolver.php:29 · PRO · src/Services/Invoice/OrderInvoicePublisher.php:164 | A NF-e não pôde ser emitida. O PRO mostra a mensagem como erro de pré-postagem e o envio segue aguardando. | int $order_id, string $message | PRO ouve e também dispara (notas do Bling) |
Tarefas agendadas
interno Ganchos executados pelo Action Scheduler (ou pelo WP-Cron). Eles aparecem aqui para você reconhecê-los na fila; são rotinas do próprio plugin.
| Gancho | Argumentos | O que faz | Plano |
|---|---|---|---|
infixs_correios_automatico_prepost_sync_schedule | int $prepost_id | 60 s depois de cada pré-postagem: relê status, chave da DC-e e motivo de cancelamento. | Grátis |
infixs_correios_automatico_update_status_schedule | int $order_id | Atualiza o status do pedido 10 s depois. | Grátis |
infixs_correios_automatico_pro_waiting_invoice_sweep | — | De hora em hora: retoma os pedidos que aguardam a NF-e. | PRO |
infixs_correios_automatico_delayed_prepost | int $order_id | Pré-postagem com o atraso configurado no método. | PRO |
infixs_correios_automatico_tracking_schedule | — na rodada de hora em hora; array $ids, true nos lotes seguintes | Rastreio periódico dos objetos, 25 por vez; o restante vai em lotes agendados 60 s depois. O ouvinte aceita 2 argumentos. | PRO |
infixs_correios_automatico_pro_logplus_sweep, _pro_logplus_send, _pro_logplus_sync_order, _pro_logplus_invoice, _pro_logplus_stock | variam | Rotinas do Correios LOG+ (rodada de 30 min, envio do pedido, leitura, XML da NF-e, estoque). | PRO |
infixs_correios_automatico_pro_auto_print, _pro_flush_print_batch, _pro_retry_print_job, _pro_print_maintenance | variam | Impressão automática e fila do agente de impressão. | PRO |
infixs_correios_automatico_pro_bling_maintenance, _pro_bling_sync_invoice, _pro_bling_lookup_order | variam | Integração nativa com o Bling. | PRO |