U8C API中心

API中心

销售管理
发货单

指导视频
对接方案模板
工具
游客

发货单新增

接口所在U8C版本:U8 cloud2.7以及更高版本

详细描述:发货单保存API

API视频讲解API详情补丁列表常见问题参考

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/so/salereceive/insert

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

参数名	必填	描述	默认值
Content-Type	是	请求体数据类型	application/json
usercode	是	用户
password	是	密码
trantype	否	翻译类型，按编码为code，不需要翻译为pk	code
uniquekey	否	幂等唯一key
system	是	系统参数

请求参数(body):

全量参数来源销售订单来源调拨订单带统计型自定义项带备注型自定义项

参数名	类型	是否数组	必填	描述
billvo		是	是	发货单
childrenvo		是	否	表体
blargessflag	string	否	否	赠品
btransportcloseflag	string	否	否	是否运输完毕
castunitid	string	否	否	辅单位
cbiztype	string	否	否	业务类型
cchauffeurid	string	否	否	司机
ccustmandocid	string	否	否	客户管理ID
cinvmandocid	string	否	否	存货管理档案id
cprojectid	string	否	否	项目
creceiveareaid	string	否	否	收货地区
creceivecalbodyid	string	否	否	收货库存组织
creceivecustid	string	否	否	收货单位
creceivewareid	string	否	否	收货仓库
csendareaid	string	否	否	发货地区
csendcalbodyid	string	否	否	发货库存组织
csendpointid	string	否	否	发货地点
csendwareid	string	否	否	发货仓库
csourcebillbodyid	string	否	否	来源单据子表id
csourcebillid	string	否	否	来源单据主表id
cspaceid	string	否	否	货位
csupercargoid	string	否	否	押运员
ctranscustid	string	否	否	承运商
cvehicleid	string	否	否	车辆
cvehicletypeid	string	否	否	车型
ddeliverdate	string	否	否	要求收货日期
dsenddate	string	否	否	发货日期
nastnumber	double	否	否	辅数量
nnumber	double	否	是	数量
nvolume	double	否	否	体积
nweight	double	否	否	重量
pk_defdoc1	string	否	否	自定义项1（统计型的传编码）
pk_defdoc10	string	否	否	自定义项10
pk_defdoc11	string	否	否	自定义项11
pk_defdoc12	string	否	否	自定义项12
pk_defdoc13	string	否	否	自定义项13
pk_defdoc14	string	否	否	自定义项14
pk_defdoc15	string	否	否	自定义项15
pk_defdoc16	string	否	否	自定义项16
pk_defdoc17	string	否	否	自定义项17
pk_defdoc18	string	否	否	自定义项18
pk_defdoc19	string	否	否	自定义项19
pk_defdoc2	string	否	否	自定义项2
pk_defdoc20	string	否	否	自定义项20
pk_defdoc3	string	否	否	自定义项3
pk_defdoc4	string	否	否	自定义项4
pk_defdoc5	string	否	否	自定义项5
pk_defdoc6	string	否	否	自定义项6
pk_defdoc7	string	否	否	自定义项7
pk_defdoc8	string	否	否	自定义项8
pk_defdoc9	string	否	否	自定义项9
pk_receivecorp	string	否	否	收货公司
pk_sendcorp	string	否	否	发货公司
vbatchcode	string	否	否	批次号
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2（备注型的直接传内容）
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vfree0	string	否	否	自由项
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vreceiveaddress	string	否	否	收货地址
vreceiveperson	string	否	否	收货联系人
vreceivepointid	string	否	否	收货地点
vreceivetel	string	否	否	收货联系电话
vrownote	string	否	否	备注
vsendaddress	string	否	否	发货地址
vsendperson	string	否	否	发货联系人
vsendtel	string	否	否	发货联系电话
vsourcereceivecode	string	否	是	来源单据号
vsourcerowno	string	否	是	来源单据行号
vsourcetype	string	否	是	来源单据类型
parentvo		否	否	表头
bifclose	string	否	否	是否关闭
cbiztype	string	否	否	业务类型
cdeptid	string	否	否	发货部门
cemployeeid	string	否	否	发货计划员
cmodifyid	string	否	否	最后修改人
coperatorid	string	否	是	制单人
csalecorpid	string	否	否	销售组织
ctransportcorpid	string	否	否	运输组织
ctransportrouteid	string	否	否	运输路线
ctransporttypeid	string	否	否	运输方式
dapprovedate	string	否	否	审批日期
dbilldate	string	否	否	单据日期
dmakedate	string	否	否	制单日期
pk_corp	string	否	是	公司
pk_defdoc1	string	否	否	自定义项1（统计型的传编码）
pk_defdoc10	string	否	否	自定义项10
pk_defdoc11	string	否	否	自定义项11
pk_defdoc12	string	否	否	自定义项12
pk_defdoc13	string	否	否	自定义项13
pk_defdoc14	string	否	否	自定义项14
pk_defdoc15	string	否	否	自定义项15
pk_defdoc16	string	否	否	自定义项16
pk_defdoc17	string	否	否	自定义项17
pk_defdoc18	string	否	否	自定义项18
pk_defdoc19	string	否	否	自定义项19
pk_defdoc2	string	否	否	自定义项2
pk_defdoc20	string	否	否	自定义项20
pk_defdoc3	string	否	否	自定义项3
pk_defdoc4	string	否	否	自定义项4
pk_defdoc5	string	否	否	自定义项5
pk_defdoc6	string	否	否	自定义项6
pk_defdoc7	string	否	否	自定义项7
pk_defdoc8	string	否	否	自定义项8
pk_defdoc9	string	否	否	自定义项9
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2（备注型的直接传内容）
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vnote	string	否	否	备注
vreceivecode	string	否	否	单据号
vtel	string	否	否	电话

返回类型参数:

参数名	类型	是否数组	必填	描述
SaleReceiveVO				发货单保存后返回VO
childrenvo		是	否	表体
blargessflag	string	否	否	赠品
btransportcloseflag	string	否	否	是否运输完毕
castunitid	string	否	否	辅单位
cbiztype	string	否	否	业务类型
cchauffeurid	string	否	否	司机
ccustmandocid	string	否	否	客户管理ID
cinvmandocid	string	否	否	存货管理档案id
cprojectid	string	否	否	项目
creceiveareaid	string	否	否	收货地区
creceivecalbodyid	string	否	否	收货库存组织
creceivecustid	string	否	否	收货单位
creceivewareid	string	否	否	收货仓库
csendareaid	string	否	否	发货地区
csendcalbodyid	string	否	否	发货库存组织
csendpointid	string	否	否	发货地点
csendwareid	string	否	否	发货仓库
csourcebillbodyid	string	否	否	来源单据子表id
csourcebillid	string	否	否	来源单据主表id
cspaceid	string	否	否	货位
csupercargoid	string	否	否	押运员
ctranscustid	string	否	否	承运商
cvehicleid	string	否	否	车辆
cvehicletypeid	string	否	否	车型
ddeliverdate	string	否	否	要求收货日期
dsenddate	string	否	否	发货日期
nastnumber	double	否	否	辅数量
nnumber	double	否	是	数量
nvolume	double	否	否	体积
nweight	double	否	否	重量
pk_defdoc1	string	否	否	自定义项1（统计型的传编码）
pk_defdoc10	string	否	否	自定义项10
pk_defdoc11	string	否	否	自定义项11
pk_defdoc12	string	否	否	自定义项12
pk_defdoc13	string	否	否	自定义项13
pk_defdoc14	string	否	否	自定义项14
pk_defdoc15	string	否	否	自定义项15
pk_defdoc16	string	否	否	自定义项16
pk_defdoc17	string	否	否	自定义项17
pk_defdoc18	string	否	否	自定义项18
pk_defdoc19	string	否	否	自定义项19
pk_defdoc2	string	否	否	自定义项2
pk_defdoc20	string	否	否	自定义项20
pk_defdoc3	string	否	否	自定义项3
pk_defdoc4	string	否	否	自定义项4
pk_defdoc5	string	否	否	自定义项5
pk_defdoc6	string	否	否	自定义项6
pk_defdoc7	string	否	否	自定义项7
pk_defdoc8	string	否	否	自定义项8
pk_defdoc9	string	否	否	自定义项9
pk_receivecorp	string	否	否	收货公司
pk_sendcorp	string	否	否	发货公司
vbatchcode	string	否	否	批次号
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2（备注型的直接传内容）
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vfree0	string	否	否	自由项
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vreceiveaddress	string	否	否	收货地址
vreceiveperson	string	否	否	收货联系人
vreceivepointid	string	否	否	收货地点
vreceivetel	string	否	否	收货联系电话
vrownote	string	否	否	备注
vsendaddress	string	否	否	发货地址
vsendperson	string	否	否	发货联系人
vsendtel	string	否	否	发货联系电话
vsourcereceivecode	string	否	是	来源单据号
vsourcerowno	string	否	是	来源单据行号
vsourcetype	string	否	是	来源单据类型
parentvo		否	否	表头
bifclose	string	否	否	是否关闭
cbiztype	string	否	否	业务类型
cdeptid	string	否	否	发货部门
cemployeeid	string	否	否	发货计划员
cmodifyid	string	否	否	最后修改人
coperatorid	string	否	是	制单人
csalecorpid	string	否	否	销售组织
ctransportcorpid	string	否	否	运输组织
ctransportrouteid	string	否	否	运输路线
ctransporttypeid	string	否	否	运输方式
dapprovedate	string	否	否	审批日期
dbilldate	string	否	否	单据日期
dmakedate	string	否	否	制单日期
pk_corp	string	否	是	公司
pk_defdoc1	string	否	否	自定义项1（统计型的传编码）
pk_defdoc10	string	否	否	自定义项10
pk_defdoc11	string	否	否	自定义项11
pk_defdoc12	string	否	否	自定义项12
pk_defdoc13	string	否	否	自定义项13
pk_defdoc14	string	否	否	自定义项14
pk_defdoc15	string	否	否	自定义项15
pk_defdoc16	string	否	否	自定义项16
pk_defdoc17	string	否	否	自定义项17
pk_defdoc18	string	否	否	自定义项18
pk_defdoc19	string	否	否	自定义项19
pk_defdoc2	string	否	否	自定义项2
pk_defdoc20	string	否	否	自定义项20
pk_defdoc3	string	否	否	自定义项3
pk_defdoc4	string	否	否	自定义项4
pk_defdoc5	string	否	否	自定义项5
pk_defdoc6	string	否	否	自定义项6
pk_defdoc7	string	否	否	自定义项7
pk_defdoc8	string	否	否	自定义项8
pk_defdoc9	string	否	否	自定义项9
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2（备注型的直接传内容）
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vnote	string	否	否	备注
vreceivecode	string	否	否	单据号
vtel	string	否	否	电话

代码示例:

Java模板示例下载 C#模板示例下载

请求参数示例:

来源销售订单来源调拨订单带统计型自定义项带备注型自定义项

复制代码

{"billvo":[{"parentvo":{"coperatorid":"apicyc","pk_corp":"3101"},"childrenvo":[{"nnumber":"0.01","vsourcereceivecode":"30TO4331100000000","vsourcerowno":"10","vsourcetype":"30"}]}]}

正确返回示例:

复制代码

{"status":"success","data":"[{\"parentvo\":{\"pk_corp\":\"1012\",\"corp_code\":\"3101\",\"code_name\":\"cyc交通建设集团有限公司\",\"coperatorid\":\"0001A2100000000000YV\",\"coperator_code\":\"apicyc\",\"coperator_name\":\"cyc\",\"bifclose\":false,\"cbiztype\":\"1012A210000000000043\",\"cbiztype_code\":\"r001\",\"cbiztype_name\":\"普通销售（不质检）\",\"cdeptid\":\"\",\"cmodifyid\":\"0001A2100000000000YV\",\"cmodify_code\":\"apicyc\",\"cmodify_name\":\"cyc\",\"creceipttype\":\"4331\",\"csalecorpid\":\"0001A21000000000YC08\",\"csalecorp_code\":\"1\",\"csalecorp_name\":\"1\",\"csalereceiveid\":\"1012ZZ10000000001FQS\",\"dbilldate\":\"2023-08-22\",\"dmakedate\":\"2023-08-22\",\"fstatus\":\"8\",\"ntotalnumber\":\"0.01\",\"tmaketime\":\"2023-08-22 10:19:23\",\"tmodifytime\":\"2023-08-22 10:19:23\",\"vreceivecode\":\"4331********2308220004\"},\"childrenvo\":[{\"csendcalbodyid\":\"1012A2100000000001LI\",\"csendcalbody_code\":\"3101-_-K1001\",\"csendcalbody_name\":\"A总-管\",\"pk_sendcorp\":\"1012\",\"sendcorp_code\":\"3101\",\"sendcorp_name\":\"cyc交通建设集团有限公司\",\"ccustbasdocid\":\"0001A11000000003GA8W\",\"ccustbasdoc_code\":\"2101123\",\"ccustbasdoc_name\":\"徐老板信息技术有限公司\",\"creceivecustbasid\":\"0001A11000000003GA8W\",\"creceivebascust_code\":\"2101123\",\"creceivebascust_name\":\"徐老板信息技术有限公司\",\"cbiztype\":\"1012A210000000000043\",\"cbiztype_code\":\"r001\",\"cbiztype_name\":\"普通销售（不质检）\",\"cinvmandocid\":\"0001A210000000001H35\",\"cinvmandoc_code\":\"IN0007\",\"cinvmandoc_name\":\"TEST11111\",\"ccustmandocid\":\"0001A11000000003GAH5\",\"ccustmandoc_code\":\"2101123\",\"ccustmandoc_name\":\"徐老板信息技术有限公司\",\"blargessflag\":false,\"cinvbasdocid\":\"0001ZZ10000000000DX1\",\"nnumber\":\"0.01\",\"ddeliverdate\":\"2023-08-21\",\"dsenddate\":\"2023-08-21\",\"btransportcloseflag\":false,\"vsourcereceivecode\":\"30TO4331100000000\",\"csourcebillbodyid\":\"1012F410000000001DG0\",\"crowno\":\"10\",\"ntotaltransnum\":\"0.00000000\",\"bifrowclose\":false,\"vsourcerowno\":\"10\",\"csalereceiveid_bid\":\"1012ZZ10000000001FQT\",\"creceivecustid\":\"0001A11000000003GAH5\",\"creceivecust_code\":\"2101123\",\"creceivecust_name\":\"徐老板信息技术有限公司\",\"csourcebillid\":\"1012F410000000001DFY\",\"vsourcetype\":\"30\"}]}]","taskNumber":"202308220005"}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "",
errormsg: "发货单不支持来源单据类型为12！"
}