💡 Mirakl - Come inviare le fatture dei clienti a un marketplace Mirakl?

Lengow ti consente di caricare le tue fatture clienti per inviarle a qualsiasi marketplace Mirakl.

Hai 3 opzioni per inviare le fatture clienti a un marketplace Mirakl:

• Attraverso la API di Lengow
• Nella piattaforma Lengow 
• Nel tuo back-office Mirakl

Nota: Le fatture non possono essere caricate tramite il plugin Lengow dal tuo CMS.

Caricamento tramite API

- API dei marketplace: parametro "invoice_upload"

Se il marketplace consente il caricamento delle fatture, troverai il parametro invoice_upload nell'API dei marketplace.

Esempio per 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 degli ordini: chiamata API

Punto di accesso: https://api.lengow.io/v3.0/document/

Esegui la seguente chiamata API per caricare una fattura 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"'

Informazioni sui parametri di questa chiamata:

• Tutti i parametri vengono inviati in form-data
• Tutti i parametri sono campi di testo, tranne upload, che è un campo "files"
• metadata deve contenere questi parametri:
  • document_number : numero di fattura come stringa di caratteri.
  • issue_date : stringa di caratteri nel formato data UTC ISO: YYYY-MM-ddTHH:MM:SSZ
  • due_date : stringa di caratteri nel formato data UTC ISO: YYYY-MM-ddTHH:MM:SSZ
  • total_amount_excluding_taxes : intero a virgola mobile con due decimali. Es: 31.99
  • total_tax_amount : intero a virgola mobile con due decimali. Es: 3.19
• upload : la fattura del cliente deve essere inviata in formato xml o pdf. Dimensione massima del file: 20 Mo
  
   

Per ulteriori informazioni, consulta la nostra documentazione API

 

Caricamento nella piattaforma Lengow

Per caricare una fattura nella piattaforma Lengow:

• Nella sezione Ordini in Lengow, vai alla pagina di dettaglio del tuo ordine ;
• Clicca sull'icona di caricamento in basso a destra della pagina, e su "Carica una fattura";
• Si apre una finestra che ti permette di inserire le informazioni richieste e selezionare la fattura da caricare (vedi screenshot);
• Quando sei pronto, clicca su "Invia" per trasmettere la fattura dell'ordine al marketplace.

Se non vedi questa icona, significa che il marketplace non ha attivato l'opzione di caricamento della fattura. 

Carica nel tuo back-office Mirakl

Per caricare la fattura del tuo cliente per un ordine nel tuo back-office Mirakl, vai alla pagina dei dettagli dell'ordine.

Nella parte superiore destra dello schermo, clicca su "More actions" e poi su "Documents". Nella sezione "Documenti contabili", puoi caricare la fattura del cliente per questo ordine.

Ad esempio per Decathlon, il processo dettagliato è fornito qui nella loro documentazione.