ChannelEngine: upload merchant invoices

About this article

This article describes how to upload merchant invoices to ChannelEngine.

Table of contents

Introduction

Setup

• Via the Merchant API
• Via the web interface

Channel-fulfilled orders

Check the invoice status

Introduction

You can submit invoices on orders that come in from select marketplaces, including Amazon, bol, Kaufland, and Mirakl-based marketplaces, via the Merchant API and ChannelEngine web interface.

Setup

Via the Merchant API

• Upload invoices for orders: POST /v2/orders/{merchantOrderNo}/invoice

Use this endpoint to upload merchant invoices for orders. Provide a unique Merchant order number for the order and include the invoice in PDF format in the request body.

If your system does not support PDF invoices and can only process text, you can use Base64 encoding for your order invoices. To provide the invoice in the Base64 format to ChannelEngine, send a request to the POST /v2/orders/{merchantOrderNo}/invoice-base64 endpoint – including the invoice content and invoice number in the body of the request.

Via the web interface

Upload the invoice to ChannelEngine directly via the web interface:

1. From the left-hand side menu, go to Orders, Orders.
2. Click the eye icon next to the order for which you want to upload an invoice.
3. On the Order details page, scroll down to the Documents section, and click Upload merchant invoice.
4. In your file explorer, select a PDF file to upload. Once selected, the status of the invoice changes to the Ready to export to marketplace.

Channel-fulfilled orders

You have the option to upload invoices for channel-fulfilled orders, e.g.: Fulfilled by .... Before uploading merchant invoices for channel-fulfilled orders, always consult with the channel beforehand. Channels more often manage invoices for channel-fulfilled orders than merchants do. 

Check the invoice status

From the left-side menu, go to Orders, Documents. 

At the top of the Documents overview, there is a search bar and several different filters. Use the search bar to filter on one or more specific invoices by entering an identifier, such as the Order ID or the Channel order number.

Additionally, use one of the following filters: 

• Select channels - filter on the marketplace.
• Status - filter on the status of the invoice. The options are ‘Ready to export to marketplace’ and ‘Exported to marketplace’.
• Type - filter on the type of document. Select ‘Invoice’ from the dropdown.
• Date - filter on the date and time of the last action – when the invoice was uploaded to ChannelEngine or exported to the marketplace.

For more details on using the order documents overview, check out ChannelEngine: order documents.