{"files":{"SKILL.md":"---\nname: billbee-api\ndescription: \"Billbee API skill. Use when working with Billbee for api. Covers 87 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Billbee API\nAPI version: V1\n\n## Auth\nbasic | ApiKey X-Billbee-Api-Key in header\n\n## Base URL\nhttps://app.billbee.io\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /api/v1/apiusage -- verify access\n3. POST /api/v1/customer-addresses -- create first customer-addresses\n\n## Endpoints\n\n87 endpoints across 1 groups. See references/api-spec.lap for full details.\n\n### api\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /api/v1/apiusage | Get summarised api usage statistics |\n| GET | /api/v1/apiusage/detail | Get detailed api usage statistics |\n| GET | /api/v1/cloudstorages | Gets a list of all connected cloud storage devices |\n| GET | /api/v1/customer-addresses | Get a list of all customer addresses |\n| POST | /api/v1/customer-addresses | Creates a new customer address |\n| GET | /api/v1/customer-addresses/{id} | Queries a single customer address by id |\n| PUT | /api/v1/customer-addresses/{id} | Updates a customer address by id |\n| GET | /api/v1/customers | Get a list of all customers |\n| POST | /api/v1/customers | Creates a new customer |\n| GET | /api/v1/customers/{id} | Queries a single customer by id |\n| PUT | /api/v1/customers/{id} | Updates a customer by id |\n| GET | /api/v1/customers/{id}/orders | Queries a list of orders from a customer |\n| GET | /api/v1/customers/{id}/addresses | Queries a list of addresses from a customer |\n| POST | /api/v1/customers/{id}/addresses | Adds a new address to a customer |\n| GET | /api/v1/customers/addresses/{id} | Queries a single address from a customer |\n| PUT | /api/v1/customers/addresses/{id} | Updates all fields of an address |\n| PATCH | /api/v1/customers/addresses/{id} | Updates one or more fields of an address |\n| GET | /api/v1/enums/paymenttypes | Returns a list with all defined paymenttypes |\n| GET | /api/v1/enums/shippingcarriers | Returns a list with all defined shippingcarriers |\n| GET | /api/v1/enums/accountsyncstate | Returns a list with all defined account sync states |\n| GET | /api/v1/enums/shopaccounttype | Returns a list with all defined account types |\n| GET | /api/v1/enums/shipmenttypes | Returns a list with all defined shipmenttypes |\n| GET | /api/v1/enums/orderstates | Returns a list with all defined orderstates |\n| GET | /api/v1/events | Get a list of all events optionally filtered by date. This request is extra throttled to 2 calls per page per hour. |\n| POST | /api/v1/orders/createmultiple |  |\n| GET | /api/v1/orders | Get a list of all orders optionally filtered by date |\n| POST | /api/v1/orders |  |\n| PUT | /api/v1/orders/{id}/tags | Sets the tags attached to an order |\n| POST | /api/v1/orders/{id}/tags | Attach one or more tags to an order |\n| POST | /api/v1/orders/tags | Add one or more tags to multiple orders |\n| GET | /api/v1/orders/{id} | Get a single order by its internal billbee id. This request is throttled to 6 calls per order in one minute |\n| PATCH | /api/v1/orders/{id} | Updates one or more fields of an order |\n| GET | /api/v1/orders/findbyextref/{extRef} | Get a single order by its external order number |\n| PUT | /api/v1/orders/{id}/orderstate | Changes the main state of a single order |\n| POST | /api/v1/orders/{id}/shipment | Add a shipment to a given order |\n| GET | /api/v1/orders/invoices | Get a list of all invoices optionally filtered by date. This request ist throttled to 1 per 1 minute for same page and minInvoiceDate |\n| GET | /api/v1/orders/find/{id}/{partner} | Find a single order by its external id (order number) |\n| POST | /api/v1/orders/CreateDeliveryNote/{id} | Create 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. |\n| POST | /api/v1/orders/CreateInvoice/{id} | Create an invoice for an existing order. This request is extra throttled by order and api key to a maximum of 1 per 5 minutes. |\n| GET | /api/v1/orders/PatchableFields | Returns a list of fields which can be updated with the orders/{id} patch call |\n| POST | /api/v1/orders/{id}/send-message | Sends a message to the buyer |\n| POST | /api/v1/orders/{id}/trigger-event | Triggers a rule event |\n| POST | /api/v1/orders/{id}/parse-placeholders | Parses a text and replaces all placeholders |\n| POST | /api/v1/orders/{id}/message | Adds a message to the order |\n| GET | /api/v1/layouts |  |\n| POST | /api/v1/search | Search for products, customers and orders. |\n| GET | /api/v1/products | Get a list of all products |\n| POST | /api/v1/products | Creates a new product |\n| GET | /api/v1/products/{id} | Queries a single article by id or by sku |\n| DELETE | /api/v1/products/{id} | Deletes a product |\n| PATCH | /api/v1/products/{id} | Updates one or more fields of a product |\n| GET | /api/v1/products/stocks | Query all defined stock locations |\n| GET | /api/v1/products/PatchableFields | Returns a list of fields which can be updated with the patch call |\n| GET | /api/v1/products/category | GEts a list of all defined categories |\n| POST | /api/v1/products/updatestock | Update the stock qty of an article |\n| POST | /api/v1/products/stockmultiple | Retrieve the stock qty for multiple articles at once |\n| POST | /api/v1/products/updatestockmultiple | Update the stock qty for multiple articles at once |\n| GET | /api/v1/products/reservedamount | Queries the reserved amount for a single article by id or by sku |\n| POST | /api/v1/products/updatestockcode | Update the stock code of an article |\n| GET | /api/v1/products/custom-fields | Queries a list of all custom fields |\n| GET | /api/v1/products/custom-fields/{id} | Queries a single custom field |\n| GET | /api/v1/products/{productId}/images | Returns a list of all images of the product |\n| PUT | /api/v1/products/{productId}/images | Add multiple images to a product or replace the product images by the given images |\n| GET | /api/v1/products/{productId}/images/{imageId} | Returns a single image by id |\n| PUT | /api/v1/products/{productId}/images/{imageId} | Add or update an existing image of a product |\n| DELETE | /api/v1/products/{productId}/images/{imageId} | Deletes a single image from a product |\n| GET | /api/v1/products/images/{imageId} | Returns a single image by id |\n| DELETE | /api/v1/products/images/{imageId} | Deletes a single image by id |\n| POST | /api/v1/products/images/delete |  |\n| POST | /api/v1/automaticprovision/createaccount | Creates a new Billbee user account with the data passed |\n| GET | /api/v1/automaticprovision/termsinfo | Returns infos about Billbee terms and conditions |\n| POST | /api/v1/shipment/shipmentmultiple | Creates multiple shipments |\n| POST | /api/v1/shipment/shipment | Creates a new shipment with the selected Shippingprovider |\n| GET | /api/v1/shipment/shippingproviders | Query all defined shipping providers |\n| POST | /api/v1/shipment/shipwithlabel | Creates a shipment for an order in billbee |\n| POST | /api/v1/shipment/shipwithlabelmultiple | Creates shipments for a list of orders in billbee |\n| GET | /api/v1/shipment/shippingcarriers | Queries the currently available shipping carriers. |\n| GET | /api/v1/shipment/ping |  |\n| GET | /api/v1/shipment/shipments | Get a list of all shipments optionally filtered by date. All parameters are optional. |\n| GET | /api/v1/shopaccounts | Queries a list of avaible shop accounts |\n| GET | /api/v1/webhooks | Gets all registered WebHooks for a given user. |\n| POST | /api/v1/webhooks | Registers a new WebHook for a given user. |\n| DELETE | /api/v1/webhooks | Deletes all existing WebHook registrations. |\n| GET | /api/v1/webhooks/{id} | Looks up a registered WebHook with the given {id} for a given user. |\n| PUT | /api/v1/webhooks/{id} | Updates an existing WebHook registration. |\n| DELETE | /api/v1/webhooks/{id} | Deletes an existing WebHook registration. |\n| GET | /api/v1/webhooks/filters | Returns a list of all known filters you can use to register webhooks |\n\n## Common Questions\n\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all apiusage?\" -> GET /api/v1/apiusage\n- \"List all detail?\" -> GET /api/v1/apiusage/detail\n- \"List all cloudstorages?\" -> GET /api/v1/cloudstorages\n- \"List all customer-addresses?\" -> GET /api/v1/customer-addresses\n- \"Create a customer-address?\" -> POST /api/v1/customer-addresses\n- \"Get customer-address details?\" -> GET /api/v1/customer-addresses/{id}\n- \"Update a customer-address?\" -> PUT /api/v1/customer-addresses/{id}\n- \"List all customers?\" -> GET /api/v1/customers\n- \"Create a customer?\" -> POST /api/v1/customers\n- \"Get customer details?\" -> GET /api/v1/customers/{id}\n- \"Update a customer?\" -> PUT /api/v1/customers/{id}\n- \"List all orders?\" -> GET /api/v1/customers/{id}/orders\n- \"List all addresses?\" -> GET /api/v1/customers/{id}/addresses\n- \"Create a address?\" -> POST /api/v1/customers/{id}/addresses\n- \"Get address details?\" -> GET /api/v1/customers/addresses/{id}\n- \"Update a address?\" -> PUT /api/v1/customers/addresses/{id}\n- \"Partially update a address?\" -> PATCH /api/v1/customers/addresses/{id}\n- \"List all paymenttypes?\" -> GET /api/v1/enums/paymenttypes\n- \"List all shippingcarriers?\" -> GET /api/v1/enums/shippingcarriers\n- \"List all accountsyncstate?\" -> GET /api/v1/enums/accountsyncstate\n- \"List all shopaccounttype?\" -> GET /api/v1/enums/shopaccounttype\n- \"List all shipmenttypes?\" -> GET /api/v1/enums/shipmenttypes\n- \"List all orderstates?\" -> GET /api/v1/enums/orderstates\n- \"List all events?\" -> GET /api/v1/events\n- \"Create a createmultiple?\" -> POST /api/v1/orders/createmultiple\n- \"List all orders?\" -> GET /api/v1/orders\n- \"Create a order?\" -> POST /api/v1/orders\n- \"Create a tag?\" -> POST /api/v1/orders/{id}/tags\n- \"Create a tag?\" -> POST /api/v1/orders/tags\n- \"Get order details?\" -> GET /api/v1/orders/{id}\n- \"Partially update a order?\" -> PATCH /api/v1/orders/{id}\n- \"Get findbyextref details?\" -> GET /api/v1/orders/findbyextref/{extRef}\n- \"Create a shipment?\" -> POST /api/v1/orders/{id}/shipment\n- \"List all invoices?\" -> GET /api/v1/orders/invoices\n- \"Get find details?\" -> GET /api/v1/orders/find/{id}/{partner}\n- \"List all PatchableFields?\" -> GET /api/v1/orders/PatchableFields\n- \"Create a send-message?\" -> POST /api/v1/orders/{id}/send-message\n- \"Create a trigger-event?\" -> POST /api/v1/orders/{id}/trigger-event\n- \"Create a parse-placeholder?\" -> POST /api/v1/orders/{id}/parse-placeholders\n- \"Create a message?\" -> POST /api/v1/orders/{id}/message\n- \"List all layouts?\" -> GET /api/v1/layouts\n- \"Create a search?\" -> POST /api/v1/search\n- \"List all products?\" -> GET /api/v1/products\n- \"Create a product?\" -> POST /api/v1/products\n- \"Get product details?\" -> GET /api/v1/products/{id}\n- \"Delete a product?\" -> DELETE /api/v1/products/{id}\n- \"Partially update a product?\" -> PATCH /api/v1/products/{id}\n- \"List all stocks?\" -> GET /api/v1/products/stocks\n- \"List all PatchableFields?\" -> GET /api/v1/products/PatchableFields\n- \"List all category?\" -> GET /api/v1/products/category\n- \"Create a updatestock?\" -> POST /api/v1/products/updatestock\n- \"Create a stockmultiple?\" -> POST /api/v1/products/stockmultiple\n- \"Create a updatestockmultiple?\" -> POST /api/v1/products/updatestockmultiple\n- \"List all reservedamount?\" -> GET /api/v1/products/reservedamount\n- \"Create a updatestockcode?\" -> POST /api/v1/products/updatestockcode\n- \"List all custom-fields?\" -> GET /api/v1/products/custom-fields\n- \"Get custom-field details?\" -> GET /api/v1/products/custom-fields/{id}\n- \"List all images?\" -> GET /api/v1/products/{productId}/images\n- \"Get image details?\" -> GET /api/v1/products/{productId}/images/{imageId}\n- \"Update a image?\" -> PUT /api/v1/products/{productId}/images/{imageId}\n- \"Delete a image?\" -> DELETE /api/v1/products/{productId}/images/{imageId}\n- \"Get image details?\" -> GET /api/v1/products/images/{imageId}\n- \"Delete a image?\" -> DELETE /api/v1/products/images/{imageId}\n- \"Create a delete?\" -> POST /api/v1/products/images/delete\n- \"Create a createaccount?\" -> POST /api/v1/automaticprovision/createaccount\n- \"List all termsinfo?\" -> GET /api/v1/automaticprovision/termsinfo\n- \"Create a shipmentmultiple?\" -> POST /api/v1/shipment/shipmentmultiple\n- \"Create a shipment?\" -> POST /api/v1/shipment/shipment\n- \"List all shippingproviders?\" -> GET /api/v1/shipment/shippingproviders\n- \"Create a shipwithlabel?\" -> POST /api/v1/shipment/shipwithlabel\n- \"Create a shipwithlabelmultiple?\" -> POST /api/v1/shipment/shipwithlabelmultiple\n- \"List all shippingcarriers?\" -> GET /api/v1/shipment/shippingcarriers\n- \"List all ping?\" -> GET /api/v1/shipment/ping\n- \"List all shipments?\" -> GET /api/v1/shipment/shipments\n- \"List all shopaccounts?\" -> GET /api/v1/shopaccounts\n- \"List all webhooks?\" -> GET /api/v1/webhooks\n- \"Create a webhook?\" -> POST /api/v1/webhooks\n- \"Get webhook details?\" -> GET /api/v1/webhooks/{id}\n- \"Update a webhook?\" -> PUT /api/v1/webhooks/{id}\n- \"Delete a webhook?\" -> DELETE /api/v1/webhooks/{id}\n- \"List all filters?\" -> GET /api/v1/webhooks/filters\n- \"How to authenticate?\" -> See Auth section\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- List endpoints may support pagination; check for limit, offset, or cursor params\n- Create/update endpoints typically return the created/updated object\n\n## CLI\n\n```bash\n# Update this spec to the latest version\nnpx @lap-platform/lapsh get billbee-api -o references/api-spec.lap\n\n# Search for related APIs\nnpx @lap-platform/lapsh search billbee-api\n```\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Billbee API\n@base https://app.billbee.io\n@version V1\n@auth basic | ApiKey X-Billbee-Api-Key in header\n@endpoints 87\n@hint download_for_search\n@toc api(87)\n\n@endpoint GET /api/v1/apiusage\n@desc Get summarised api usage statistics\n@optional {request.date: any # Only year and month of this is relevant}\n@returns(200) OK\n\n@endpoint GET /api/v1/apiusage/detail\n@desc Get detailed api usage statistics\n@optional {request.date: any # Only year and month of this is relevant}\n@returns(200) OK\n\n@endpoint GET /api/v1/cloudstorages\n@desc Gets a list of all connected cloud storage devices\n@returns(200) OK\n\n@endpoint GET /api/v1/customer-addresses\n@desc Get a list of all customer addresses\n@optional {page: any # The current page to request starting with 1 (default is 1), pageSize: any # The page size for the result list. Values between 1 and 250 are allowed. (default is 50)}\n@returns(200) OK\n\n@endpoint POST /api/v1/customer-addresses\n@desc Creates a new customer address\n@required {model: map}\n@returns(200) OK\n\n@endpoint GET /api/v1/customer-addresses/{id}\n@desc Queries a single customer address by id\n@required {id: any # The id of the address to query}\n@returns(200) OK\n\n@endpoint PUT /api/v1/customer-addresses/{id}\n@desc Updates a customer address by id\n@required {model: map, id: any # The id of the address}\n@returns(200) OK\n\n@endpoint GET /api/v1/customers\n@desc Get a list of all customers\n@optional {page: any # The current page to request starting with 1, pageSize: any # The pagesize for the result list. Values between 1 and 250 are allowed}\n@returns(200) OK\n\n@endpoint POST /api/v1/customers\n@desc Creates a new customer\n@required {model: map}\n@returns(200) OK\n\n@endpoint GET /api/v1/customers/{id}\n@desc Queries a single customer by id\n@required {id: any # The id of the customer to query}\n@returns(200) OK\n\n@endpoint PUT /api/v1/customers/{id}\n@desc Updates a customer by id\n@required {model: map, id: any # The id of the customer}\n@returns(200) OK\n\n@endpoint GET /api/v1/customers/{id}/orders\n@desc Queries a list of orders from a customer\n@required {id: any # The id of the customer}\n@optional {page: any # The current page to request starting with 1, pageSize: any # The pagesize for the result list. Values between 1 and 250 are allowed}\n@returns(200) OK\n\n@endpoint GET /api/v1/customers/{id}/addresses\n@desc Queries a list of addresses from a customer\n@required {id: any # The id of the customer}\n@optional {page: any # The current page to request starting with 1, pageSize: any # The pagesize for the result list. Values between 1 and 250 are allowed}\n@returns(200) OK\n\n@endpoint POST /api/v1/customers/{id}/addresses\n@desc Adds a new address to a customer\n@required {id: any # CustomerId to attach the new address to., model: map # Model containing the address, that should be attached.}\n@returns(200) OK\n\n@endpoint GET /api/v1/customers/addresses/{id}\n@desc Queries a single address from a customer\n@required {id: any # The id of the address}\n@returns(200) OK\n\n@endpoint PUT /api/v1/customers/addresses/{id}\n@desc Updates all fields of an address\n@required {model: map # The updated address. Please query an address via (todo) to see all fields. Note that Id and CustomerId cannot be changed., id: any # The id of the address}\n@returns(200) OK\n\n@endpoint PATCH /api/v1/customers/addresses/{id}\n@desc Updates one or more fields of an address\n@required {id: any # The id of the address, model: map # The address fields to be changed. Please query an address via (todo) to see all fields. Note that Id and CustomerId cannot be changed.}\n@returns(200) OK\n\n@endpoint GET /api/v1/enums/paymenttypes\n@desc Returns a list with all defined paymenttypes\n@returns(200) OK\n\n@endpoint GET /api/v1/enums/shippingcarriers\n@desc Returns a list with all defined shippingcarriers\n@returns(200) OK\n\n@endpoint GET /api/v1/enums/accountsyncstate\n@desc Returns a list with all defined account sync states\n@returns(200) OK\n\n@endpoint GET /api/v1/enums/shopaccounttype\n@desc Returns a list with all defined account types\n@returns(200) OK\n\n@endpoint GET /api/v1/enums/shipmenttypes\n@desc Returns a list with all defined shipmenttypes\n@returns(200) OK\n\n@endpoint GET /api/v1/enums/orderstates\n@desc Returns a list with all defined orderstates\n@returns(200) OK\n\n@endpoint GET /api/v1/events\n@desc Get a list of all events optionally filtered by date. This request is extra throttled to 2 calls per page per hour.\n@optional {minDate: any # Specifies the oldest date to include in the response, maxDate: any # Specifies the newest date to include in the response, page: any # Specifies the page to request, pageSize: any # Specifies the pagesize. Defaults to 50, max value is 250, typeId: any # Filter for specific event types, orderId: any # Filter for specific order id}\n@returns(200) OK\n\n@endpoint POST /api/v1/orders/createmultiple\n@required {models: [map]}\n@returns(200) OK\n\n@endpoint GET /api/v1/orders\n@desc Get a list of all orders optionally filtered by date\n@optional {minOrderDate: any # Specifies the oldest order date to include in the response, maxOrderDate: any # Specifies the newest order date to include in the response, page: any # Specifies the page to request, pageSize: any # Specifies the pagesize. Defaults to 50, max value is 250, shopId: any # Specifies a list of shop ids for which invoices should be included, orderStateId: any # Specifies a list of state ids to include in the response, tag: any # Specifies a list of tags the order must have attached to be included in the response, minimumBillBeeOrderId: any # If given, all delivered orders have an Id greater than or equal to the given minimumOrderId, modifiedAtMin: any # If given, the last modification has to be newer than the given date, modifiedAtMax: any # If given, the last modification has to be older or equal than the given date., articleTitleSource: any # The source field for the article title. 0 = Order Position (default), 1 = Article Title, 2 = Article Invoice Text, excludeTags: any # If true the list of tags passed to the call are used to filter orders to not include these tags}\n@returns(200) OK\n\n@endpoint POST /api/v1/orders\n@required {orderData: map}\n@optional {shopId: any}\n@returns(200) OK\n\n@endpoint PUT /api/v1/orders/{id}/tags\n@desc Sets the tags attached to an order\n@required {tagData: map # Tags to attach, id: any # The internal id of the order}\n@returns(200) OK\n\n@endpoint POST /api/v1/orders/{id}/tags\n@desc Attach one or more tags to an order\n@required {tagData: map # Tags to attach, id: any # The internal id of the order}\n@returns(200) OK\n\n@endpoint POST /api/v1/orders/tags\n@desc Add one or more tags to multiple orders\n@required {model: map # Contains lists of orderids and tags}\n@returns(200) OK\n\n@endpoint GET /api/v1/orders/{id}\n@desc Get a single order by its internal billbee id. This request is throttled to 6 calls per order in one minute\n@required {id: any # The internal billbee id of the order}\n@optional {articleTitleSource: any # The source field for the article title. 0 = Order Position (default), 1 = Article Title, 2 = Article Invoice Text}\n@returns(200) OK\n\n@endpoint PATCH /api/v1/orders/{id}\n@desc Updates one or more fields of an order\n@required {id: any, model: map}\n@returns(200) OK\n\n@endpoint GET /api/v1/orders/findbyextref/{extRef}\n@desc Get a single order by its external order number\n@required {extRef: any # The extern order number of the order}\n@returns(200) OK\n\n@endpoint PUT /api/v1/orders/{id}/orderstate\n@desc Changes the main state of a single order\n@required {id: any # The internal id of the order, model: map # The data used to change the state}\n@returns(200) OK\n\n@endpoint POST /api/v1/orders/{id}/shipment\n@desc Add a shipment to a given order\n@required {id: any # The internal billbee id of the order, model: map # The shipment data to create the shipment}\n@returns(200) OK\n\n@endpoint GET /api/v1/orders/invoices\n@desc Get a list of all invoices optionally filtered by date. This request ist throttled to 1 per 1 minute for same page and minInvoiceDate\n@optional {minInvoiceDate: any # Specifies the oldest invoice date to include, maxInvoiceDate: any # Specifies the newest invoice date to include, page: any # Specifies the page to request, pageSize: any # Specifies the pagesize. Defaults to 50, max value is 250, shopId: any # Specifies a list of shop ids for which invoices should be included, orderStateId: any # Specifies a list of state ids to include in the response, tag: any, minPayDate: any, maxPayDate: any, includePositions: any, excludeTags: any # If true the list of tags passed to the call are used to filter orders to not include these tags}\n@returns(200) OK\n\n@endpoint GET /api/v1/orders/find/{id}/{partner}\n@desc Find a single order by its external id (order number)\n@required {id: any # The order id from the external system, partner: any # Optional the name of the shop/marketplace the order was imported from}\n@returns(200) OK\n\n@endpoint POST /api/v1/orders/CreateDeliveryNote/{id}\n@desc Create 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.\n@required {id: any # The internal billbee id of the order}\n@optional {includePdf: any # If true, the PDF is included in the response as base64 encoded string, sendToCloudId: any # Optionally specify the id of a billbee connected cloud device to send the pdf to}\n@returns(200) OK\n\n@endpoint POST /api/v1/orders/CreateInvoice/{id}\n@desc Create an invoice for an existing order. This request is extra throttled by order and api key to a maximum of 1 per 5 minutes.\n@required {id: any # The internal billbee id of the order}\n@optional {includeInvoicePdf: any # If true, the PDF is included in the response as base64 encoded string, templateId: any # You can pass the id of an invoice template to overwrite the assigned template for invoice creation, sendToCloudId: any # You can pass the id of a connected cloud printer/storage to send the invoice to it}\n@returns(200) OK\n\n@endpoint GET /api/v1/orders/PatchableFields\n@desc Returns a list of fields which can be updated with the orders/{id} patch call\n@returns(200) OK\n\n@endpoint POST /api/v1/orders/{id}/send-message\n@desc Sends a message to the buyer\n@required {id: any # The id of the order, model: map # The message model}\n@returns(200) OK\n\n@endpoint POST /api/v1/orders/{id}/trigger-event\n@desc Triggers a rule event\n@required {id: any # The id of the order, model: map}\n@returns(200) OK\n\n@endpoint POST /api/v1/orders/{id}/parse-placeholders\n@desc Parses a text and replaces all placeholders\n@required {id: any # The id of the order, container: map}\n@returns(200) OK\n\n@endpoint POST /api/v1/orders/{id}/message\n@desc Adds a message to the order\n@required {id: any # The id of the order, orderMessage: map}\n@returns(200) OK\n\n@endpoint GET /api/v1/layouts\n@returns(200) OK\n\n@endpoint POST /api/v1/search\n@desc Search for products, customers and orders.\n@required {model: map}\n@returns(200) OK\n\n@endpoint GET /api/v1/products\n@desc Get a list of all products\n@optional {page: any # The current page to request starting with 1, pageSize: any # The pagesize for the result list. Values between 1 and 250 are allowed, minCreatedAt: any # Optional the oldest create date of the articles to be returned, minimumBillBeeArticleId: any, maximumBillBeeArticleId: any}\n@returns(200) OK\n\n@endpoint POST /api/v1/products\n@desc Creates a new product\n@required {model: map}\n@returns(200) OK\n\n@endpoint GET /api/v1/products/{id}\n@desc Queries a single article by id or by sku\n@required {id: any # The id or the sku of the article to query}\n@optional {lookupBy: any # Either the value id, ean or the value sku to specify the meaning of the id parameter.}\n@returns(200) OK\n\n@endpoint DELETE /api/v1/products/{id}\n@desc Deletes a product\n@required {id: any # The id of the Product}\n@returns(200) OK\n\n@endpoint PATCH /api/v1/products/{id}\n@desc Updates one or more fields of a product\n@required {id: any # The id of the Product, model: map}\n@returns(200) OK\n\n@endpoint GET /api/v1/products/stocks\n@desc Query all defined stock locations\n@returns(200) OK\n\n@endpoint GET /api/v1/products/PatchableFields\n@desc Returns a list of fields which can be updated with the patch call\n@returns(200) OK\n\n@endpoint GET /api/v1/products/category\n@desc GEts a list of all defined categories\n@returns(200) OK\n\n@endpoint POST /api/v1/products/updatestock\n@desc Update the stock qty of an article\n@required {model: map}\n@returns(200) OK\n\n@endpoint POST /api/v1/products/stockmultiple\n@desc Retrieve the stock qty for multiple articles at once\n@required {request: map}\n@optional {modifiedSince: any, page: any, pageSize: any}\n@returns(200) OK\n\n@endpoint POST /api/v1/products/updatestockmultiple\n@desc Update the stock qty for multiple articles at once\n@required {models: [map]}\n@returns(200) OK\n\n@endpoint GET /api/v1/products/reservedamount\n@desc Queries the reserved amount for a single article by id or by sku\n@required {id: any # The id or the sku of the article to query}\n@optional {lookupBy: any # Either the value id or the value sku to specify the meaning of the id parameter, stockId: any # Optional the stock id if the multi stock feature is enabled}\n@returns(200) OK\n\n@endpoint POST /api/v1/products/updatestockcode\n@desc Update the stock code of an article\n@required {model: map}\n@returns(200) OK\n\n@endpoint GET /api/v1/products/custom-fields\n@desc Queries a list of all custom fields\n@optional {page: any, pageSize: any}\n@returns(200) OK\n\n@endpoint GET /api/v1/products/custom-fields/{id}\n@desc Queries a single custom field\n@required {id: any # The id of the custom field to query}\n@returns(200) OK\n\n@endpoint GET /api/v1/products/{productId}/images\n@desc Returns a list of all images of the product\n@required {productId: any # The Id of the product}\n@returns(200) OK\n\n@endpoint PUT /api/v1/products/{productId}/images\n@desc Add multiple images to a product or replace the product images by the given images\n@required {productId: any # The id of the product, models: [map] # An array of ArticleApiImageModel}\n@optional {replace: any # If you pass true, the images will be replaced by the passed images. Otherwise the passed images will be appended to the product.}\n@returns(200) OK\n\n@endpoint GET /api/v1/products/{productId}/images/{imageId}\n@desc Returns a single image by id\n@required {productId: any # The Id of the product, imageId: any # The Id of the image}\n@returns(200) OK\n\n@endpoint PUT /api/v1/products/{productId}/images/{imageId}\n@desc Add or update an existing image of a product\n@required {productId: any # The product id, imageId: any # The image id. If you pass 0, the image will be added, model: map # The ArticleApiImageModel}\n@returns(200) OK\n\n@endpoint DELETE /api/v1/products/{productId}/images/{imageId}\n@desc Deletes a single image from a product\n@required {productId: any # The product id, imageId: any # The image id}\n@returns(200) OK\n\n@endpoint GET /api/v1/products/images/{imageId}\n@desc Returns a single image by id\n@required {imageId: any # The Id of the image}\n@returns(200) OK\n\n@endpoint DELETE /api/v1/products/images/{imageId}\n@desc Deletes a single image by id\n@required {imageId: any # The image id}\n@returns(200) OK\n\n@endpoint POST /api/v1/products/images/delete\n@required {imageIds: [int(int64)]}\n@returns(200) OK\n\n@endpoint POST /api/v1/automaticprovision/createaccount\n@desc Creates a new Billbee user account with the data passed\n@required {model: map}\n@returns(200) OK\n\n@endpoint GET /api/v1/automaticprovision/termsinfo\n@desc Returns infos about Billbee terms and conditions\n@returns(200) OK\n\n@endpoint POST /api/v1/shipment/shipmentmultiple\n@desc Creates multiple shipments\n@required {models: [map] # Data to specify shipment parameters}\n@returns(200) OK\n\n@endpoint POST /api/v1/shipment/shipment\n@desc Creates a new shipment with the selected Shippingprovider\n@required {model: map # Data to specify shipment parameters}\n@returns(200) OK\n\n@endpoint GET /api/v1/shipment/shippingproviders\n@desc Query all defined shipping providers\n@returns(200) OK\n\n@endpoint POST /api/v1/shipment/shipwithlabel\n@desc Creates a shipment for an order in billbee\n@required {shipmentInformation: map # Details on the order and the shipping methods, that should be used.}\n@returns(200) OK\n\n@endpoint POST /api/v1/shipment/shipwithlabelmultiple\n@desc Creates shipments for a list of orders in billbee\n@required {models: [map]}\n@returns(200) OK\n\n@endpoint GET /api/v1/shipment/shippingcarriers\n@desc Queries the currently available shipping carriers.\n@returns(200) OK\n\n@endpoint GET /api/v1/shipment/ping\n@returns(200) OK\n\n@endpoint GET /api/v1/shipment/shipments\n@desc Get a list of all shipments optionally filtered by date. All parameters are optional.\n@optional {page: any # Specifies the page to request., pageSize: any # Specifies the pagesize. Defaults to 50, max value is 250, createdAtMin: any # Specifies the oldest shipment date to include in the response, createdAtMax: any # Specifies the newest shipment date to include in the response, orderId: any # Get shipments for this order only., minimumShipmentId: any # Get Shipments with a shipment greater or equal than this id. New shipments have a greater id than older shipments., shippingProviderId: any # Get Shippings for the specified shipping provider only.}\n@returns(200) OK\n\n@endpoint GET /api/v1/shopaccounts\n@desc Queries a list of avaible shop accounts\n@optional {page: any # The current page to request starting with 1, pageSize: any # The pagesize for the result list. Values between 1 and 250 are allowed}\n@returns(200) OK\n\n@endpoint GET /api/v1/webhooks\n@desc Gets all registered WebHooks for a given user.\n@returns(200) OK\n\n@endpoint POST /api/v1/webhooks\n@desc Registers a new WebHook for a given user.\n@required {webHook: map # The webhook to create. Attach ?noecho to the uri to prevent echo test.}\n@returns(200) OK\n\n@endpoint DELETE /api/v1/webhooks\n@desc Deletes all existing WebHook registrations.\n@returns(200) OK\n\n@endpoint GET /api/v1/webhooks/{id}\n@desc Looks up a registered WebHook with the given {id} for a given user.\n@required {id: any}\n@returns(200) OK\n\n@endpoint PUT /api/v1/webhooks/{id}\n@desc Updates an existing WebHook registration.\n@required {id: any # The WebHook ID., webHook: map # The new webhook to use.}\n@returns(200) OK\n\n@endpoint DELETE /api/v1/webhooks/{id}\n@desc Deletes an existing WebHook registration.\n@required {id: any # The WebHook ID.}\n@returns(200) OK\n\n@endpoint GET /api/v1/webhooks/filters\n@desc Returns a list of all known filters you can use to register webhooks\n@returns(200) OK\n\n@end\n"}}