Upload en beheer facturen met Channable Api

Leer hoe je orderfacturen uploadt en beheert met de Channable Api voor ondersteunde marktplaatsen.

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

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

Alle op Mirakl gebaseerde marketplaces

• 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

1

Channable API-toegangstoken genereren

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

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.

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.

2

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

1

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

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.

1. Gebruik Alle Orders V2 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.

2

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.

3

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.

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.

4

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.