Caricare e gestire fatture con l'API di Channable

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 (es. MediaMarkt, Decathlon, Leroy Merlin ecc.).

Prima di iniziare

Per sfruttare al meglio questa funzione, assicurati di aver considerato quanto segue:

Ti serviranno

• Un collegamento ordini attivo con ordini esistenti

• Un token di accesso all’API di Channable

• Una conoscenza di base di come funziona l’API di Channable

• Ordini esistenti provenienti da un marketplace supportato

Buono a sapersi

• Attualmente puoi caricare e gestire solo i tuoi webshop tramite l’API di Channable (non le piattaforme basate su webshop)

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

• Questa configurazione prevede la connessione del tuo sistema a Channable tramite la nostra API. Si tratta di un processo tecnico che normalmente richiede un sviluppatore o qualcuno con conoscenze di programmazione.

Tutti i marketplace basati su Mirakl

• MediaMarkt

• Leroy Merlin

• Bricoman

• Decathlon

• Debenhams

• Vtwonen

• ANWB

• INNO

• But

• 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 token di accesso all’API di Channable

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

1. In Channable, vai al tuo Impostazioni azienda.

2. Nella sezione Strumenti, seleziona Channable API.

3. Annota il tuo ID azienda, poiché ti servirà più avanti.

4. Clicca Genera token per generare un token aziendale.

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

2

Trova e annota gli ID dei prodotti e degli ordini

1

OPZIONE 1: Recupera gli ID degli ordini usando l’API di Channable (consigliato per sviluppatori)

Nota: se salvi l’ID ordine di Channable quando recuperi e processi inizialmente gli ordini aperti, non sarà necessario 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 non sviluppatori)

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

2. Nella barra laterale, vai a Impostazioni. Questo ti porterà al tuo Impostazioni del progetto.

3. Annota il tuo ID progetto, poiché ti servirà nella richiesta API.

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

5. Annota gli ID degli ordini specifici per i quali vuoi caricare le fatture.

3

Integrare per le fatture (sviluppatore)

In questo passaggio, tu/il tuo sviluppatore scriverete 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. Costruisci la tua richiesta:

   1. Crea una richiesta POST all’endpoint order_attachment_upload.

   2. Inserisci il token di accesso all’API nell’intestazione 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 tua fattura

      • order_item_ids (opzionale, solo bol): un array di ID degli articoli dell’ordine. Se non li aggiungi, la fattura sarà collegata a tutti gli articoli dell’ordine.

Per istruzioni dettagliate, consulta la nostra documentazione API Order Attachments.

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

4

Controlla le fatture caricate

Dopo che tu/il tuo sviluppatore avete inviato una fattura tramite la nostra API di Channable, verifica che sia stata allegata correttamente all’interno di Channable.

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

• Vai a Ordini.

• Clicca sull’ordine per cui hai caricato la fattura.

• Vai al Allegati ordine mirakl_unknown_error_code - "Il prodotto non esiste"

• Clicca Scarica fattura.