API v3 – Invoices

Bol.com uses a monthly ‘All in one’ invoicing system. The first day of the month we create the ‘All-in-one’ invoice for partners to retrieve.

We use three different invoice endpoints, each returning a different level of specification:


1. Get all invoices
Returns the available invoice including invoice id and minimal summary of monetary totals.

2. Get an invoice by invoice id
Returns an invoice with summaries of the available line types.

3. Get an invoice specification by invoice id
Returns all transactions for a specific invoice.

An invoice can consist of different line types. The following invoice lines exist

Invoice line type Explanation
BRMG Costs for bol.com Retail Media Group services.
BRMG_REFUND Correction of initially charged bol.com Retail Media Group services.
COMMISSION Commission for an article sold and shipped.
CORRECTION_COMMISSION Correction of initially charged commission.
COMPENSATION Compensation.
COMPENSATION_LOST_GOODS Compensation for lost items.
FIRST_MILE Costs for pick-up of inventory into the bol.com warehouse (FBB).
CORRECTION_FIRST_MILE Correction of initially charged first mile costs (FBB).
LOGISTICAL_CHARGE Costs for either: labeling incoming inventory, order to destroy inventory or sending back unsellable inventory (FBB).
NCK_STOCK Costs for not saleable inventory (FBB).
OUTBOUND Costs for a FBB shipment.
CORRECTION_OUTBOUND Correction of initially charged outbound.
PICK_PACK Picking & packing costs (FBB).
CORRECTION_PICK_PACK Correction on initially charged pick & packing costs (FBB).
PLAZA_RETURN_SHIPPING_LABEL Costs for a return label.
CORRECTION_PLAZA_RETURN_SHIPPING_LABEL Correction of initially charged return labels.
RETAILER_AUTHORIZATION Costs for authorization of brands.
CORRECTION_RETAILER_AUTHORIZATION Correction of initially charged retailer authorization
SHIPMENT_LABEL Costs for a shipping label.
CORRECTION_SHIPMENT_LABEL Correction of initially charged shipment labels
SHIPMENT_LABEL_POST Costs for a shipping label from PostNL. PostNL is VAT exempt and all other transports have the standard high TAX rate.
CORRECTION_SHIPMENT_LABEL_POST Correction of initially charged PostNL labels
STOCK Costs that are made for your inventory (FBB).
TURNOVER Price of the item you sold and shipped
CORRECTION_TURNOVER Correction on turnover in case of a return.
CORRECTION_CORRECTION* This can be almost everything. Some examples that might occur: NCO (Non Commercial Order), URO (Unsellable Return Order), bSKU labelling or stock corrections.

* This invoice line is not used anymore today but may still appear in older invoices.