API create CR for orders from the merchant.
URL
https://api.tikinow.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ả, Xem danh sách mã code tại đây | ||
| 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 |