1.2 从临时订单转换成订单
- tuhao
说明
批量订单是为了方便进行一次性处理大量订单而提供的一个创建临时处理订单的接口，通过派分处理任务让系统自动处理临时订单并自动生成本地出库订单
按调用的先后顺序, 有三个接口 上传临时订单 、 处理临时订单 、 查询处理结果
1. 上传临时订单
接口格式
url | http://<系统域名>/client/consignment-upload/Temp-Consignment-Json | ||
接口功能 | 批量添加订单 | ||
支持参数格式 | JSON | 开发人员 |
|
method | POST | 发布日期 |
|
接口参数
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
contact | STRING | 必填 | 联系人 |
business_name | STRING | 选填 | 公司名称 |
name_customs | STRING | 选填 | 产品英文名称 |
address_line1 | STRING | 必填 | 地址行1 |
address_line2 | STRING | 选填 | 地址行2 |
address_line3 | STRING | 选填 | 地址行3 |
city | STRING | 必填 | 城市 |
county | STRING | 选填 | 省/郡 |
post_code | STRING | 必填 | 邮编 |
country_name | STRING | 必填 | 国家名称 |
telephone | STRING | 选填 | 电话号码 |
STRING | 选填 | 电子邮箱 | |
sales_order_id | STRING | 选填 | 销售订单ID, 【yodel 出口必填】 |
payment_reference | STRING | 选填 | 付款凭证 |
special_instruction | STRING | 选填 | 备注1 |
product_company_ref | STRING | 必填 | 以拼接字符串方式提供的多个产品信息, 多个产品以”+”号连接: 产品1*数量||eBay订单交易号||eBay产品ID||平台销售单价+产品2*数量||eBay订单交易号||eBay产品ID||平台销售单价+….. 其中: 产品 必填，详见下文说明
数量 必填
eBay订单交易号 选填
ebay产品ID 选填
平台销售单价 选填例如: 1-1996129*1||ebayid||ebatproduct||18+1996125*1||ebayid2||ebatproduct2||20 选填项可以省略，例如最简单的格式: 1996129*1+1996125*2
其中的产品1,产品2，可以用 产品id/客户sku，由 “设置”->”账户” 中的 批量订单设置来决定:  也支持定向共享产品.其格式： 当设置是系统id时，用 产品来源客人ID#产品ID#D , 例如 11#13756#D
当设置是客户SKU时，用 产品来源客人ID#客户SKU#D , 例如 11#PRRA-1-SG#D |
delivery_service_name | STRING | 选填 | 邮递服务名称 从 邮递服务查询 获取邮递服务列表，只能填写订单类型为LOCAL/DIRECT的服务, 且要与报文中的type字段对应. |
status | STRING | 选填 | 订单状态：PENDING |
type | STRING | 选填 | 订单类型 取值LOCAL或DIRECT, LOCAL是本地订单, DIRECT是专线订单. 默认LOCAL |
thirty_system_id | STRING | 选填 | 第三方系统单号ID. 会在response中返回，以便ERP能将返回数据与其批量提交的数据一一对应 |
custom_identity_reference | STRING | 选填 | 自定义唯一跟踪号 (如果填写了，会进行重复检测，同一批量订单种类同一站点下的订单，6个月内不能有重复的标识， 重复的话会返回: {"success":false,"message":"Duplicate consignment identity reference [....]"}) |
sales_reference | STRING | 选填 | 销售跟踪号 |
sales_price | STRING | 选填 | 销售平台单价 |
omp_name | STRING | 选填 | 销售平台名称，必须是英文 【royal mail，yodel 出口必填】 常见的平台代码如下: wish, Wish
smt, 速卖通
ebay, eBay
amazon, Amazon
lazada, Lazada
dh, 敦煌
jd, 京东
jdid, 京东印尼
cd, Cdiscount
shopify, Shopify
magento, Magento
woocomm, Woocommerce
joom, Joom
shopee, Shopee
tophatter, Tophatter
magento2, Magento2
walmart, Walmart
mymall, MyMall
ueeshop, Ueeshop
shopyy, Shopyy
vova, Vova
kilimall, Kilimall
gogomall, GogoMall
shoplazza, 店匠
gearbest, Gearbest
mercado, Mercado
jumia, Jumia
tiki, Tiki
xshoppy, XShoppy
shopline, Shopline
alibaba, Alibaba
bigcommer, BigCommerce
shopbase, ShopBase
allegro, Allegro
daraz, Daraz
other, 手工订单 |
omp_vat_number | STRING | 选填 | 销售平台VAT号, 【yodel 出口必填】 英国发往非英国且公司不为空（"business_name"字段）的DPD订单必填 |
shipper_eori | STRING | 选填 | 客人的EORI号, 必须是国家代码+12位数字，例如:GB000000777888 ，必须提前在鸟系统备案VAT，详询客服. 参考接口: 获取VAT账号 ，【royal mail，yodel 出口必填】 英国发往EU必填 英国发往非英国的DPD服务必填 |
reason_for_export | STRING | 选填 | 出口原因, 取值【SALE:销售; RETURN REPLACEMENT:退换; GIFT:礼物】【dpd 出口必填】 |
content_type | STRING | 选填 | 包裹类型, 取值【GIFT:礼物; DOCUMENTS:文件; OTHER:其他】【royalmail 出口必填】 |
ioss_vat_number | STRING | 必填 | IOSS号, 发往欧盟国家时必填, 限制填12位字符, 格式: 两位字母+十位数字 |
receiver_eori | STRING | 选填 | 收件人EORI 英国发往非英国且公司不为空（“business_name“字段）的DPD订单必填 |
receiver_pid_number | STRING | 选填 | 收件人个人证件号, 英国发往挪威、西班牙、意大利的DPD订单必填 |
is_compensation_for_delay | BOOL | 选填 | 是否需要晚必赔服务（仅支持部分服务，偏远地区除外）, 取值0或者1, 默认为0 |
接口示例
2. 处理临时订单
接口格式
URL | http://<系统域名>/client/Temp-Consignment-Info/Convert-Into-Consignment/?type=LOCAL&ids=XXX | ||
|---|---|---|---|
接口功能 | 处理批量临时本地订单到正式订单 | ||
支持参数格式 | URL | 开发人员 |
|
请求方式 | GET | 发布日期 |
|
接口参数
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | STRING | 必填 | 订单类型，取值为LOCAL或DIRECT，代表本地订单或专线订单 |
ids | STRING | 选填 | 要处理的临时订单id列表，多个id用下划线分隔；如果不传的话，默认取所有待处理的订单 |
includeProblemConsignments | BOOL | 选填 | 是否包含有问题的订单，传1时表示包括有问题的订单；不传或者传其他值表示忽略有问题的订单 |
接口示例
3. 查询处理结果
接口格式
URL | http://<系统域名>/client/Gearman-background-tasks/Get-Detail?id=xxxx | ||
接口功能 | 查询后台任务处理情况 | ||
支持参数格式 | URL | 开发人员 |
|
请求方式 | GET | 发布日期 |
|
接口参数
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | INT | 选填 | 后台任务ID，为空默认查询所有后台任务 |
接口示例