Page Comparison

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

...

字段

注释

是否必填

类型

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

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

Expand

title	发货方式字段描述

发货方式

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

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

Expand

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

Code Block

language	json

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"
    }
]

返回结果

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

Versions Compared

Old Version 19

New Version Current

Key