---
title: "Creates a shipment for an order in billbee"
method: POST
path: "/api/v1/shipment/shipwithlabel"
tags: ["Shipments"]
---

# Creates a shipment for an order in billbee

`POST /api/v1/shipment/shipwithlabel`

## Request body

- 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

- 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/revisions/e64f07f4f526/schema)