Billbee API
Documentation of the Billbee REST API to connect a Billbee account to external aplications.
Endpoint
The Billbee API endpoint base url is
Activation
You have to enable the API in the settings of your Billbee account. In addition you need a Billbee API Key identifying the application you develop. To get an API key, send a mail to and send us a short note about what you are building.
Authorization & security
Because you can access private data with the Billbee API, every request has to be sent over https and must
- Contain a valid API Key identifying the application/developer. It has to be sent as the HTTP header X-Billbee-Api-Key
- Contain a valid user login with billbee username and api password in form of a basic auth HTTP header
Throttling
Each endpoint has a throttle of max 2 requests per second per combination of API Key and Billbee user.
When you exceed these 2 calls, the API will return a HTTP 429 status code
- Homepage
- https://api.apis.guru/v2/specs/billbee.io/v1.json
- Provider
- billbee.io
- OpenAPI version
- 2.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/billbee.io/v1/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/billbee.io/v1/openapi.yaml
Tools (78)
Extracted live via the executor SDK.
-
cloudStorage.cloudStorageApiGetListGets a list of all connected cloud storage devices
-
customerAddresses.customerAddressesCreateCreates a new customer address
-
customerAddresses.customerAddressesGetAllGet a list of all customer addresses
-
customerAddresses.customerAddressesGetOneQueries a single customer address by id
-
customerAddresses.customerAddressesUpdateUpdates a customer address by id
-
customers.customerAddCustomerAddressId and CustomerId will be ignored in model. If Id is set, the addition will be stopped.
-
customers.customerCreateCreates a new customer
-
customers.customerGetAllGet a list of all customers
-
customers.customerGetCustomerAddressQueries a single address from a customer
-
customers.customerGetCustomerAddressesQueries a list of addresses from a customer
-
customers.customerGetCustomerOrdersQueries a list of orders from a customer
-
customers.customerGetOneQueries a single customer by id
-
customers.customerPatchAddressId and CustomerId cannot be changed
-
customers.customerUpdateUpdates a customer by id
-
customers.customerUpdateAddressId and CustomerId cannot be changed. Fields you do not send will become empty.
-
enumApi.enumApiGetOrderStatesReturns a list with all defined orderstates
-
enumApi.enumApiGetPaymentTypesReturns a list with all defined paymenttypes
-
enumApi.enumApiGetShipmentTypesReturns a list with all defined shipmenttypes
-
enumApi.enumApiGetShippingCarriersReturns a list with all defined shippingcarriers
-
events.eventApiGetListGet a list of all events optionally filtered by date. This request is extra throttled to 2 calls per page per hour.
-
orders.layoutApiGetListGET /api/v1/layouts
-
orders.orderApiAddShipmentAdd a shipment to a given order
-
orders.orderApiCreateDeliveryNoteCreate an delivery note for an existing order. This request is extra throttled by order and api key to a maximum of 1 per 5 minutes.
-
orders.orderApiCreateInvoiceCreate an invoice for an existing order. This request is extra throttled by order and api key to a maximum of 1 per 5 minutes.
-
orders.orderApiFindFind a single order by its external id (order number)
-
orders.orderApiGetGet a single order by its internal billbee id. This request is throttled to 6 calls per order in one minute
-
orders.orderApiGetByExtRefGet a single order by its external order number
-
orders.orderApiGetInvoiceListGet a list of all invoices optionally filtered by date. This request ist throttled to 1 per 1 minute for same page and minInvoiceDate
-
orders.orderApiGetListGet a list of all orders optionally filtered by date
-
orders.orderApiGetPatchableFieldsReturns a list of fields which can be updated with the orders/{id} patch call
-
orders.orderApiParsePlaceholdersParses a text and replaces all placeholders
-
orders.orderApiPatchOrderUpdates one or more fields of an order
-
orders.orderApiPostNewOrderTo create an order POST an JSON object to the orders endpoint with the shown properties. Not all properties are required.
-
orders.orderApiSendMessageSends a message to the buyer
-
orders.orderApiTagsCreateWhen a tag is already attached, it is ignored. Tags are not case sensitive. All given tags are added to the existing tags.
-
orders.orderApiTagsUpdateAll existing tags will be replaced by the given list of new tags. To just add tags, use POST method.
-
orders.orderApiTriggerEventTriggers a rule event
-
orders.orderApiUpdateStateREMARKS
Use this call to change the state of an order to i.e. paid or sent.
The state is transfered to the external shop/marketplace if configured. This is the list of known states:
- 1: ordered
- 2: confirmed
- 3: paid
- 4: shipped
- 5: reclamation
- 6: deleted
- 7: closed
- 8: canceled
- 9: archived
- 10: not used
- 11: demand note 1
- 12: demand note 2
- 13: packed
- 14: offered
- 15: payment reminder
- 16: fulfilling
-
products.articleCreateArticleCreates a new product
-
products.articleDeleteArticleDeletes a product
-
products.articleDeleteImageDeletes a single image by id
-
products.articleDeleteImageFromProductDeletes a single image from a product
-
products.articleDeleteImagesDelete multiple images by id
-
products.articleGetArticleQueries a single article by id or by sku
-
products.articleGetCategoryGEts a list of all defined categories
-
products.articleGetCustomFieldQueries a single custom field
-
products.articleGetCustomFieldsQueries a list of all custom fields
-
products.articleGetImageReturns a single image by id
-
products.articleGetImageFromProductReturns a single image by id
-
products.articleGetImagesReturns a list of all images of the product
-
products.articleGetListGet a list of all products
-
products.articleGetPatchableFieldsReturns a list of fields which can be updated with the patch call
-
products.articleGetReservedAmountQueries the reserved amount for a single article by id or by sku
-
products.articleGetStocksQuery all defined stock locations
-
products.articlePatchArticleUpdates one or more fields of a product
-
products.articlePutImageAdd or update an existing image of a product
-
products.articlePutImagesAdd multiple images to a product or replace the product images by the given images
-
products.articleUpdateStockThe article is specified by sku. You have to send the absolute value for the current stock
-
products.articleUpdateStockCodeUpdate the stock code of an article
-
products.articleUpdateStockMultipleUpdate the stock qty for multiple articles at once
-
products.searchSearchSearch for products, customers and orders. Type can be "order", "product" and / or "customer" Term can contains lucene query syntax
-
provisioning.automaticProvisioningCreateAccountCreates a new Billbee user account with the data passed
-
provisioning.automaticProvisioningTermsInfoReturns infos about Billbee terms and conditions
-
shipments.shipmentGetListGet a list of all shipments optionally filtered by date. All parameters are optional.
-
shipments.shipmentGetPingGET /api/v1/shipment/ping
-
shipments.shipmentGetShippingCarrierQueries the currently available shipping carriers.
-
shipments.shipmentGetShippingprovidersQuery all defined shipping providers
-
shipments.shipmentPostShipmentCreates a new shipment with the selected Shippingprovider
-
shipments.shipmentShipWithLabelCreates a shipment for an order in billbee
-
webhooks.webHookManagementDeleteDeletes an existing WebHook registration.
-
webhooks.webHookManagementDeleteAllDeletes all existing WebHook registrations.
-
webhooks.webHookManagementGetGets all registered WebHooks for a given user.
-
webhooks.webHookManagementGetFiltersReturns a list of all known filters you can use to register webhooks
-
webhooks.webHookManagementLookupLooks up a registered WebHook with the given {id} for a given user.
-
webhooks.webHookManagementPostRegisters a new WebHook for a given user.
-
webhooks.webHookManagementPutUpdates an existing WebHook registration.
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools