Lengow te permite cargar tus facturas de cliente para enviarlas a cualquier mercado de Mirakl.
Tienes 3 opciones para enviar facturas de cliente a un mercado de Mirakl:
- A través de la API de Lengow
- En la plataforma Lengow
- En tu back-office de Mirakl
Documento de factura del cliente
Para asegurarte de que tus facturas son conformes y cumplen con las regulaciones geográficas y comerciales, Mirakl recomienda consultar a tus asesores fiscales y legales.
Mirakl proporciona este ejemplo de factura en su documentación.
Carga a través de la API
- API de Marketplaces: parámetro "invoice_upload"
Si el mercado permite la carga de facturas, encontrarás el parámetro invoice_upload en la API de Marketplaces.
Ejemplo para Decathlon:
"decathlon_eu_be_fr": {
"logo": "",
"name": "Decathlon BE (Francés)",
"orders": {},
"country": "BEL",
"package": "sp_decathlon_eu.mp.be_fr",
"features": {
"invoice_upload": true
- API de pedidos: llamada API
Punto final: https://api.lengow.io/v3.0/document/
Haz la siguiente llamada API para cargar una factura de cliente:
curl --location 'https://api.lengow.io/api/v3.1/document/' \
--form 'order_id="5137116-A"' \
--form 'account_id="58"' \
--form 'metadata="{\"document_number\":\"123\",\"issue_date\":\"2024-10-17T00:00:00Z\",\"due_date\":\"2024-10-18T00:00:00Z\",\"total_amount_excluding_taxes\":31.99,\"total_tax_amount\":3.19}"' \
--form 'marketplace="decathlon_eu_be_fr"' \
--form 'upload=@"/C:/Users/invoices/ma_facture.pdf"'Información sobre los parámetros de esta llamada:
- Todos los parámetros se envían en form-data
- Todos los parámetros son campos de texto, excepto upload, que es un campo de "archivos"
-
metadata debe contener estos parámetros:
- document_number : número de factura como una cadena de caracteres.
-
issue_date : cadena de caracteres en formato de fecha UTC ISO: YYYY-MM-ddTHH:MM:SSZ
-
due_date : cadena de caracteres en formato de fecha UTC ISO: YYYY-MM-ddTHH:MM:SSZ
-
total_amount_excluding_taxes : entero de punto flotante con dos decimales. Ej: 31.99
-
total_tax_amount : entero de punto flotante con dos decimales. Ej: 3.19
-
upload : la factura del cliente debe enviarse en formato xml o pdf. Tamaño máximo del archivo: 20 Mo
Para más información, consulta nuestra documentación de la API
Carga en la plataforma Lengow
Para cargar una factura en la plataforma Lengow:
- En la sección de Pedidos en Lengow, ve a la página de detalles de tu pedido ;
- Haz clic en el icono de carga en la parte inferior derecha de la página, y en "Cargar una factura";
- Se abre una ventana para permitirte rellenar la información solicitada y seleccionar la factura a cargar (ver captura de pantalla);
- Cuando estés listo, haz clic en "Enviar" para transmitir la factura del pedido al mercado.
Si no ves este icono, significa que el mercado no ha activado la opción de carga de facturas.
Carga en tu back-office de Mirakl
Para cargar tu factura de cliente para un pedido en tu back-office de Mirakl, ve a la página de detalles del pedido.
En la parte superior derecha de la pantalla, haz clic en "Más acciones" y luego en "Documentos". En la sección "Documentos contables", puedes cargar la factura del cliente para este pedido.
Por ejemplo para Decathlon, el proceso detallado se proporciona Consulte aquí en su documentación.