Upload and manage invoices with Channable API

If you have an order connection, you can upload and manage your invoices in PDF format for supported marketplaces via the Channable API. This feature is available for Amazon, Kaufland, bol, and all Mirakl-based marketplaces (e.g. MediaMarkt, Decathlon, Leroy Merlin etc.)

Before you start

To make the most of this feature, make sure you’ve considered the following:

You’ll need

• An active order connection with existing orders

• A Channable API access token

• An understanding of how Channable's API works

• Existing orders from a supported marketplace

Good to know

• Currently, you can only upload and manage your webshops with the Channable API (not webshop-based platforms)

• The API allows us to receive invoice information. Currently, we can’t automatically retrieve invoices from order connection platforms.

• This setup involves connecting your system to Channable using our API. This is a technical process that typically requires a developer or someone with programming knowledge.

All Mirakl-based marketplaces

• MediaMarkt

• Leroy Merlin

• Bricoman

• Decathlon

• Debenhams

• Vtwonen

• ANWB

• INNO

• But

• 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

Generate Channable API access token

Tip: You can skip this step if you’ve already generated an access token.

1. In Channable, go to your Company Settings.

2. In the Tools section, select Channable API.

3. Make note of your Company ID, as you will need it later.

4. Click Generate token to generate a Company token.

Important: Once your token is generated, save it in a safe place. For security reasons, we don’t display the token again after you generate it. If you lose it, you’ll need to generate a new one.

2

Find and note your product and order ids

1

OPTION 1: Retrieve order IDs using the Channable API (recommended for developers)

Note: If you save the Channable order ID when initially fetching and processing open orders, you won't need to re-fetch orders when sending invoices. You can use the ID from the data you already have.

1. Use All Orders V2 to fetch orders from Channable.

2. Each order contains an id attribute — this is the id you need to provide when uploading invoices for a specific order.

2

OPTION 2: Find Order IDs manually in Channable (recommended for non-developers)

1. In Channable, open the project with your order connection.

2. In the sidebar, go to Settings. This will take you to your Project settings.

3. Make note of your Project ID, as you will need it in your API request.

4. Go to Orders. You’ll see a list of your imported orders.

5. Make note of the specific order IDs you want to upload invoices for.

3

Integrate for Invoices (developer)

In this step, you/your developer will write code that communicates directly with Channable to send the invoice data to the correct order.

1. Convert your invoice file from a PDF into a Base64 encoded string.

2. Build your request:

   1. Create a POST request to the order_attachment_upload endpoint.

   2. Embed your API access token in the Authorization: Bearer your_api_token header.

   3. Fill in the request body. It should contain:

      • attachment_type: Set to “INVOICE”

      • file: the Base64 encoded string of your invoice file

      • order_item_ids (optional, bol only): an array of order item IDs. If you don’t add them, the invoice will be linked to all items in the order.

For detailed instructions, refer to our Order Attachments API documentation.

Note: You can submit multiple invoices per order. However, some channels (like Amazon) only keep a record of the latest invoice, removing previous ones. For specific information about channel behavior, it’s best to contact your marketplace’s support team.

4

Check your uploaded invoices

After you/your developer sends an invoice via our Channable API, check it was attached correctly within Channable.

• In Channable, open the project with your order connection.

• Go to Orders.

• Click on the order you uploaded the invoice for.

• Go to the Order attachments tab.

• Click Download Invoice.