¿Cómo configurar la importación automática del XML de la NF-e?

Este artículo explica cómo configurar la importación automática del XML de la NF-e (Nota Fiscal Eletrônica, la factura electrónica de Brasil) en ANYMARKET. La funcionalidad permite importar el XML mediante el servicio de captura por correo electrónico, disponible para las plataformas compatibles.

Además, las integraciones Wake y VTEX también pueden poner el XML a disposición mediante sus recursos nativos, lo que permite que ANYMARKET capture el documento directamente desde la plataforma cuando esa configuración está en uso.

La importación automática del XML de la NF-e permite que ANYMARKET capture automáticamente el archivo XML de la factura emitida por el vendedor y envíe sus datos al marketplace. Así, se elimina la necesidad de cargarlo manualmente, se reducen los errores operativos y se agiliza la facturación de los pedidos.

En este artículo:

• Requisitos previos
• Cómo funciona la importación automática del XML de la NF-e
• Paso a paso para configurar la funcionalidad
• Buenas prácticas
• Preguntas frecuentes

Requisitos previos para la importación automática del XML de la NF-e

La funcionalidad de importación automática del XML de la NF-e está disponible para las siguientes plataformas, también llamadas backoffices:

• Magento
• Shopify
• Tray
• VTEX
• Wake

Para usar el servicio de importación automática por correo electrónico, es necesario que:

• La opción de importación automática esté activa en los parámetros de ANYMARKET.
• El XML de la NF-e se envíe al correo de importación de ANYMARKET.
• El pedido se actualice en el backoffice con la clave de acceso de la NF-e.
• La clave de acceso permita que ANYMARKET identifique y vincule el XML al pedido correcto.

Para Wake y VTEX, además del flujo de importación por correo electrónico, también es posible usar la importación nativa del XML de la NF-e mediante los recursos de las propias plataformas. En ese caso, es necesario que:

• La integración esté activa.
• El pedido exija la emisión de NF-e.
• El XML esté disponible en los endpoints nativos de la plataforma.

Con el flujo nativo, ANYMARKET captura el XML automáticamente, sin necesidad de enviarlo por correo electrónico ni de actualizar el pedido con la clave de acceso de la NF-e.

Cómo funciona la importación automática del XML de la NF-e

La importación automática del XML de la NF-e permite que ANYMARKET capture automáticamente el archivo XML de la factura emitida por el vendedor y envíe sus datos al marketplace.

Esta automatización evita la carga manual de la NF-e, reduce errores operativos y agiliza el proceso de facturación de los pedidos.

Flujo por correo electrónico (Magento, Shopify, Tray, Wake y VTEX)

Para estas plataformas, el proceso depende de dos acciones: enviar el XML al correo de importación de ANYMARKET y actualizar el pedido en el backoffice con la clave de acceso de la NF-e.

ANYMARKET captura automáticamente el XML enviado al correo configurado y vincula el archivo al pedido correcto usando la clave de acceso informada.

Flujo nativo para Wake

Además del flujo por correo electrónico, Wake ofrece un flujo nativo para capturar el XML de la NF-e. En este modelo, ANYMARKET consulta el endpoint de seguimiento del pedido y obtiene el XML completo de la factura a través del campo XmlNfe, que se devuelve al solicitar camposAdicionais=XmlNfe.

Con el flujo nativo de Wake, ANYMARKET puede usar el XML para facturar el pedido automáticamente, sin depender del envío del archivo por correo electrónico ni del reprocesamiento del servicio de importación.

Después del registro de la NF-e en Wake, el XML ya queda disponible para la captura, lo que agiliza la facturación. Si el flujo nativo no está implementado o configurado en la integración, la importación del XML por correo electrónico sigue disponible como alternativa.

Flujo nativo para VTEX

Además del flujo por correo electrónico, VTEX ofrece un flujo nativo para capturar el XML de la NF-e. En este modelo, ANYMARKET consulta los datos del pedido y obtiene el XML de la factura a través del campo EmbeddedInvoice, disponible en la plataforma.

Con el flujo nativo de VTEX, ANYMARKET puede usar el XML para facturar el pedido automáticamente, sin depender del envío manual del archivo por correo electrónico ni del reprocesamiento del servicio de importación.

Después del registro de la NF-e en VTEX, el XML queda disponible para la captura, lo que agiliza la facturación. Si el flujo nativo no está implementado o configurado en la integración, la importación del XML por correo electrónico sigue disponible como alternativa.

¿Qué es el congelamiento de estado?

El congelamiento de estado es un mecanismo de control que garantiza la sincronización correcta entre el estado del pedido en ANYMARKET y el estado en el marketplace.

En los pedidos en los que el canal de venta exige el envío del XML de la NF-e, el estado del pedido en ANYMARKET no avanza a Facturado hasta que se identifica el XML de la factura, ya sea por el flujo por correo electrónico o por el flujo nativo de Wake o VTEX.

El congelamiento de estado evita actualizaciones incorrectas y garantiza que el pedido solo se considere facturado después del envío del XML al marketplace.

Paso a paso para configurar la importación automática del XML de la NF-e

Flujo por correo electrónico: Magento, Shopify, Tray, Wake y VTEX

1. Activar la importación y el envío automático del XML en ANYMARKET

1. En el panel de ANYMARKET, accede a Configuración > Parámetros > Importación y envío del NF- e XML.
2. Activa la opción Activar la importación y el envío automático dl XML de NF-e.

2. Enviar los archivos XML de las facturas a ANYMARKET

El envío de los archivos XML puede hacerse de dos formas:

• Por el sistema de facturación o ERP: configura el ERP para enviar automáticamente el XML al correo de importación.
• Envío manual: reenvía los archivos XML directamente al correo de importación.

Correo para el envío de los XML: importacaoxml.anymarket@db1.com.br

3. Actualizar el pedido en el backoffice con la clave de acceso de la NF-e

Después de enviar el XML al correo de importación, es necesario actualizar el pedido en el backoffice, es decir, en la plataforma de e-commerce, e informar la clave de acceso de la factura. La clave de acceso es esencial para que ANYMARKET identifique y vincule el XML al pedido correcto.

Cada plataforma tiene su propia forma de actualizar la clave de acceso. Si tienes dudas sobre cómo ingresar la clave de acceso en el backoffice, comunícate con el equipo de soporte.

4. Hacer seguimiento a la actualización del pedido

Con la funcionalidad activada y el XML enviado correctamente:

• ANYMARKET captura automáticamente el XML enviado al correo configurado.
• Si el pedido cumple los criterios para el envío del XML, ANYMARKET envía el archivo al marketplace.
• Después de integrar el XML con éxito, el estado del pedido en ANYMARKET se actualiza a Facturado.
• El congelamiento de estado garantiza que el proceso ocurra en el orden correcto y evita fallas de sincronización.

Flujo nativo: Wake y VTEX

Para los pedidos de Wake y VTEX que usan el flujo nativo, no hay un paso a paso de configuración manual. Con la integración activa, ANYMARKET captura automáticamente el XML de la NF-e de todo pedido que exija NF-e:

• ANYMARKET consulta el pedido en Wake o en VTEX e identifica el XML de la NF-e en el campo XmlNfe (Wake) o EmbeddedInvoice (VTEX).
• Si el pedido cumple los criterios para el envío del XML, ANYMARKET envía el archivo al marketplace.
• Después de integrar el XML con éxito, el estado del pedido en ANYMARKET se actualiza a Facturado.
• El congelamiento de estado garantiza que el proceso ocurra en el orden correcto y evita fallas de sincronización.

El flujo nativo garantiza que la facturación y la actualización de estado ocurran de forma automática, segura y alineada entre los sistemas.

Buenas prácticas

• Confirma que la plataforma que usas es compatible con la funcionalidad.
• Para el flujo por correo electrónico:
  • Activa la opción de importación automática en los parámetros de ANYMARKET antes de comenzar los envíos.
  • Configura tu ERP para enviar los XML automáticamente, cuando sea posible.
  • Actualiza el pedido en el backoffice con la clave de acceso de la NF-e después de enviar el XML.
  • Verifica que la clave de acceso informada en el backoffice corresponda al XML enviado.
• Para el flujo nativo de Wake y VTEX: no es necesario enviar el XML manualmente ni actualizar la clave de acceso. Solo mantén la integración activa y los pedidos con la NF-e emitida.
• Ten en cuenta el congelamiento de estado en los canales donde el XML es obligatorio para la facturación.

Preguntas frecuentes

¿Qué es la importación automática del XML de la NF-e?
Es la funcionalidad con la que ANYMARKET captura automáticamente el XML de la factura electrónica emitida por el vendedor y envía la información al marketplace.

¿Qué plataformas son compatibles con la importación automática del XML de la NF-e?
La funcionalidad está disponible para Magento, Shopify, Tray, VTEX y Wake.

Para pedidos de Wake o VTEX, ¿todavía necesito enviar el XML por correo electrónico?
No necesariamente. Las integraciones Wake y VTEX ofrecen un flujo nativo de captura del XML de la NF-e, que permite que ANYMARKET obtenga el documento directamente desde la plataforma. Si el flujo nativo no está implementado o configurado, la importación del XML por correo electrónico sigue disponible como alternativa.

¿Dónde activo la importación automática del XML en ANYMARKET?
Para el flujo por correo electrónico, accede a Configuración > Parámetros > Importación y envío del NF-e XML y activa la opción Activar la importación y el envío automático de XML de NF-e. Para el flujo nativo de Wake y VTEX, no es necesario activar ningún parámetro: la captura nativa del XML ocurre automáticamente para los pedidos que exigen NF-e.

¿A qué correo electrónico debo enviar los XML de la NF-e?
Para el flujo por correo electrónico, envía los archivos XML a importacaoxml.anymarket@db1.com.br.

¿Puedo enviar el XML de la NF-e manualmente?
Sí, puedes reenviar manualmente los archivos XML al correo de importación. Si usas el flujo nativo de Wake o VTEX, el envío manual no es necesario.

¿Mi ERP puede enviar el XML de la NF-e automáticamente?
Sí, tu ERP puede configurarse para enviar el XML automáticamente al correo de importación de ANYMARKET. En el flujo nativo, ANYMARKET captura el XML directamente desde el pedido en la plataforma, sin depender del ERP para ese envío.

¿Por qué necesito actualizar la clave de acceso de la NF-e en el backoffice?
En el flujo por correo electrónico, la clave de acceso permite que ANYMARKET identifique y vincule el XML al pedido correcto. En el flujo nativo de Wake y VTEX, esa actualización no es necesaria.

¿Por qué mi pedido no avanza a Facturado?
Puede ser por el congelamiento de estado: este control impide que el pedido avance a Facturado mientras no se identifique el XML obligatorio de la NF-e, ya sea por el flujo por correo electrónico o por el flujo nativo.

¿Qué pasa después de que ANYMARKET identifica el XML de la NF-e?
Si el pedido cumple los criterios, ANYMARKET envía el XML al marketplace y, después de la integración exitosa, el estado del pedido se actualiza a Facturado.