获取预置信息
创建订单的时候, 需要邮递服务和包裹尺寸, 可以预存到你们系统里, 不经常改变, 不需要每次都请求.
获取邮递服务
地址: GET http://test.birdsystem.com/client/delivery-service?status=ACTIVE
返回
{
"total":2,
"success":true,
"data":[
{
"id": 2667,
"company_id": 36,
"restrict_max_length_contact": "35",
"restrict_max_length_address_line1": "35",
"restrict_max_length_address_line2": "35",
"restrict_max_length_address_line3": "35",
"restrict_max_length_post_code": null,
"restrict_regex_post_code": null,
"restrict_regex_telephone": null,
"name": "代理平邮UK24",
"locale_name": "AGENT UNTRACK UK 24",
"is_signature": "0",
"is_tracking": "0",
"is_express": "0",
"is_international": "0",
"is_customs_required": "0",
"is_check_post_code": "1",
"is_check_telephone": "0",
"is_allow_urgent_consignment": "1",
"is_hide_delivery_reference_to_consignment": "1",
"special_type": "RM2",
"consignment_type": "AGENT_DIRECT",
"consignment_notice_enable": "0",
"consignment_notice": "",
"status": "ACTIVE"
},
{
"id": 2668,
"company_id": 36,
"restrict_max_length_contact": "35",
"restrict_max_length_address_line1": "35",
"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": "代理跟踪UK48",
"locale_name": "AGENT TRACK UK 48",
"is_signature": "0",
"is_tracking": "1",
"is_express": "0",
"is_international": "0",
"is_customs_required": "0",
"is_check_post_code": "1",
"is_check_telephone": "0",
"is_allow_urgent_consignment": "1",
"is_hide_delivery_reference_to_consignment": "1",
"special_type": "RM2",
"consignment_type": "AGENT_DIRECT",
"consignment_notice_enable": "0",
"consignment_notice": "",
"status": "ACTIVE"
}
],
"moduleName":"client"
}
注意 is_hide_delivery_reference_to_consignment 的值为1时，没有跟踪号。
获取可用的产品属性
往代理专线订单添加产品的时候, 需要产品海关属性, 可以预存到你们系统里, 不经常改变, 不需要每次都请求.
接口说明：（无入参）
| URL | http://test.birdsystem.com/client/product-customs-property | ||
|---|---|---|---|
| 接口功能 | 获取产品的海关属性 | ||
| 支持格式 | JSON | 开发人员 | |
| 请求方式 | GET | 发布日期 | |
接口返回示例：
获取指定产品的属性
接口说明：
| URL | http://test.birdsystem.com/client/Product-Customs-Property/Get-All-Label/?product_id=XXX | ||
|---|---|---|---|
| 接口功能 | 获取指定产品的海关属性 | ||
| 支持格式 | JSON | 开发人员 | |
| 请求方式 | GET | 发布日期 | |
参数说明：
| 参数 | 说明 | 类型 |
|---|---|---|
| product_id | 产品ID，即系统sku | INT（10） |
请求示例：
http://test.birdsystem.com/client/Product-Customs-Property/Get-All-Label/?product_id=175191
接口返回示例：----------有问题，查到还是全部的海关属性。
创建订单
地址: POST http://test.birdsystem.com/client/consignment/Post-Pending-Consignment-With-Products-Json
参数 说明
product_customs_property： 产品属性性可以用名称，也可以用ID，获取途径如上。 [必填]
product_name_cn：产品中文名称 ，不填写会影响清关文件 [必填]
sales_price： 订单在销售平台的价格，(不填的话会自动调用产品申报价格)。
sales_reference：需要填写销售跟踪号请自行添加参数 sales_reference, 例如 "sales_reference":"12345"
weight：重量，单位为g [必填]
price_customs_export：海关出口报关价，单位为美元。（用product_name或name、product_name_cn,或name_cn、price_customs_export或 price都可以上传对应的值） [必填]
client_ref：对应客户sku，有传则可配置面单显示此字段，便于拣货。 [必填]
custom_identity_reference：自定义唯一跟踪号，属于排重字段，防止重复订单，填写后会检查同一订单类型下6个月内是否有重复订单，重复则报错提示。
brand：品牌
attachment-url：产品图片URL，传送图片链接供飞鸟质检审核产品（只能传网上的图片，不能传本地的） [必填]
returnLabel：直接对接获取面单参数（只适用于下一个订单的情况）
接口：http://branch.birdsystem.com/client/Consignment/post-Pending-Consignment-With-Products-Json?returnLabel=1&company_id=36&api_key=a0366845436b4775e6c5caef5ebc0d0d
[
{
"delivery_service_id": "5198",
"type":"AGENT_DIRECT",
"business_name": "",
"contact": "Rochelle Kerr",
"address_line1": "23 Portelet Court",
"city": "London",
"county": "London",
"post_code": "N1 5TL",
"country_iso": "GB",
"telephone": "07983-467763-467763",
"custom_identity_reference":"224SF242321",
"line": "1",
"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"
},
{
"product_name": "4apple29",
"product_name_cn":"4苹果29",
"brand":"asd品牌",
"client_ref":"a5456",
"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"
}
]
}
]
line: 创建失败的时候, 会告知是哪一个line出错.
返回
data是创建成功的订单号和跟踪号的键值对 json对象