carriers5

channels5

clusters5

customer-addresses3

customers4

delivery-modalities5

delivery-types5

freight-types5

fulfillment-order-shipment-tracking-events1

fulfillment-order-shipments3

fulfillment-order-tracking-events1

fulfillment-orders4

inventory2

inventory-movements1

operators5

order-payments2

orders7

payment-methods3

permissions1

price-lists7

product-categories5

products3

promotions5

state-machines6

statuses5

strategies5

strategy-carriers5

strategy-channels5

strategy-operators5

strategy-price-lists5

webhook-subscriptions6

fulfillment-order-shipments

Create a shipment on a fulfillment order (synchronous)

Changed on Jul 7, 2026

Creates a shipment (status SHIPMENT_CREATED — not yet dispatched by the carrier) linked to the fulfillment order and opens its tracking timeline with a matching event, in a single transaction. It does not change the fulfillment order status. Validates that the fulfillment order, the carrier and every package SKU exist. accountCode comes from the JWT.

post/api/v1/fulfillment-orders/{fulfillmentOrderId}/shipments

Request

Base URL
https://oms-api.tenant.krzlabs.io
Auth
- HTTP basic
- or HTTP bearer
TypeScript
https://skmtc.dev/kruzer-corp/apis/oms-api/docs/api/v1/fulfillment-orders/:fulfillmentOrderId/shipments/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

fulfillmentOrderIdstring uuid required

Example:01920000-0000-7000-8000-000000000000

Parent fulfillment order identifier (UUID).

Request body

carrier_idstring required

Identificador (UUID) da transportadora cadastrada.

tracking_codestring nullable

Código de rastreio, quando já atribuído pela transportadora. Ausente na criação até o despacho.

labelstring nullable

Referência da etiqueta de transporte, quando o carrier a emite.

metadataobject nullable

Example request

{
  "carrier_id": "9a29b0c5-faff-4149-b7dd-5eeca344d157",
  "tracking_code": "BR123456789BR",
  "packages": [
    {
      "weight_kg": 1.5,
      "dimensions": {
        "length_cm": 20,
        "width_cm": 15,
        "height_cm": 10
      },
      "items": [
        {
          "sku": "SKU-001",
          "quantity": 2
        }
      ]
    }
  ]
}

Response

Shipment created (status SHIPMENT_CREATED, awaiting dispatch). Fulfillment order status unchanged.

metadataobject nullable required

shipment_idstring required

fo_statusstring required

fulfillment_order_idstring required

order_idstring required

carrier_idstring required

tracking_codestring nullable required

labelstring nullable required

dispatched_atstring nullable required

delivered_atstring nullable required

created_atstring required

updated_atstring required

Changes

Jul 7, 2026a3b4750a505f Revision changes
- breaking
  the request property's minItems was increased to 1
- breaking
  the // request property's minItems was increased to 1
- breaking
  the request property type changed from object to string
- breaking
  the // request property type changed from object to string
- breaking
  the // request property type changed from object to number
- breaking
  the request property type changed from object to string
- warning
  the /////// request property's min was set to 1.00
- warning
  the /////// request property's min was set to 1.00
- warning
  the /////// request property's min was set to 1.00
- warning
  the //// request property's min was set to 1.00
- warning
  the // request property's min was set to 1.00
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
Jul 7, 202684194c31ab85 Revision changes
- info
  endpoint added

Operation history