Ca key (http_api_key)
Send an authentication token in the
x-ca-key
header
to authenticate with the API.
This is the API descriptor for the Nomad Envoy API, responsible for order operation and product lists. Developed by Samarkand Global in partnership with Youzan, LittleRED, PDD, etc. Read the documentation online at Nomad API Suite.
npm install nomad_envoy_cli
pip install nomad-envoy-cli
This is the documentation for version 1.50.0
of the API. Last update on Feb 23, 2023.
https://nomad.samarkand-global.cn/envoy
The API accepts 2 different authentication methods:
Send an authentication token in the
x-ca-key
header
to authenticate with the API.
Send an authentication token in the
x-ca-stage
header
to authenticate with the API.
Create, retrieve and cancel orders
ID of the store.
Order ref of ERP system.
Client order ref of E-commerce platform.
Order status, available options are: WAIT_BUYER_PAY, WAIT_SELLER_SEND_GOODS, WAIT_BUYER_CONFIRM_GOODS, TRADE_SUCCESS, TRADE_CLOSED,TRADE_REFUND, TRADE_FAILED.
Order type, 2 available options: NORMAL, DISTRIBUTION
The time range of order creation, use ISO_8601 format here.
The time range of order update, use ISO_8601 format here.
Page number, between 1 and 1000.
Page size, options: 1, 10, 50, 100.
Success
Debugging information about API invocation
The input of a NomadMapping, usually it's JSON format.
The name of mapping class.
API path
The link of current mapping, usually a url.
Raw data of current HTTP request to the third party server, easy for debug.
The number of requests against the third party in one Nomad request.
The response time of current NomadMapping request, including sub-NomadMapping. The time unit is millisecond.
The response time of current NomadMapping request, including sub-NomadMapping's. The time unit is millisecond. This 'responseTime' is different from the one in ApiResponseConnectorResponse, since our NomadMapping supports spawn mode, whose output will be replaced by its children's instead of its own.
any other return value.
Order ref of ERP system.
Client order ref of E-commerce platform.
Client parent order ref (E-commerce platform)
Client transaction id (E-commerce platform), e.g. PDD for customs purpose payment
Platform name, available options: pdd, youzan, littleredbook, nomad, douyin, checkout.
Declare if current order is a sub order.
Default value is false
.
Declare if current order is a distribution order.
Default value is false
.
Distributor Name
Current order type, could be one of DEFAULT/DISTRIBUTOR/SUPPLIER
Default value is DEFAULT
.
A product in an order
product ID of third parties.
Default name, usually it's Chinese.
English name, should be optional
all SKU in a product
The selling price of current SKU.
recommended retail price
group buying price
tax-free sale price, refer to https://www.voyageone.com/docs/api/v1/7_object_models.html#product#priceCost
Default value is 0
.
Images in a product
The stock level of current SKU in current product.
The default net weight of current SKU. If not present, then switch back to the default value of product
The default gross weight of current SKU. If not present, then switch back to the default value of product
The shipping cost of current SKU. Will overwrite product's.
The days that take to ship and deliver to customer's door. Will overwrite product's.
The model of current sku.
The spec of current sku.
aka customsUnitCodeSKU. The quantity unit code of current sku for customs purpose. Both Chinese or number are ok.
The quantity unit code customs purpose. Declaration Unit, 申报单位.
The weight unit code for customs purpose.
Default value is 035
.
The number of available SKUs.
The number of SKUs in warehouse.
The warehouse where SKUs are stocked.
The currency used in current product, it makes sense if we declare it explicity.
Default value is RMB
.
weight unit in current product.
Default value is Kilogram
.
time unit in current product.
The default selling price of current product.
recommended retail price
group buying price
The default net weight of current product.
The default gross weight of current product.
Images in a product
if a product/sku is on sale.
The status of a product in a store (more like a post) , could be draft/to_check/published/deleted/revoked. This field 'status' has priority over 'is_onsale'
Default value is draft
.
The category of current product, and the platform may or may not require fixed categories data
The name of the product vendor
The country of origin.
How long could we keep current product on the shelf.
The time that when current product was created, and should be ISO 8601 format.
The time that when the last time current product was updated, and should be ISO 8601 format.
logistics mode of current product.
The shipping cost of current product.
The days that take to ship and deliver to customer's door
The Harmonized Commodity Description and Coding System (HS code) of the tariff nomenclature is an international standardised system of names and numbers for the classification of commodities. The HS code system is based on a 6-digit nomenclature.
行邮税。Chinese version of parcel tax
The ingredient of current product.
The model of current product.
The spec of current product.
The warranty period of current product, time unit is day
Default value is 365
.
CC/BC/BBC. CC for free samples, like Temple Spa free samples; BBC for perfume, like Shay & Blue; BC for other products
The default discount price of current product.
The default tax rate of current product.
The brand name of current product
Default value is Other
.
The initial store id this product belongs to
The categoryId, currently required by TOF
It's unit price of current product, but not the total price. And it's the sell price exactly, not original or pre-tax.
It's unit discount of current product
The tax of current product.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The ID of buyer on current E-commerce platform.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
View valid status at get /order query params
package tracking reference.
Proposed by Onion, original Chinese phrase is 三段码.
Proposed by Onion, original Chinese phrase is 集包地.
Logistic companies, e.g. STO, Goldjet.
BC/BBC. BC means business-customer, BBC means business-business-customer, like distribution sell mode.
The currency used in current order, it makes sense if we declare it explicitly.
Default value is RMB
.
海关编号 ZZ:郑州新郑综合保税区;GZ:广州海关;HZ:杭州海关;SH:上海海关
Default value is SH
.
The filing id that returned from Customs
The time when current order was created. ISO_8601 format
The time when current order was updated. ISO_8601 format
The amount of final paid.
The pay number generated by the eCommerce platform such as Youzan
the payment number generated by payment tool such as WeChat Pay
The time when the pay was made. ISO_8601 format
The payment declaration number from customs.
The sum tax of all products in current order, including Non-cash deduction amount.
The shipping cost of current order, excluding the shipping cost on each contained products. If delivery free, just set 0.
The shipping tax of current order. If delivery free, just set 0.
Amount that deducted by non-cash, e.g. member points, virtual currency, voucher code, etc.
The insurance fee of current shipping.
The special note from the buyer.
The URL of delivery slip.
The discount code.
Order ref of ERP system.
Client order ref of E-commerce platform.
Client parent order ref (E-commerce platform)
Client transaction id (E-commerce platform), e.g. PDD for customs purpose payment
Platform name, available options: pdd, youzan, littleredbook, nomad, douyin, checkout.
Declare if current order is a sub order.
Default value is false
.
Declare if current order is a distribution order.
Default value is false
.
Distributor Name
Current order type, could be one of DEFAULT/DISTRIBUTOR/SUPPLIER
Default value is DEFAULT
.
A product in an order
product ID of third parties.
Default name, usually it's Chinese.
English name, should be optional
all SKU in a product
The selling price of current SKU.
recommended retail price
group buying price
tax-free sale price, refer to https://www.voyageone.com/docs/api/v1/7_object_models.html#product#priceCost
Default value is 0
.
Images in a product
The stock level of current SKU in current product.
The default net weight of current SKU. If not present, then switch back to the default value of product
The default gross weight of current SKU. If not present, then switch back to the default value of product
The shipping cost of current SKU. Will overwrite product's.
The days that take to ship and deliver to customer's door. Will overwrite product's.
The model of current sku.
The spec of current sku.
aka customsUnitCodeSKU. The quantity unit code of current sku for customs purpose. Both Chinese or number are ok.
The quantity unit code customs purpose. Declaration Unit, 申报单位.
The weight unit code for customs purpose.
Default value is 035
.
The number of available SKUs.
The number of SKUs in warehouse.
The warehouse where SKUs are stocked.
The currency used in current product, it makes sense if we declare it explicity.
Default value is RMB
.
weight unit in current product.
Default value is Kilogram
.
time unit in current product.
The default selling price of current product.
recommended retail price
group buying price
The default net weight of current product.
The default gross weight of current product.
Images in a product
if a product/sku is on sale.
The status of a product in a store (more like a post) , could be draft/to_check/published/deleted/revoked. This field 'status' has priority over 'is_onsale'
Default value is draft
.
The category of current product, and the platform may or may not require fixed categories data
The name of the product vendor
The country of origin.
How long could we keep current product on the shelf.
The time that when current product was created, and should be ISO 8601 format.
The time that when the last time current product was updated, and should be ISO 8601 format.
logistics mode of current product.
The shipping cost of current product.
The days that take to ship and deliver to customer's door
The Harmonized Commodity Description and Coding System (HS code) of the tariff nomenclature is an international standardised system of names and numbers for the classification of commodities. The HS code system is based on a 6-digit nomenclature.
行邮税。Chinese version of parcel tax
The ingredient of current product.
The model of current product.
The spec of current product.
The warranty period of current product, time unit is day
Default value is 365
.
CC/BC/BBC. CC for free samples, like Temple Spa free samples; BBC for perfume, like Shay & Blue; BC for other products
The default discount price of current product.
The default tax rate of current product.
The brand name of current product
Default value is Other
.
The initial store id this product belongs to
The categoryId, currently required by TOF
It's unit price of current product, but not the total price. And it's the sell price exactly, not original or pre-tax.
It's unit discount of current product
The tax of current product.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The ID of buyer on current E-commerce platform.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
View valid status at get /order query params
package tracking reference.
Proposed by Onion, original Chinese phrase is 三段码.
Proposed by Onion, original Chinese phrase is 集包地.
Logistic companies, e.g. STO, Goldjet.
BC/BBC. BC means business-customer, BBC means business-business-customer, like distribution sell mode.
The currency used in current order, it makes sense if we declare it explicitly.
Default value is RMB
.
海关编号 ZZ:郑州新郑综合保税区;GZ:广州海关;HZ:杭州海关;SH:上海海关
Default value is SH
.
The filing id that returned from Customs
The time when current order was created. ISO_8601 format
The time when current order was updated. ISO_8601 format
The amount of final paid.
The pay number generated by the eCommerce platform such as Youzan
the payment number generated by payment tool such as WeChat Pay
The time when the pay was made. ISO_8601 format
The payment declaration number from customs.
The sum tax of all products in current order, including Non-cash deduction amount.
The shipping cost of current order, excluding the shipping cost on each contained products. If delivery free, just set 0.
The shipping tax of current order. If delivery free, just set 0.
Amount that deducted by non-cash, e.g. member points, virtual currency, voucher code, etc.
The insurance fee of current shipping.
The special note from the buyer.
The URL of delivery slip.
The discount code.
Invalid input
Couldn't get order.
Debugging information about API invocation
The input of a NomadMapping, usually it's JSON format.
The name of mapping class.
API path
The link of current mapping, usually a url.
Raw data of current HTTP request to the third party server, easy for debug.
The number of requests against the third party in one Nomad request.
The response time of current NomadMapping request, including sub-NomadMapping. The time unit is millisecond.
The response time of current NomadMapping request, including sub-NomadMapping's. The time unit is millisecond. This 'responseTime' is different from the one in ApiResponseConnectorResponse, since our NomadMapping supports spawn mode, whose output will be replaced by its children's instead of its own.
any other return value.
Order ref of ERP system.
Client order ref of E-commerce platform.
Client parent order ref (E-commerce platform)
Client transaction id (E-commerce platform), e.g. PDD for customs purpose payment
Platform name, available options: pdd, youzan, littleredbook, nomad, douyin, checkout.
Declare if current order is a sub order.
Default value is false
.
Declare if current order is a distribution order.
Default value is false
.
Distributor Name
Current order type, could be one of DEFAULT/DISTRIBUTOR/SUPPLIER
Default value is DEFAULT
.
A product in an order
product ID of third parties.
Default name, usually it's Chinese.
English name, should be optional
all SKU in a product
The selling price of current SKU.
recommended retail price
group buying price
tax-free sale price, refer to https://www.voyageone.com/docs/api/v1/7_object_models.html#product#priceCost
Default value is 0
.
Images in a product
The stock level of current SKU in current product.
The default net weight of current SKU. If not present, then switch back to the default value of product
The default gross weight of current SKU. If not present, then switch back to the default value of product
The shipping cost of current SKU. Will overwrite product's.
The days that take to ship and deliver to customer's door. Will overwrite product's.
The model of current sku.
The spec of current sku.
aka customsUnitCodeSKU. The quantity unit code of current sku for customs purpose. Both Chinese or number are ok.
The quantity unit code customs purpose. Declaration Unit, 申报单位.
The weight unit code for customs purpose.
Default value is 035
.
The number of available SKUs.
The number of SKUs in warehouse.
The warehouse where SKUs are stocked.
The currency used in current product, it makes sense if we declare it explicity.
Default value is RMB
.
weight unit in current product.
Default value is Kilogram
.
time unit in current product.
The default selling price of current product.
recommended retail price
group buying price
The default net weight of current product.
The default gross weight of current product.
Images in a product
if a product/sku is on sale.
The status of a product in a store (more like a post) , could be draft/to_check/published/deleted/revoked. This field 'status' has priority over 'is_onsale'
Default value is draft
.
The category of current product, and the platform may or may not require fixed categories data
The name of the product vendor
The country of origin.
How long could we keep current product on the shelf.
The time that when current product was created, and should be ISO 8601 format.
The time that when the last time current product was updated, and should be ISO 8601 format.
logistics mode of current product.
The shipping cost of current product.
The days that take to ship and deliver to customer's door
The Harmonized Commodity Description and Coding System (HS code) of the tariff nomenclature is an international standardised system of names and numbers for the classification of commodities. The HS code system is based on a 6-digit nomenclature.
行邮税。Chinese version of parcel tax
The ingredient of current product.
The model of current product.
The spec of current product.
The warranty period of current product, time unit is day
Default value is 365
.
CC/BC/BBC. CC for free samples, like Temple Spa free samples; BBC for perfume, like Shay & Blue; BC for other products
The default discount price of current product.
The default tax rate of current product.
The brand name of current product
Default value is Other
.
The initial store id this product belongs to
The categoryId, currently required by TOF
It's unit price of current product, but not the total price. And it's the sell price exactly, not original or pre-tax.
It's unit discount of current product
The tax of current product.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The ID of buyer on current E-commerce platform.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
View valid status at get /order query params
package tracking reference.
Proposed by Onion, original Chinese phrase is 三段码.
Proposed by Onion, original Chinese phrase is 集包地.
Logistic companies, e.g. STO, Goldjet.
BC/BBC. BC means business-customer, BBC means business-business-customer, like distribution sell mode.
The currency used in current order, it makes sense if we declare it explicitly.
Default value is RMB
.
海关编号 ZZ:郑州新郑综合保税区;GZ:广州海关;HZ:杭州海关;SH:上海海关
Default value is SH
.
The filing id that returned from Customs
The time when current order was created. ISO_8601 format
The time when current order was updated. ISO_8601 format
The amount of final paid.
The pay number generated by the eCommerce platform such as Youzan
the payment number generated by payment tool such as WeChat Pay
The time when the pay was made. ISO_8601 format
The payment declaration number from customs.
The sum tax of all products in current order, including Non-cash deduction amount.
The shipping cost of current order, excluding the shipping cost on each contained products. If delivery free, just set 0.
The shipping tax of current order. If delivery free, just set 0.
Amount that deducted by non-cash, e.g. member points, virtual currency, voucher code, etc.
The insurance fee of current shipping.
The special note from the buyer.
The URL of delivery slip.
The discount code.
Order ref of ERP system.
Client order ref of E-commerce platform.
Client parent order ref (E-commerce platform)
Client transaction id (E-commerce platform), e.g. PDD for customs purpose payment
Platform name, available options: pdd, youzan, littleredbook, nomad, douyin, checkout.
Declare if current order is a sub order.
Default value is false
.
Declare if current order is a distribution order.
Default value is false
.
Distributor Name
Current order type, could be one of DEFAULT/DISTRIBUTOR/SUPPLIER
Default value is DEFAULT
.
A product in an order
product ID of third parties.
Default name, usually it's Chinese.
English name, should be optional
all SKU in a product
The selling price of current SKU.
recommended retail price
group buying price
tax-free sale price, refer to https://www.voyageone.com/docs/api/v1/7_object_models.html#product#priceCost
Default value is 0
.
Images in a product
The stock level of current SKU in current product.
The default net weight of current SKU. If not present, then switch back to the default value of product
The default gross weight of current SKU. If not present, then switch back to the default value of product
The shipping cost of current SKU. Will overwrite product's.
The days that take to ship and deliver to customer's door. Will overwrite product's.
The model of current sku.
The spec of current sku.
aka customsUnitCodeSKU. The quantity unit code of current sku for customs purpose. Both Chinese or number are ok.
The quantity unit code customs purpose. Declaration Unit, 申报单位.
The weight unit code for customs purpose.
Default value is 035
.
The number of available SKUs.
The number of SKUs in warehouse.
The warehouse where SKUs are stocked.
The currency used in current product, it makes sense if we declare it explicity.
Default value is RMB
.
weight unit in current product.
Default value is Kilogram
.
time unit in current product.
The default selling price of current product.
recommended retail price
group buying price
The default net weight of current product.
The default gross weight of current product.
Images in a product
if a product/sku is on sale.
The status of a product in a store (more like a post) , could be draft/to_check/published/deleted/revoked. This field 'status' has priority over 'is_onsale'
Default value is draft
.
The category of current product, and the platform may or may not require fixed categories data
The name of the product vendor
The country of origin.
How long could we keep current product on the shelf.
The time that when current product was created, and should be ISO 8601 format.
The time that when the last time current product was updated, and should be ISO 8601 format.
logistics mode of current product.
The shipping cost of current product.
The days that take to ship and deliver to customer's door
The Harmonized Commodity Description and Coding System (HS code) of the tariff nomenclature is an international standardised system of names and numbers for the classification of commodities. The HS code system is based on a 6-digit nomenclature.
行邮税。Chinese version of parcel tax
The ingredient of current product.
The model of current product.
The spec of current product.
The warranty period of current product, time unit is day
Default value is 365
.
CC/BC/BBC. CC for free samples, like Temple Spa free samples; BBC for perfume, like Shay & Blue; BC for other products
The default discount price of current product.
The default tax rate of current product.
The brand name of current product
Default value is Other
.
The initial store id this product belongs to
The categoryId, currently required by TOF
It's unit price of current product, but not the total price. And it's the sell price exactly, not original or pre-tax.
It's unit discount of current product
The tax of current product.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The ID of buyer on current E-commerce platform.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
View valid status at get /order query params
package tracking reference.
Proposed by Onion, original Chinese phrase is 三段码.
Proposed by Onion, original Chinese phrase is 集包地.
Logistic companies, e.g. STO, Goldjet.
BC/BBC. BC means business-customer, BBC means business-business-customer, like distribution sell mode.
The currency used in current order, it makes sense if we declare it explicitly.
Default value is RMB
.
海关编号 ZZ:郑州新郑综合保税区;GZ:广州海关;HZ:杭州海关;SH:上海海关
Default value is SH
.
The filing id that returned from Customs
The time when current order was created. ISO_8601 format
The time when current order was updated. ISO_8601 format
The amount of final paid.
The pay number generated by the eCommerce platform such as Youzan
the payment number generated by payment tool such as WeChat Pay
The time when the pay was made. ISO_8601 format
The payment declaration number from customs.
The sum tax of all products in current order, including Non-cash deduction amount.
The shipping cost of current order, excluding the shipping cost on each contained products. If delivery free, just set 0.
The shipping tax of current order. If delivery free, just set 0.
Amount that deducted by non-cash, e.g. member points, virtual currency, voucher code, etc.
The insurance fee of current shipping.
The special note from the buyer.
The URL of delivery slip.
The discount code.
curl \
-X GET https://nomad.samarkand-global.cn/envoy/order/samarkand.youzan.test \
-H "x-ca-key: $API_KEY"
{
"code": 42,
"message": "string",
"connectorResponses": [
{
"input": "string",
"mappingName": "GetProductMapping",
"api": [
"string"
],
"apiDocLink": "https://open.pinduoduo.com/#/apidocument/port?portId=pdd.goods.commit.detail.get",
"httpRequestRawData": "-",
"code": 42,
"response": "string",
"responseEn": "string",
"platform": "youzan",
"requestCount": 1,
"responseTime": 1000
}
],
"responseTime": 1000,
"data": {
"returnValue": "string",
"orders": [
{
"orderId": "string",
"clientOrderRef": "string",
"clientParentOrderRef": "string",
"platformTransactionId": "string",
"platformName": "pdd",
"isSubOrder": false,
"isDistributionOrder": false,
"distributorName": "string",
"orderType": "DISTRIBUTOR",
"items": [
{
"product": {
"productId": 123456,
"name": "COLAB Dry Shampoo",
"nameEn": "COLAB Dry Shampoo",
"skus": [
{
"skuNumber": "SMK123",
"price": 10,
"rrp": 8,
"groupBuyingPrice": 6,
"cost": 200,
"images": {
"ids": [
"string"
],
"urls": [
"string"
],
"uploads": [
"string"
]
},
"barcode": 55001234567,
"color": "green",
"size": "small",
"quantity": 10,
"isOnsale": false,
"netWeight": 30.3,
"grossWeight": 35.3,
"shippingCost": 4.2,
"shippingTime": 7,
"model": "iPhone XR",
"spec": "25mm",
"customsUnitCode": "142, 007, 瓶, ...",
"customsUnitCodePackage": "142, 011, 140",
"customsUnitCodeWeight": "035(means 千克, kilogram)",
"availableStock": 6,
"warehouseStock": 6,
"warehouse": "142, 011, 140"
}
],
"currency": "RMB",
"massUnit": "Kilogram",
"timeUnit": "days",
"barcode": 55001234567,
"description": "Some nice dry shampoo for when you cant be bothered to shower",
"price": 7,
"rrp": 8,
"groupBuyingPrice": 6,
"netWeight": 30.3,
"grossWeight": 35.3,
"images": {
"ids": [
"string"
],
"urls": [
"string"
],
"uploads": [
"string"
]
},
"isOnsale": false,
"status": "draft",
"category": [
"All",
"Cloth",
"Top"
],
"vendor": "Apple",
"country": "France",
"shelfLife": 21,
"createdAt": "2019-03-19T08:57:41.133Z",
"updatedAt": "2019-03-19T08:57:41.133Z",
"logisticsMode": "red_auto",
"shippingCost": 4.2,
"shippingTime": 7,
"hsCode": "7606929900",
"personalPostalArticlesTax": "01000000",
"ingredient": "Silk",
"model": "iPhone XR",
"spec": "25mm",
"warrantyPeriod": 180,
"expressType": "string",
"discount": 0,
"taxRate": 0,
"brand": "Nike",
"storeId": "samarkand.xxx",
"categoryId": "12345"
},
"quantity": 4,
"price": 10.1,
"discount": 10.1,
"tax": 1.2
}
],
"customer": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"customerIdRef": "string",
"seller": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"payer": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"status": "string",
"trackingReference": "string",
"destinationCode": "string",
"nodeCode": "string",
"expressCompany": "string",
"expressType": "string",
"currency": "RMB",
"customsCode": "SH",
"customsFilingId": "ABCDE29102918171",
"createdAt": "2019-07-12T13:13:52.004637+01:00",
"updatedAt": "2019-07-12T13:13:52.004637+01:00",
"payMethod": "EASIPAY",
"payMerchantName": "Paypal",
"payAmount": 611.08,
"payId": "2014030120394812",
"paymentPayId": "191028195204000214",
"paidAt": "2019-07-12T13:13:52.004637+01:00",
"payCustomsNo": "190401103508000055101002",
"productsTotalTax": 53.28,
"shippingCost": 25,
"shippingTax": 1,
"nonCashDeductionAmount": 0,
"insuranceFee": 2.5,
"customerNote": "This package is very important.",
"deliverySlipUrl": "string",
"campaignTrackingData": {
"cj_event": "test",
"utm_campaign": "my campaign"
},
"discountCode": "string"
}
],
"order": {
"orderId": "string",
"clientOrderRef": "string",
"clientParentOrderRef": "string",
"platformTransactionId": "string",
"platformName": "pdd",
"isSubOrder": false,
"isDistributionOrder": false,
"distributorName": "string",
"orderType": "DISTRIBUTOR",
"items": [
{
"product": {
"productId": 123456,
"name": "COLAB Dry Shampoo",
"nameEn": "COLAB Dry Shampoo",
"skus": [
{
"skuNumber": "SMK123",
"price": 10,
"rrp": 8,
"groupBuyingPrice": 6,
"cost": 200,
"images": {
"ids": [
"string"
],
"urls": [
"string"
],
"uploads": [
"string"
]
},
"barcode": 55001234567,
"color": "green",
"size": "small",
"quantity": 10,
"isOnsale": false,
"netWeight": 30.3,
"grossWeight": 35.3,
"shippingCost": 4.2,
"shippingTime": 7,
"model": "iPhone XR",
"spec": "25mm",
"customsUnitCode": "142, 007, 瓶, ...",
"customsUnitCodePackage": "142, 011, 140",
"customsUnitCodeWeight": "035(means 千克, kilogram)",
"availableStock": 6,
"warehouseStock": 6,
"warehouse": "142, 011, 140"
}
],
"currency": "RMB",
"massUnit": "Kilogram",
"timeUnit": "days",
"barcode": 55001234567,
"description": "Some nice dry shampoo for when you cant be bothered to shower",
"price": 7,
"rrp": 8,
"groupBuyingPrice": 6,
"netWeight": 30.3,
"grossWeight": 35.3,
"images": {
"ids": [
"string"
],
"urls": [
"string"
],
"uploads": [
"string"
]
},
"isOnsale": false,
"status": "draft",
"category": [
"All",
"Cloth",
"Top"
],
"vendor": "Apple",
"country": "France",
"shelfLife": 21,
"createdAt": "2019-03-19T08:57:41.133Z",
"updatedAt": "2019-03-19T08:57:41.133Z",
"logisticsMode": "red_auto",
"shippingCost": 4.2,
"shippingTime": 7,
"hsCode": "7606929900",
"personalPostalArticlesTax": "01000000",
"ingredient": "Silk",
"model": "iPhone XR",
"spec": "25mm",
"warrantyPeriod": 180,
"expressType": "string",
"discount": 0,
"taxRate": 0,
"brand": "Nike",
"storeId": "samarkand.xxx",
"categoryId": "12345"
},
"quantity": 4,
"price": 10.1,
"discount": 10.1,
"tax": 1.2
}
],
"customer": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"customerIdRef": "string",
"seller": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"payer": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"status": "string",
"trackingReference": "string",
"destinationCode": "string",
"nodeCode": "string",
"expressCompany": "string",
"expressType": "string",
"currency": "RMB",
"customsCode": "SH",
"customsFilingId": "ABCDE29102918171",
"createdAt": "2019-07-12T13:13:52.004637+01:00",
"updatedAt": "2019-07-12T13:13:52.004637+01:00",
"payMethod": "EASIPAY",
"payMerchantName": "Paypal",
"payAmount": 611.08,
"payId": "2014030120394812",
"paymentPayId": "191028195204000214",
"paidAt": "2019-07-12T13:13:52.004637+01:00",
"payCustomsNo": "190401103508000055101002",
"productsTotalTax": 53.28,
"shippingCost": 25,
"shippingTax": 1,
"nonCashDeductionAmount": 0,
"insuranceFee": 2.5,
"customerNote": "This package is very important.",
"deliverySlipUrl": "string",
"campaignTrackingData": {
"cj_event": "test",
"utm_campaign": "my campaign"
},
"discountCode": "string"
},
"orderId": "string"
}
}
{
"code": 42,
"message": "string",
"connectorResponses": [
{
"input": "string",
"mappingName": "GetProductMapping",
"api": [
"string"
],
"apiDocLink": "https://open.pinduoduo.com/#/apidocument/port?portId=pdd.goods.commit.detail.get",
"httpRequestRawData": "-",
"code": 42,
"response": "string",
"responseEn": "string",
"platform": "youzan",
"requestCount": 1,
"responseTime": 1000
}
],
"responseTime": 1000,
"data": {
"returnValue": "string",
"orders": [
{
"orderId": "string",
"clientOrderRef": "string",
"clientParentOrderRef": "string",
"platformTransactionId": "string",
"platformName": "pdd",
"isSubOrder": false,
"isDistributionOrder": false,
"distributorName": "string",
"orderType": "DISTRIBUTOR",
"items": [
{
"product": {
"productId": 123456,
"name": "COLAB Dry Shampoo",
"nameEn": "COLAB Dry Shampoo",
"skus": [
{
"skuNumber": "SMK123",
"price": 10,
"rrp": 8,
"groupBuyingPrice": 6,
"cost": 200,
"images": {
"ids": [
"string"
],
"urls": [
"string"
],
"uploads": [
"string"
]
},
"barcode": 55001234567,
"color": "green",
"size": "small",
"quantity": 10,
"isOnsale": false,
"netWeight": 30.3,
"grossWeight": 35.3,
"shippingCost": 4.2,
"shippingTime": 7,
"model": "iPhone XR",
"spec": "25mm",
"customsUnitCode": "142, 007, 瓶, ...",
"customsUnitCodePackage": "142, 011, 140",
"customsUnitCodeWeight": "035(means 千克, kilogram)",
"availableStock": 6,
"warehouseStock": 6,
"warehouse": "142, 011, 140"
}
],
"currency": "RMB",
"massUnit": "Kilogram",
"timeUnit": "days",
"barcode": 55001234567,
"description": "Some nice dry shampoo for when you cant be bothered to shower",
"price": 7,
"rrp": 8,
"groupBuyingPrice": 6,
"netWeight": 30.3,
"grossWeight": 35.3,
"images": {
"ids": [
"string"
],
"urls": [
"string"
],
"uploads": [
"string"
]
},
"isOnsale": false,
"status": "draft",
"category": [
"All",
"Cloth",
"Top"
],
"vendor": "Apple",
"country": "France",
"shelfLife": 21,
"createdAt": "2019-03-19T08:57:41.133Z",
"updatedAt": "2019-03-19T08:57:41.133Z",
"logisticsMode": "red_auto",
"shippingCost": 4.2,
"shippingTime": 7,
"hsCode": "7606929900",
"personalPostalArticlesTax": "01000000",
"ingredient": "Silk",
"model": "iPhone XR",
"spec": "25mm",
"warrantyPeriod": 180,
"expressType": "string",
"discount": 0,
"taxRate": 0,
"brand": "Nike",
"storeId": "samarkand.xxx",
"categoryId": "12345"
},
"quantity": 4,
"price": 10.1,
"discount": 10.1,
"tax": 1.2
}
],
"customer": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"customerIdRef": "string",
"seller": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"payer": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"status": "string",
"trackingReference": "string",
"destinationCode": "string",
"nodeCode": "string",
"expressCompany": "string",
"expressType": "string",
"currency": "RMB",
"customsCode": "SH",
"customsFilingId": "ABCDE29102918171",
"createdAt": "2019-07-12T13:13:52.004637+01:00",
"updatedAt": "2019-07-12T13:13:52.004637+01:00",
"payMethod": "EASIPAY",
"payMerchantName": "Paypal",
"payAmount": 611.08,
"payId": "2014030120394812",
"paymentPayId": "191028195204000214",
"paidAt": "2019-07-12T13:13:52.004637+01:00",
"payCustomsNo": "190401103508000055101002",
"productsTotalTax": 53.28,
"shippingCost": 25,
"shippingTax": 1,
"nonCashDeductionAmount": 0,
"insuranceFee": 2.5,
"customerNote": "This package is very important.",
"deliverySlipUrl": "string",
"campaignTrackingData": {
"cj_event": "test",
"utm_campaign": "my campaign"
},
"discountCode": "string"
}
],
"order": {
"orderId": "string",
"clientOrderRef": "string",
"clientParentOrderRef": "string",
"platformTransactionId": "string",
"platformName": "pdd",
"isSubOrder": false,
"isDistributionOrder": false,
"distributorName": "string",
"orderType": "DISTRIBUTOR",
"items": [
{
"product": {
"productId": 123456,
"name": "COLAB Dry Shampoo",
"nameEn": "COLAB Dry Shampoo",
"skus": [
{
"skuNumber": "SMK123",
"price": 10,
"rrp": 8,
"groupBuyingPrice": 6,
"cost": 200,
"images": {
"ids": [
"string"
],
"urls": [
"string"
],
"uploads": [
"string"
]
},
"barcode": 55001234567,
"color": "green",
"size": "small",
"quantity": 10,
"isOnsale": false,
"netWeight": 30.3,
"grossWeight": 35.3,
"shippingCost": 4.2,
"shippingTime": 7,
"model": "iPhone XR",
"spec": "25mm",
"customsUnitCode": "142, 007, 瓶, ...",
"customsUnitCodePackage": "142, 011, 140",
"customsUnitCodeWeight": "035(means 千克, kilogram)",
"availableStock": 6,
"warehouseStock": 6,
"warehouse": "142, 011, 140"
}
],
"currency": "RMB",
"massUnit": "Kilogram",
"timeUnit": "days",
"barcode": 55001234567,
"description": "Some nice dry shampoo for when you cant be bothered to shower",
"price": 7,
"rrp": 8,
"groupBuyingPrice": 6,
"netWeight": 30.3,
"grossWeight": 35.3,
"images": {
"ids": [
"string"
],
"urls": [
"string"
],
"uploads": [
"string"
]
},
"isOnsale": false,
"status": "draft",
"category": [
"All",
"Cloth",
"Top"
],
"vendor": "Apple",
"country": "France",
"shelfLife": 21,
"createdAt": "2019-03-19T08:57:41.133Z",
"updatedAt": "2019-03-19T08:57:41.133Z",
"logisticsMode": "red_auto",
"shippingCost": 4.2,
"shippingTime": 7,
"hsCode": "7606929900",
"personalPostalArticlesTax": "01000000",
"ingredient": "Silk",
"model": "iPhone XR",
"spec": "25mm",
"warrantyPeriod": 180,
"expressType": "string",
"discount": 0,
"taxRate": 0,
"brand": "Nike",
"storeId": "samarkand.xxx",
"categoryId": "12345"
},
"quantity": 4,
"price": 10.1,
"discount": 10.1,
"tax": 1.2
}
],
"customer": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"customerIdRef": "string",
"seller": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"payer": {
"firstName": "John",
"lastName": "string",
"address1": "string",
"address2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"tin": "string",
"phone": "string",
"countryCode": "string",
"email": "string",
"age": 42,
"gender": "Female",
"chineseId": "string"
},
"status": "string",
"trackingReference": "string",
"destinationCode": "string",
"nodeCode": "string",
"expressCompany": "string",
"expressType": "string",
"currency": "RMB",
"customsCode": "SH",
"customsFilingId": "ABCDE29102918171",
"createdAt": "2019-07-12T13:13:52.004637+01:00",
"updatedAt": "2019-07-12T13:13:52.004637+01:00",
"payMethod": "EASIPAY",
"payMerchantName": "Paypal",
"payAmount": 611.08,
"payId": "2014030120394812",
"paymentPayId": "191028195204000214",
"paidAt": "2019-07-12T13:13:52.004637+01:00",
"payCustomsNo": "190401103508000055101002",
"productsTotalTax": 53.28,
"shippingCost": 25,
"shippingTax": 1,
"nonCashDeductionAmount": 0,
"insuranceFee": 2.5,
"customerNote": "This package is very important.",
"deliverySlipUrl": "string",
"campaignTrackingData": {
"cj_event": "test",
"utm_campaign": "my campaign"
},
"discountCode": "string"
},
"orderId": "string"
}
}
ID of the store.
Order details
Order ref of ERP system.
Client order ref of E-commerce platform.
Client parent order ref (E-commerce platform)
Client transaction id (E-commerce platform), e.g. PDD for customs purpose payment
Platform name, available options: pdd, youzan, littleredbook, nomad, douyin, checkout.
Declare if current order is a sub order.
Default value is false
.
Declare if current order is a distribution order.
Default value is false
.
Distributor Name
Current order type, could be one of DEFAULT/DISTRIBUTOR/SUPPLIER
Default value is DEFAULT
.
A product in an order
product ID of third parties.
Default name, usually it's Chinese.
English name, should be optional
all SKU in a product
The selling price of current SKU.
recommended retail price
group buying price
tax-free sale price, refer to https://www.voyageone.com/docs/api/v1/7_object_models.html#product#priceCost
Default value is 0
.
Images in a product
The stock level of current SKU in current product.
The default net weight of current SKU. If not present, then switch back to the default value of product
The default gross weight of current SKU. If not present, then switch back to the default value of product
The shipping cost of current SKU. Will overwrite product's.
The days that take to ship and deliver to customer's door. Will overwrite product's.
The model of current sku.
The spec of current sku.
aka customsUnitCodeSKU. The quantity unit code of current sku for customs purpose. Both Chinese or number are ok.
The quantity unit code customs purpose. Declaration Unit, 申报单位.
The weight unit code for customs purpose.
Default value is 035
.
The number of available SKUs.
The number of SKUs in warehouse.
The warehouse where SKUs are stocked.
The currency used in current product, it makes sense if we declare it explicity.
Default value is RMB
.
weight unit in current product.
Default value is Kilogram
.
time unit in current product.
The default selling price of current product.
recommended retail price
group buying price
The default net weight of current product.
The default gross weight of current product.
Images in a product
if a product/sku is on sale.
The status of a product in a store (more like a post) , could be draft/to_check/published/deleted/revoked. This field 'status' has priority over 'is_onsale'
Default value is draft
.
The category of current product, and the platform may or may not require fixed categories data
The name of the product vendor
The country of origin.
How long could we keep current product on the shelf.
The time that when current product was created, and should be ISO 8601 format.
The time that when the last time current product was updated, and should be ISO 8601 format.
logistics mode of current product.
The shipping cost of current product.
The days that take to ship and deliver to customer's door
The Harmonized Commodity Description and Coding System (HS code) of the tariff nomenclature is an international standardised system of names and numbers for the classification of commodities. The HS code system is based on a 6-digit nomenclature.
行邮税。Chinese version of parcel tax
The ingredient of current product.
The model of current product.
The spec of current product.
The warranty period of current product, time unit is day
Default value is 365
.
CC/BC/BBC. CC for free samples, like Temple Spa free samples; BBC for perfume, like Shay & Blue; BC for other products
The default discount price of current product.
The default tax rate of current product.
The brand name of current product
Default value is Other
.
The initial store id this product belongs to
The categoryId, currently required by TOF
It's unit price of current product, but not the total price. And it's the sell price exactly, not original or pre-tax.
It's unit discount of current product
The tax of current product.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The ID of buyer on current E-commerce platform.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
View valid status at get /order query params
package tracking reference.
Proposed by Onion, original Chinese phrase is 三段码.
Proposed by Onion, original Chinese phrase is 集包地.
Logistic companies, e.g. STO, Goldjet.
BC/BBC. BC means business-customer, BBC means business-business-customer, like distribution sell mode.
The currency used in current order, it makes sense if we declare it explicitly.
Default value is RMB
.
海关编号 ZZ:郑州新郑综合保税区;GZ:广州海关;HZ:杭州海关;SH:上海海关
Default value is SH
.
The filing id that returned from Customs
The time when current order was created. ISO_8601 format
The time when current order was updated. ISO_8601 format
The amount of final paid.
The pay number generated by the eCommerce platform such as Youzan
the payment number generated by payment tool such as WeChat Pay
The time when the pay was made. ISO_8601 format
The payment declaration number from customs.
The sum tax of all products in current order, including Non-cash deduction amount.
The shipping cost of current order, excluding the shipping cost on each contained products. If delivery free, just set 0.
The shipping tax of current order. If delivery free, just set 0.
Amount that deducted by non-cash, e.g. member points, virtual currency, voucher code, etc.
The insurance fee of current shipping.
The special note from the buyer.
The URL of delivery slip.
The discount code.
Success
Debugging information about API invocation
The input of a NomadMapping, usually it's JSON format.
The name of mapping class.
API path
The link of current mapping, usually a url.
Raw data of current HTTP request to the third party server, easy for debug.
The number of requests against the third party in one Nomad request.
The response time of current NomadMapping request, including sub-NomadMapping. The time unit is millisecond.
The response time of current NomadMapping request, including sub-NomadMapping's. The time unit is millisecond. This 'responseTime' is different from the one in ApiResponseConnectorResponse, since our NomadMapping supports spawn mode, whose output will be replaced by its children's instead of its own.
any other return value.
Order ref of ERP system.
Client order ref of E-commerce platform.
Client parent order ref (E-commerce platform)
Client transaction id (E-commerce platform), e.g. PDD for customs purpose payment
Platform name, available options: pdd, youzan, littleredbook, nomad, douyin, checkout.
Declare if current order is a sub order.
Default value is false
.
Declare if current order is a distribution order.
Default value is false
.
Distributor Name
Current order type, could be one of DEFAULT/DISTRIBUTOR/SUPPLIER
Default value is DEFAULT
.
A product in an order
product ID of third parties.
Default name, usually it's Chinese.
English name, should be optional
all SKU in a product
The selling price of current SKU.
recommended retail price
group buying price
tax-free sale price, refer to https://www.voyageone.com/docs/api/v1/7_object_models.html#product#priceCost
Default value is 0
.
Images in a product
The stock level of current SKU in current product.
The default net weight of current SKU. If not present, then switch back to the default value of product
The default gross weight of current SKU. If not present, then switch back to the default value of product
The shipping cost of current SKU. Will overwrite product's.
The days that take to ship and deliver to customer's door. Will overwrite product's.
The model of current sku.
The spec of current sku.
aka customsUnitCodeSKU. The quantity unit code of current sku for customs purpose. Both Chinese or number are ok.
The quantity unit code customs purpose. Declaration Unit, 申报单位.
The weight unit code for customs purpose.
Default value is 035
.
The number of available SKUs.
The number of SKUs in warehouse.
The warehouse where SKUs are stocked.
The currency used in current product, it makes sense if we declare it explicity.
Default value is RMB
.
weight unit in current product.
Default value is Kilogram
.
time unit in current product.
The default selling price of current product.
recommended retail price
group buying price
The default net weight of current product.
The default gross weight of current product.
Images in a product
if a product/sku is on sale.
The status of a product in a store (more like a post) , could be draft/to_check/published/deleted/revoked. This field 'status' has priority over 'is_onsale'
Default value is draft
.
The category of current product, and the platform may or may not require fixed categories data
The name of the product vendor
The country of origin.
How long could we keep current product on the shelf.
The time that when current product was created, and should be ISO 8601 format.
The time that when the last time current product was updated, and should be ISO 8601 format.
logistics mode of current product.
The shipping cost of current product.
The days that take to ship and deliver to customer's door
The Harmonized Commodity Description and Coding System (HS code) of the tariff nomenclature is an international standardised system of names and numbers for the classification of commodities. The HS code system is based on a 6-digit nomenclature.
行邮税。Chinese version of parcel tax
The ingredient of current product.
The model of current product.
The spec of current product.
The warranty period of current product, time unit is day
Default value is 365
.
CC/BC/BBC. CC for free samples, like Temple Spa free samples; BBC for perfume, like Shay & Blue; BC for other products
The default discount price of current product.
The default tax rate of current product.
The brand name of current product
Default value is Other
.
The initial store id this product belongs to
The categoryId, currently required by TOF
It's unit price of current product, but not the total price. And it's the sell price exactly, not original or pre-tax.
It's unit discount of current product
The tax of current product.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The ID of buyer on current E-commerce platform.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
View valid status at get /order query params
package tracking reference.
Proposed by Onion, original Chinese phrase is 三段码.
Proposed by Onion, original Chinese phrase is 集包地.
Logistic companies, e.g. STO, Goldjet.
BC/BBC. BC means business-customer, BBC means business-business-customer, like distribution sell mode.
The currency used in current order, it makes sense if we declare it explicitly.
Default value is RMB
.
海关编号 ZZ:郑州新郑综合保税区;GZ:广州海关;HZ:杭州海关;SH:上海海关
Default value is SH
.
The filing id that returned from Customs
The time when current order was created. ISO_8601 format
The time when current order was updated. ISO_8601 format
The amount of final paid.
The pay number generated by the eCommerce platform such as Youzan
the payment number generated by payment tool such as WeChat Pay
The time when the pay was made. ISO_8601 format
The payment declaration number from customs.
The sum tax of all products in current order, including Non-cash deduction amount.
The shipping cost of current order, excluding the shipping cost on each contained products. If delivery free, just set 0.
The shipping tax of current order. If delivery free, just set 0.
Amount that deducted by non-cash, e.g. member points, virtual currency, voucher code, etc.
The insurance fee of current shipping.
The special note from the buyer.
The URL of delivery slip.
The discount code.
Order ref of ERP system.
Client order ref of E-commerce platform.
Client parent order ref (E-commerce platform)
Client transaction id (E-commerce platform), e.g. PDD for customs purpose payment
Platform name, available options: pdd, youzan, littleredbook, nomad, douyin, checkout.
Declare if current order is a sub order.
Default value is false
.
Declare if current order is a distribution order.
Default value is false
.
Distributor Name
Current order type, could be one of DEFAULT/DISTRIBUTOR/SUPPLIER
Default value is DEFAULT
.
A product in an order
product ID of third parties.
Default name, usually it's Chinese.
English name, should be optional
all SKU in a product
The selling price of current SKU.
recommended retail price
group buying price
tax-free sale price, refer to https://www.voyageone.com/docs/api/v1/7_object_models.html#product#priceCost
Default value is 0
.
Images in a product
The stock level of current SKU in current product.
The default net weight of current SKU. If not present, then switch back to the default value of product
The default gross weight of current SKU. If not present, then switch back to the default value of product
The shipping cost of current SKU. Will overwrite product's.
The days that take to ship and deliver to customer's door. Will overwrite product's.
The model of current sku.
The spec of current sku.
aka customsUnitCodeSKU. The quantity unit code of current sku for customs purpose. Both Chinese or number are ok.
The quantity unit code customs purpose. Declaration Unit, 申报单位.
The weight unit code for customs purpose.
Default value is 035
.
The number of available SKUs.
The number of SKUs in warehouse.
The warehouse where SKUs are stocked.
The currency used in current product, it makes sense if we declare it explicity.
Default value is RMB
.
weight unit in current product.
Default value is Kilogram
.
time unit in current product.
The default selling price of current product.
recommended retail price
group buying price
The default net weight of current product.
The default gross weight of current product.
Images in a product
if a product/sku is on sale.
The status of a product in a store (more like a post) , could be draft/to_check/published/deleted/revoked. This field 'status' has priority over 'is_onsale'
Default value is draft
.
The category of current product, and the platform may or may not require fixed categories data
The name of the product vendor
The country of origin.
How long could we keep current product on the shelf.
The time that when current product was created, and should be ISO 8601 format.
The time that when the last time current product was updated, and should be ISO 8601 format.
logistics mode of current product.
The shipping cost of current product.
The days that take to ship and deliver to customer's door
The Harmonized Commodity Description and Coding System (HS code) of the tariff nomenclature is an international standardised system of names and numbers for the classification of commodities. The HS code system is based on a 6-digit nomenclature.
行邮税。Chinese version of parcel tax
The ingredient of current product.
The model of current product.
The spec of current product.
The warranty period of current product, time unit is day
Default value is 365
.
CC/BC/BBC. CC for free samples, like Temple Spa free samples; BBC for perfume, like Shay & Blue; BC for other products
The default discount price of current product.
The default tax rate of current product.
The brand name of current product
Default value is Other
.
The initial store id this product belongs to
The categoryId, currently required by TOF
It's unit price of current product, but not the total price. And it's the sell price exactly, not original or pre-tax.
It's unit discount of current product
The tax of current product.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The ID of buyer on current E-commerce platform.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
View valid status at get /order query params
package tracking reference.
Proposed by Onion, original Chinese phrase is 三段码.
Proposed by Onion, original Chinese phrase is 集包地.
Logistic companies, e.g. STO, Goldjet.
BC/BBC. BC means business-customer, BBC means business-business-customer, like distribution sell mode.
The currency used in current order, it makes sense if we declare it explicitly.
Default value is RMB
.
海关编号 ZZ:郑州新郑综合保税区;GZ:广州海关;HZ:杭州海关;SH:上海海关
Default value is SH
.
The filing id that returned from Customs
The time when current order was created. ISO_8601 format
The time when current order was updated. ISO_8601 format
The amount of final paid.
The pay number generated by the eCommerce platform such as Youzan
the payment number generated by payment tool such as WeChat Pay
The time when the pay was made. ISO_8601 format
The payment declaration number from customs.
The sum tax of all products in current order, including Non-cash deduction amount.
The shipping cost of current order, excluding the shipping cost on each contained products. If delivery free, just set 0.
The shipping tax of current order. If delivery free, just set 0.
Amount that deducted by non-cash, e.g. member points, virtual currency, voucher code, etc.
The insurance fee of current shipping.
The special note from the buyer.
The URL of delivery slip.
The discount code.
Invalid input
Order creation failed.
Debugging information about API invocation
The input of a NomadMapping, usually it's JSON format.
The name of mapping class.
API path
The link of current mapping, usually a url.
Raw data of current HTTP request to the third party server, easy for debug.
The number of requests against the third party in one Nomad request.
The response time of current NomadMapping request, including sub-NomadMapping. The time unit is millisecond.
The response time of current NomadMapping request, including sub-NomadMapping's. The time unit is millisecond. This 'responseTime' is different from the one in ApiResponseConnectorResponse, since our NomadMapping supports spawn mode, whose output will be replaced by its children's instead of its own.
any other return value.
Order ref of ERP system.
Client order ref of E-commerce platform.
Client parent order ref (E-commerce platform)
Client transaction id (E-commerce platform), e.g. PDD for customs purpose payment
Platform name, available options: pdd, youzan, littleredbook, nomad, douyin, checkout.
Declare if current order is a sub order.
Default value is false
.
Declare if current order is a distribution order.
Default value is false
.
Distributor Name
Current order type, could be one of DEFAULT/DISTRIBUTOR/SUPPLIER
Default value is DEFAULT
.
A product in an order
product ID of third parties.
Default name, usually it's Chinese.
English name, should be optional
all SKU in a product
The selling price of current SKU.
recommended retail price
group buying price
tax-free sale price, refer to https://www.voyageone.com/docs/api/v1/7_object_models.html#product#priceCost
Default value is 0
.
Images in a product
The stock level of current SKU in current product.
The default net weight of current SKU. If not present, then switch back to the default value of product
The default gross weight of current SKU. If not present, then switch back to the default value of product
The shipping cost of current SKU. Will overwrite product's.
The days that take to ship and deliver to customer's door. Will overwrite product's.
The model of current sku.
The spec of current sku.
aka customsUnitCodeSKU. The quantity unit code of current sku for customs purpose. Both Chinese or number are ok.
The quantity unit code customs purpose. Declaration Unit, 申报单位.
The weight unit code for customs purpose.
Default value is 035
.
The number of available SKUs.
The number of SKUs in warehouse.
The warehouse where SKUs are stocked.
The currency used in current product, it makes sense if we declare it explicity.
Default value is RMB
.
weight unit in current product.
Default value is Kilogram
.
time unit in current product.
The default selling price of current product.
recommended retail price
group buying price
The default net weight of current product.
The default gross weight of current product.
Images in a product
if a product/sku is on sale.
The status of a product in a store (more like a post) , could be draft/to_check/published/deleted/revoked. This field 'status' has priority over 'is_onsale'
Default value is draft
.
The category of current product, and the platform may or may not require fixed categories data
The name of the product vendor
The country of origin.
How long could we keep current product on the shelf.
The time that when current product was created, and should be ISO 8601 format.
The time that when the last time current product was updated, and should be ISO 8601 format.
logistics mode of current product.
The shipping cost of current product.
The days that take to ship and deliver to customer's door
The Harmonized Commodity Description and Coding System (HS code) of the tariff nomenclature is an international standardised system of names and numbers for the classification of commodities. The HS code system is based on a 6-digit nomenclature.
行邮税。Chinese version of parcel tax
The ingredient of current product.
The model of current product.
The spec of current product.
The warranty period of current product, time unit is day
Default value is 365
.
CC/BC/BBC. CC for free samples, like Temple Spa free samples; BBC for perfume, like Shay & Blue; BC for other products
The default discount price of current product.
The default tax rate of current product.
The brand name of current product
Default value is Other
.
The initial store id this product belongs to
The categoryId, currently required by TOF
It's unit price of current product, but not the total price. And it's the sell price exactly, not original or pre-tax.
It's unit discount of current product
The tax of current product.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The ID of buyer on current E-commerce platform.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
The address that current order will be delivered.
Taxpayer identification number, including Chinese ID. https://www.gov.uk/hmrc-internal-manuals/international-exchange-of-information/ieim402040
missing
Gender identity.
Values are Female
, Male
, or Custom
.
Chinese ID card. Deprecated, use 'tin' instead.
View valid status at get /order query params
package tracking reference.
Proposed by Onion, original Chinese phrase is 三段码.
Proposed by Onion, original Chinese phrase is 集包地.
Logistic companies, e.g. STO, Goldjet.
BC/BBC. BC means business-customer, BBC means business-business-customer, like distribution sell mode.
The currency used in current order, it makes sense if we declare it explicitly.
Default value is RMB
.
海关编号 ZZ:郑州新郑综合保税区;GZ:广州海关;HZ:杭州海关;SH:上海海关
Default value is SH
.
The filing id that returned from Customs
The time when current order was created. ISO_8601 format
The time when current order was updated. ISO_8601 format
The amount of final paid.
The pay number generated by the eCommerce platform such as Youzan
the payment number generated by payment tool such as WeChat Pay
The time when the pay was made. ISO_8601 format
The payment declaration number from customs.
The sum tax of all products in current order, including Non-cash deduction amount.
The shipping cost of current order, excluding the shipping cost on each contained products. If delivery free, just set 0.
The shipping tax of current order. If delivery free, just set 0.
Amount that deducted by non-cash, e.g. member points, virtual currency, voucher code, etc.
The insurance fee of current shipping.
The special note from the buyer.
The URL of delivery slip.
The discount code.
Order ref of ERP system.
Client order ref of E-commerce platform.
Client parent order ref (E-commerce platform)
Client transaction id (E-commerce platform), e.g. PDD for customs purpose payment
Platform name, available options: pdd, youzan, littleredbook, nomad, douyin, checkout.
Declare if current order is a sub order.
Default value is false
.
Declare if current order is a distribution order.
Default value is false
.
Distributor Name
Current order type, could be one of DEFAULT/DISTRIBUTOR/SUPPLIER
Default value is DEFAULT
.
A product in an order
product ID of third parties.
Default name, usually it's Chinese.
English name, should be optional
all SKU in a product
The selling price of current SKU.
recommended retail price
group buying price
tax-free sale price, refer to https://www.voyageone.com/docs/api/v1/7_object_models.html#product#priceCost
Default value is 0
.
Images in a product
The stock level of current SKU in current product.
The default net weight of current SKU. If not present, then switch back to the default value of product
The default gross weight of current SKU. If not present, then switch back to the default value of product
The shipping cost of current SKU. Will overwrite product's.
The days that take to ship and deliver to customer's door. Will overwrite product's.
The model of current sku.
The spec of current sku.
aka customsUnitCodeSKU. The quantity unit code of current sku for customs purpose. Both Chinese or number are ok.
The quantity unit code customs purpose. Declaration Unit, 申报单位.
The weight unit code for customs purpose.
Default value is 035
.
The number of available SKUs.
The number of SKUs in warehouse.
The warehouse where SKUs are stocked.
The currency used in current product, it makes sense if we declare it explicity.
Default value is RMB
.
weight unit in current product.
Default value is Kilogram
.
time unit in current product.
The default selling price of current product.