Billbee Order Management

Billbee is the leading German/DACH multichannel order-management tool (20,000+ retailers) connecting marketplaces and shops (Amazon, eBay, Otto, Kaufland, Shopify, WooCommerce, etc.). This connector wraps the REST API at https://api.billbee.io/api/v1.

Authentication (THREE credentials, all required)

Billbee requires both an application API key AND HTTP Basic Auth at the same time:

1. BILLBEE_API_KEY — sent in the X-Billbee-Api-Key header. Request it from Billbee (via their API request form / [email protected], describing what you build).
2. BILLBEE_LOGIN_EMAIL — your Billbee account login email (Basic Auth username).
3. BILLBEE_API_PASSWORD — a dedicated API password (NOT your normal login password). Enable the API and set this password in the Billbee web app under Settings → Billbee API → General Settings. All three are mandatory; the API key alone or Basic Auth alone will be rejected.

Pagination

List endpoints use page (1-based) and pageSize (max 250). Responses wrap rows in a paged envelope: a Data array plus a Paging object with Page, TotalPages, TotalRows. Iterate page until Page == TotalPages.

Orders

billbee_list_orders filters by minOrderDate/maxOrderDate and modifiedAtMin/modifiedAtMax (incremental sync). Order states are numeric; use billbee_get_order for full detail, or billbee_get_order_by_extref to look up by the marketplace's external order number.

Rate limit

Hard limit of 2 requests per second per (API key + user); exceeding it returns HTTP 429 — back off and retry. The API has usage-based pricing above a free allotment, so avoid tight polling loops; prefer modifiedAtMin/updatedOrNewSince-style incremental queries.