Caricare e gestire le fatture con l'API Channable

Scopri come caricare e gestire le fatture degli ordini con l'API Channable per i marketplace supportati.

Se hai un collegamento ordini, puoi caricare e gestire le tue fatture in formato PDF per i marketplace supportati tramite l'API di Channable. Questa funzione è disponibile per Amazon, Kaufland, bol e tutti i marketplace basati su Mirakl (ad es. MediaMarkt, Decathlon, Leroy Merlin, ecc.)

Prima di iniziare

Per sfruttare al meglio questa funzione, assicurati di aver preso in considerazione quanto segue:

Ti serviranno

• Un collegamento ordini attivo con ordini esistenti

• Un token di accesso per l'API di Channable

• Una comprensione del funzionamento dell'API di Channable

• Ordini esistenti da un marketplace supportato

Da sapere

• Al momento, puoi caricare e gestire solo i tuoi webshop con l'API di Channable (non le piattaforme basate su webshop)

• L'API ci consente di ricevere le informazioni sulla fattura. Al momento, non possiamo recuperare automaticamente le fatture dalle piattaforme di collegamento ordini.

• Questa configurazione prevede il collegamento del tuo sistema a Channable tramite la nostra API. Si tratta di un processo tecnico che in genere richiede uno sviluppatore o una persona con conoscenze di programmazione.

Tutti i marketplace basati su Mirakl

• MediaMarkt

• Leroy Merlin

• Bricoman

• Decathlon

• Debenhams

• Vtwonen

• ANWB

• INNO

• Ma

• Conrad

• La Redoute

• Praxis

• Le BHV Marais

• Home24

• Galeries LaFayette

• fonQ

• BlokkerConnect!

• Carrefour France

• Carrefour Spain

• Maisons du Monde

• Kruidvat

• Obelink

• Worten

• Douglas

• FNAC Darty Offers

• Manor

• Leen Bakker

• Conforama

• PcComponentes

• ePrice

1

Genera un token di accesso per l'API di Channable

Suggerimento: puoi saltare questo passaggio se hai già generato un token di accesso.

1. In Channable, vai alle tue Impostazioni azienda.

2. Nella sezione Strumenti, seleziona Channable API.

3. Prendi nota del tuo ID azienda, perché ti servirà più avanti.

4. Fai clic Genera token per generare un token azienda.

Importante: una volta generato il token, salvalo in un posto sicuro. Per motivi di sicurezza, non mostriamo di nuovo il token dopo la generazione. Se lo perdi, dovrai generarne uno nuovo.

2

Trova e annota gli ID dei tuoi prodotti e ordini

1

OPZIONE 1: recupera gli ID ordine usando l'API di Channable (consigliato per gli sviluppatori)

Nota: se salvi l'ID ordine di Channable quando recuperi ed elabori inizialmente gli ordini aperti, non dovrai recuperare di nuovo gli ordini quando invii le fatture. Puoi usare l'ID dai dati che hai già.

1. Usa Tutti gli ordini V2 per recuperare gli ordini da Channable.

2. Ogni ordine contiene un attributo id: è questo l'id che devi fornire quando carichi le fatture per un ordine specifico.

2

OPZIONE 2: trova manualmente gli ID ordine in Channable (consigliato per chi non è sviluppatore)

1. In Channable, apri il progetto con il tuo collegamento ordini.

2. Nella barra laterale, vai a Impostazioni. Questo ti porterà alle tue Impostazioni progetto.

3. Prendi nota del tuo ID progetto, perché ti servirà nella richiesta API.

4. Vai a Ordini. Vedrai un elenco dei tuoi ordini importati.

5. Prendi nota degli ID ordine specifici per cui vuoi caricare le fatture.

3

Integra per le fatture (sviluppatore)

In questo passaggio, tu/il tuo sviluppatore scriverete il codice che comunica direttamente con Channable per inviare i dati della fattura all'ordine corretto.

1. Converti il file della fattura da PDF a una stringa codificata in Base64.

2. Prepara la tua richiesta:

   1. Crea una richiesta POST all'endpoint order_attachment_upload.

   2. Inserisci il tuo token di accesso API nell'header Authorization: Bearer your_api_token.

   3. Compila il corpo della richiesta. Deve contenere:

      • attachment_type: impostalo su “INVOICE”

      • file: la stringa codificata in Base64 del file della fattura

      • order_item_ids (facoltativo, solo bol): un array di ID articolo ordine. Se non li aggiungi, la fattura verrà collegata a tutti gli articoli dell'ordine.

Per istruzioni dettagliate, fai riferimento alla nostra documentazione API degli allegati ordine.

Nota: Puoi inviare più fatture per ordine. Tuttavia, alcuni canali (come Amazon) conservano solo la registrazione dell'ultima fattura, rimuovendo le precedenti. Per informazioni specifiche sul comportamento del canale, è meglio contattare il team di supporto del marketplace.

4

Controlla le fatture caricate

Dopo che tu/il tuo sviluppatore inviate una fattura tramite la nostra API di Channable, verifica che sia stata allegata correttamente in Channable.

• In Channable, apri il progetto con il tuo collegamento ordini.

• Vai a Ordini.

• Fai clic sull'ordine per cui hai caricato la fattura.

• Vai al passaggio Allegati ordine .

• Fai clic Scarica fattura.