FBT estimate order fee

Get FBT estimate order fee and time to delivery.

1. API endpoint

https://tikinowapi.tiki.vn/business/v1/fbt-quotes

2. Header request

Content-Type: application/json

Authorization: Bearer + token: token get from API get token or login into public app, in-house app or token from Seller Center.

3. CURL Example

curl --location 'https://tikinowapi.tiki.vn/business/v1/fbt-quotes' \
--header 'authorization: Bearer xxx' \
--header 'content-type: application/json;' \
--data '{"is_fulfillment_only":false,"shipping":{"ward_tiki_code":"VN039007006","warehouse_code":"sgn"},"items":[{"product_sku":"9587541851263","qty":2},{"product_sku":"7458471327837","qty":1}]}'

4. Payload

Field	Type	Mandatory	Description
is_fulfillment_only	Bool	Yes	– false: E2E order – true: FFO order (fulfillment only)
shipping	Object	Yes	Shipping address info and warehouse info
shipping.ward_tiki_code	String	Yes	Tiki ward code of shipping address
shipping.warehouse_code	String	Yes	Tiki warehouse code
items	Array	Yes	Array of product in order
items[].product_sku	Object	Yes	Product SKU on Tiki system
items[].product_sku	Number	Yes	Quantity of product

5. Response

Error

{
    "success": false,
    "error": {
        "status_code": 401,
        "message": "Unauthorized",
        "message_code": "INVALID_TOKEN"
    },
    "meta_data": {
        "request_id": "c00433cc7e5b25e390a6920052f7fedf"
    }
}

Success

{
    "success": true,
    "data": {
        "fee_standard": [
            {
                "fee_type_en": "Order processing fee",
                "fee_type_vi": "Phí xử lý đơn hàng",
                "product_charge": 1421280,
                "fee_key": "tnsl_fee_order_processing"
            },
            {
                "fee_type_en": "Package fee",
                "fee_type_vi": "Phí đóng gói",
                "product_charge": 363960,
                "fee_key": "tnsl_fee_package_material"
            },
            {
                "fee_type_en": "Order Delivery",
                "fee_type_vi": "Phí giao hàng",
                "product_charge": 1446120,
                "fee_key": "tnsl_fee_order_delivery"
            }
        ],
        "fee_2h": [
            {
                "fee_type_en": "Order processing fee",
                "fee_type_vi": "Phí xử lý đơn hàng",
                "product_charge": 1782000,
                "fee_key": "tnsl_fee_order_processing"
            },
            {
                "fee_type_en": "Package fee",
                "fee_type_vi": "Phí đóng gói",
                "product_charge": 363960,
                "fee_key": "tnsl_fee_package_material"
            },
            {
                "fee_type_en": "Order Delivery",
                "fee_type_vi": "Phí giao hàng",
                "product_charge": 1822500,
                "fee_key": "tnsl_fee_order_delivery"
            }
        ],
        "delivery_estimate_time_2h": "2023-12-12 13:00:00",
        "delivery_estimate_time_standard": "2023-12-13 19:00:00"
    },
    "meta_data": {
        "request_id": "4a00b96ca5e883946bde1674e4075849"
    }
}

Description

Field	Type	Description
success	Bool	Response true/false
data	Object	Data response when successfully
fee_standard	Array	Estimate standard order fee
fee_2h	Array	Estimate 2h order fee
fee_type_en	String	English name of the fee
fee_type_vi	String	Vietnamese name of the fee
product_charge	Number	Fee amount (VNĐ include VAT)
fee_key	String	Fee key on TNSL system
delivery_estimate_time_2h	Datetime	Estimate time to 2h delivery (E2E) or 2h processing (FFO)
delivery_estimate_time_standard	Datetime	Estimate time to standard delivery (E2E) or standard processing (FFO)