客户发货单-批量创建

Owned by to Hallucin Grape (Unlicensed)
Last updated: 2024-07-08 by tuhao
4 min read

批量创建客户发货单：接口描述

URL

https://<系统域名>/client/Client-Dispatch-Upload/Client-Dispatch-Json

URL

https://<系统域名>/client/Client-Dispatch-Upload/Client-Dispatch-Json

接口功能

创建客户发货单

支持格式

JSON/TEXT

开发人员

 

请求方式

POST

发布日期

 

发货单-参数

字段

注释

是否必填

类型

字段

注释

是否必填

类型

id

客户发货单ID（添加发货单，无需填写）

选填

INT

type

发货单类型/种类

必填
填写参数可参考
客户发货单种类

VARCHAR

warehouse_id_origination

发货仓ID/始发仓

必填
填写参数可参考如下文档接口获取

获取客户可用仓库
当发货单的类型type为DIRECT的时候时,这个字段不用填，始终跟warehouse_id_destination一致,当type为SPONTANEOUS和WAREHOUSE_TRANSFER时,选填,不填则跟warehouse_id_destination一致,其余情况必填

INT

warehouse_id_destination

目的仓ID

必填
填写参数可参考接口文档

获取客户可用仓库

INT

final_freight_method

最终运输方式

必填
填写参数可参考接口文档
最终运输方式

VARCHAR

sea_trans_calc_fee_method

海运计费方式

选填

VARCHAR

warehouse_dispatch_freight

仓库货运

选填

 

warehouse_dispatch_freight_id

头程物流计划ID

系统自动分配

INT

delivery_time

客户预计发货时间

选填

TIMESTAMP

YYYY- MM- DD格式的日期

confirm_delivery_time

客户实际发货时间

修改状态已发货时，系统自动分配

TIMESTAMP

client_dispatch_final_address_contact

联系人

选填

VARCHAR

client_dispatch_final_address_business_name

公司

选填

VARCHAR

client_dispatch_final_address_line1

地址行1

选填

VARCHAR

client_dispatch_final_address_line2

地址行2

选填

VARCHAR

client_dispatch_final_address_line3

地址行3

选填

VARCHAR

client_dispatch_final_address_city

城市

选填

VARCHAR

client_dispatch_final_address_county

省份

选填

VARCHAR

client_dispatch_final_address_post_code

邮编

选填

VARCHAR

client_dispatch_final_address_country_iso

国家代码

选填

VARCHAR

client_dispatch_final_address_telephone

电话

选填

INT

client_dispatch_final_address_email

邮箱

选填

VARCHAR

client_dispatch_shipping_agent-id

发货单代理人id

选填

INT

is_use_whole_warehouse_dispatch_freight

是否包柜

海运时必填

INT(0或1)

client_dispatch_delivery_type_id

到仓调度类型ID

选填，ID或代码必填一个

INT

client_dispatch_delivery_type_code

到仓调度类型代码

选填，ID或代码必填一个
填写参数可参考接口文档获取到仓调度类型
code值请看/client/Client-Dispatch-Delivery-Type 
如果到仓调度类型的列is_delivery_to_warehouse为0, 则发货单需要填写最终发货地址的联系人, 国家.  

VARCHAR

delivery_reference

基本细节--运输跟踪号

选填

VARCHAR

reference

跟踪号

选填

VARCHAR

client_vat_number_id

VAT号码

选填
填写参数可参考接口文档获取VAT账号
通过/client/Client-Dispatch-Vat-Number获取

INT

confirmed

允许仓库根据实际到仓时间优化物流计划

选填

取值0：需要更换物流计划时提示：是否更换物流计划
取值1：表示允许系统自动更换
取值2：表示不允许系统自动更换.

note

备注

选填

VARCHAR

shipping_agent_id

发货方式id

必填，其他参数详情可查看下面文档

发货方式

INT

shipping_agent_note

客户发货到仓库时的备注信息

 

TEXT

estimate_arrival_destination_warehouse_time

预计到达目的仓时间，仅用于自发头程的发货单

选填

TIMESTAMP

YYYY- MM-DD HH:ii:ss格式的日期时间

发货箱参数

字段

注释

是否必填

类型

字段

注释

是否必填

类型

client_dispatch_container_type_code

客户发货箱类型

必填
code值请看 /client/Client-Dispatch-Container-Type

VARCHAR

quantity

数量

必填

INT

product_id

产品ID

必填
填写参数可参考接口文档产品查询

INT

client_dispatch_container_reference

发货箱的跟踪号

选填

STRING

请求描述
(以下为折叠内容，签署合同时以下信息无需参考，仅供第三方对接参考)

 

POST /client/Client-Dispatch-Upload/Client-Dispatch-Json? HTTP/1.1 Host: {{Bird_URL}} Headres: api_key: {{api_key}} company_id: {{company_id}} Cookie: PHPSESSID=3s3nejv43u9bhirsrvq9nge254 Body raw [ { "client_dispatch_container_product_list": [ { "client_dispatch_container_reference": "1452", "client_dispatch_container_type_code": "CUSTOM", "product_id": "2253112", "quantity": 1 }, { "client_dispatch_container_reference": "1452", "client_dispatch_container_type_code": "CUSTOM", "product_id": "2253112", "quantity": 1 } ], "type": "SPONTANEOUS", "warehouse_id_destination": "1", "warehouse_id_origination": "83", "final_freight_method": "AIR", "sea_trans_calc_fee_method":"", "warehouse_dispatch_freight_id":null, "delivery_time": "2021-05-29", "client_dispatch_final_address_contact": "name", "client_dispatch_final_address_business_name":"company_name", "client_dispatch_final_address_line1":"adderss1", "client_dispatch_final_address_line2":"adderss2", "client_dispatch_final_address_line3":"adderss3", "client_dispatch_final_address_telephone":"phone", "client_dispatch_final_address_city":"shenzheng", "client_dispatch_final_address_county":"guangdong", "client_dispatch_final_address_post_code":"12345", "client_dispatch_final_address_country_iso":"GB", "client_dispatch_final_address_email":"1515@qq.com", "client_dispatch_delivery_type_code": "01", "confirmed": "1", "delivery_reference": "delivery_reference", "is_use_whole_warehouse_dispatch_freight": "1", "note": "注释", "reference": "RKPG201229000002", "estimate_arrival_destination_warehouse_time": "2023-05-01 00:00:00", "shipping_agent_id": "4" }, { "client_dispatch_container_product_list": [ { "client_dispatch_container_reference": "1452", "client_dispatch_container_type_code": "CUSTOM", "product_id": "2253112", "quantity": 1 }, { "client_dispatch_container_reference": "1452", "client_dispatch_container_type_code": "CUSTOM", "product_id": "2253112", "quantity": 1 } ], "type": "SPONTANEOUS", "warehouse_id_destination": "1", "warehouse_id_origination": "83", "final_freight_method": "AIR", "sea_trans_calc_fee_method":"", "warehouse_dispatch_freight_id":null, "delivery_time": "2021-05-29", "client_dispatch_final_address_contact": "name", "client_dispatch_final_address_business_name":"company_name", "client_dispatch_final_address_line1":"adderss1", "client_dispatch_final_address_line2":"adderss2", "client_dispatch_final_address_line3":"adderss3", "client_dispatch_final_address_telephone":"phone", "client_dispatch_final_address_city":"shenzheng", "client_dispatch_final_address_county":"guangdong", "client_dispatch_final_address_post_code":"12345", "client_dispatch_final_address_country_iso":"GB", "client_dispatch_final_address_email":"1515@qq.com", "client_dispatch_delivery_type_code": "01", "confirmed": "1", "delivery_reference": "delivery_reference", "is_use_whole_warehouse_dispatch_freight": "1", "note": "注释", "reference": "RKPG201229000002", "shipping_agent_id": "4" } ]

返回结果

{ "data": [ "696977071", "696977072" ], "message": null, "success": true, "moduleName": "client" }