Update Order

PATCH

/api/v2/public/order/{omisell_order_number}

PATCH is a partial update, so nothing in the body is required. The same body is used for POST /order/add, where shop_id, receiver and items are required.
PUT is not supported on this path.

🛑 order_number (the sales-channel order code) cannot be changed through this API — it is the key every reconciliation joins on. Sending order_number or external_tracking_code here is ignored, and so is created_time.
Since 2026-09-02 PATCH is a true partial update: any field you do not send keeps its current value. Before that, a PATCH that changed only desc also wiped the sales-channel order code, pushed the order date forward to the time of the API call, and cleared the order note.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.omisell.com/api/v2/public/order/' \
--header 'Seller-ID;' \
--header 'Country;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "order_note": "Customer changed the delivery time"
}'

Response Example

{
    "data": {
        "completed_time": 0.0,
        "created_time": 1786691565.0,
        "escrow_release_time": 0.0,
        "external_information": {
            "cart_id": null
        },
        "fulfilled_time": 0.0,
        "invoice_information": {
            "code": null,
            "company": null,
            "fullname": null,
            "email": null,
            "phone": null,
            "address": null,
            "zip_code": null,
            "commune": null,
            "district": null,
            "province": null,
            "country": null
        },
        "is_fulfilled": false,
        "omisell_created_time": 1786691567.0,
        "omisell_order_number": "ODVN2608141B95956A",
        "order_note": "Updated via API — documentation example",
        "order_number": "ODVN2608141B95956A",
        "order_type": "normal",
        "parcels": [
            {
                "package_number": "1",
                "pickup_id": 38472,
                "pickup_code": "PK138472",
                "shipping_fee": 0,
                "catalogue_items": [
                    {
                        "order_item_id": 987654321,
                        "catalogue_sku": "DOC-EXAMPLE-1786691565",
                        "product_name": null,
                        "quantity": 1,
                        "weight": 0,
                        "original_price": 250000.0,
                        "discounted_price": 199000.0,
                        "is_gift": false,
                        "is_combo": false,
                        "discount_seller": 51000.0,
                        "discount_platform": 0.0,
                        "voucher_seller": 0.0,
                        "voucher_platform": 0.0,
                        "warehouse_code": ""
                    }
                ],
                "inventory_items": [
                    {
                        "order_item_id": 987654321,
                        "catalogue_sku": "DOC-EXAMPLE-1786691565",
                        "inventory_sku": "DOC-EXAMPLE-1786691565",
                        "esku": "ERP-DOC-EXAMPLE-1786691565",
                        "product_name": "Sản phẩm mẫu tài liệu",
                        "unit_name": "Cái",
                        "quantity": 1,
                        "sale_price": 199000.0,
                        "sale_price_before_tax": 199000.0,
                        "sale_amount": 199000.0,
                        "invoice_lines": [
                            {
                                "quantity": 1,
                                "unit_price_before_tax": 199000.0,
                                "unit_price_after_tax": 199000.0,
                                "amount_before_tax": 199000.0,
                                "vat_amount": 0.0,
                                "total": 199000.0
                            }
                        ],
                        "serial_numbers": [],
                        "tax_vat": 0.0,
                        "vendor_pickup_id": 38472,
                        "vendor_pickup_code": "PK138472",
                        "vendor_name": "Omisell Demo",
                        "vendor_id": 27001999
                    }
                ]
            }
        ],
        "payment_information": [
            {
                "origin_payment_method": "",
                "payment_method": "1",
                "payment_method_name": "Cash on Delivery",
                "transaction_amount": 199000.0,
                "transaction_status": 200,
                "transaction_status_name": "Paid",
                "transaction_code": "PV260814E8CA0ABF",
                "transaction_external_code": "",
                "transaction_reference": "",
                "transaction_time": 1786691565.0,
                "transaction_note": ""
            }
        ],
        "platform": "tiktok",
        "platform_name": "Tiktok Shop",
        "receiver": {
            "fullname": "Nguyen Van A",
            "email": "[email protected]",
            "phone": "+84900000000",
            "address": "123 Example Street",
            "country": "VN",
            "zip_code": "",
            "province": "Hà Nội",
            "province_id": 466589,
            "district": "Phường Bồ Đề",
            "district_id": 47349,
            "subdistrict_name": null,
            "subdistrict_id": null
        },
        "seller_id": 27001999,
        "seller_voucher_code": [],
        "shipped_time": 0.0,
        "shipping_information": {
            "origin_shipping_fee": 0,
            "buyer_shipping_fee": 0,
            "seller_shipping_fee": 0,
            "platform_ship_rebate": 0,
            "seller_ship_rebate": 0,
            "wrong_weight_adjustment": 0
        },
        "shop_id": 34251,
        "shop_name": "SANDBOX7413243897012717317",
        "status_id": 700,
        "status_name": "Cancelled by seller",
        "updated_time": 1788315988.0
    },
    "error": false,
    "error_code": 200,
    "attr_error": null,
    "messages": "",
    "request_id": "6a9789544ea125d5a8d1ccad"
}

Modified at 2026-11-04 04:15:32

Get Order Detail

Cancel Order