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

Lengow ti permette 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
  
  

Caricamento tramite API

- API Marketplaces: parametro "invoice_upload"

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

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 Ordini: chiamata API

Endpoint: 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 delle fatture. 

Caricamento nel tuo back-office Mirakl

Per caricare la tua fattura cliente per un ordine nel tuo back-office Mirakl, vai alla pagina di dettaglio dell'ordine.

Sul lato destro superiore dello schermo, clicca su "Altre azioni" e poi su "Documenti". Nella sezione "Documenti contabili", puoi caricare la fattura cliente per questo ordine.

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