创建订单
地址: POST http://test.birdsystem.com/client/consignment/Post-Pending-Consignment-With-Products-Json
参数 |
|
"success": true,
"data": [
{
"id": 2012010010000334,
"company_id": 1,
"client_id": 4790,
"warehouse_id": null,
"consignment_product_quantity": "1",
"consignment_product_reference": "3apple29",
"delivery_service_id": 5947,
"delivery_service_id_internal": 5947,
"delivery_package_size_id": 1,
"total_price": "0.00",
"total_delivery_fee": "0.00",
"total_handling_fee": "0.10",
"length": "0.00",
"width": "0.00",
"depth": "0.00",
"total_weight": "300.00",
"total_volume": "0.00",
"total_volume_weight": "0.0000",
"total_fee_weight": "300.0000",
"guarantee_percentage": "0.00",
"contact": "Norman Drury",
"business_name": null,
"address_line1": "3, Northam Close",
"address_line2": "Marshside",
"address_line3": null,
"city": "Southport",
"county": "Merseyside",
"post_code": "PR9 9GA",
"country_iso": "GB",
"telephone": "01704 226830",
"email": "mm",
"sender_contact": null,
"sender_business_name": null,
"sender_address_line1": null,
"sender_address_line2": null,
"sender_address_line3": null,
"sender_city": null,
"sender_county": null,
"sender_post_code": null,
"sender_country_iso": null,
"sender_email": null,
"sender_telephone": null,
"sales_reference": "2",
"sales_price": "0.000",
"customs_price": "3.000",
"custom_identity_reference": null,
"sales_order_id": "110222319566-0",
"payment_reference": null,
"delivery_reference": null,
"tracking_reference": null,
"special_instruction": "mm",
"neighbour_instruction": null,
"temp_consignment_info_id": null,
"is_urgent": "0",
"is_forced_delivery_service": "0",
"create_time": "2020-12-01 15:16:23",
"finish_time": "2020-12-01 15:16:24",
"arrive_time": null,
"update_time": "2020-12-01 15:16:24",
"type": "AGENT_DIRECT",
"status": "FINISHED",
"stock_status": "ONLY_ORI_STOCK_ENOUGH",
"is_hide_delivery_reference_to_consignment": "0",
"delivery_service_is_signature": "0",
"delivery_service_is_tracking": "1"
}
],
"moduleName": "client"
}
line: 创建失败的时候, 会告知是哪一个line出错.
返回
data是创建成功的订单号和跟踪号的键值对 json对象
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接口示例
接口请求示例
URL:http://test.birdsystem.com/client/delivery-service?id=5217
company_id:{{bs.default_company_id}}
api_key:{{bs.default_api_key}}
id:5217
接口返回示例
2查询可用产品属性
2.1.1、接口
| url | http://test.birdsystem.com/client/product-customs-property | ||
|---|---|---|---|
| 接口功能 | 查询可用产品属性 | ||
| 支持格式 | JSON | 开发人员 | |
| 请求方式 | GET | 发布时间 | |
2.1.2、请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| id | 选填 | int | 产品属性ID |
2.1.3、返回字段
| 返回字段 | 字段类型 | 说明 |
|---|---|---|
| id | int | 产品属性ID |
| name | string | 产品属性名称 |
value_type | string | 产品属性种类 |
default_value | string | 产品属性默认值 |
symbol | string | 产品属性符号 |
is_separate_picking_list | int | 是否创建单独的拣货单 |
is_separate_warehouse_transfer | int | 是否创建单独的调拨单 |
consignment_priority | int | 订单属性优先级 |
picking_list_group | string | 渠道属性分组 |
create_time | string | 创建时间 |
special_type | string | 特殊类别 |
primary_keys | string | 主键列名 |
2.2.1接口示例：
接口请求示例：
地址：http://test.birdsystem.com/client/product-customs-property
company_id:{{bs.default_company_id}}
api_key:{{bs.default_api_key}}
id:1
接口返回示例：
查询参数为空或输入无效参数，则默认查询所有产品属性