---
title: "Creates shipments for a list of orders in billbee"
method: POST
path: "/api/v1/shipment/shipwithlabelmultiple"
tags: ["Shipments"]
---

# Creates shipments for a list of orders in billbee

`POST /api/v1/shipment/shipwithlabelmultiple`

## Request body

- RechnungsdruckWebAppControllersApiApiBatchRequestOfRechnungsdruckWebAppControllersApiShipmentWithLabel[]
  - `RequestId` string
  - `Data` RechnungsdruckWebAppControllersApiShipmentWithLabel
    - `OrderId` integer — The Billbee internal id of the order to ship
    - `ProviderId` integer — The id of the provider. You can query all providers with the shippingproviders endpoint
    - `ProductId` integer — the id of the shipping provider product to be used
    - `ChangeStateToSend` boolean — Optional parameter to automatically change the orderstate to sent after creating the shipment
    - `PrinterName` string — Optional the name of a connected cloudprinter to send the label to
    - `WeightInGram` integer — Optional the shipments weight in gram to override the calculated weight
    - `ShipDate` string, date-time — Optional specify the shipdate to be transmitted to the carrier
    - `ClientReference` string — Optional specify a reference text to be included on the label. Works not with all carriers
    - `Dimension` BillbeeInterfacesShippingShipmentDataDimensions
      - `length` number, double
      - `width` number, double
      - `height` number, double

## Response `200`

OK

- RechnungsdruckWebAppControllersApiApiBatchResponseOfRechnungsdruckWebAppControllersApiShipmentWithLabelResult[]
  - `RequestId` string
  - `Result` RechnungsdruckWebAppControllersApiApiResultOfRechnungsdruckWebAppControllersApiShipmentWithLabelResult
    - `ErrorMessage` string
    - `ErrorCode` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31
    - `ErrorDescription` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31
    - `Data` RechnungsdruckWebAppControllersApiShipmentWithLabelResult
      - `OrderId` integer
      - `OrderReference` string
      - `ShippingId` string
      - `ReturnShippingId` string
      - `TrackingUrl` string
      - `LabelDataPdf` string, byte
      - `ReturnLabelDataPdf` string, byte
      - `ExportDocsPdf` string, byte
      - `Carrier` string
      - `ShippingDate` string, date-time

---

[API](https://skmtc.net/billbee/apis/billbee-api.md) · [All operations](https://skmtc.net/billbee/apis/billbee-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/billbee/billbee-api/versions/e64f07f4f526/schema)