La etapa de facturación de un pedido en ANYMARKET consiste en enviar al marketplace los datos de la factura fiscal y el documento fiscal correspondiente (XML o PDF). Anteriormente, este proceso requería dos llamadas separadas a la API.
Con esta actualización, el endpoint POST order/fiscalDocument ahora acepta tanto el documento fiscal como los datos de la factura en una única solicitud, simplificando la integración entre el ERP del vendedor y el marketplace.
El flujo anterior sigue estando disponible, por lo que la adopción del formato consolidado es opcional.
En este artículo:
Requisitos previos
- Tener una integración activa con ANYMARKET mediante API.
- Contar con un token de autenticación válido (
gumgaToken). - Disponer de un pedido existente en ANYMARKET con un estado apto para ser facturado.
- Tener el documento fiscal emitido en el ERP del vendedor (XML para NF-e en Brasil; XML o PDF en LATAM).
Cómo funciona
Flujo anterior (dos llamadas)
Hasta ahora, facturar un pedido requería dos pasos separados:
Paso 1: Enviar los datos de la factura
Envío de los datos de la factura (número, serie, clave de acceso, valores, fechas, etc.).
Paso 2: Enviar el documento fiscal
Brasil:
POST /orders/{id}/nfeLATAM:
POST /orders/{id}/fiscalDocumentEnvío del archivo XML o PDF del documento fiscal.
Nuevo flujo (llamada única - recomendado)
Ahora, los datos de la factura y el documento fiscal se envían juntos en una única solicitud multipart/form-data:
POST /orders/{orderId}/fiscalDocument?packageId=Ejemplo de llamada
curl 'https://sandbox-api.anymarket.com.br/v2/orders/{orderId}/fiscalDocument?packageId=' \
--request POST \
--header 'Content-Type: multipart/form-data' \
--header 'gumgaToken: TU_TOKEN' \
--form 'file=@factura.xml' \
--form 'number=12345' \
--form 'date=2026-08-06T10:00:00-03:00' \
--form 'accessKey=3525XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
--form 'series=1' \
--form 'cfop=6108' \
--form 'companyStateTaxId=123456789' \
--form 'linkNfe=https://...' \
--form 'invoiceLink=https://...' \
--form 'extraDescription=' \
--form 'operationType=' \
--form 'emissionType=' \
--form 'authorizationProtocol=' \
--form 'origin=ORIGIN_ERP'ANYMARKET procesa de forma automática la información consolidada y completa la etapa de facturación del pedido.
Campos aceptados por el endpoint
Además del campo file (documento fiscal XML o PDF), el endpoint POST order/fiscalDocument acepta los siguientes datos de la factura:
| Campo | Descripción |
|---|---|
file | Archivo del documento fiscal (XML o PDF) |
number | Número de la factura |
date | Fecha de emisión de la factura |
accessKey | Clave de acceso de la NF-e |
series | Serie de la factura |
cfop | Código Fiscal de Operaciones y Prestaciones |
companyStateTaxId | Inscripción estatal de la empresa |
linkNfe | Enlace de la NF-e |
invoiceLink | Enlace de la factura/documento |
extraDescription | Descripción adicional u observaciones |
operationType | Tipo de operación |
emissionType | Tipo de emisión |
authorizationProtocol | Protocolo de autorización de la factura |
origin | Origen del envío (ej.: ORIGIN_ERP) |
También está disponible el parámetro de consulta (query parameter) packageId, utilizado cuando el pedido está dividido en paquetes.
La obligatoriedad de cada campo puede variar según el país y el marketplace. Consulta la referencia técnica del endpoint para conocer el contrato completo.
Preguntas frecuentes
¿Necesito migrar mi integración inmediatamente?
No. El flujo anterior (PUT order;faturado + order/nfe u order/fiscalDocument) continúa funcionando con normalidad. La llamada consolidada es una opción para reducir el esfuerzo de integración, no una obligación.
¿Qué datos de la factura puedo enviar junto con el documento fiscal?
Además del archivo (file), el endpoint acepta los campos: number, date, accessKey, series, cfop, companyStateTaxId, linkNfe, invoiceLink, extraDescription, operationType, emissionType, authorizationProtocol y origin.
¿Este cambio aplica para Brasil y LATAM?
Sí. El endpoint POST order/fiscalDocument unifica el envío en ambos escenarios. En Brasil, normalmente se utiliza el XML de la NF-e; en LATAM, XML o PDF según el marketplace.
¿Puedo seguir enviando los datos y el documento en llamadas separadas?
Sí. Ambos enfoques continúan coexistiendo. Puedes elegir el que mejor se adapte a tu integración.
¿Necesito configurar algo en el panel de ANYMARKET para utilizar el formato consolidado?
No. No se requiere ninguna configuración adicional. Solo debes adaptar la llamada de tu integración al nuevo payload.
¿Para qué sirve el parámetro packageId?
Identifica el paquete cuando un pedido está dividido en más de un envío. Debe utilizarse cuando aplique a tu operación.
¿Qué ocurre si envío los datos de la factura sin el documento fiscal (o viceversa)?
La etapa de facturación solo se completa cuando el marketplace recibe toda la información necesaria. Verifica los campos obligatorios en la referencia técnica para garantizar que la solicitud esté completa.
¿Necesitas ayuda?
Ponte en contacto con el soporte de ANYMARKET a través de tu canal de atención habitual, indicando el número del pedido y el endpoint utilizado para agilizar el análisis.
Comentarios
0 comentarios
El artículo está cerrado para comentarios.