We just GoLive API Rate Limits. Please follow up

Update Shipment Status

PUT

/api/v2/public/shipment/{omisell_shipment_number}/update-status

Change the status of a self-shipped shipment by tracking code.

Allowed only when Shipment.can_public_update_status is true:

self-shipped: shipping_provider == SELF OR marketplace order shipped by seller's own fleet (NOT marketplace/3PL transported);

current status >= SHIPPED (300) and NOT a terminal state (delivered/returned/cancelled);

target status must be a valid transition from the current one.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.omisell.com/api/v2/public/shipment//update-status' \
--header 'Authorization:  Omi {{Token}}' \
--header 'Authorization:  Omi {{Token}}' \
--header 'Seller-ID;' \
--header 'Seller-ID;' \
--header 'Country;' \
--header 'Country;' \
--header 'Content-Type: application/json' \
--data '{
    "status": 310
}'

Response Example

{
    "data": {
        "order_number": "230101ABCDEF",
        "omisell_order_number": "OPVN123456",
        "omisell_shipment_number": "SPVN26032832918DE4",
        "wms_order_number": "BMVN987654",
        "courier_tracking_number": "861768290186",
        "created_time": 1704067200,
        "updated_time": 1704153600,
        "fulfilled_time": 1704070800,
        "sla_time": 1704240000,
        "shipped_time": 1704074400,
        "delivered_time": 0,
        "cod_amount": 250000,
        "total_amount": 250000,
        "currency": "VND",
        "weight": 1.5,
        "volume": 0.02,
        "fail_reason": "",
        "shipment_note": "",
        "fulfillment_by": "self",
        "cross_check_by": "",
        "status_id": 310,
        "status_name": "In-transit",
        "is_fulfilled": true,
        "courier": {
            "name": "J&T Express",
            "service_code": "STD",
            "service_name": "Standard"
        },
        "receiver": {
            "fullname": "N*** V** A",
            "phone": "09*****567",
            "email": "a***@e***.com",
            "address": "1, Main St",
            "subdistrict_name": "Ward 1",
            "subdistrict_id": 27154,
            "district_name": "District 1",
            "district_id": 760,
            "province_name": "Ho Chi Minh",
            "province_id": 79,
            "country": "VN"
        },
        "pickup": {
            "id": 111,
            "pickup_code": "PU001",
            "pickup_name": "Main WH",
            "address": "10, Warehouse Rd"
        },
        "items": [
            {
                "catalogue_sku": "COMBO1",
                "inventory_sku": "SKU1",
                "product_name": "Product A",
                "quantity": 2,
                "sale_price": 125000,
                "vendor_pickup_id": 0,
                "vendor_name": "My Shop",
                "vendor_id": 0
            }
        ]
    },
    "error": false,
    "error_code": 200,
    "messages": "",
    "request_id": "667cebaa2ec7fcfe0a43da77"
}

Modified at 2026-07-21 06:07:23

Update Document Shipment

Pickup Address