Facturen uploaden en beheren met de Channable API

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

Voordat je begint

Om het meeste uit deze functie te halen, zorg dat je het volgende hebt overwogen:

Je hebt nodig

• Een actieve orderkoppeling met bestaande orders

• Een Channable API-toegangstoken

• Een basisbegrip van hoe de Channable API werkt

• Bestaande orders van een ondersteunde marktplaats

Goed om te weten

• Momenteel kun je via de Channable API alleen je webshops uploaden en beheren (niet platformen die zelf als webshop fungeren).

• De API stelt ons in staat om te ontvangen factuurinformatie. Op dit moment kunnen we facturen niet automatisch ophalen van orderkoppelingplatforms.

• Deze opzet omvat het verbinden van je systeem met Channable via onze API. Dit is een technische procedure die doorgaans een ontwikkelaar of iemand met programmeerkennis vereist.

Alle Mirakl-gebaseerde marktplaatsen

• MediaMarkt

• Leroy Merlin

• Bricoman

• Decathlon

• Debenhams

• Vtwonen

• ANWB

• INNO

• But

• Conrad

• La Redoute

• Praxis

• Le BHV Marais

• Home24

• Galeries LaFayette

• fonQ

• BlokkerConnect!

• Carrefour Frankrijk

• Carrefour Spanje

• Maisons du Monde

• Kruidvat

• Obelink

• Worten

• Douglas

• FNAC Darty-aanbiedingen

• Manor

• Leen Bakker

• Conforama

• PcComponentes

• ePrice

1

Genereer Channable API-toegangstoken

Tip: Je kunt deze stap overslaan als je al een toegangstoken hebt gegenereerd.

1. Ga in Channable naar je Bedrijfsgegevens.

2. Kies in de sectie Tools voor Channable API.

3. Noteer je Bedrijfs-ID, je hebt deze later nodig.

4. Klik Genereer token om een bedrijfstoken te genereren.

Belangrijk: Zodra je token is gegenereerd, sla het op een veilige plek op. Om veiligheidsredenen tonen we het token niet opnieuw nadat je het hebt gegenereerd. Als je het verliest, moet je een nieuw token genereren.

2

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

1

OPTIE 1: Haal order-ID's op via de Channable API (aanbevolen voor ontwikkelaars)

Opmerking: Als je de Channable order-ID opslaat bij het aanvankelijk ophalen en verwerken van openstaande orders, hoef je de orders niet opnieuw op te halen wanneer je facturen verzendt. Je kunt de ID uit de gegevens gebruiken die je al hebt.

1. Gebruik All Orders V2 om orders van Channable op te halen.

2. Elke order bevat een id-attribuut — dit is de id die je moet opgeven wanneer je facturen voor een specifieke order uploadt.

2

OPTIE 2: Vind order-ID's handmatig in Channable (aanbevolen voor niet-ontwikkelaars)

1. Open in Channable het project met je orderkoppeling.

2. Ga in de zijbalk naar Instellingen. Dit brengt je naar je Projectinstellingen.

3. Noteer je Project-ID, die je nodig hebt in je API-aanvraag.

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.

3

Integreren voor facturen (ontwikkelaar)

In deze stap schrijf jij of je ontwikkelaar code die rechtstreeks met Channable communiceert om de factuurgegevens naar de juiste order te sturen.

1. Converteer je factuurbestand van PDF naar een Base64-gecodeerde string.

2. Bouw je request op:

   1. Maak een POST-request naar de order_attachment_upload endpoint.

   2. Plaats je API-toegangstoken in de Authorization: Bearer your_api_token header.

   3. Vul de request-body in. Deze moet het volgende bevatten:

      • attachment_type: Stel in op “INVOICE”

      • file: de Base64-gecodeerde string van je factuurbestand

      • order_item_ids (optioneel, alleen bol): een array met order item IDs. Als je deze niet toevoegt, wordt de factuur gekoppeld aan alle items in de order.

Voor gedetailleerde instructies, raadpleeg onze Order Attachments API-documentatie.

Opmerking: Je kunt meerdere facturen per order indienen. Sommige kanalen (zoals Amazon) bewaren echter alleen een record van de laatste factuur en verwijderen eerdere. Voor specifieke informatie over het gedrag van een kanaal kun je het beste contact opnemen met de support van de betreffende marktplaats.

4

Bekijk je geüploade facturen

Nadat jij of je ontwikkelaar een factuur via onze Channable API heeft verzonden, controleer je of deze correct is gekoppeld binnen Channable.

• 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 Factuur downloaden.