批量添加客户发货单

批量添加客户发货单

url

http://test.birdsystem.com/client/Client-Dispatch-Upload/Client-Dispatch-Json

method

post

body

[ { "warehouse_id_origination": "80", "warehouse_id_destination": "1", "final_freight_method": "AIR", "warehouse_dispatch_freight_id": "221", "delivery_time": "2015-07-31", "is_use_whole_warehouse_dispatch_freight": "0", "client_dispatch_delivery_type_code": "01", "client_vat_number_id": "505", "reference": "", "delivery_reference": "", "type": "NORMAL", "client_dispatch_final_address_contact": "howard", "client_dispatch_final_address_business_name": "Birdsystem", "final_address_line1": "320 Regent Street", "final_address_line2": "", "final_address_line3": "", "client_dispatch_final_address_city": "London", "client_dispatch_final_address_county": "", "client_dispatch_final_address_post_code": "W1B 3BB", "client_dispatch_final_address_country_iso": "GB", "client_dispatch_final_address_telephone": "6666 6666 666", "client_dispatch_final_address_email": "", "shipping_agent_id": "1", "shipping_agent_delivery_reference": "aabb", "shipping_agent_note": "aabb", "note": "", "client_dispatch_container_product_list": [ { "client_dispatch_container_reference": "1", "client_dispatch_container_type_code": "BIG", "client_dispatch_container_weight": "3000", "product_id": "499235", "quantity": "10" }, { "client_dispatch_container_reference": "1", "client_dispatch_container_type_code": "BIG", "client_dispatch_container_weight": "3000", "product_id": "499235", "quantity": "10" }, { "client_dispatch_container_reference": "2", "client_dispatch_container_type_code": "BIG", "client_dispatch_container_weight": "3000", "product_id": "499235", "quantity": "10" } ] } ]

返回

{"success":true,"message":null,"data":["8288","8289"]}

参数

Field

Comment

warehouse_id_origination

起始仓id, 通过/client/Warehouse/Client-Use-Warehouse获取  
(当type为DIRECT的时候时,这个字段不用填,始终跟warehouse_id_destination一致,当type为SPONTANEOUS和WAREHOUSE_TRANSFER时,选填,不填则跟warehouse_id_destination一致,其余情况必填)

warehouse_id_destination

目的仓id, 同上

is_use_whole_warehouse_dispatch_freight

是否包柜

warehouse_dispatch_freight_id

发货批次, 通过/client/Warehouse-Dispatch-Freight/Get-Closest-Freight获取

[参数:delivery_time, final_freight_method, warehouse_id_origination, warehouse_id_destination,is_use_whole_freight,type]

上面几个参数的解释: 货到头程仓时间, 最终运输方式, 起始仓,目的仓,是否包柜,发货单类型

(当发货单的类型type为'SPONTANEOUS','CLIENT_TRANSFER','DIRECT','WAREHOUSE_TRANSFER'时,这个字段为空, 其余情况必填)

client_dispatch_delivery_type_code

到仓调度类型, code值请看/client/Client-Dispatch-Delivery-Type 
如果到仓调度类型的列is_delivery_to_warehouse为0, 则发货单需要填写最终发货地址的联系人, 国家.  

client_vat_number_id

客户vat账号id, 通过/client/Client-Dispatch-Vat-Number获取 

client_dispatch_container_type_code

客户发货箱类型, code值请看 /client/Client-Dispatch-Container-Type

final_address_*

如果有预存的地址薄可以通过/client/Address-Book获取[参数:type], 也可以通过这个地址维护地址薄

shipping_agent_id

客户发货到仓库的方式, 可以通过/client/Shipping-Agent/列表来获取

目前shipping_agent_id取值可以为1,2,3,4四个数字,且不同数字时有不同的附加字段.如下:
1:快递发货
附加参数: 
shipping_agent_property_1: 快递公司, 选填 
shipping_agent_property_2: 体积(m3), 选填
shipping_agent_property_3: 重量(kg), 选填
shipping_agent_property_35: 发货时间(yyyy-mm-dd hh:ii:ss), 选填

2:飞鸟提货
附加参数: 
shipping_agent_property_4: 发货人及电话, 必填 
shipping_agent_property_5: 提货时间(yyyy-mm-dd hh:ii:ss), 必填
shipping_agent_property_6: 体积(m3), 必填
shipping_agent_property_37: 提货时间段, 必填 
shipping_agent_property_38: 重量(kg), 必填

3: 客户自送
附加参数: 
shipping_agent_property_7: 发货人及电话, 必填 
shipping_agent_property_8: 车牌号, 选填
shipping_agent_property_9: 发货时间(yyyy-mm-dd hh:ii:ss), 选填
shipping_agent_property_10: 体积(m3), 选填

4: 物流发货
附加参数: 
shipping_agent_property_11: 物流公司, 选填 
shipping_agent_property_12: 体积(m3), 选填
shipping_agent_property_13: 重量(kg), 选填
shipping_agent_property_36: 发货时间(yyyy-mm-dd hh:ii:ss), 选填

shipping_agent_delivery_reference

客户发货到仓库时, 用于参考的跟踪号信息

shipping_agent_note

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

type

'NORMAL','TRANSFER','SPONTANEOUS','CLIENT_TRANSFER','DIRECT','WAREHOUSE_TRANSFER'其中之一

confirmed

是否同意系统自动切换物流计划, 默认为0,还可取值 1, 2

0是表示系统直接返回提示: 是否更换物流计划

1是表示允许系统自动更换

2是表示不允许系统自动更换.