批量添加客户发货单

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

参数

FieldComment
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是表示不允许系统自动更换.