Carica y gestisci le fatture con l'Api di Channable
Scopri come Para caricare y gestire le fatture del Pedido con l'Api di 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
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.
Trova e annota gli ID dei tuoi prodotti e ordini
OPZIONE 1: recupera gli ID ordine usando l'API di Channable (consigliato per gli sviluppatori)
Usa Tutti gli ordini V2 per recuperare gli ordini da Channable.
Ogni ordine contiene un attributo id: è questo l'id che devi fornire quando carichi le fatture per un ordine specifico.
OPZIONE 2: trova manualmente gli ID ordine in Channable (consigliato per chi non è sviluppatore)
In Channable, apri il progetto con il tuo collegamento ordini.
Nella barra laterale, vai a Impostazioni. Questo ti porterà alle tue Impostazioni progetto.
Prendi nota del tuo ID progetto, perché ti servirà nella richiesta API.
Vai a Ordini. Vedrai un elenco dei tuoi ordini importati.
Prendi nota degli ID ordine specifici per cui vuoi caricare le fatture.
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.
Converti il file della fattura da PDF a una stringa codificata in Base64.
Prepara la tua richiesta:
Crea una richiesta POST all'endpoint order_attachment_upload.
Inserisci il tuo token di accesso API nell'header Authorization: Bearer your_api_token.
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.
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.
Ultimo aggiornamento
È stato utile?