Connect bol
Add a bol seller account with dedicated Retailer API credentials.
On this page
A bol connection brings marketplace orders into Balta Labs. It also imports shipments, returns, and settlement lines as supporting records. The connection reads data; it does not change listings, ship orders, or handle returns on bol.
Before you begin
You need an active bol seller account. In bol’s Seller Dashboard, open Settings → Services → API Settings, add a technical contact, and create a dedicated pair under API Credentials for the Retailer API. Copy the Client ID and Client secret. Advertising API credentials will not work here. Bol’s authentication guide has the current seller-side steps.
Add the seller account
- In Balta Labs, open Settings → Connections → Add account → bol.
- Enter a Connection name (optional) to distinguish this seller account.
- Paste the Client ID and Client secret, then select Save credentials.
- On the connection card, select Test and Explore to check access.
- Open Orders → Configuration → Sources and start the first import. Watch the status of the orders, shipments, returns, and invoice lines.
Use one connection per bol seller account. To rotate a credential, create a new pair in bol and use Manage to replace it here. Leaving a secret field blank during an ordinary edit keeps its current value.
What you can review
Bol orders appear in the Orders workspace with their VAT-inclusive totals. Shipments, returns, and settlement lines are stored as linked evidence; the customer-facing view currently shows their import status and counts rather than a separate record browser. The first import can take time, and bol limits the historical records available through its API. Compare connection coverage if you use several sources.
Bol alone does not supply the seller VAT and net amounts needed for OSS reporting. Bol’s settlement invoice tax concerns bol’s charges, not the VAT on your sale to the customer. Connect the ERP or invoicing system that records your sales tax, match the orders, and review the results before an OSS export. Bol explains this distinction in its Sales Invoice guide.