Page Comparison

1.1、获取邮递服务
1.1.1接口接口说明

1	url	http://test.birdsystem.com/client/delivery-service?consignment_type=LOCAL
2	接口功能	获取邮递服务信息以及邮递服务限制条件
3	支持格式	URL	开发人员
4	请求方式	GET	发布日期

1.1.2请求参数

	参数	必选	类型	说明
1	id	选填	int(4)	邮递服务ID
2	special_type	选填	string(50)	邮递服务特殊类别
3	consignment_type	选填	string(50)	邮递服务所属订单类型
4	status	选填	string（50）	邮递服务所属状态

1.1.3返回字段
1表示为是，0表示为否

	返回字段	字段类型	说明
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	邮递服务当前状态

1.2接口示例
1.2.1接口请求示例
URL:http://test.birdsystem.com/client/delivery-service?id=5217

Code Block

language	xml
title	URL:http://test.birdsystem.com/client/delivery-service?id=5217
linenumbers	true
collapse	true

company_id:{{bs.default_company_id}}
api_key:{{bs.default_api_key}}
id:5217

接口返回示例

Code Block

language	xml
title	http://test.birdsystem.com/client/delivery-service?id=5217接口返回示例
collapse	true

{
    "total": 1,
    "data": [
        {
            "id": 5217,
            "company_id": 36,
            "restrict_max_length_contact": "20",
            "restrict_max_length_address_line1": "20",
            "restrict_max_length_address_line2": "35",
            "restrict_max_length_address_line3": "35",
            "restrict_max_length_post_code": "0",
            "restrict_regex_post_code": null,
            "restrict_regex_telephone": null,
            "name": "飞鸟小包",
            "locale_name": "",
            "is_signature": "0",
            "is_tracking": "0",
            "is_express": "0",
            "is_international": "0",
            "is_customs_required": "0",
            "is_check_post_code": "0",
            "is_check_telephone": "0",
            "is_allow_urgent_consignment": "1",
            "is_hide_delivery_reference_to_consignment": "0",
            "special_type": null,
            "consignment_type": "LOCAL",
            "consignment_notice_enable": "0",
            "consignment_notice": "",
            "status": "ACTIVE"
        }
    ],
    "success": true,
    "moduleName": "client"
}

...

地址: POST http://test.birdsystem.com/client/consignment/Post-Pending-Consignment-With-Products-Json

参数

is_urgent	是否是紧急订单		TINYINT(1)
delivery_service_id	邮递服务ID	必填	INT(4)
sales_reference	销售跟踪号		VARCHAR(50)
sales_reference	销售跟踪号		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)
type	订单类型		'AGENT_DIRECT'
products	产品	必填	包含 id /client_sku/reference 和quantity的json对象例如： [ {"client_sku":”IP-XX3355”,"quantity":5}, {"id":2,"quantity":4}, {"reference":2,"quantity":4} ] 注 id ：飞鸟产品系统id，飞鸟系统自动生成的。 client_sku ：主要是给那些有自己的SKU体系的客户用的。如果传了值就是你们传的，如果没传，系统会自动根据 client_id-id的格式生成。 client_ref： id和sku都可以填，但部分接口不适用，post-pending不适用client_ref参数。 reference是基于客户对批量订单产品字段的设置,　自动识别为ID或者SKU. 对于代理专线订单,　需要传如下格式的产品 (每个字段均是必填): [ {"name":”IP-XX3355”,"name_cn":"中文产品名","quantity":5,"weight":5,"price":5}, ]
parcel_pieces	多包裹信息	可选（如果仅一个包裹时可不用填）	数据结构如下： [ {"weight":500, "length":25, "width":20, "depth":15, "description":"table"}, {"weight":400, "length":22, "width":18, "depth":13, "description":"chair"}, ] 备注：重量为克（g），长度为毫米（mm）
ebay_transaction_id	eBay订单交易号	选填	VARCHAR(50)
ebay_item_no	eBay产品ID	选填	VARCHAR(50)

参数说明

product_customs_property：产品属性性可以用名称，也可以用ID，获取途径如上。 [必填]

...

Versions Compared

Old Version 47

New Version 48

Key

1.1、获取邮递服务
1.1.1接口接口说明

1.1.3返回字段
1表示为是，0表示为否

Page Comparison

Versions Compared

Old Version 47

New Version 48

Key

1.1.3返回字段1表示为是，0表示为否

1.1.3返回字段
1表示为是，0表示为否