# Facturen uploaden en beheren met Channable Api

Als je een orderkoppeling hebt, kun je je facturen in PDF-formaat uploaden en beheren voor ondersteunde marketplaces via de Channable API. Deze functie is beschikbaar voor Amazon, Kaufland, bol en alle op Mirakl gebaseerde marketplaces (bijv. MediaMarkt, Decathlon, Leroy Merlin enz.).

### Voordat je begint

Om het meeste uit deze functie te halen, zorg je ervoor dat je rekening hebt gehouden met het volgende:

**Je hebt nodig**

* Een actieve orderkoppeling met bestaande orders
* Een Channable API-toegangstoken
* [Inzicht in hoe de Channable API werkt](/list-advertise/list-and-advertise-nl/orders/orderkoppelingen/ondersteunde-e-commerceplatformen-voor-order-koppelingen/hoe-je-de-channable-api-instelt-voor-een-order-koppeling.md)
* Bestaande orders van een ondersteunde marketplace

**Goed om te weten**

* Op dit moment kun je alleen je webshops uploaden en beheren met de Channable API (niet met webshopgebaseerde platformen)
* Met de API kunnen we **ontvangen** factuurinformatie. Op dit moment kunnen we facturen niet automatisch ophalen van orderkoppelingsplatformen.
* Voor deze setup koppel je je systeem aan Channable via onze API. Dit is een technisch proces waarvoor meestal een developer of iemand met programmeerkennis nodig is.

<details>

<summary>Alle op Mirakl gebaseerde marketplaces</summary>

* MediaMarkt
* Leroy Merlin
* Bricoman
* Decathlon
* Debenhams
* Vtwonen
* ANWB
* INNO
* Maar
* 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 %}

### Channable API-toegangstoken genereren

{% hint style="success" %}
Tip: Je kunt deze stap overslaan als je al een toegangstoken hebt gegenereerd.
{% endhint %}

1. Ga in Channable naar je **Bedrijfsgegevens**.
2. Selecteer in de sectie Tools **Channable API**.
3. Noteer je **Bedrijfs-ID**, want die heb je later nodig.
4. Klik op **Token genereren** om een bedrijfstoken te genereren.

{% hint style="warning" %}
Belangrijk: zodra je token is gegenereerd, sla je het op een veilige plek op. Om veiligheidsredenen tonen we het token niet opnieuw nadat je het hebt gegenereerd. Als je het kwijtraakt, moet je een nieuw token genereren.
{% endhint %}
{% endstep %}

{% step %}

### Zoek en noteer je product- en order-id's

{% stepper %}
{% step %}

#### OPTIE 1: Order-id's ophalen via de Channable API (aanbevolen voor developers)

{% hint style="info" %}
Let op: als je de Channable order-id opslaat wanneer je open orders voor het eerst ophaalt en verwerkt, hoef je orders niet opnieuw op te halen wanneer je facturen verstuurt. Je kunt dan de id gebruiken uit de data die je al hebt.
{% endhint %}

1. Gebruik [Alle Orders V2](https://api.channable.com/v1/docs#tag/orders/operation/all_orders_v2_v2_companies__company_id__projects__project_id__orders_get) om orders op te halen uit Channable.
2. Elke order bevat een id-attribuut — dit is de id die je moet doorgeven wanneer je facturen uploadt voor een specifieke order.
   {% endstep %}

{% step %}

#### OPTIE 2: Order-id's handmatig vinden in Channable (aanbevolen voor niet-developers)

1. Open in Channable het project met je orderkoppeling.
2. Ga in de zijbalk naar **Instellingen**. Daarmee kom je bij je **Projectinstellingen**.
3. Noteer je **Project-ID**, want die heb je nodig in je API-verzoek.
4. Ga naar **Orders**. Je ziet een lijst met je geïmporteerde orders.
5. Noteer de specifieke order-id's waarvoor je facturen wilt uploaden.
   {% endstep %}
   {% endstepper %}
   {% endstep %}

{% step %}

### Koppelen voor facturen (developer)

In deze stap schrijf jij/jouw developer code die rechtstreeks met Channable communiceert om de factuurdata naar de juiste order te sturen.

1. Zet je factuurbestand om van PDF naar een Base64-gecodeerde string.
2. Bouw je verzoek op:
   1. Maak een POST-verzoek naar het endpoint order\_attachment\_upload.
   2. Neem je API-toegangstoken op in de header Authorization: Bearer your\_api\_token.
   3. Vul de request body in. Die moet het volgende bevatten:
      * attachment\_type: instellen op **“INVOICE”**
      * file: de Base64-gecodeerde string van je factuurbestand
      * order\_item\_ids (optioneel, **alleen bol**): een array met order item-id's. Als je die niet toevoegt, wordt de factuur gekoppeld aan alle items in de order.

Raadpleeg voor gedetailleerde instructies onze [API-documentatie voor orderbijlagen](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" %}
**Opmerking:** Je kunt meerdere facturen per order indienen. Sommige kanalen (zoals Amazon) bewaren echter alleen een record van de meest recente factuur en verwijderen de vorige. Voor specifieke informatie over het gedrag per kanaal neem je het beste contact op met het supportteam van je marketplace.
{% endhint %}
{% endstep %}

{% step %}

### Controleer je geüploade facturen

Nadat jij/jouw developer een factuur via onze Channable API hebt verstuurd, controleer je in Channable of deze correct is gekoppeld.

* Open in Channable het project met je orderkoppeling.
* Ga naar **Orders**.
* Klik op de order waarvoor je de factuur hebt geüpload.
* Ga naar de **Orderbijlagen** tabblad.
* Klik op **Factuur downloaden**.

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


---

# Agent Instructions: 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:

```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-nl/orders/configureer-order-setup/facturen-uploaden-en-beheren-met-channable-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.