---
title: "createShipment order"
method: POST
path: "/ops/shipment"
tags: ["ops"]
---

# createShipment order

`POST /ops/shipment`

Add shipment info to an existing order.

## Request body

- CreateShipmentRequestBody
  - `order_id` string, regexp, required — topi order ID
  - `seller_id` string, required — id of the seller owner of this order
  - `serial_numbers` SerialNumberByAsset[], required — The serial numbers to register
    - `asset_id` string, required — The topi asset ID to update
    - `seller_product_reference` SellerProductReference
      - `reference` string, required — The ID related with the source. This value should be unique for that source.
      - `source` string, required — The seller internal source name for this reference type.
    - `serial_number` string, required — This is an id that identifies this asset as unique
    - `tracking_url` string — The tracking URL of the product shipment

## Response `200`

OK response.

- Shipment
  - `seller_id` string, required — id of the seller owner of this order
  - `serial_numbers` SerialNumberByAsset[], required — The serial numbers to register
    - `asset_id` string, required — The topi asset ID to update
    - `seller_product_reference` SellerProductReference
      - `reference` string, required — The ID related with the source. This value should be unique for that source.
      - `source` string, required — The seller internal source name for this reference type.
    - `serial_number` string, required — This is an id that identifies this asset as unique
    - `tracking_url` string — The tracking URL of the product shipment

## Other responses

- `400` — BadRequest: Bad Request response.
- `401` — Unauthorized: Unauthorized response.
- `403` — InvalidScopes: Forbidden response.
- `404` — NotFound: Not Found response.

---

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