💡 Decathlon - How to send customer invoices to the marketplace?

Lengow is allowing you to upload your customer invoices to submit them to Decathlon.

You have 3 options to send customer invoices to Decathlon:

• Through the Lengow API
• In the Lengow platform (will be available in the coming weeks)
• In your Mirakl back-office
  
  

Upload via API

- Marketplaces API: "invoice_upload" parameter

If the marketplace allows invoice upload, you will find the invoice_upload parameter in the Marketplaces API.

Example for Decathlon:

 "decathlon_eu_be_fr": {
"logo": "",
"name": "Decathlon BE (French)",
"orders": {},
"country": "BEL",
"package": "sp_decathlon_eu.mp.be_fr",
"features": {
"invoice_upload": true

- Orders API: API call

Endpoint: https://api.lengow.io/v3.0/document/

Make the following API call to upload a customer invoice:

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"'

Information on the parameters of this call:

• All parameters are sent in form-data
• All parameters are text fields, except for upload, which is a "files" field
• metadata must contain these parameters:
  • document_number : invoice number as a string of characters.

  • issue_date : character string in ISO UTC date format: YYYY-MM-ddTHH:MM:SSZ

  • due_date : character string in ISO UTC date format: YYYY-MM-ddTHH:MM:SSZ

  • total_amount_excluding_taxes : floating-point integer to two decimal places. Ex: 31.99

  • total_tax_amount : floating-point integer to two decimal places. Ex: 3.19

• upload : the customer invoice must be sent in xml or pdf format. Maximum size of the file: 20 Mo
  
  

For more information, refer to our API documentation

Upload in the Lengow platform

To upload an invoice in the Lengow platform:

• In the Orders section in Lengow, go to the detail page of your order ;
• Click on the upload icon at the bottom right of the page, and on "Upload an invoice";
• A window opens to allow you to fill in the requested information and select the invoice to upload (see screenshot);
• When you're ready, click on "Send" to transmit the order's invoice to the marketplace.

Upload in your Mirakl back-office

To upload your customer invoice for an order in your Mirakl back-office, go to the order details page.

On the top right side of the screen, click on "More actions" and then on "Documents". In the "Accounting documents" section, you may upload the customer invoice for this order.

Refer to the detailed process here in Decathlon's documentation.