Billbee API

Name: Billbee API API
Brand: Billbee API
Availability: InStock

✓ Official Vendor SpecE CommerceOrder ManagementapiKey, basic80 EndpointsREST

For Agents

Read multi-channel orders, create invoices and shipments, update product stock, and manage Billbee customers and webhooks for an e-commerce back office.

Quickstart

Get started with Billbee API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"create an invoice for an order in billbee"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Billbee API API.

Read and patch orders across connected shop accounts and transition order states

Generate invoices and delivery notes for orders and attach shipment records with tracking numbers

Manage products, custom fields, categories, and stock counts including image uploads

Maintain customers and customer addresses, and look up a customer's order history

GET STARTED

Start building with Billbee API API

Explore with Jentic

View OpenAPI Document

Use for: I need to fetch all open orders from my Billbee account, I want to create an invoice for a specific order, Generate a delivery note for an order ready to ship, Update the order state to shipped after a label is purchased

Not supported: Does not handle storefront rendering, payment processing, or carrier rate-shopping — use for multi-channel order management, invoicing, and shipment booking only.

Billbee is a German multi-channel e-commerce back office that consolidates orders, shipments, products, and customers from marketplaces and webshops into a single workflow. The API exposes orders across connected shop accounts, lets agents create invoices and delivery notes, transition order states, attach shipments, and patch product and stock data. Customer records, customer addresses, events, layouts, cloud storage targets, and webhook subscriptions round out the surface so an agent can run end-to-end fulfillment without opening the Billbee web app.

Use Cases

Patterns agents use Billbee API API for, with concrete tasks.

★ Multi-channel order processing

Pull new orders from every connected shop into one queue, generate the invoice and delivery note, and transition the order state once the shipment is booked. The Billbee API exposes GET /api/v1/orders for the queue, POST /api/v1/orders/CreateInvoice/{id} and POST /api/v1/orders/CreateDeliveryNote/{id} for documents, and PUT /api/v1/orders/{id}/orderstate for the state change. A small operations team can process hundreds of marketplace orders a day from a single agent loop.

Fetch open orders via GET /api/v1/orders, then for each call POST /api/v1/orders/CreateInvoice/{id} and PUT /api/v1/orders/{id}/orderstate to mark them shipped

Inventory and product catalog sync

Keep the Billbee product catalog and stock levels in step with an upstream PIM or ERP. POST /api/v1/products creates new SKUs, POST /api/v1/products/{id}/stockcode (and related stock endpoints) update available units, and POST /api/v1/products/images uploads imagery. This avoids the drift that breaks marketplace listings when stock counts go stale.

Create a product with SKU 'WIDGET-001' via POST /api/v1/products, then patch its stock to 50 and verify with GET /api/v1/products/{id}

Customer record and history lookup

Maintain customer master records and pull a buyer's full order history for support workflows. The API exposes POST /api/v1/customers to create, PUT /api/v1/customers/{id} to update, and GET /api/v1/customers/{id}/orders to retrieve every order placed by that customer. Useful when a support agent needs context on a returning buyer in seconds.

Look up customer ID 12345 via GET /api/v1/customers/{id}, then call GET /api/v1/customers/{id}/orders and return the last five orders

Event-driven shipping workflow

Subscribe a webhook so an agent reacts the moment a new order or shipment event fires in Billbee. The API exposes GET /api/v1/events to enumerate event types and the webhooks endpoints to register a callback URL. The agent can then call POST /api/v1/orders/{id}/shipment to attach a label and tracking number as soon as the order is ready.

Register a webhook for the order.created event, then on receipt call POST /api/v1/orders/{id}/shipment with the carrier and tracking number

Agent-driven Billbee operations via Jentic

An AI agent uses Jentic to discover Billbee operations from intents like 'create an invoice for an order' or 'update product stock'. Jentic returns the matching operation, loads its schema, and executes with credentials held in the vault. The agent can run a full fulfillment loop without ever holding the X-Billbee-Api-Key header value directly.

Search Jentic for 'create an invoice for an order in billbee', load the CreateInvoice schema, and execute it for order ID 778899

Key Endpoints

80 endpoints — billbee is a german multi-channel e-commerce back office that consolidates orders, shipments, products, and customers from marketplaces and webshops into a single workflow.

METHOD

PATH

DESCRIPTION

GET

/api/v1/orders

List orders across connected shops

POST

/api/v1/orders/CreateInvoice/{id}

Create an invoice for an order

POST

/api/v1/orders/CreateDeliveryNote/{id}

Create a delivery note for an order

PUT

/api/v1/orders/{id}/orderstate

Transition the order state

POST

/api/v1/orders/{id}/shipment

Attach a shipment to an order

GET

/api/v1/products

List products in the catalog

POST

/api/v1/customers

Create a customer record

GET

/api/v1/customers/{id}/orders

Get a customer's order history

GET

/api/v1/orders

List orders across connected shops

POST

/api/v1/orders/CreateInvoice/{id}

Create an invoice for an order

POST

/api/v1/orders/CreateDeliveryNote/{id}

Create a delivery note for an order

PUT

/api/v1/orders/{id}/orderstate

Transition the order state

POST

/api/v1/orders/{id}/shipment

Attach a shipment to an order

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Billbee requires two credentials on every call (X-Billbee-Api-Key plus basic-auth username and password). Jentic stores both encrypted in the vault and exposes only a scoped reference, so a leaked agent context cannot read order or customer data.

Intent-based discovery

Agents search intents like 'create an invoice for an order' or 'list open orders' and Jentic returns the matching Billbee operation with its input schema, so the agent does not need to read Billbee's reference docs.

Time to first call

Direct Billbee integration: 1-2 days for the dual-auth setup, throttle handling, and order-state state machine. Through Jentic: under an hour to the first invoice created.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Shopify

Shopify is the storefront platform; Billbee aggregates orders from many shops including Shopify.

Choose Shopify when the storefront is the system of record; choose Billbee when orders flow in from multiple marketplaces and shops that need a unified back office.

Alternative

ShipStation

ShipStation is a shipping-focused order manager popular in North America.

Choose ShipStation for US-centric shipping workflows with native carrier rates; choose Billbee for European marketplace coverage and built-in invoicing.

Complementary

Easyship

Easyship adds carrier-rate and label generation alongside Billbee's order management.

Use Easyship alongside Billbee when you need international carrier rate-shopping after Billbee has assembled the order.

FAQs

Specific to using Billbee API API through Jentic.

What authentication does the Billbee API use?

Billbee requires two credentials on every request: an API key sent in the X-Billbee-Api-Key header that identifies your application, plus a basic-auth header carrying the Billbee username and an API password. Through Jentic both credentials sit encrypted in the vault and the agent only ever holds a scoped reference.

Can I create invoices and delivery notes with this API?

Yes. Call POST /api/v1/orders/CreateInvoice/{id} to generate an invoice for an order and POST /api/v1/orders/CreateDeliveryNote/{id} to generate the delivery note. The endpoints return a reference to the document and Billbee can also push it to a configured cloud-storage target.

What rate limits apply to the Billbee API?

Billbee enforces 50 calls per second per API key, 10 calls per second per API key plus user combination, and a per-endpoint cap of 2 requests per second per API key plus user. Exceeding the limit returns HTTP 429 with a Retry-After header indicating the wait.

How do I create an invoice through Jentic?

Search Jentic for 'create an invoice for an order in billbee'. Jentic returns the CreateInvoice operation, loads its schema, and your agent calls POST /api/v1/orders/CreateInvoice/{id} with the order ID. Pair with PUT /api/v1/orders/{id}/orderstate to mark the order processed.

Can I subscribe to Billbee events?

Yes. Use GET /api/v1/events to enumerate event types and the webhooks endpoints to register a callback URL. Webhooks fire on order, shipment, and product events so an agent can react in near real time without polling.

Is the Billbee API free?

API access is included with paid Billbee plans rather than a separate free tier. You also need to email support@billbee.io to request your developer API key. Jentic does not add usage charges on top of the underlying plan.