Poizon V2 API Documentation

Base URL: https://openapi.dajisaas.com
All Poizon endpoints are under the /poizonV2/ path.

1. Overview & Access

Supported capabilities
Keyword search, product detail, prepaid balance query, order creation & payment, order query, order cancellation, and logistics trace query.

Notes

Poizon access must be activated separately. Contact the platform to enable Poizon for your Access Key before calling any /poizonV2/* endpoint.

All orders are paid with your prepaid balance. Make sure your balance is sufficient before creating an order — you can check it with the Balance Query API. If procurement fails after the order is created, the prepaid amount is refunded.

Recipient addresses must be within Mainland China.

Poizon APIs are pull-based. The platform does not push order or logistics status to your system. Please poll Query Order Info and Query Logistics Trace for updates.

Product search keywords: Chinese keywords go to dwSpuTitle, English keywords go to distSpuTitle. Search results are returned in both Chinese and English.

Signature rules are identical to the other platforms — see API Signature Rules (Sign). No change is required if you already have a working signature implementation.

2. Response Format & Error Handling

2.1 Standard envelope (most APIs)

{
  "code": 200,
  "message": "success",
  "data": { },
  "timestamp": 1756012800000,
  "traceId": "a1b2c3d4e5f6",
  "cost": 235
}

Field	Type	Description
code	integer	`200` means success
message	string	Result description
data	object	Business data
timestamp	integer	Server timestamp, UTC milliseconds
traceId	string	Trace ID — please include it when reporting an issue
cost	integer	Server processing time, in milliseconds

2.2 Simplified envelope (Keyword Search & Product Detail)

These two APIs return a simplified envelope — note the field is msg (not message) and there is no traceId:

{ "code": 200, "msg": "success", "data": { }, "status": 200 }

Each API page states which envelope it uses.

2.3 Error response

Failures return HTTP 400 with a problem-detail body — not the envelope above:

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "40002:order not exist",
  "instance": "/poizonV2/order/cancelOrder"
}

Field	Description
status	HTTP status code
detail	Error detail. For parameter errors: `field:message`. For Poizon business errors: `code:message` passed through from Poizon
instance	The endpoint that was called

Recommended client logic: treat HTTP 2xx + code == 200 as success; on HTTP 400, read detail.

2.4 Common errors

Scenario	Example `detail`
Missing required parameter	`requestId:requestId cannot be empty`
Access Key not activated for Poizon	`site config not found`
Signature failure	`sign verify fail`
Poizon business error	`40002:order not exist`
Insufficient prepaid balance	Passed through from Poizon in `detail`

3. API Reference

Common conventions

appKey is required on every request.

In production, sign the request and pass sign; appSecret is for debugging only.

For POST endpoints, appKey / appSecret / sign go in the JSON body (same as the 1688 and Taobao APIs).

All timestamps are UTC milliseconds.

3.1 Keyword Search

GET /poizonV2/product/queryList
Response format: simplified (code / msg / data / status).

Chinese or English keywords are supported; results contain both Chinese and English.

Query parameters

Name	Type	Required	Description
appKey	string	Y	Daji platform appKey
appSecret	string	N	Secret key, for debugging only. Use `sign` in production
startId	integer	N	Pagination cursor, starts from 0
pageSize	integer	N	Max 50; 20 is recommended for best results
dwSpuTitle	string	N	Chinese keyword
distSpuTitle	string	N	English keyword
dwDesignerId	string	N	Style / article number
distBrandName	array[string]	N	Brand names, 0–200 items
distCategoryl1Name	array[string]	N	Level-1 categories, 0–200 items
distCategoryl2Name	array[string]	N	Level-2 categories, 0–200 items
distCategoryl3Name	array[string]	N	Level-3 categories, 0–200 items
distFitPeopleName	array[string]	N	Target audience, 0–200 items
season	string	N	Season
distStatus	string	N	`PRODUCT_ON` = published, `PRODUCT_OFF` = removed
modifyStartTime	integer	N	Modified from, UTC milliseconds
modifyEndTime	integer	N	Modified to, UTC milliseconds
querySku	boolean	N	Whether to return SKU info
language	string	N	Response language for product content. Defaults to `en`

Response data — data.total, data.spuList[] with dwSpuTitle / distSpuTitle / dwSpuId / image / baseImage / authPrice / categories / season / distStatus / sizeChart / modifyTime / createTime …

3.2 Product Detail

GET /poizonV2/product/queryDetail
Response format: simplified (code / msg / data / status).

Query parameters

Name	Type	Required	Description
appKey	string	Y	Daji platform appKey
appSecret	string	N	Debugging only
dwSpuId	integer	Y	Poizon SPU ID
distSpuId	string	N	Distributor SPU ID
dwDesignerId	string	N	Style / article number
language	string	N	Response language for product content. Defaults to `en`

Response data — SPU fields + data.skuList[] with dwSkuId / minBidPrice / saleAttr[] / skuLink …

minBidPrice is the current lowest bid price and is filled in automatically — you do not need to call a separate price API.

3.3 Create Order & Payment

POST /poizonV2/order/createOrder
Response format: standard.

Creates a new order and pays with your prepaid balance. Once paid, procurement starts. If procurement fails, the prepaid amount is refunded.

requestId is your idempotency key. It is unique and cannot be changed after the order is created — retrying with the same requestId will not create a duplicate order.

Recipient addresses must be within Mainland China.

Check your balance with the Balance Query API before ordering; orders fail if the prepaid balance is insufficient.

Body parameters

Name	Type	Required	Description
appKey	string	Y	Daji AppKey
appSecret	string	N	Debugging only
requestId	string	Y	Unique request ID, 32–64 characters. Idempotency key
shippingAddress	object	Y	Recipient address (Mainland China only)
shippingAddress.name	string	Y	Name
shippingAddress.phone	string	Y	Phone number
shippingAddress.province	string	Y	Province
shippingAddress.city	string	Y	City
shippingAddress.district	string	Y	District
shippingAddress.detailAddress	string	Y	Detailed address
shippingAddress.email	string	N	Email
product	object	Y	Item object
product.dwSpuId	integer	Y	Poizon SPU ID
product.dwSkuId	integer	Y	Poizon SKU ID
product.distSpuId	string	Y	Distributor SPU ID
product.distSkuId	string	Y	Distributor SKU ID
product.quantity	integer	Y	Quantity, 1–5
product.price	integer	Y	Price per item, in cents, currency CNY

Response data

Field	Type	Description
requestId	string	Your unique request ID
customerOrderNo	string	Customer order number — use it for cancel / query / logistics
distOrderNo	string	Main order number
orderItems	array	Sub-order list
orderItems[].distSubOrderNo	string	Sub-order number
orderItems[].orderStatus	string	Order status
orderItems[].dwSkuId	string	Poizon SKU ID
orderItems[].distSkuId	string	Distributor SKU ID
orderItems[].quantity	integer	Quantity
orderItems[].realPayAmount	string	Paid amount
orderItems[].currency	string	Payment currency
orderItems[].createTime	integer	Creation time, UTC milliseconds
orderItems[].modifyTime	integer	Last modified time, UTC milliseconds
orderItems[].failMessage	string	Failure reason, if any

3.4 Query Order Info

POST /poizonV2/order/queryOrderInfo
Response format: standard.

All filters are optional; combine as needed.

Body parameters

Name	Type	Required	Description
appKey	string	Y	Daji AppKey
appSecret	string	N	Debugging only
pageNum	integer	N	Page number
pageSize	integer	N	Page size, 1–200
customerOrderNo	array[string]	N	Customer order numbers, 0–200 items
distOrderNo	array[string]	N	Main order numbers, 0–200 items
distSubOrderNo	array[string]	N	Sub-order numbers, 0–200 items
orderStatus	string	N	`PENDING_PAY` / `PAID` / `SELLER_PENDING_SHIP` / `SELLER_SHIPPED` / `PLATFORM_SHIP` / `COMPLETED` / `FAILED` / `RETURN_GOOD`
dwSkuId	array[string]	N	Poizon SKU IDs, 0–200 items
distSkuId	array[string]	N	Distributor SKU IDs, 0–200 items
trackingNo	array[string]	N	Tracking numbers, 0–200 items
createStartTime	integer	N	Created from, UTC milliseconds
createEndTime	integer	N	Created to, UTC milliseconds
modifyStartTime	integer	N	Modified from, UTC milliseconds
modifyEndTime	integer	N	Modified to, UTC milliseconds

Response data

Field	Type	Description
total	integer	Total order count
orderList	array	Order list
orderList[].id	integer	Record ID
orderList[].customerOrderNo	string	Customer order number
orderList[].distOrderNo	string	Main order number
orderList[].distSubOrderNo	string	Sub-order number
orderList[].orderStatus	string	Order status
orderList[].dwSpuId	string	Poizon SPU ID
orderList[].dwSkuId	string	Poizon SKU ID
orderList[].distSkuId	string	Distributor SKU ID
orderList[].distSpuTitle	string	Product title
orderList[].distBrandName	string	Brand name
orderList[].designerId	string	Style / article number
orderList[].distCategoryl1Name	string	Level-1 category
orderList[].distCategoryl2Name	string	Level-2 category
orderList[].distCategoryl3Name	string	Level-3 category
orderList[].image	string	Product image
orderList[].size	string	Size
orderList[].maxQuantity	integer	Quantity
orderList[].realPayAmount	string	Paid amount
orderList[].currency	string	Currency
orderList[].userName	string	Recipient name
orderList[].userId	string	User ID
orderList[].carrier	string	Carrier (Poizon → buyer)
orderList[].trackingNo	string	Tracking number (Poizon → buyer)
orderList[].headCarrier	string	First-leg carrier
orderList[].headTrackingNo	string	First-leg tracking number
orderList[].fulfillmentMode	string	Fulfillment mode
orderList[].fulfillmentModeDesc	string	Fulfillment mode description
orderList[].returnStatus	integer	Return status
orderList[].returnStatusDesc	string	Return status description
orderList[].reverseItemNo	string	Return item number
orderList[].createTime	integer	Creation time, UTC milliseconds
orderList[].modifyTime	integer	Last modified time, UTC milliseconds

3.5 Cancel Order

POST /poizonV2/order/cancelOrder
Response format: standard.

Submits a cancellation request for an order. Whether the cancellation succeeds depends on the current order status — check failDetailList in the response.

Body parameters

Name	Type	Required	Description
appKey	string	Y	Daji AppKey
appSecret	string	N	Debugging only
customerOrderNo	string	Y	Customer order number returned by Create Order

Response data

Field	Type	Description
successTotal	integer	Number of sub-orders cancelled successfully
failTotal	integer	Number of sub-orders that could not be cancelled
failDetailList	array	Failure details
failDetailList[].id	integer	Sub-order record ID
failDetailList[].failReason	string	Reason for failure

3.6 Query Logistics Trace

POST /poizonV2/order/queryLogisticsTrace
Response format: standard.

Each sub-order may return two legs: the first leg (seller → Poizon warehouse) and the last leg (Poizon → buyer).

Body parameters

Name	Type	Required	Description
appKey	string	Y	Daji AppKey
appSecret	string	N	Debugging only
customerOrderNo	string	Y	Customer order number returned by Create Order

Response data

Field	Type	Description
customerOrderNo	string	Customer order number
distOrderNo	string	Main order number
userName	string	Recipient name
userId	string	User ID
subOrderTraceInfo	array	Trace info per sub-order
subOrderTraceInfo[].distSubOrderNo	string	Sub-order number
subOrderTraceInfo[].dwSkuId	string	Poizon SKU ID
subOrderTraceInfo[].distSkuId	string	Distributor SKU ID
subOrderTraceInfo[].heardLogisticTraceInfo	object	First leg trace (field name is spelled `heard` by the source system — parse it as-is)
subOrderTraceInfo[].tailLogisticTraceInfo	object	Last leg trace

Both trace objects share the same structure:

Field	Type	Description
waybillNo	string	Waybill number
courierName	string	Courier name
courierPhone	string	Courier phone
arrivalTime	string	Arrival time
trackNodeInfos	array	Trace nodes
trackNodeInfos[].node	string	Node code
trackNodeInfos[].opeTitle	string	Node title
trackNodeInfos[].desc	string	Node description
trackNodeInfos[].time	string	Node time
trackNodeInfos[].deliveryDate	string	Delivery date
trackNodeInfos[].location	object	Node location: `province`, `city`, `district`, `siteName`, `longitude`, `latitude`

3.7 Balance Query

GET /poizonV2/prepayment/queryPrepaymentBalance
Response format: standard.

Returns the prepaid balance of your Poizon account. Check it before creating orders.

Query parameters

Name	Type	Required	Description
appKey	string	Y	Daji platform appKey
appSecret	string	N	Debugging only

Response data

Field	Type	Description
imoneyDTO	object	Balance object
imoneyDTO.amount	string	Prepaid balance, string format
imoneyDTO.minUnitVal	integer	Balance in minimum unit (cents)
imoneyDTO.currency	string	Currency

Poizon API Description

Poizon V2 API Documentation#

1. Overview & Access#

2. Response Format & Error Handling#

2.1 Standard envelope (most APIs)#

2.2 Simplified envelope (Keyword Search & Product Detail)#

2.3 Error response#

2.4 Common errors#

3. API Reference#

3.1 Keyword Search#

3.2 Product Detail#

3.3 Create Order & Payment#

3.4 Query Order Info#

3.5 Cancel Order#

3.6 Query Logistics Trace#

3.7 Balance Query#

Poizon V2 API Documentation

1. Overview & Access

2. Response Format & Error Handling

2.1 Standard envelope (most APIs)

2.2 Simplified envelope (Keyword Search & Product Detail)

2.3 Error response

2.4 Common errors

3. API Reference

3.1 Keyword Search

3.2 Product Detail

3.3 Create Order & Payment

3.4 Query Order Info

3.5 Cancel Order

3.6 Query Logistics Trace

3.7 Balance Query