API中心

  1. 销售管理
  2. 销售发票
返回

销售发票新增

接口所在U8C版本:U8 cloud2.7以及更高版本
详细描述:用于销售发票新增
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/so/saleinvoice/insert

参数填写指南

请求方式:POST

请求参数(header):

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

请求参数(body):

全量参数来源销售订单来源库存销售出库单带统计型自定义项带备注型自定义项
参数名类型是否数组必填描述默认值示例值
billvos是是销售发票实体
childrenvo是否表体
blargessflagboolean否否是否赠品
cinventoryidstring否否存货
cpackunitidstring否否辅单位
cprojectidstring否否项目
cquoteunitidstring否否报价单位
crownostring否否行号
cupreceipttypestring否否来源单据类型（参照来源单据做单时必填）
cupsourcebillcodestring否否来源单据号（参照来源单据做单时必填）
ddeliverdatestring否否交货日期
frownotestring否否行备注
nitemdiscountratedouble否否单品折扣
nnumberdouble否否数量
noriginalcurmnydouble否否无税金额
noriginalcurnetpricedouble否否无税净价
noriginalcurpricedouble否否无税单价
noriginalcursummnydouble否否价税合计
noriginalcurtaxnetpricedouble否否含税净价
noriginalcurtaxpricedouble否否含税单价
npacknumberdouble否否辅数量
ntaxratedouble否否税率
pk_defdoc1string否否自定义项主键，有20个
vdef1string否否自定义项值，有20个
vfree1string否否自由项1，有5个
vsourcerownostring否是来源单据行号（参照来源单据做单时必填）
parentvo否否表头
cbiztypestring否是业务流
ccalbodyidstring否是库存组织
ccurrencyidstring否否币种
cdeptidstring否否部门
cemployeeidstring否否业务员
coperatoridstring否是制单人
creceiptcorpidstring否是客户
csalecorpidstring否是销售组织
cwarehouseidstring否否仓库
dbilldatestring否否单据日期：如2019-04-18
finvoicetypeint否否发票类型：默认为1。 0增值税专用发票; 1增值税普通发票; 2营业税发票; 3收据; 4其它发票;5增值税电子普通发票
ndiscountrateint否否整单折扣
pk_corpstring否是公司
pk_defdoc1string否否自定义项主键有20个，就不全写了。
vdef1string否否自定义项值有20个，就不全写了
vnotestring否否备注
vreceiptcodestring否否单据号

返回类型参数:

参数名类型是否数组必填描述默认值
data销售发票保存后返回VO
childrenvo是否销售发票表体_查询
blargessflagboolean否否是否赠品
cbatchidstring否否批次号（5.1开始支持）
cinventoryidstring否否存货主键
corder_bidstring否否主键
coriginalbillcodestring否否源头单据号
cpackunitidstring否否辅单位
cprojectidstring否否项目主键
cquoteunitidstring否否报价单位
crownostring否否行号
csaleidstring否否表头主键
csourcebillbodyidstring否否来源单据附表id
csourcebillidstring否否来源单据主表id
cunitidstring否否单位主键
ddeliverdatestring否否交货日期
frownotestring否否行备注
inventory_codestring否否存货编码
inventory_namestring否否存货名称
nitemdiscountratedouble否否单品折扣
nnumberdouble否否数量
noriginalcurdiscountmnydouble否否折扣额
noriginalcurmnydouble否否无税金额
noriginalcurnetpricedouble否否无税净价
noriginalcurpricedouble否否无税单价
noriginalcursummnydouble否否价税合计
noriginalcurtaxmnydouble否否税额
noriginalcurtaxnetpricedouble否否含税净价
noriginalcurtaxpricedouble否否含税单价
npacknumberdouble否否辅数量
ntaxratedouble否否税率
packunit_codestring否否辅单位编码
packunit_namestring否否辅单位名称
pk_defdoc1string否否自定义项主键，有20个。
project_codestring否否项目编码
project_namestring否否项目名称
quoteunit_codestring否否报价单位编码
quoteunit_namestring否否报价单位名称
unit_codestring否否单位编码
unit_namestring否否单位名称
vdef1string否否自定义项值，有20个。
vfre1string否否自由项，有5个
parentvo否否销售发票表头_查询
approver_codestring否否审批人编码
approver_namestring否否审批人名称
biztype_codestring否否业务流编码
biztype_namestring否否业务流名称
calbody_codestring否否库存组织编码
calbody_namestring否否库存组织名称
capproveidstring否否审批人主键
cbiztypestring否否业务流主键
ccalbodyidstring否否库存组织主键
cdeptidstring否否部门主键
cemployeeidstring否否业务员主键
coperatoridstring否否制单人主键
corp_codestring否否公司编码
corp_namestring否否公司名称
creceiptcorpidstring否否客户主键
csalecorpidstring否否销售组织主键
csaleidstring否否主键
customer_codestring否否客户编码
customer_namestring否否客户名称
cwarehouseidstring否否仓库主键
dapprovedatestring否否审批日期
daudittimestring否否审批时间
dbilldatestring否否单据日期
dbilltimestring否否制单时间
dept_codestring否否部门编码
dept_namestring否否部门名称
dmakedatestring否否制单日期
dmoditimestring否否最后修改时间
employee_codestring否否业务员编码
employee_namestring否否业务员名称
iprintcountint否否打印次数
ndiscountratedouble否否整单折扣
operator_codestring否否制单人编码
operator_namestring否否制单人名称
pk_corpstring否否公司主键
pk_defdoc1string否否自定义项主键，有20个
salecorp_codestring否否销售组织编码
salecorp_namestring否否销售组织名称
vdef1string否否自定义项值，有20个
vnotestring否否备注
vreceiptcodestring否否单据号
warehouse_codestring否否仓库编码
warehouse_namestring否否仓库名称

代码示例:

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

请求参数示例:

来源销售订单来源库存销售出库单带统计型自定义项带备注型自定义项

复制代码

{"billvos": [{ "parentvo": { "pk_corp": "2901","cbiztype": "so02","coperatorid": "apilym","creceiptcorpid": "LYX", "cdeptid":"2901-_-2001" },"childrenvo": [{"cinventoryid": "IN0007","nnumber": "1","noriginalcurprice": "99","cupsourcebillcode": "SO23090100001","cupreceipttype": "30","vsourcerowno": "10"}]}]}

正确返回示例:

复制代码

{
    "status": "success",
    "data": "[{\"parentvo\":{\"pk_corp\":\"1010\",\"corp_code\":\"2901\",\"corp_name\":\"lym投资控股有限公司\",\"cbiztype\":\"1010A21000000000003Q\",\"biztype_code\":\"so02\",\"biztype_name\":\"普通销售\",\"creceiptcorpid\":\"0001A21000000001JATZ\",\"creceiptcorpid_code\":\"LYX\",\"creceiptcorpid_name\":\"lyx国电有限公司\",\"coperatorid\":\"0001A2100000000000Y8\",\"operator_code\":\"apilym\",\"operator_name\":\"lym\",\"cdeptid\":\"1010A2100000000001LA\",\"dept_code\":\"2901-_-2001\",\"dept_name\":\"A销售-省内\",\"vreceiptcode\":\"SI2309010001\",\"dbilldate\":\"2023-09-01\",\"dmakedate\":\"2023-09-01\",\"dbilltime\":\"2023-09-01 14:45:25\",\"dmoditime\":\"2023-09-01 14:45:25\",\"creceiptcustomerid\":\"0001A21000000001JATZ\",\"receiptcustomer_code\":\"LYX\",\"receiptcustomer_name\":\"lyx国电有限公司\",\"fstatus\":\"1\",\"ndiscountrate\":\"100\",\"csaleid\":\"1010ZZ10000000001CM1\",\"ccurrencyid\":\"00010000000000000001\",\"ccurrencyid_code\":\"CNY\",\"ccurrencyid_name\":\"人民币\",\"nexchangeotobrate\":\"1.00000000\"},\"childrenvo\":[{\"cinventoryid\":\"0001A210000000001FYU\",\"inventory_code\":\"IN0007\",\"inventory_name\":\"TEST11111\",\"invspec\":\"123\",\"invtype\":\"4\",\"nnumber\":\"1\",\"noriginalcursummny\":\"111.870000\",\"cunitid\":\"0001A2100000000003DG\",\"unit_code\":\"1\",\"unit_name\":\"件1\",\"csaleid\":\"1010ZZ10000000001CM1\",\"creceiptcorpid\":\"0001A21000000001JATZ\",\"cquoteunitid\":\"0001A2100000000003DG\",\"quoteunit_code\":\"1\",\"quoteunit_name\":\"件1\",\"blargessflag\":false,\"noriginalcurprice\":\"99\",\"crowno\":\"10\",\"ntaxrate\":\"13.00000000\",\"noriginalcurtaxprice\":\"111.87\",\"noriginalcurmny\":\"99.000000\",\"noriginalcurtaxmny\":\"12.870000\",\"ndiscountrate\":\"100\",\"nitemdiscountrate\":\"100\",\"noriginalcurnetprice\":\"99.00\",\"noriginalcurtaxnetprice\":\"111.87\",\"noriginalcurdiscountmny\":\"0.00000000\",\"ccustomerid\":\"0001A21000000001JATZ\",\"ddeliverdate\":\"2023-09-01\",\"cupreceipttype\":\"30\",\"cupsourcebillcode\":\"SO23090100001\",\"vsourcerowno\":\"10\",\"nexchangeotobrate\":\"1\"}]}]",
    "taskNumber": "202309010037"
}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "",
errormsg: "nc.vo.pub.BusinessException: 传入数据有的字段为空！第1条数据：表头：[业务流, 制单人, 客户, 公司]第1行表体：[存货, 数量]"
}