bol.com Integration Setup

📋Before You Start

• Active bol.com retailer account (retailer.bol.com)
• bol.com API credentials: Client ID and Client Secret (generated in bol.com retailer settings)

🔧Setup Steps

1. 1
   Generate bol.com API credentials

   Log into retailer.bol.com. Navigate to Account Settings → API → Create API Access. Enter a name ("Pythias Integration") and select Read/Write permissions for Orders and Shipments. Click Save. Copy the Client ID and Client Secret.
2. 2
   Enter credentials in Pythias

   In Pythias, go to Admin → Integrations → Add New Integration → bol.com. Enter your Client ID and Client Secret. Click Test Connection. If the test passes, click Save.
3. 3
   Configure carrier settings

   bol.com supports PostNL, DPD, DHL, and several other Dutch/Belgian carriers. In the integration settings, select your preferred carrier for bol.com orders. If you use PostNL via bol.com's shipping service, Pythias can request labels directly through the bol.com Shipping API.

🔄What Gets Synced

• ✓Open orders (polled every 10 minutes)
• ✓Order items, EAN codes, quantities, and buyer shipping address
• ✓Shipment confirmation with transporter code (carrier) and tracking number
• ✓Order fulfillment status update

💡Tips & Troubleshooting

• ⚡bol.com's SLA requires shipment confirmation within the handling time you specified for each listing. Set urgency flags in Pythias for orders approaching the deadline.
• ⚡bol.com uses EAN codes to identify products. Map EANs to your Pythias product SKUs in Admin → Edit Data.
• ⚡bol.com API credentials do not expire but can be revoked. If orders stop pulling, verify credentials in retailer.bol.com settings.