Onflow Open API
    • Getting Started
    • Overall logic
    • Error code
    • API
      • Config
        • Get Warehouse
        • Get Brand
        • Get Province
        • Get District
        • Get Ward
        • Upload file
        • Pricing
      • Product
        • Create Product
        • Assign Product
        • Get Product List
        • Get Product Detail
        • Get Stock
        • Deactivate Product
      • PO
        • Create PO
        • Get PO List
        • Get PO Bill
        • Get PO Detail
        • Get PO Inspection Detail
        • Cancel PO
      • Shipment
        • B2C Shipment
          • Create B2C Shipment
          • Get B2C Shipment List
          • Get B2C Shipment Detail
          • Cancel B2C Shipment
          • Get B2C Return Inspection
        • B2C Return shipment
          • Create Return B2C Shipment
          • Get Return B2C Shipment List
          • Get Return B2C Shipment Detail
          • Cancel Return B2C Shipment
          • Get B2C Return Shipment Inspection
        • B2B Shipment
          • Create
          • Get list
          • Get detail
          • Cancel
        • B2B Return shipment
          • Create
          • Get list
          • Get detail
          • Cancel
          • Get B2B Return Shipment Inspection
      • Stock
        • Get inventory Batch/lot
        • Get inventory Expired date
        • Get inventory Expired percent
    • Webhook
      • Shipment
        • Updated Shipment Status
      • Return
        • Updated Return Status
      • PO
        • Updated PO Status
      • Stock
        • Updated Stock

    Error code

    1. General#

    error_codemessage enmessage vi
    BAD_REQUESTBad request-
    UNAUTHORIZEDInvalid access token-
    FORBIDDENUser does not have access permission-
    NOT_FOUNDResource not foundKhông tìm thấy tài nguyên
    METHOD_NOT_ALLOWEDMethod not allowedPhương thức không được hỗ trợ
    REQUEST_TIMEOUTRequest timeout-
    INVALID_PAYLOADInvalid request payload-
    INTERNAL_SERVER_ERRORInternal server error-
    PRODUCTS_BY_OASIN_NOT_FOUNDThe OASIN codes {oasin_list} do not exist-
    PRODUCTS_NOT_MAPPED_IN_WAREHOUSEThe OASIN codes {oasin_list} are not mapped to this warehouse codeMã sản phẩm {oasin_list} chưa được gắn với mã kho yêu cầu
    PRODUCTS_INACTIVEThe OASIN codes {oasin_list} must be in ACTIVE status to perform this actionMã sản phẩm {oasin_list} phải ở trạng thái ACTIVE để thực hiện thao tác này
    UNAUTHORIZEDInvalid token header. No credentials provided.Token không hợp lệ. Bạn chưa cung cấp thông tin xác thực.
    UNAUTHORIZEDInvalid token. User key not found.Token không hợp lệ. Mã xác thực không được tìm thấy.

    2. Product#

    error_codemessage enmessage vi
    DUPLICATE_BARCODEBarcode already exists within the same businessMã vạch đã tồn tại trong cùng doanh nghiệp
    ALREADY_EXISTSSKU already exists within the same businessSKU đã tồn tại trong cùng doanh nghiệp
    NOT_FOUNDBrand not foundKhông tìm thấy thương hiệu
    PRODUCT_NOT_FOUNDProduct not foundKhông tìm thấy sản phẩm
    PRODUCT_STATUS_NOT_NEWProduct must be in NEW status to perform this actionSản phẩm phải ở trạng thái NEW để thực hiện thao tác này
    PRODUCT_WAREHOUSE_CONFLICTProduct is already mapped with this warehouseSản phẩm đã được gán với kho này
    PRODUCT_CANNOT_ASSIGN_TO_WAREHOUSEProduct cannot be assigned to warehouse because its status is not allowedKhông thể gán sản phẩm vào kho vì trạng thái không được phép
    PRODUCT_NOT_IN_WAREHOUSEProduct does not exist in the specified warehouseSản phẩm không tồn tại trong kho được chỉ định

    3. PO#

    error_codemessage enmessage vi
    DUPLICATE_PACKAGE_CODEDuplicate package code values are not allowed within the same POKhông được trùng giá trị mã kiện trong cùng một PO
    DUPLICATE_OASIN_IN_ITEMSDuplicate product values are not allowed within the same packageKhông được trùng giá trị sản phẩm trong cùng một kiện hàng
    PURCHASE_ORDER_ALREADY_EXISTSmerchant_po_reference already exists within the same businessmerchant_po_reference đã tồn tại
    PURCHASE_ORDER_NOT_FOUNDPurchase order not foundKhông tìm thấy PO
    PURCHASE_ORDER_STATUS_NOT_TRANSITPurchase order must be in TRANSIT status to perform this actionPurchase order phải ở trạng thái TRANSIT để thực hiện thao tác này
    PURCHASE_ORDER_STATUS_NOT_COMPLETEDPurchase order must be in COMPLETED status to perform this actionPurchase order phải ở trạng thái COMPLETED để thực hiện thao tác này
    PURCHASE_ORDER_ALREADY_EXISTSPurchase order already existsPurchase order đã tồn tại

    4. B2C Shipment#

    error_codemessage vimessage en
    DUPLICATE_TRACKING_CODE-Tracking code already exists
    INVALID_WAREHOUSE-Invalid warehouse code
    PRODUCT_NOT_FOUNDKhông tìm thấy sản phẩmProduct not found
    SHIPMENT_NOT_FOUNDMã đơn hàng không hợp lệInvalid tracking_code value
    INVALID_PLATFORMNền tảng không hợp lệ, chỉ chấp nhận TIKI, LAZADA, SHOPEE, TIKTOKPlatform must be one of TIKI, LAZADA, SHOPEE, TIKTOK
    INVALID_FULFILL_TYPELoại Fulfill không hợp lệInvalid fulfill type value
    INVALID_CARRIER_CODEMã hãng vận chuyển không hợp lệInvalid carrier code value
    DUPLICATE_PARTNER_TRACKING_CODEMã đơn nền tảng đã tồn tại trên hệ thốngPartner tracking code already exist
    INVALID_ORDER_TYPEĐơn hàng ưu tiên chỉ áp dụng cho nền tảng LazadaPRIOR fulfill type is only supported for Lazada
    DUPLICATE_OASINKhông được trùng giá trị sản phẩm trong cùng một kiện hàngDuplicate product values are not allowed within the same package
    SHIPMENT_CANNOT_BE_CANCELLEDĐơn hàng không thể huỷ do đã ở trạng thái đã huỷ hoặc đang xử lý hoànTracking code cannot be cancelled in its current status
    DUPLICATE_COURIER_TRACKING_CODEcourier_tracking_code đã tồn tại trên hệ thốngcourier_tracking_code already exist
    INSUFFICIENT_STOCKMã sản phẩm {oasin_list} số lượng tồn kho không đủThe OASIN codes {oasin_list} out of stock
    PRODUCT_INVENTORIES_BY_OASIN_NOT_FOUND-The OASIN codes {oasin_list} product inventories do not exist
    DUPLICATE_MERCHANT_TRACKING_CODE_REFERENCEmerchant_tracking_code_reference đã tồn tại trên hệ thốngmerchant_tracking_code_reference already exist
    BATCH_NOT_FOUND-Batch/Lot does not exist
    EXPIRY_DATE_NOT_FOUND-Expiry date does not exist
    EXPIRY_DATE_PERCENT_NOT_FOUND-Expiry date percent does not exist
    INVALID_PAYLOADChỉ được phép dùng một trong hai trường carrier_service_code hoặc courier_tracking_codeOnly one of carrier_service_code or courier_tracking_code is allowed
    BOX_DIMENSION_NOT_FOUNDKhông tìm thấy cấu hình box. vui lòng vào OMS để cấu hìnhBox dimension not found, please configure on OMS
    BUSINESS_PHONE_NOT_FOUNDKhông tìm thấy số điện thoại, vui lòng vào OMS để cấu hìnhBusiness phone not found, please configure on OMS

    5. B2C Return Shipment#

    error_codemessage vimessage en
    RETURN_SHIPMENT_NOT_FOUNDKhông tìm thấy đơn hoàn trảReturn shipment not found
    DUPLICATE_OASIN_IN_ITEMSKhông được trùng giá trị sản phẩm trong cùng một kiện hàngDuplicate product values are not allowed within the same package
    SHIPMENT_STATUS_NOT_ELIGIBLE_FOR_RETURNVận đơn phải ở Trạng thái vận đơn không đủ điều kiện để hoàn trảShipment status is not eligible for return.
    RETURN_SHIPMENT_STATUS_NOT_WAITING_FOR_RECEIVEReturn tracking code phải ở trạng thái WAITING FOR RECEIVE để thực hiện thao tác nàyReturn shipment must be in WAITING_FOR_RECEIVE status to perform this action
    SHIPMENT_NOT_FOUNDVận đơn không tồn tại trong hệ thốngTracking code does not exist
    MERCHANT_RETURN_TRACKING_CODE_ALREADY_EXISTSmerchant_return_tracking_code_reference đã tồn tạimerchant_return_tracking_code_reference already exists within the same business
    RETURN_COURIER_TRACKING_CODE_ALREADY_EXISTSreturn_courier_tracking_code đã tồn tạireturn_courier_tracking_code already exists in this warehouse
    Modified at 2026-06-15 10:31:12
    Previous
    Overall logic
    Next
    Get Warehouse
    Built with