Correios Automático

Metadados

Os metadados que o Correios Automático lê e grava. O seu plugin grava só os dois da NF-e; os demais servem para leitura. Use sempre os métodos do pedido (get_meta, update_meta_data, save), que funcionam com HPOS.

Correios Automático 1.14.0PRO 1.6.4REST infixs-correios-automatico/v1WP 6.0+ · PHP 7.4+ · HPOSGuia de instalaçãoPlugin no WordPress.orgCorreios Automático PRO
Metadados

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.

Pedido: NF-e

ChaveTipoQuem gravaUso
_infixs_correios_automatico_invoice_numbersrc/Services/OrderInvoiceResolver.php:47stringO seu plugin (ou o lojista). O Correios Automático regrava com a nota usada depois de cada pré-postagem.Número da NF-e. Reserva do filtro infixs_correios_automatico_order_invoice.
_infixs_correios_automatico_invoice_keysrc/Services/OrderInvoiceResolver.php:56string (44 dígitos)O seu plugin (ou o lojista). Também regravado depois de cada pré-postagem.Chave da NF-e (modelo 55). Apague no cancelamento da nota, se ainda for a sua.
_infixs_correios_automatico_auto_prepost_waiting_invoice PROPRO · src/Services/AutoPrepostInvoice.php:33array shipping_item_id => timestampO PROEnvios que aguardam a NF-e (0 = pedido inteiro). Somente leitura.

Pedido: pré-postagem, devolução e rastreio

ChaveTipoQuem gravaUso
_infixs_correios_automatico_prepost_createdsrc/Services/PrepostService.php:1109yesO pluginO pedido foi pré-postado; sai quando a última pré-postagem é cancelada. Somente leitura.
_infixs_correios_automatico_prepost_idsrc/Services/PrepostService.php:1110intO pluginId local da última pré-postagem de ida. Somente leitura.
_infixs_correios_automatico_prepost_errorssrc/Services/PrepostService.php:39array de { id, code, message, shipping_item_id, date } (até 20)O pluginErros de pré-postagem mostrados no pedido e no painel. Somente leitura.
_infixs_correios_automatico_reverse_prepost_idsrc/Services/PrepostService.php:1376intO pluginId local da última pré-postagem reversa.
_infixs_correios_automatico_reverse_prepost_codesrc/Services/PrepostService.php:1377stringO pluginCódigo do objeto da última reversa; já gravado quando prepost_created dispara.
_infixs_correios_automatico_reverse_prepostssrc/Services/PrepostService.php:55array de { id, code, shipping_item_id }O pluginReversas do pedido, uma por linha de frete (Container::prepostService()->getReversePreposts( $order )).
_infixs_correios_automatico_return_requestedsrc/Services/ReturnService.php:42marcaO pluginO cliente já pediu a devolução.
_infixs_correios_automatico_printedsrc/Services/OrderService.php:232data e horaO pluginA etiqueta foi marcada como impressa.
_infixs_correios_automatico_email_tracking_sentsrc/Services/TrackingService.php:181data e horaO pluginEnvio do e-mail de rastreio. Também _email_preparing_sent, _email_out_for_delivery_sent, _email_waiting_pickup_sent, _email_returning_sent e _email_delivered_sent.
_correios_tracking_codesrc/Services/TrackingService.php:132string (códigos separados por vírgula)O plugin, com a compatibilidade de rastreio ligadaEspelho dos códigos de rastreio para outros plugins.

Os códigos de rastreio ficam numa tabela própria do plugin. Leia por Container::trackingService() (getShipmentCodes(), getReverseCodes()), por GET /orders/{id} ou pela REST do WooCommerce (tracking_codes).

Pedido: Correios LOG+

PRO Gravados pelo PRO; leitura liberada.

ChaveTipoQuem gravaUso
_infixs_logplus_id PROPRO · src/Integrations/LogPlus/Orders/LogPlusOrderMeta.php:25stringO PROId do pedido nos Correios, o xPed da NF-e. Vazio enquanto o pedido não existe no armazém.
_infixs_logplus_number PROPRO · src/Integrations/LogPlus/Orders/LogPlusOrderMeta.php:34string (dígitos)O PRONúmero com que o pedido foi ao armazém.
_infixs_logplus_status PROPRO · src/Integrations/LogPlus/Orders/LogPlusOrderMeta.php:70created, shipped ou errorO PROSituação do pedido no armazém.
_infixs_logplus_xml_status PROPRO · src/Integrations/LogPlus/Orders/LogPlusOrderMeta.php:115waiting, sent ou failedO PROSituação do XML da NF-e.
_infixs_logplus_xml_attempts PROPRO · src/Integrations/LogPlus/Orders/LogPlusOrderMeta.php:124intO PRORecusas do XML pelo armazém.
_infixs_logplus_xml PROPRO · src/Integrations/LogPlus/Orders/LogPlusOrderMeta.php:106stringO PRO, com o XML enviado pelo lojistaXML manual; tem prioridade sobre o filtro de XML.
_infixs_logplus_xml_error PROPRO · src/Integrations/LogPlus/Orders/LogPlusOrderMeta.php:136stringO PROMotivo da última recusa do XML (o último erro do pedido fica em _infixs_logplus_error).
_infixs_logplus_service PROPRO · src/Integrations/LogPlus/Orders/LogPlusOrderMeta.php:43stringO PROServiço LOG+. Também _infixs_logplus_warehouse, _environment, _situation, _tracking, _synced_at e _created_at.

Linha de frete e produto

ChaveTipoQuem gravaUso
_infixs_correios_automatico_prepost_idsrc/Services/PrepostService.php:46intO plugin, na linha de fretePré-postagem daquele volume. Confira antes de pré-postar por código.
shipping_product_codesrc/Entities/Order.php:343stringO plugin, na linha de freteCódigo do serviço dos Correios.
_infixs_volume_indexsrc/Core/Shipping/CorreiosShippingMethod.php:53intO plugin, na linha de fretePosição do volume (_infixs_volume_total traz o total).
_infixs_linked_instance_idsrc/Core/Shipping/LinkedShippingMethod.php:34intO plugin, na linha de freteInstância dos Correios vinculada a um frete nativo.
delivery_timesrc/Entities/Order.php:340variamO plugin, na linha de freteDados da cotação: também _width, _height, _length, _weight, _insurance_cost, _original_cost e vendor_id.
_infixs_correios_automatico_ncmsrc/Core/Admin/WooCommerce/Product.php:29stringO lojista, no produto (aba Entrega)NCM da declaração de conteúdo e dos itens da etiqueta; numa variação, lido da própria variação.
_infixs_correios_automatico_additional_dayssrc/Core/Admin/WooCommerce/Product.php:37intO lojista, no produtoDias somados ao prazo de entrega.
_infixs_correios_automatico_dangerous_productsrc/Core/Admin/WooCommerce/Product.php:50yes ou noO lojista, no produtoArtigo perigoso (serviço adicional na pré-postagem).