Como configurar a importação automática do XML de NF-e?

Este artigo explica como configurar a importação automática do XML de NF-e no ANYMARKET. A funcionalidade permite que o XML seja importado por meio do serviço de captura via e-mail, disponível para plataformas compatíveis. Além disso, as integrações Wake e VTEX também podem disponibilizar o XML por meio de seus recursos nativos, permitindo que o ANYMARKET capture o documento diretamente pela plataforma quando essa configuração estiver em uso.

A importação automática do XML de NF-e permite que o ANYMARKET capture, de forma automática, o arquivo XML da Nota Fiscal Eletrônica emitida pelo vendedor e envie suas informações ao marketplace, eliminando a necessidade de upload manual, reduzindo erros operacionais e agilizando o faturamento dos pedidos.

Neste artigo:

• Pré-requisitos
• Como funciona a importação automática do XML de NF-e
• Passo a passo para configurar a funcionalidade
• Boas práticas
• Dúvidas comuns

Pré-requisitos

A funcionalidade de importação automática do XML de NF-e está disponível para as seguintes plataformas, também chamadas de backoffices:

• Magento
• Shopify
• Tray
• VTEX
• Wake

Para utilizar o serviço de importação automática via e-mail, é necessário que:

• A opção de importação automática esteja ativa nos parâmetros do ANYMARKET;
• O XML da NF-e seja enviado para o e-mail de importação do ANYMARKET;
• O pedido seja atualizado no backoffice com a chave de acesso da NF-e;
• A chave de acesso permita que o ANYMARKET identifique e vincule o XML ao pedido correto.

Para Wake e VTEX, além do fluxo de importação por e-mail, também é possível utilizar a importação nativa do XML da NF-e por meio dos recursos disponibilizados pelas próprias plataformas. Nesses casos, é necessário que a integração esteja ativa, que o pedido exija a emissão de NF-e e que o XML esteja disponível nos endpoints nativos da plataforma. Assim, o ANYMARKET realiza a captura automática do documento, sem a necessidade de envio por e-mail ou de atualização do pedido com a chave de acesso da NF-e.

Como funciona a importação automática do XML de NF-e

A importação automática do XML de NF-e é uma funcionalidade que permite ao ANYMARKET capturar, de forma automática, o arquivo XML da Nota Fiscal Eletrônica emitida pelo vendedor e enviar suas informações ao marketplace.

Essa automação evita a necessidade de upload manual da NF-e, reduz erros operacionais e agiliza o processo de faturamento dos pedidos.

Fluxo por e-mail (Magento, Shopify, Tray, Wake e VTEX)

Para essas plataformas, o processo depende do envio do XML para o e-mail de importação do ANYMARKET e da atualização do pedido no backoffice com a chave de acesso da NF-e.

O ANYMARKET captura, de forma automática, o XML enviado para o e-mail configurado e vincula o arquivo ao pedido correto usando a chave de acesso informada.

Fluxo nativo para Wake

Além do fluxo de importação por e-mail, a Wake também disponibiliza um fluxo nativo para captura do XML da NF-e. Nesse modelo, o ANYMARKET consulta o endpoint de rastreamento do pedido e obtém o XML completo da nota fiscal por meio do campo XmlNfe, retornado ao solicitar camposAdicionais=XmlNfe.

Com isso, o ANYMARKET pode utilizar o XML para faturar o pedido de forma automática, sem depender do envio do arquivo por e-mail nem do reprocessamento do serviço de importação.

Após o registro da NF-e na Wake, o XML já fica disponível para captura, permitindo que o faturamento siga de forma mais ágil. Caso o fluxo nativo não esteja implementado ou configurado na integração, a importação do XML por e-mail continua disponível como alternativa.

Fluxo nativo para VTEX

Além do fluxo de importação por e-mail, a VTEX também disponibiliza um fluxo nativo para captura do XML da NF-e. Nesse modelo, o ANYMARKET consulta os dados do pedido e obtém o XML da nota fiscal por meio do campo EmbeddedInvoice, disponibilizado pela plataforma.

Com isso, o ANYMARKET pode utilizar o XML para faturar o pedido de forma automática, sem depender do envio manual do arquivo por e-mail nem do reprocessamento do serviço de importação.

Após o registro da NF-e na VTEX, o XML fica disponível para captura, permitindo que o faturamento siga de forma mais ágil. Caso o fluxo nativo não esteja implementado ou configurado na integração, a importação do XML por e-mail continua disponível como alternativa.

O que é o congelamento de status?

O congelamento de status é um mecanismo de controle que garante a sincronização correta entre o status do pedido no ANYMARKET e o status no marketplace.

Para pedidos em que o envio do XML da NF-e é obrigatório para o canal de venda, o status do pedido no ANYMARKET não avançará para Faturado até que o XML da nota fiscal seja identificado, seja pelo fluxo por e-mail, seja pelo fluxo nativo da Wake ou VTEX.

Isso evita atualizações incorretas e garante que o pedido só seja considerado faturado após o envio do XML ao marketplace.

Passo a passo para configurar a funcionalidade

Para Magento, Shopify, Tray, Wake e VTEX

1. Ativar a importação e envio automático de XML no ANYMARKET

   No painel do ANYMARKET, acesse: Configurações > Parâmetros > Importação e envio do XML da NF-e.

   Ative a opção: Ativar a importação e envio automático de XML da NF-e.

2. Enviar os arquivos XML das notas fiscais para o ANYMARKET

   O envio dos arquivos XML pode ser feito de duas formas:

   • Via sistema de faturamento ou ERP: configure o ERP para enviar, de forma automática, o XML para o e-mail de importação;
   • Envio manual: encaminhe os arquivos XML diretamente para o e-mail de importação.

   E-mail para envio dos XMLs: importacaoxml.anymarket@db1.com.br

3. Atualizar o pedido no backoffice com a chave de acesso da NF-e

   Após o envio do XML para o e-mail, é necessário atualizar o pedido no backoffice, ou seja, na plataforma de e-commerce, informando a chave de acesso da nota fiscal. Essa informação é essencial para que o ANYMARKET consiga identificar e vincular o XML ao pedido correto.

   Cada plataforma possui sua própria forma de atualizar essa informação. Se tiver dúvidas sobre como inserir a chave de acesso no backoffice, entre em contato com o time de suporte.

4. Acompanhar a atualização do pedido

   Com a funcionalidade ativada e o XML enviado corretamente:

   • O ANYMARKET captura, de forma automática, o XML enviado para o e-mail configurado;
   • Se o pedido atender aos critérios para envio do XML, o arquivo será enviado ao marketplace;
   • Após a integração do XML com sucesso, o status do pedido no ANYMARKET será atualizado para Faturado;
   • O congelamento de status garante que o processo aconteça na ordem correta, evitando falhas de sincronização.

Para os fluxos nativos Wake e VTEX

Para pedidos Wake e VTEX que usam o fluxo nativo, não há passo a passo de configuração manual: assim que a integração está ativa, o ANYMARKET passa a capturar o XML da NF-e de forma automática do rastreamento do pedido, para todo pedido que exija NF-e.

• O ANYMARKET consulta o rastreamento do pedido na Wake ou na VTEX e identifica o XML da NF-e no campo XmlNfe (Wake) ou EmbeddedInvoice (VTEX);
• Se o pedido atender aos critérios para envio do XML, o arquivo é enviado ao marketplace;
• Após a integração do XML com sucesso, o status do pedido no ANYMARKET é atualizado para Faturado;
• O congelamento de status garante que o processo aconteça na ordem correta, evitando falhas de sincronização.

Esse fluxo garante que o faturamento e a atualização de status aconteçam de forma automática, segura e alinhada entre os sistemas.

Boas práticas

• Confirme se a plataforma utilizada é compatível com a funcionalidade.
• Para o fluxo por e-mail: ative a opção de importação automática nos parâmetros do ANYMARKET antes de iniciar os envios; configure o seu ERP para enviar os XMLs de forma automática, quando possível; atualize o pedido no backoffice com a chave de acesso da NF-e após o envio do XML; garanta que a chave de acesso informada no backoffice corresponde ao XML enviado.
• Para o fluxo nativo de Wake e VTEX: não é necessário nenhum envio manual de XML nem atualização de chave de acesso. Apenas mantenha a integração ativa e os pedidos com NF-e emitida.
• Considere o congelamento de status em canais onde o XML é obrigatório para faturamento.

Dúvidas comuns

O que é a importação automática do XML de NF-e?
É a funcionalidade em que o ANYMARKET captura, de forma automática, o XML da Nota Fiscal Eletrônica emitida pelo vendedor e envia as informações para o marketplace.

Quais plataformas são compatíveis?
A funcionalidade está disponível para Magento, Shopify, Tray, VTEX e Wake.

Para pedidos Wake, ainda preciso enviar o XML por e-mail?
Não necessariamente. A integração Wake também oferece um fluxo nativo de captura do XML da NF-e, permitindo que o ANYMARKET obtenha o documento diretamente pela plataforma. Caso esse fluxo não esteja implementado ou configurado, a importação do XML por e-mail continua disponível como alternativa.

Onde ativo a funcionalidade no ANYMARKET?
Para o fluxo por e-mail, acesse Configurações > Parâmetros > Importação e envio do XML da NF-e e ative a opção Ativar a importação e envio automático de XML da NF-e. Para o fluxo nativo de Wake e VTEX, não é necessário ativar nenhum parâmetro: a captura nativa do XML acontece de forma automática para pedidos que exigem NF-e.

Para qual e-mail devo enviar os XMLs?
Para o fluxo por e-mail, envie os arquivos XML para importacaoxml.anymarket@db1.com.br.

Posso enviar o XML manualmente?
Sim, é possível encaminhar manualmente os arquivos XML para o e-mail de importação. Caso você utilize o fluxo nativo, o envio manual não é necessário.

Meu ERP pode enviar o XML automaticamente?
Sim, o seu ERP pode ser configurado para enviar o XML de forma automática para o e-mail de importação do ANYMARKET. Já no fluxo nativo, o ANYMARKET captura o XML direto do rastreamento do pedido, sem depender do ERP para esse envio.

Por que preciso atualizar a chave de acesso da NF-e no backoffice?
Para o fluxo por e-mail, a chave de acesso permite que o ANYMARKET identifique e vincule o XML ao pedido correto. Para o fluxo nativo, essa atualização não é necessária.

O que é o congelamento de status?
É um controle que impede o pedido de avançar para Faturado enquanto o XML obrigatório da NF-e não for identificado, seja pelo fluxo por e-mail, seja pelo fluxo nativo.

O que acontece após o XML ser identificado?
Se o pedido atender aos critérios, o XML será enviado ao marketplace e, após a integração com sucesso, o status do pedido será atualizado para Faturado.