> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/ordini/configura-il-pedido/carica-y-gestisci-le-fatture-con-lapi-di-channable.md).

# Carica y gestisci le 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 (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](/list-advertise/list-and-advertise-it/ordini/connessioni-di-pedido/piattaforme-ecommerce-supportate-per-le-connessioni-di-pedido/come-para-configurare-lapi-di-channable-arriba-per-una-connessione-di-pedido.md)
* 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.

<details>

<summary>Tutti i marketplace basati su Mirakl</summary>

* 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

</details>

{% stepper %}
{% step %}

### Genera un token di accesso per l'API di Channable

{% hint style="success" %}
Suggerimento: puoi saltare questo passaggio se hai già generato un token di accesso.
{% endhint %}

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.

{% hint style="warning" %}
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.
{% endhint %}
{% endstep %}

{% step %}

### Trova e annota gli ID dei tuoi prodotti e ordini

{% stepper %}
{% step %}

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

{% hint style="info" %}
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à.
{% endhint %}

1. Usa [Tutti gli ordini V2](https://api.channable.com/v1/docs#tag/orders/operation/all_orders_v2_v2_companies__company_id__projects__project_id__orders_get) 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.
   {% endstep %}

{% step %}

#### 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.
   {% endstep %}
   {% endstepper %}
   {% endstep %}

{% step %}

### 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](https://api.channable.com/v1/docs#tag/order_attachments/operation/order_attachment_upload_companies__company_id__projects__project_id__orders__order_id__attachments_post).

{% hint style="info" %}
**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.
{% endhint %}
{% endstep %}

{% step %}

### 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**.

<figure><img src="/files/1d3c0e98b862d6bef6c5476cbe0c6bedf3e76aa6" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-it/ordini/configura-il-pedido/carica-y-gestisci-le-fatture-con-lapi-di-channable.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.