接口说明

批量创建代理专线订单接口

URL	http://test.birdsystem.com/client/consignment/Post-Pending-Consignment-With-Products-Json
接口功能	批量创建代理专线订单
支持格式	JSON	开发人员
请求方式	POST	发布日期

请求参数

参数ee参数

参数

说明

是否必填

类型

is_urgent

是否是紧急订单

TINYINT(1)

delivery_service_id

邮递服务ID

必填

INT(4)

sales_reference

销售跟踪号

VARCHAR(50)

sales_order_id

销售订单号

VARCHAR(50)

custom_identity_reference

自定义惟一标识

(注: 如果填写了，会进行检测，同一种类型同一站点下的订单，6个月内不能有重复的标识)

重复的话会返回: {"success":false,"message":"Duplicate consignment identity reference [....]"}

VARCHAR(50)

contact

联系人

必填

VARCHAR(100)

business_name

公司

VARCHAR(255)

address_line1

地址行1

VARCHAR(100)

address_line2

地址行2

VARCHAR(100)

address_line3

地址行3

VARCHAR(100)

city

城市

VARCHAR(50)

county

省/郡

VARCHAR(50)

post_code

邮编

VARCHAR(10)

country_iso

国家

必填

CHAR(2)

telephone

电话

VARCHAR(50)

email

电子邮件

VARCHAR(255)

special_instruction

备注1

VARCHAR(255)

type

订单类型

'AGENT_DIRECT'

products

产品

必填

包含
字段详情查看产品接口

id /client_sku/reference 和quantity的json对象例如：
请求参数

Code Block

language	xml

   "products":[
           {
            "product_name": "3apple29",
            "product_name_cn":"3苹果29",
            "brand":"asd品牌",
            "client_ref":"a4624",
            "price_customs_export": "3",
            "sales_price":"10",
            "weight": "300",
            "quantity": "1",
            "product_customs_property":["其它"],
            "attachment-url":"http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg"
           }
        ]

parcel_pieces

多包裹信息

（如果仅一个包裹时可不用填）

数据结构如下：

[

{"weight":500, "length":25, "width":20, "depth":15, "description":"table"},

{"weight":400, "length":22, "width":18, "depth":13, "description":"chair"},

]

备注：重量为克（g），长度为毫米（mm）

payment_reference

付款凭证

string

temp_consignment_info_id

临时订单号批量订单ID

int

返回字段

返回字段	字段类型	说明
success	int	返回结果状态。true：正常，false：失败
id	int	订单ID
company_id	int	公司ID
client_id	int	客户ID
warehouse_id	int	仓库ID
consignment_product_quantity	int	订单产品数量
consignment_product_reference	int	产品英文名称
delivery_service_id	int	邮递服务ID
delivery_service_id_internal	int	内部邮递服务
delivery_package_size_id	int	包装尺寸
total_price	int	产品总价格
total_delivery_fee	int	邮递服务费用
total_handling_fee	int	手续费
length	int	长
width	int	宽
depth	int	高
total_weight	int	总重量
total_volume	int	总体积
total_volume_weight	int	总体积重
total_fee_weight	int	计费重
guarantee_percentage	int
contact	string	联系人
business_name	string	公司名称
address_line1	string	地址行1
address_line2	string	地址行2
address_line3	string	地址行3
city	string	城市
county	string	省/郡
post_code	string	邮编
country_iso	string	国家简称
telephone	int	电话
email	string	邮箱
sender_contact	string	发件人
sender_business_name	string	发件人公司名称
sender_address_line1	string	发件人地址行1
sender_address_line2	string	发件人地址行2
sender_address_line3	string	发件人地址行3
sender_city	string	发件人城市
sender_county	string	发件人省/郡
sender_post_code	int	发件人邮编
sender_country_iso	string	发件人国家简称
sender_email	string	发件人邮箱
sender_telephone	string	发件人电话
sales_reference	string	销售跟踪号
sales_price	int	销售价格
customs_price	int	报关价格
custom_identity_reference	string	自定义唯一跟踪号
sales_order_id	string	销售订单号
payment_reference	string	付款凭证
delivery_reference	string	运输跟踪号
tracking_reference	string	17tarck跟踪号
special_instruction	string	备注1
neighbour_instruction	string	备注2
temp_consignment_info_id	int	临时订单号
is_urgent	int	是否为紧急订单，1：是，0：否
is_forced_delivery_service	int	是否强制选择一种邮递服务
create_time	string	创建时间
finish_time	string	完成时间
arrive_time	string	抵达时间
update_time	string	更新时间
type	string	订单类型
status	string	订单状态
stock_status	string	库存状态
is_hide_delivery_reference_to_consignment	string	是否隐藏订单运输跟踪号
delivery_service_is_signature	string	邮递服务是否签名服务
delivery_service_is_tracking	string	邮递服务是否跟踪服务

接口示例

接口请求示例

地址：https://test.birdsystem.co.uk/client/consignment/post-pending-consignment-with-products-json

Code Block

language	xml
linenumbers	true
collapse	true

{
	"company_id":"{{bs.default_company_id}}"，
	"api_key":"{{bs.default_api_key}}"
}

...

	返回字段	字段类型	说明
1	id	int	邮递服务ID
2	company_id	int	站点ID
3	restrict_max_length_contact	int	联系人最大长度
4	restrict_max_length_address_line1	int	地址行1最大长度
5	restrict_max_length_address_line2	int	地址行2最大长度
6	restrict_max_length_address_line3	int	地址行3最大长度
7	restrict_max_length_post_code	int	邮编最大长度
8	restrict_regex_post_code	string	邮编正则表达式
9	restrict_regex_telephone	string	电话正则表达式
10	name	string	邮递服务名称
11	locale_name	string	本地名称（当地区域语言）
12	is_signature	int（1或0）布尔值	是否签名服务()
13	is_tracking	int（1或0）布尔值	是否跟踪服务
14	is_express	int（1或0）布尔值	是否为快递
15	is_international	int（1或0）布尔值	是否为国际服务
16	is_customs_required	int（1或0）布尔值	是否需要报关
17	is_check_post_code	int（1或0）布尔值	是否检查邮编正确性
18	is_check_telephone	int（1或0）布尔值	是否检查电话正确性
19	is_allow_urgent_consignment	int（1或0）布尔值	是否允许设置紧急订单
20	is_hide_delivery_reference_to_consignment	int（1或0）布尔值	是否隐藏订单运输跟踪号
21	special_type	string	邮递服务特殊类别
22	consignment_type	string	邮递服务所属订单类型
23	consignment_notice_enable	int（1或0）布尔值	是否开启下单提示
24	consignment_notice	status	下单提示
25	status	string	邮递服务当前状态

...

Versions Compared

Old Version 64

New Version 65

Key

接口说明

请求参数

返回字段

接口示例

接口请求示例

Page Comparison

Versions Compared

Old Version 64

New Version 65

Key

请求参数

返回字段

接口示例

接口请求示例