API Search CR create CR for orders from the merchant.
URL
https://tikinowapi.tiki.vn/aftersales/2.0/customer_return/create
Link Production
METHOD
POST
QUERY HEADERS
Header | Value | Note |
---|---|---|
Content-Type | application/json | |
Authorization | Bearer <access_token> | access_token is generated by authorizing the In-House application of the Tiki Developer Platform |
PAYLOAD
Params | Data Type | Required | Default Value | Description | Example |
---|---|---|---|---|---|
order_code | string | Y | Mã đơn hàng | ||
order_items | Array | Y | |||
order_items[].product_sku | string | N | SKU của sản phẩm Required if item_type = order_product | ||
order_items[].qty | integer | Y | Số lượng | ||
order_items[].return_reason_code | string | Y | Mã code lý do đổi trả | ||
order_items[].resolution_type | string | Y | Loại giải pháp: PICKUP_ONLY: Chỉ thu hồi | ||
order_items[].images | array | N | Danh sách link hình ảnh | ||
order_items[].note | string | N | Ghi chú | ||
return_method | string | Y | Tìm kiếm theo phương thức đổi trả: TIKI: Trả hàng thông qua Tiki SELLER_DELIVERY: Seller tự lấy hàng TNSL_EXTERNAL: Khách hàng TNSL tự gửi hàng | ||
return_option | string | N | Lựa chọn thu hồi: Required if return_method = TIKI tiki_pickup: Tiki lấy hàng tại nhà | ||
pickup_address | Object | N | Required if return_option = tiki_pickup | ||
destination_address | Object | N | Địa chỉ giao hàng là Optional Nếu Loại đơn hàng == lastmile và API có truyền lên destination_address thì hệ thống sẽ lấy destination_address làm địa chỉ giao hàng của Seller Nếu Loại đơn hàng == lastmile và API ko truyền lên destination_address thì hệ thống sẽ mặc định lấy thông tin địa chỉ trả hàng của Seller Nếu Loại đơn hàng != lastmile thì không cần truyền lên destination_address. Hệ thống sẽ lấy địa chỉ của Kho Hậu mãi gần nhất làm địa chỉ giao hàng | { “full_name”: “Dao nguyen”, “phone”: “0909000111”, “email”: “dao.nguyen@gmail.vn“, “region_tiki_code”: “VN039”, “district_tiki_code”: “VN039006”, “ward_tiki_code”: “VN039006002”, “street”: “15 hàng phố”, “address_type”: 1 } | |
note | string | N | |||
tnsl_ref_code | string | N | Mã đổi trả của đối tác TNSL. Required if return_method = TNSL_EXTERNAL Mã này sử dụng 1 lần với CR đang active |
Thông tin địa chỉ: pickup address & destination address
Params | Data Type | Required | Default Value | Description |
---|---|---|---|---|
full_name | String | Y | ||
phone | String | Y | ||
String | N | |||
region_tiki_code | String | Y | Mã tiki code tỉnh / thành phố | |
district_tiki_code | String | Y | Mã tiki code quận / huyện | |
ward_tiki_code | String | Y | Mã tiki code phường xã | |
street | String | Y | ||
address_type | Number | N | 1 | 1: Nhà riêng2: Công ty |
RESPONSE
Params | Type | Required | Description |
---|---|---|---|
code | string | Y | CR Code. Ví dụ: CRV22993281276 |