We just GoLive API Rate Limits. Please follow up

Update Order

PATCH

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

PATCH is a partial update, so nothing in the body is required. The same serializer is used for POST /order/add, where shop_id, receiver and items are required.
PUT is deliberately disabled on this path (http_method_names = ['get', 'patch', 'options']).

🛑 order_number (mã đơn của sàn) không sửa được qua API này — nó là khoá mọi đối soát join vào. Gửi order_number hoặc external_tracking_code vào đây đều bị bỏ qua. created_time cũng vậy.
Từ 2026-09-02, PATCH thực sự là cập nhật một phần: trường nào không gửi thì giữ nguyên. Trước đó một PATCH chỉ sửa desc cũng vô tình xoá mã đơn của sàn, đẩy ngày đặt hàng thành thời điểm gọi API, và xoá ghi chú.

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": "Khách đổi giờ giao"
}'

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,
                "shipping_fee": 0,
                "catalogue_items": [
                    {
                        "catalogue_sku": "DOC-EXAMPLE-1786691565",
                        "product_name": null,
                        "quantity": 1,
                        "weight": 0,
                        "original_price": 250000.0,
                        "discounted_price": 199000.0,
                        "is_gift": false,
                        "discount_seller": 51000.0,
                        "discount_platform": 0.0,
                        "voucher_seller": 0.0,
                        "voucher_platform": 0.0,
                        "warehouse_code": ""
                    }
                ],
                "inventory_items": []
            }
        ],
        "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-09-02 05:41:20

Get Returns Receiving Note

Returns Order