💡 Mirakl - Comment envoyer les factures clients à une marketplace Mirakl ?

Lengow vous permet de télécharger vos factures clients pour les transmettre à n'importe quelle marketplace Mirakl ayant activé cette fonctionnalité.

Vous avez 3 options pour envoyer des factures clients à une marketplace Mirakl :

• Par le biais de l'API Lengow
• Sur la plateforme Lengow
• Dans votre back-office Mirakl
  
  

Téléchargement via API

- API Marketplaces : paramètre "invoice_upload"

Si la marketplace permet le téléchargement de factures, vous trouverez le paramètre invoice_upload dans l'API Marketplaces.

Exemple pour Decathlon :

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

- API Orders : Appel API

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

Faites l'appel API suivant pour télécharger une facture client :

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=@"/invoices/ma_facture.pdf"'

Informations sur les paramètres de cet appel :

• Tous les paramètres sont envoyés en form-data
• Tous les paramètres sont des champs de texte, sauf pour upload, qui est un champ "fichiers"
• metadata doit contenir ces paramètres :
  • document_number : chaîne de caractères correspondant au numéro de facture.

  • issue_date : date d'émission. Chaîne de caractères au format date ISO UTC : YYYY-MM-ddTHH:MM:SSZ

  • due_date : date d'échéance. Chaîne de caractères au format date ISO UTC : YYYY-MM-ddTHH:MM:SSZ

  • total_amount_excluding_taxes : montant total HT. Nombre entier à virgule flottante à deux décimales. Ex : 31.99

  • total_tax_amount : montant de la taxe. Nombre entier à virgule flottante à deux décimales. Ex : 3.19

• upload : la facture client doit être envoyée au format xml ou pdf. Taille maximale du fichier : 20 Mo
  
  

Pour plus d'informations, consultez notre documentation API

Téléchargement sur la plateforme Lengow

Pour transmettre une facture via la plateforme Lengow :

• Dans la section Commandes de Lengow, allez sur la page de détails de la commande ;
• Cliquez sur l'icône de téléchargement en bas à droite de la page, puis sur "Télécharger une facture" ;
• Une fenêtre s'ouvre pour vous permettre de renseigner les informations demandées et de sélectionner la facture à envoyer (voir capture d'écran) ;
• Lorsque vous êtes prêt, cliquez sur "Envoyer" pour transmettre la facture de la commande à la marketplace.

Si vous ne voyez pas cette icône, cela signifie que la marketplace n'a pas activé l'option d'envoi de facture.

Téléchargement dans votre back-office Mirakl

Pour télécharger votre facture client pour une commande dans votre back-office Mirakl, allez à la page de détails de la commande.

En haut à droite de l'écran, cliquez sur "Plus d'actions" puis sur "Documents". Dans la section "Documents comptables", vous pouvez télécharger la facture client pour cette commande.

Par exemple pour Decathlon, vous pouvez consulter le processus détaillé ici dans leur documentation.