# 新增直营发货单(仅保存发货单)

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmssent/v1/addZySent/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "sent_no": "FH201612100000001",
    "sent_date": "2020-12-10",
    "order_id": "",
    "order_no": "DD201612090000001",
    "logistics_dept_code": "",
    "sign_status": "FH_CLZ",
    "business_status": "",
    "sent_storehouse_code": "",
    "sent_receive_code": "",
    "receive_name": "张三",
    "receive_phone": "18569854561",
    "receive_tel": "02578946932",
    "receive_addr": "江苏省南京市康缘智汇港",
    "exts": [
        {
            "ext_key": "级别",
            "ext_value": "四星"
        },
        {
            "ext_key": "主营商品",
            "ext_value": "食品,电器,日化用品"
        }
    ],
    "prods": [
        {
            "id": "",
            "posnr": "1",
            "sent_num": "5.00000000",
            "sent_input_unit": "6782340125265424027",
            "sent_input_unit_name": "箱",
            "sent_remark": "易损件",
            "exts": [
                {
                    "ext_key": "级别",
                    "ext_value": "四星"
                },
                {
                    "ext_key": "主营商品",
                    "ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
sent_no VARCHAR(100) 发货单号不传时自动生成。如果不存在该发货单号则新增,如果已存在则修改发货单,仅允许系统状态为“处理中”的发货单支持修改。
sent_date VARCHAR(32) 发货日期。格式:yyyy-mm-dd
order_no VARCHAR(100) 订单号,订单id和订单号必须传一个
order_id VARCHAR(32) 订单id,订单id和订单号必须传一个
create_time VARCHAR(100) 订单创建时间
logistics_dept_code VARCHAR(32) 物流部门编码
sent_storehouse_code VARCHAR(32) 厂家发货仓库编码
sign_status VARCHAR(32) 发货单系统状态。“FH_CLZ:处理中”;“FH_DQS:待入库”,不传则默认为“FH_DQS:待入库”
business_status VARCHAR(32) 发货单业务状态。“FH_CLZ:处理中”时允许传入对应的业务状态;“FH_DQS:待入库”时不需要传入
receive_name VARCHAR(100) 收货人名称
receive_phone VARCHAR(32) 收货人手机
receive_tel VARCHAR(32) 收货人电话
receive_addr VARCHAR(1000) 收货地址
receive_addr_id VARCHAR(32) 收货地址id
sent_receive_code VARCHAR(100) 收货方编码。不传则取直营订单的收货方。
prods List 列表
prods.id VARCHAR(32) 直营订单明细行id。直营订单明细行id和直营订单明细行行号必须传一个
prods.sent_num NUMERIC(18,8) 发货数量
prods.sent_input_unit VARCHAR(32) 发货单位和发货单位名称传一个即可,不传使用基本单位
prods.sent_input_unit_name VARCHAR(100) 发货单位和发货单位名称传一个即可,不传使用基本单位
prods.posnr NUMERIC(10) 直营订单明细行行号。直营订单明细行id和直营订单明细行行号必须传一个
prods.sent_remark text 发货单行备注
prods.exts List 发货单详情信息扩展字段列表
prods.exts.ext_key varchar(4000) 发货单详情信息扩展字段key值扩展字段需先在我方系统中创建
prods.exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
exts List 发货单主信息扩展字段列表
exts.ext_key varchar(4000) 发货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接

响应示例:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 新增直营订单及发货单(先保存订单再保存发货单)

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmssent/v1/addSent/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "sent_no": "FH201612100000001",
    "sent_date": "2020-12-10",
    "order_no": "DD201612090000001",
    "purchase_no": "CK20161209000001",
    "order_create_date": "2020-12-10",
    "cm_id": "6389893435290873348",
    "cm_code": "CM0001",
    "date": "2016-12-09",
    "emp_id": "9090338090192516225",
    "emp_code": "EMP0001",
    "consignment_date": "2016-12-10",
    "supply_id": "4778886974871755755",
    "supply_code": "SU00001",
    "sent_storehouse_id": "6210170610020953209",
    "sent_storehouse_code": "CK0001",
    "receive_name": "张三",
    "receive_phone": "18569854561",
    "receive_tel": "02578946932",
    "receive_addr": "江苏省南京市康缘智汇港",
    "receive_addr_id": "",
    "remark": "加急订单抓紧送货",
    "distribution_method": "配送方式",
    "exts": [
        {
            "cm_ext_key": "级别",
            "cm_ext_value": "四星"
        },
        {
            "cm_ext_key": "主营商品",
            "cm_ext_value": "食品,电器,日化用品"
        }
    ],
    "prods": [
        {
            "product_id": "7755038711664976249",
            "product_code": "PD001",
            "order_price": "20.000000",
            "order_count": "10.00000000",
            "order_input_unit": "6782340125265424027",
            "order_input_unit_name": "箱",
            "order_amount": "200.00",
            "order_discount_amount": "0.00",
            "sent_num": "5.00000000",
            "sent_input_unit": "6782340125265424027",
            "sent_input_unit_name": "箱",
            "is_gift": "N",
            "posnr": "10",
            "remark": "易损件",
            "exts": [
                {
                    "cm_ext_key": "级别",
                    "cm_ext_value": "四星"
                },
                {
                    "cm_ext_key": "主营商品",
                    "cm_ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
sent_no VARCHAR(100) 发货单号不传自动生成
sent_date VARCHAR(32) 发货日期。格式:yyyy-mm-dd
order_no VARCHAR(100) 销售订单号,销售订单号和采购单号必须传一个
purchase_no VARCHAR(100) 采购单号,销售订单号和采购单号必须传一个
order_create_date VARCHAR(32) 订单创建日期。格式:yyyy-mm-dd
cm_id VARCHAR(32) 客户id,客户id和客户编码必须传一个
cm_code VARCHAR(100) 客户编码,客户id和客户编码必须传一个
date VARCHAR(32) 业务日期。格式:yyyy-mm-dd
emp_id VARCHAR(32) 业务员Id,业务员id和业务员编码都不传,默认取其中一个客户经理的
emp_code VARCHAR(100) 业务员编码,业务员id和业务员编码都不传默认取其中一个客户经理的
consignment_date VARCHAR(32) 要求交货日期。格式:yyyy-mm-dd
supply_id VARCHAR(32) 供应商id,-1表示厂家供货。如果供应商id和供应商编码(经销商的编码)都不传将根据客户的上级经销商来查询
supply_code VARCHAR(100) 供应商编码(经销商的编码),-1表示厂家供货。如果供应商id和供应商编码(经销商的编码)都不传将根据客户的上级经销商来查询
sent_storehouse_id VARCHAR(32) 供应商发货仓库id。如果供应商发货仓库id和供应商发货仓库编码都不传,则根据供应商去查询默认仓库
sent_storehouse_code VARCHAR(100) 供应商发货仓库编码。如果供应商发货仓库id和供应商发货仓库编码都不传,则根据供应商去查询默认仓库
receive_name VARCHAR(100) 收货人名称
receive_phone VARCHAR(32) 收货人手机
receive_tel VARCHAR(32) 收货人电话
receive_addr VARCHAR(1000) 收货地址
receive_addr_id VARCHAR(32) 收货地址id
remark text 订单表体备注
distribution_method text 配送方式
sent_receive_id VARCHAR(32) 发货单收货方id
sent_receive_code VARCHAR(100) 发货单收货方编码
sent_receive_name VARCHAR(100) 发货单收货方名称
sent_receive_addr_id VARCHAR(32) 发货单收货地址id
sent_receive_addr VARCHAR(100) 发货单收货地址名称
prods List 列表
prods.product_id VARCHAR(32) 商品id和商品编码必须传一个
prods.product_code VARCHAR(100) 商品id和商品编码必须传一个
prods.order_price NUMERIC(18,8) 订货价不传就取客户价格,赠品价格为0
prods.order_count NUMERIC(18,8) 订货数量
prods.order_input_unit VARCHAR(32) 订货单位id和订货单位名称传一个即可,不传使用基本单位
prods.order_input_unit_name VARCHAR(32) 订货单位id和订货单位名称传一个即可,不传使用基本单位
prods.order_amount NUMERIC(18,2) 订货金额
prods.order_discount_amount NUMERIC(18,2) 订货优惠金额
prods.sent_num NUMERIC(18,8) 发货数量
prods.sent_input_unit VARCHAR(32) 发货单位和发货单位名称传一个即可,不传使用基本单位
prods.sent_input_unit_name VARCHAR(32) 发货单位和发货单位名称传一个即可,不传使用基本单位
prods.is_gift VARCHAR(10) 是否是赠品。Y:是,N:否。不传默认为非赠品
prods.posnr NUMERIC(10) 对应订单下单商品的序号,标识本行发货是对着订单中的哪行商品进行发货的,且序号必须能对应上订单中序号
prods.remark text 订单子表的备注
prods.sent_remark text 发货单行备注
costpooldetails List 列表
costpooldetails.account VARCHAR(32) 客户账户名称
costpooldetails.amount NUMERIC(18,8) 核销金额
products.exts List 发货单详情信息扩展字段列表
products.exts.ext_key varchar(4000) 发货单详情信息扩展字段key值扩展字段需先在我方系统中创建
products.exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
exts List 发货单主信息扩展字段列表
exts.ext_key varchar(4000) 发货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接

接口说明:订货价order_price不传默认取客户价格,是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,order_price传0,is_gift传Y。未免出错,这二个字段建议必填

响应示例:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 新增直营订单发货单运输信息

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmssent/v1/addSentWaybilllogs/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "bill_code": "FH20201110000001",
    "driver_name":"小杜呀",
    "driver_phone":"13675189390",
    "car_no":"che1",
    "delivery_date":"2020-12-27",
    "remark":"我这是备注",
    "logistics_url":"",
    "url_type": "",
    "orderSents":[
        {
            "sent_id":"7817081791819132613",
            "sent_no":"FH20210118000003"
        }
    ],
    "exts":[
        {
            "ext_key": "自定义字段1",
            "ext_value": "自定义值1"
        },
        {
            "ext_key": "自定义字段2",
            "ext_value": "自定义值2"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
bill_code VARCHAR(100) 运单号
driver_name VARCHAR(32) 司机名称
driver_phone VARCHAR(32) 司机手机号
car_no VARCHAR(32) 车牌号
delivery_date TIMESTAMP 预计送达日期。格式:yyyy-MM-dd
remark TEXT 备注
logistics_url VARCHAR(100) 物流链接地址
url_type VARCHAR(32) 链接类型
orderSents List 发货单列表
orderSents.sent_id INT8 发货单id,接口传参至少要传一条发货单数据
orderSents.sent_no VARCHAR(100) 发货单号
exts List 运单主信息扩展字段列表
exts.ext_key varchar(4000) 运单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接

响应示例:

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据

# 直营订单发货单自动签收

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/zyOrderSign/v1/autoSignFromSentNo/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "sent_no": "FH20201110000001"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
sent_no VARCHAR(100) 发货单号

响应示例:

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据

# 分销订单发货单自动签收

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/fxOrderSign/v1/autoSignFromSentNo/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "sent_no": "FH20201110000001"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
sent_no VARCHAR(100) 发货单号

响应示例:

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据

# 查询分销或者直营发货单

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmsdatasearch/v1/getDmsOrderSentInfos/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例:

{
    "page_number": 1,
    "s_status": 1,
    "send_no": "FH20150819",
    "send_date_begin": "2017-05-01 00:00:00",
    "send_date_end": "2017-05-31 00:00:00"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
page_length INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
s_status CHAR(1) 记录状态。0:已删除,1:正常
send_no VARCHAR(32) 发货单编码,有效字符详见附录:有效字符说明 (opens new window)
order_type VARCHAR(32) 单据类型。ZY:直营,FX:分销
after_create_date TIMESTAMP 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
start_create_date TIMESTAMP 创建时间开始。格式:yyyy-MM-dd
end_create_date TIMESTAMP 创建时间结束。格式:yyyy-MM-dd
start_modify_date TIMESTAMP 修改时间开始。格式:yyyy-MM-dd
end_modify_date TIMESTAMP 修改时间结束。格式:yyyy-MM-dd

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "id": "7226306356013346628",
        "status": "1",
        "sent_no": "FH201612010001",
        "purchase_no": "CK201612010001",
        "order_no": "FX201612010001",
        "order_id": "7226306356013346628",
        "date": "2016-12-01",
        "order_amount": "10.00",
        "order_discount_amount": "2.00",
        "emp_dept_id": "6173157522867102283",
        "emp_dept_name": "市场部",
        "emp_dept_code": "DP00001",
        "emp_dept_source_code": "000001",
        "emp_id": "6360879952207158181",
        "emp_code": "EMP0001",
        "emp_name": "张明",
        "emp_source_code": "000001",
        "send_time_str": "2016-12-01 00:00:00",
        "send_id": "4786443529856258791",
        "send_name": "张三",
        "send_code": "EMP0001",
        "send_source_code": "EMP0001",
        "cm_id": "4786443529856258791",
        "cm_code": "CUS00001",
        "cm_name": "南京苏果超市",
        "cm_source_code": "0001",
        "cm_dept_id": "5479044577173277483",
        "cm_dept_name": "南京市场部",
        "cm_dept_code": "DP0001",
        "cm_dept_source_code": "00001",
        "sign_status": "CG_DFH",
        "order_status": "CG_DFH",
        "purchase_status": "CG_DFH",
        "consignment_date": "2016-12-01",
        "supply_id": "4786443529856258791",
        "supply_name": "CUS00001",
        "supply_code": "南京苏果超市",
        "supply_source_code": "0001",
        "receive_name": "李四",
        "receive_phone": "18254623212",
        "receive_tel": "02589652314",
        "receive_addr": "江苏省南京建邺区云龙山路66号",
        "remark": "请尽快送货",
        "from_storehouse": "4786443529856258791",
        "from_storehouse_name": "仓库1",
        "from_storehouse_code": "ck001",
        "order_type": "ZY",
        "prods": 
        [
              {
                    "detail_id": "4843786111936788462",
                    "order_detail_id": "4843786111936788462",
                    "product_id": "4843786111936788462",
                    "product_name": "商品1",
                    "product_code": "P0001",
                    "product_source_code": "P0001",
                    "order_price": "10.00000000",
                    "order_count": "20.00000000",
                    "order_input_unit": "8215768532653672550",
                    "order_input_unit_name": "箱",
                    "base_unit": "6930792320160995628",
                    "base_unit_name": "瓶",
                    "order_base_unit_count": "120.00000000",
                    "order_amount": "200.00",
                    "order_discount_amount": "10.00",
                    "is_gift": "N",
                    "sent_input_unit": "8215768532653672550",
                    "sent_input_unit_name": "箱",
                    "sent_base_unit_num": "20.0000"
              }
       ]
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 单据ID
status VARCHAR(1) 0:已删除,1:正常
sent_no VARCHAR(100) 发货单编号
purchase_no VARCHAR(100) 直营订单号
order_no VARCHAR(100) 分销订单号
order_id VARCHAR(32) 对应的分销或者直营单id
date TIMESTAMP 单据业务日期。格式:yyyy-mm-dd
order_amount NUMERIC(20,2) 单据金额
order_discount_amount NUMERIC(20,2) 单据优惠金额
emp_dept_id VARCHAR(32) 业务员下单时候所在的部门id
emp_dept_name VARCHAR(100) 业务员下单时候所在的部门名称
emp_dept_code VARCHAR(100) 业务员下单时候所在的部门编码
emp_dept_source_code VARCHAR(32) 业务员下单时候所在的部门对应外部数据id
emp_id VARCHAR(32) 单据业务员id
emp_code VARCHAR(100) 员工编码
emp_name VARCHAR(100) 单据业务员名称
emp_source_code VARCHAR(32) 单据业务员对应外部数据id
send_time_str TIMESTAMP 发货单发货时间。格式:yyyy-mm-dd hh24:mi:ss
send_id VARCHAR(32) 发货人id
send_name VRACHAR(100) 发货人名称
send_code VRACHAR(100) 发货人编码
send_source_code VRACHAR(32) 发货人对应外部数据id
cm_id VARCHAR(32) 客户id
cm_code VARCHAR(32) 客户编码
cm_name VARCHAR(100) 客户名称
cm_source_code VARCHAR(32) 客户对应外部数据id
cm_dept_id VARCHAR(32) 下单时候客户所在的部门id
cm_dept_name VARCHAR(100) 下单时候客户所在部门的名称
cm_dept_code VARCHAR(100) 下单时候客户所在部门的编码
cm_dept_source_code VARCHAR(32) 下单时候客户所在的部门对应外部数据id
sign_status varchar(32) 发货单状态。FH_CLZ:发货处理中,FH_DQS:待签收,FH_YQS:已签收
order_status varchar(32) 销售订单状态。XS_DFH:待发货,XS_DQS:待签收,XS_YWC:已完成,XS_DQR:待确认,XS_YQX:已取消,XS_FHZ:发货中
purchase_status varchar(32) 直营订单状态。CG_DFH:待发货,CG_DRK:待入库,CG_YWC:已完成,CG_DQR:待确认,CG_YQX:已取消,CG_FHZ:发货中
consignment_date TIMESTAMP 要求送货日期。格式:yyyy-mm-dd
supply_id VARCHAR(32) 供货商id,-1就是没有供货商
supply_name VARCHAR(200) 供货商名称
supply_code VARCHAR(200) 供货商编码
supply_source_code VARCHAR(32) 供货商第三方id
receive_name varchar(100) 收货人名称
receive_phone varchar(100) 收货人手机号码
receive_tel varchar(100) 收货人电话
receive_addr varchar(1000) 收货地址
remark varchar(4000) 备注
from_storehouse VARCHAR(32) 发货仓库id
from_storehouse_name VARCHAR(200) 发货仓库名称
from_storehouse_code VARCHAR(200) 发货仓库编码
order_type varchar(20) 单据类型。ZY:直营,FX:分销
prods List 列表
prods.detail_id VARCHAR(32) 发货子表id
prods.order_detail_id VARCHAR(32) 分销单或直营单的子表id
prods.product_id varchar(32) 商品id
prods.product_name varchar(100) 商品名称
prods.product_code varchar(100) 商品编码
prods.product_source_code varchar(32) 商品对应外部数据id
prods.order_price numeric(28,8) 价格
prods.order_count numeric(28,8) 数量
prods.order_input_unit VARCHAR(32) 下单时候录入单位id
prods.order_input_unit_name VARCHAR(100) 下单时候录入单位名称
prods.base_unit VARCHAR(32) 下单时候商品基本单位id
prods.base_unit_name VARCHAR(100) 下单时候商品基本单位名称
prods.order_base_unit_count numeric(28,8) 数量转化成基本单位以后的数量
prods.order_amount numeric(20,2) 金额
prods.order_discount_amount numeric(20,2) 优惠金额
prods.is_gift varchar(2) 是否是赠品。Y:是,N:否
prods.sent_num numeric(28,8) 发货数量
prods.sent_input_unit VARCHAR(32) 发货单位
prods.sent_input_unit_name VARCHAR(100) 发货单位名称
prods.sent_base_unit_num numeric(28,8) 发货数量转化成基本单位的数量
waybilllogs List 列表
waybilllogs.bill_code VARCHAR(100) 运单号
waybilllogs.driver_name VARCHAR(32) 司机姓名
waybilllogs.driver_phone VARCHAR(32) 司机联系电话
waybilllogs.car_no VARCHAR(32) 车牌号码
waybilllogs.delivery_date TIMESTAMP 预计送达时间
waybilllogs.remark TEXT 备注

# 订单发货单红冲

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmssent/v1/counteractOrderSent/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "sent_no": "FH20201110000001",
    "sent_id": "20201110000001"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
sent_no VARCHAR(100) 发货单号,单号或者id传递其中的一个即可
sent_id VARCHAR(100) 发货单id,单号或者id传递其中的一个即可

响应示例:

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据

# 新增分销发货单

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmssent/v1/addFxSent/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "sent_no": "FH201612100000001",
    "sent_date": "2020-12-10",
    "order_id": "",
    "order_no": "DD201612090000001",
    "sign_status": "FH_CLZ",
    "sent_storehouse_code": "",
    "sent_receive_code": "",
    "receive_name": "张三",
    "receive_phone": "18569854561",
    "receive_tel": "02578946932",
    "receive_addr": "江苏省南京市康缘智汇港",
    "exts": [
        {
            "ext_key": "级别",
            "ext_value": "四星"
        },
        {
            "ext_key": "主营商品",
            "ext_value": "食品,电器,日化用品"
        }
    ],
    "prods": [
        {
            "id": "",
            "posnr": "1",
            "sent_num": "5.00000000",
            "sent_input_unit": "6782340125265424027",
            "sent_input_unit_name": "箱",
            "sent_remark": "易损件",
            "exts": [
                {
                    "ext_key": "级别",
                    "ext_value": "四星"
                },
                {
                    "ext_key": "主营商品",
                    "ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
sent_no VARCHAR(100) 发货单号,不传时自动生成
sent_date VARCHAR(32) 发货日期。格式:yyyy-mm-dd
order_no VARCHAR(100) 订单号,订单id和订单号必须传一个
order_id VARCHAR(32) 订单id,订单id和订单号必须传一个
create_time VARCHAR(100) 订单创建时间
sent_storehouse_code VARCHAR(32) 发货仓库编码,没有则取默认仓库
sign_status VARCHAR(32) 发货单系统状态。不传则默认为“FH_DQS:待入库”
receive_name VARCHAR(100) 收货人名称
receive_phone VARCHAR(32) 收货人手机
receive_tel VARCHAR(32) 收货人电话
receive_addr VARCHAR(1000) 收货地址
receive_addr_id VARCHAR(32) 收货地址id
sent_receive_code VARCHAR(100) 收货方编码。
prods List 列表
prods.id VARCHAR(32) 分销订单明细行id。分销订单明细行id和分销订单明细行行号必须传一个
prods.sent_num NUMERIC(18,8) 发货数量
prods.sent_input_unit VARCHAR(32) 发货单位和发货单位名称传一个即可,不传使用基本单位
prods.sent_input_unit_name VARCHAR(100) 发货单位和发货单位名称传一个即可,不传使用基本单位
prods.posnr NUMERIC(10) 分销订单明细行行号。分销订单明细行id和分销订单明细行行号必须传一个
prods.sent_remark text 发货单行备注
prods.exts List 发货单详情信息扩展字段列表
prods.exts.ext_key varchar(4000) 发货单详情信息扩展字段key值扩展字段需先在我方系统中创建
prods.exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
exts List 发货单主信息扩展字段列表
exts.ext_key varchar(4000) 发货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接

响应示例:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明