接口文档

财咖云接口文档-进销存

更新于 5 天前 · 阅读 35

财咖云ERP进销存接口文档

版本号	1.1.0
发布者	北京财咖网络科技有限公司

财咖云ERP进销存接口文档

一、获取Token

二、公司主体

1．批量新增

（1）请求参数

（2）请求示例

（3）响应

（4）返回示例

三、部门

1．批量新增

（1）请求参数

（2）请求示例

（3）响应

（4）返回示例

四、供应商

1．批量新增

（1）请求参数

（2）请求示例

（3）响应

（4）返回示例

五、客户

1．批量新增

（1）请求参数

（2）请求示例

（3）响应

（4）返回示例

六、人员

1．批量新增

（1）请求参数

（2）请求示例

（3）响应

（4）返回示例

七、商品

1．批量新增

（1）请求参数

（2）响应

（3）请求示例

（4）返回示例

七、计量单位

1．批量新增

（1）请求参数

（2）响应

（3）请求示例

（4）返回示例

八、商品类别

1．批量新增

（1）请求参数

（2）响应

（3）请求示例

（4）返回示例

九、仓库

1．批量新增

（1）请求参数

（2）响应

（3）请求参数

（4）返回示例

十、采购入库单

1．批量新增

（1）请求参数

（2）响应

（3）请求示例

（4）返回示例

十一、销售出库单

1．批量新增

（1）请求参数

（2）响应

（3）请求示例

（4）返回示例

十二、库存调拨单

1．批量新增

（1）请求参数

（2）请求示例

（3）响应

（4）返回示例

十三、其他入库单

1．批量新增

（1）请求参数

（2）请求示例

（3）响应

（4）返回示例

十四、其他出库单

1．批量新增

（1）请求参数

（2）请求示例

（3）响应

（4）返回示例

一、获取Token

接口描述	获取应用accessToken
HTTP URL	openapi/appAccessToken
HTTP Method	GET
备注	appAccessToken的最大有效期是 2 小时

请求参数

名称	类型	必填	描述
appKey	String	是	应用标识（财咖分配）
appSecret	String	是	应用密钥（财咖分配）

响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果
├appAccessToken	String

备注：

所有后续请求需要在请求头中appAccessToken请求，否则会返回401错误。如无特别说明，下列请求均需要有下列请求头。

请求头

名称	类型	必填	描述
CAIKA-AUTH-TOKEN	String	是	上述请求获取到的appAccessToken

二、公司主体

1．批量新增

接口描述	批量新增公司主体
HTTP URL	openapi/accountbook?doBatchSave
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述	长度	精度
parentAccountbookName	String	否		母公司简称	32
accountbookCode	String	是		公司编码	32
accountbookName	String	是		公司简称	32
company	String	是		公司全称	32
registeredCapital	BigDecimal	是		注册资本	32	2
taxpayerType	Integer	是	（1：小规模 2：一般）	纳税人性质	2
useDateTime	Date	否	(2023-01-01)默认当前时间	初始会计期间
baseCurrency	Integer	否	1:人民币	记账本位币	11
multiCurrencyStatus	Integer	否	1:是 0：否	多币种核算	2

（2）请求示例

[ { "accountbookName": "测试公司", "company": "测试公司", "registeredCapital": "100000", "taxpayerType": "1" }, { "accountbookName": "测试公司1", "company": "测试公司1", "registeredCapital": "200000", "taxpayerType": "1" }]

（3）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（4）返回示例

{ "success": true, "msg": "操作成功"}

三、部门

1．批量新增

接口描述	批量新增部门
HTTP URL	openapi/depart?doBatchSave
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述	长度	精度
departCode	String	否		部门编码	32
departName	String	是		部门名称	32
accountbookName	String	是		公司主体	32

（2）请求示例

[ { "departName": "测试部门", "accountbookName": "测试公司", }, { "departName": "测试部门1", "accountbookName": "测试公司", }]

（3）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（4）返回示例

{ "success": true, "msg": "操作成功"}

四、供应商

1．批量新增

接口描述	批量新增供应商
HTTP URL	openapi/supplier?doBatchSave
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述	长度	精度
supplierCode	String	否		供应商编码（唯一）	32
supplierName	String	是		供应商名称（唯一）	32
supplierType	Integer	是	1=公司2=个人	供应商分类	2
accountbookName	String	是		公司主体	32
invoiceType	Integer	否	1=普票 2=专票	发票类型	2
taxRate	BigDecimal	否	如果发票类型是专票，必填	税率	20	2
status	Integer	否	1=启用 0=禁用	供应商状态	2
bankMapList	Object	否		供应商银行
bankName	String	否		开户银行	100
bankAccount	String	否		银行账号	50

（2）请求示例

[ { "supplierName": "测试供应商", "supplierType": "1", "accountbookName": "测试公司", "bankMapList": [ { "bankName": "测试银行", "bankAccount": "11111111111111" }, { "bankName": "测试银行1", "bankAccount": "333333333333333333" } ] }, { "supplierName": "测试供应商1", "supplierType": "1", "accountbookName": "测试公司" }]

（3）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（4）返回示例

{ "success": true, "msg": "操作成功"}

五、客户

1．批量新增

接口描述	批量新增客户
HTTP URL	openapi/customer?doBatchSave
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述	长度	精度
customerCode	String	否		客户编码	32
customerName	String	是		客户名称（唯一）	32
customerType	Integer	是	1=公司 2=个人	客户分类	2
accountbookName	String	是		公司主体	32
invoiceType	Integer	否	1=普票 2=专票	发票类型	2
taxCode	String	否	如果发票类型是专票，必填	纳税人识别号	50
bankName	String	否		开户行名称	100
bankAccount	String	否		开户行账号	50
invoiceAddress	String	否		开票地址	100
invoicePhone	String	否		开票电话	32
customerStatus	Integer	否	1=启用 0=禁用	客户状态	2
bankMapList	Object	否		客户银行
bankName	String	否		开户银行	100
bankAccount	String	否		银行账号	50

（2）请求示例

[ { "customerName": "测试客户", "customerType": "1", "accountbookName": "测试公司", "bankMapList": [ { "bankName": "测试银行", "bankAccount": "33333333333" }, { "bankName": "测试银行1", "bankAccount": "44444444444" } ] }, { "customerName": "测试客户1", "customerType": "1", "accountbookName": "测试公司" }]

（3）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（4）返回示例

{ "success": true, "msg": "操作成功"}

六、人员

1．批量新增

接口描述	批量新增客户
HTTP URL	openapi/user?doBatchSave
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述	长度	精度
realName	String	是		用户名称	32
roleName	String	是		角色名称（逗号分割）	32
accountbookName	String	是		公司主体	32
departName	String	是		部门名称	32
mobilePhone	String	否		手机号	32
bankName	String	否		开户行名称	100
Sex	String	否	1：女 2：男	性别	50
citizenNo	String	否		身份证号	100
email	String	否		邮箱	32
address	String	否		联系地址	100
bankAccountName	String	否		开户银行	100
bankAccountNumber	String	否		收款账号	50

（2）请求示例

[ { "accountbookName": "缺省账簿", "realName": "测试用户1", "roleName": "账套管理员,基础财务权限,凭证中心", "departName": "缺省部门" }, { "accountbookName": "缺省账簿", "realName": "测试用户", "roleName": "账套管理员,凭证中心", "departName": "缺省部门" }]

（3）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（4）返回示例

{ "success": true, "msg": "操作成功"}

七、商品

1．批量新增

接口描述	新增商品信息
HTTP URL	openapi/goods?batchSave
HTTP Method	POST

（1）请求参数

名称	类型	长度	必填	示例值	描述
accountbookId	String	50	是		公司编码code
goodsCode	String	100	是	Ck0001	商品编码(唯一)
goodsName	String	200	是		商品名称
goodsTypeId	String	50	是		商品类别code
goodsBrand	String	200	否		品牌
goodsSpecs	String	500	否		规格型号
goodsUnit	String	50	是		基本单位code
inUnitId	String	50	否		首选入库单位code
outUnitId	String	50	否		首选出库单位code
warehouseId	String	50	是		仓库code
producingArea	String	100	否		产地
visibleRange	Integer		否	0=共有1=私有	私有化
status	Integer		是	1=启用0=禁用	状态
parentCode	String	50	否		父级商品编码
remark	String	200	否		备注
auxiliaryAttribute	Integer		是	1=设置0=未设置	设置辅助属性
priceList	[]		否		预计价格
unitId	String	50	是		计量单位code
purchasePrice	BigDecimal	10,2	否		预计采购价
goodsPrice	BigDecimal	10,2	否		预计销售价
goodsAttributeList	[]		否		辅助属性集合
attributeName	String	200	是		属性名称
attributeDetailId	String	50	是		属性值code

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果

（3）请求示例

[{ "accountbookId": " 003", "goodsCode": "ck000002-001", "goodsName": "测试商品", "goodsTypeId": "test-001", "status": 1, "goodsBrand": "电脑", "goodsSpecs": "笔记本电脑", "visibleRange": 1, "goodsUnit": "test-001", "auxiliaryAttribute": 0, "inUnitId": null, "outUnitId": null, "warehouseId": "test-03", "producingArea": null, "remark": "测试", "parentCode": null, "goodsAttributeList": null, "priceList": [{ "unitId": "test-001", "purchasePrice": 5, "goodsPrice": 10 }]}]

（4）返回示例

{ "success": true, "msg": "操作成功", "obj": null, "result": null, "attributes": null}

七、 计量单位

1．批量新增

接口描述	新增计量单位信息
HTTP URL	openapi/unit?batchSave
HTTP Method	POST

（1）请求参数

名称	类型	长度	必填	示例值	描述
unitType	Integer		是	1=基本单位2=多单位	计量单位类型
code	String	50	是		编码（唯一）
unitName	String	50	是		名称
unitList	[]		否		辅助单位集合
code	String	50	是		辅助单位编码
unitName	String	50	是		辅助单位名称
switchValue	BigDecimal	10,2	是		转换值

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果

（3）请求示例

[{ "code":"u001", "unitName": "个", "unitType": 2, "unitList": [{ "code":"u001-01", "unitName": "套", "switchValue": 3.00 }, { "code":"u001-02", "unitName": "箱", "switchValue": 9.00 } ]}]

（4）返回示例

{ "success": true, "msg": "操作成功", "result": null}

八、 商品类别

1．批量新增

接口描述	新增商品类别信息
HTTP URL	openapi/goodsType?batchSave
HTTP Method	POST

（1）请求参数

名称	类型	长度	必填	示例值	描述
typeName	String	100	是		类别名称
code	String	50	是		编码（唯一）
parentId	String	50	否		上级类别code
status	Integer		是	1=启用0=禁用	状态

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果

（3）请求示例

[{ "typeName": "小米手机", "code": "test-004-01", "parentId": "test-004", "status": 1}]

（4）返回示例

{ "success": true, "msg": "操作成功", "result": null}

九、仓库

1．批量新增

接口描述	新增仓库信息
HTTP URL	openapi/warehouse?batchSave
HTTP Method	POST

（1）请求参数

名称	类型	长度	必填	示例值	描述
accountbookId	String	36	是		账簿编码code
warehouseCode	String	50	是		仓库编码
warehouseName	String	50	是		仓库名称
warehouseProvince	String	50	否		仓库所在省份
warehouseCity	String	50	否		仓库所在城市
warehouseArea	String	50	否		仓库所在地区
warehouseTown	String	50	否		仓库所在乡镇
warehouseAddress	String	200	否		仓库详细地址
warehouseTel	String	50	否		仓库固定电话
managerName	String	50	否		管理员姓名
managerMobile	String	50	否		管理员手机号
remark	String	200	否		备注
status	Integer		是	1=启用0=禁用	状态

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果

（3）请求参数

[{ "accountbookId": "003", "warehouseName": "上海仓", "warehouseCode": "005", "status": 1}]

（4）返回示例

{ "success": true, "msg": "操作成功", "result": null}

一、

二、

三、

四、

五、

六、

七、

八、

九、

十、 自定义模板

1．获取模板全部字段

接口描述	获取模板全部字段
HTTP URL	/openapi/template?getAllColumn
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述
tableName	String	是	tb_jxc_sale_out_stock	模板名称
templateId	String	是	40288157888051a40188843d9fec0072	模板id

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果
	obj	[]	是		销售出库字段集合
	defaultname	String	否		默认名称
	customname	String	是	运费单价	字段名称
	fieldname	String	是	billDetailField0003 单据详情自定义字段billField0003 单据头自定义字段	字段
	showtype	String	是	Text 字符串类型	字段类型
	dicttable	String	否		字典
	dictid	String	否		字典key
	dictname	String	否		字典value

（3）请求示例

{"tableName": "tb_jxc_sale_out_stock","templateId": "40288157888051a40188843d9fec0072"}

（4）返回示例

{ "success":true, "msg":"操作成功", "obj":[ { "defaultname":"单据编号", "customname":"单据编号", "iscustom":0, "fieldname":"code", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"关联代销单据", "customname":"关联代销单据", "iscustom":0, "fieldname":"fictitiousOrderCode", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"业务日期", "customname":"业务日期", "iscustom":0, "fieldname":"businessDateTime", "showtype":"yyyy-MM-dd", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"销售组织", "customname":"销售组织", "iscustom":0, "fieldname":"accountbookName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"销售部门", "customname":"销售部门", "iscustom":0, "fieldname":"submitterDepartmentName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"销售人员", "customname":"销售人员", "iscustom":0, "fieldname":"saleUserName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"客户名称", "customname":"客户名称", "iscustom":0, "fieldname":"customerName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"发货组织", "customname":"发货组织", "iscustom":0, "fieldname":"accountbookIdSendName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"币别", "customname":"币别", "iscustom":0, "fieldname":"currencyTypeName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"汇率", "customname":"汇率", "iscustom":0, "fieldname":"exchangeRate", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"销售金额(原币)", "customname":"销售金额(原币)", "iscustom":0, "fieldname":"originAmount", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"提交人", "customname":"提交人", "iscustom":0, "fieldname":"submitterName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"提交日期", "customname":"提交日期", "iscustom":0, "fieldname":"createDate", "showtype":"yyyy-MM-dd", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"收货人", "customname":"收货人", "iscustom":0, "fieldname":"contacts", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"收货人电话", "customname":"收货人电话", "iscustom":0, "fieldname":"telephone", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"收货地址", "customname":"收货地址", "iscustom":0, "fieldname":"address", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"提交退货状态", "customname":"提交退货状态", "iscustom":0, "fieldname":"submitReceiveStatusName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"退货状态", "customname":"退货状态", "iscustom":0, "fieldname":"receiveStatusName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"单据状态", "customname":"单据状态", "iscustom":0, "fieldname":"statusName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"快递公司", "customname":"快递公司", "iscustom":0, "fieldname":"freightName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"快递单号", "customname":"快递单号", "iscustom":0, "fieldname":"freightNo", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"下推应收单数", "customname":"下推应收单数", "iscustom":0, "fieldname":"pushDownCount", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"施工单位", "customname":"施工单位", "iscustom":1, "fieldname":"billField0001", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"工程名称", "customname":"工程名称", "iscustom":1, "fieldname":"billField0002", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"运输方式", "customname":"运输方式", "iscustom":1, "fieldname":"billField0004", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"备注", "customname":"备注", "iscustom":0, "fieldname":"remark", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"商品类型", "customname":"商品类型", "iscustom":0, "fieldname":"billDetail.goodsTypeName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"BOM版本", "customname":"BOM版本", "iscustom":0, "fieldname":"billDetail.bomVersion", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"商品编码", "customname":"商品编码", "iscustom":0, "fieldname":"billDetail.goodsCode", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"商品名称", "customname":"商品名称", "iscustom":0, "fieldname":"billDetail.goodsName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"规格型号", "customname":"规格型号", "iscustom":0, "fieldname":"billDetail.goodsSpecs", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"属性", "customname":"属性", "iscustom":0, "fieldname":"billDetail.auxiliaryAttributeNam", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"单位", "customname":"单位", "iscustom":0, "fieldname":"billDetail.goodsUnitName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"仓库名称", "customname":"仓库名称", "iscustom":0, "fieldname":"billDetail.warehouseName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"数量", "customname":"数量", "iscustom":0, "fieldname":"billDetail.number", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"含税单价", "customname":"含税单价", "iscustom":0, "fieldname":"billDetail.goodsPriceTax", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"折扣率(%)", "customname":"折扣率(%)", "iscustom":0, "fieldname":"billDetail.discountRate", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"折扣额", "customname":"折扣额", "iscustom":0, "fieldname":"billDetail.discountAmount", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"价税合计(原币)", "customname":"价税合计(原币)", "iscustom":0, "fieldname":"billDetail.originAmount", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"发票类型", "customname":"发票类型", "iscustom":0, "fieldname":"billDetail.invoiceTypeName", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"税率(%)", "customname":"税率(%)", "iscustom":0, "fieldname":"billDetail.taxRate", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"税额", "customname":"税额", "iscustom":0, "fieldname":"billDetail.taxAmount", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"未税合计(原币)", "customname":"未税合计(原币)", "iscustom":0, "fieldname":"billDetail.originTotalAmount", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"未提交数量", "customname":"未提交数量", "iscustom":0, "fieldname":"billDetail.notSubmitNumber", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"未下推数量", "customname":"未下推数量", "iscustom":0, "fieldname":"billDetail.notPushNumber", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"退货数量", "customname":"退货数量", "iscustom":0, "fieldname":"billDetail.receiveNumber", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"运距", "customname":"运距", "iscustom":1, "fieldname":"billDetailField0002", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"运输单价", "customname":"运费单价", "iscustom":1, "fieldname":"billDetailField0003", "showtype":"number", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"车牌号码", "customname":"车牌号", "iscustom":1, "fieldname":"billDetailField0004", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"关联单据号", "customname":"关联单据号", "iscustom":1, "fieldname":"billDetailField0005", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null }, { "defaultname":"备注（明细）", "customname":"备注（明细）", "iscustom":0, "fieldname":"billDetail.remark", "showtype":"text", "dicttable":null, "dictid":null, "dictname":null } ], "result":null, "attributes":null}

十一、 采购订单

1．批量获取采购订单

接口描述	批量获取采购订单
HTTP URL	/openapi/purchase?getPurchaseOrderList
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	必填	示例值	描述
page	String	否	默认 1	分页页码
rows	String	否	默认 500	每页条数
submitDateTime_begin	String	是	2023-12-01 00:00:00	开始时间
submitDateTime_end	String	是	2023-12-01 23:59:59	结束时间
templateId	String	是		模板id
accountbookCode	String	是		采购组织编码

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果
code	String		单据编号
templateId	String	默认值 2c91e302887ca4d80188806f6eec3bf0	模板id
businessDateTime	String	1900-01-01 00:00:01	业务日期
accountbookId	String		采购组织
accountbookCode	String		采购组织编码
accountbookIdReceive	String		收货组织
accountbookCodeReceive	String		收货组织编码
supplierId	String		供应商
supplierName	String		供应商
purchaseUserId	String		采购人
purchaseUserName	String		采购人
submitterDepartmentId	String		采购部门
submitterDepartmentName	String		采购部门
amount	BigDecimal	(20,2)	采购金额
originAmount	BigDecimal	(20,2)	采购金额（原币）
currencyTypeId	Integer	接口获取（不涉及外币，填1）	币种
status	Integer	10 暂存 20 提交	单据状态
exchangeRate	BigDecimal	（不涉及外币，填1）	汇率
remark	String		备注
billDetailList	[]		采购入库单详情集合
valueFlag	Integer	0：不取参考价 1：取参考价	取参考价标志
id	String		详情id
warehouseId	String		仓库
warehouseCode	String		仓库编码
goodsCode	String		商品编码
goodsBrand	String		商品品牌
goodsId	String		商品id
unitId	String		单位
unitCode	String		单位编码
unitAmount	BigDecimal	(22,8)	计价数量
price	BigDecimal	(22,8)	含税单价
invoiceType	Integer	1=普票 2=专票	发票类型
discountRate	BigDecimal	80.01	折扣率（%）
discountAmount	BigDecimal	19.99	折扣额
taxRate	BigDecimal		税率(%)
taxAmount	BigDecimal		税额
originTaxAmount	BigDecimal		税额(原币)
untaxedAmount	BigDecimal		未税金额
originUntaxedAmount	BigDecimal		未税金额（原币）
amount	BigDecimal		价税合计
originAmount	BigDecimal		价税合计（原币）
remark	String		详情备注

（3）请求示例

{ "code": "PO00000009", "accountbookCode": "AC003"}

（4）返回示例

{ "success": true, "msg": "操作成功", "obj": { "page": 1, "rows": 1, "total": 1, "results": [ { "id": "2c91e3028c1d394b018c1e427bd02252", "templateId": "40288147883d4a6f01883d6a19aa0092", "code": "PO00000009", "accountbookId": "2c91e3028b44d4df018b4bdbc3cd7437", "accountbookName": "XX公司", "accountbookCode": "AC003", "submitterDepartmentId": "2c91e3028b63cb8a018b65f97ff331bb", "submitterDepartmentName": "技术部", "requisitionDepartmentId": "2c91e3028b63cb8a018b65f97ff331bb", "purchaseUserId": "2c91e3028b63cb8a018b6b4204ce0b74", "requisitionUserId": "2c91e3028b63cb8a018b6b4204b90b70", "purchaseUserName": "张恒", "supplierDetailId": "2c91e3028b8789dd018ba88339122d2a", "supplierName": "胡书", "supplierId": null, "accountbookIdReceive": "2c91e3028b44d4df018b4bdbc3cd7437", "accountbookIdReceiveName": "X公司", "accountbookCodeReceive": null, "currencyTypeId": 1, "currencyTypeName": "人民币", "exchangeRate": 1, "originAmount": 2500, "businessDateTime": "2023-11-30 00:00:01", "deliveryDate": "2023-11-30 00:00:00", "amount": 2500, "type": null, "submitStockStatus": 20, "submitStockStatusName": "部分提交", "stockStatus": 20, "stockStatusName": "部分入库", "closeStatus": 1, "status": 30, "statusName": "已审批", "terminateStatus": 1, "terminateStatusName": "进行中", "oaModule": null, "pushDownCount": null, "oaBillUserNodeListJson": null, "remark": "", "submitterId": "2c91e3028b44d4df018b4b635f2466b0", "submitterName": "张三", "reviewerId": null, "submitDateTime": "2023-11-30 11:25:23", "billDetailList": [ { "id": "2c91e3028c1d394b018c1e427bd52253", "fieldValueMap": null, "orderId": "2c91e3028c1d394b018c1e427bd02252", "goodsCode": "1001003001", "goodsId": "2c91e3028bb13693018bb382844f35ea", "goodsName": "机制砂0-3", "goodsSpecs": null, "auxiliaryAttributeName": null, "goodsBrand": null, "goodsUnitName": null, "unitCode": null, "unitId": "2c91e3028b44d4df018b4bf6882a7834", "warehouseId": "2c91e3028b63cb8a018b852ca3954495", "warehouseName": "原材料仓库", "warehouseCode": null, "unitAmount": 50, "price": 50, "invoiceType": 1, "invoiceName": "普票", "discountRate": null, "discountAmount": null, "taxRate": null, "taxAmount": null, "originTaxAmount": null, "untaxedAmount": 2500, "originUntaxedAmount": 2500, "amount": 2500, "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 2500, "remark": "", "notSubmitNumber": 20, "inStockNumber": 30, "stockStatus": 20, "unitName": "吨", "baseNumber": 50, "baseUnit": "2c91e3028b44d4df018b4bf6882a7834", "valueFlag": null } ] } ] } }

2．获取采购订单

接口描述	获取采购订单
HTTP URL	/openapi/purchase?getPurchaseOrder
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	必填	示例值	描述
code	String	是		单据编号
accountbookCode	String	是		采购组织编码

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果
code	String		单据编号
templateId	String	默认值 2c91e302887ca4d80188806f6eec3bf0	模板id
businessDateTime	String	1900-01-01 00:00:01	业务日期
accountbookId	String		采购组织
accountbookCode	String		采购组织编码
accountbookIdReceive	String		收货组织
accountbookCodeReceive	String		收货组织编码
supplierId	String		供应商
supplierName	String		供应商
purchaseUserId	String		采购人
purchaseUserName	String		采购人
submitterDepartmentId	String		采购部门
submitterDepartmentName	String		采购部门
amount	BigDecimal	(20,2)	采购金额
originAmount	BigDecimal	(20,2)	采购金额（原币）
currencyTypeId	Integer	接口获取（不涉及外币，填1）	币种
status	Integer	10 暂存 20 提交	单据状态
exchangeRate	BigDecimal	（不涉及外币，填1）	汇率
remark	String		备注
billDetailList	[]		采购入库单详情集合
valueFlag	Integer	0：不取参考价 1：取参考价	取参考价标志
id	String		详情id
warehouseId	String		仓库
warehouseCode	String		仓库编码
goodsCode	String		商品编码
goodsBrand	String		商品品牌
goodsId	String		商品id
unitId	String		单位
unitCode	String		单位编码
unitAmount	BigDecimal	(22,8)	计价数量
price	BigDecimal	(22,8)	含税单价
invoiceType	Integer	1=普票 2=专票	发票类型
discountRate	BigDecimal	80.01	折扣率（%）
discountAmount	BigDecimal	19.99	折扣额
taxRate	BigDecimal		税率(%)
taxAmount	BigDecimal		税额
originTaxAmount	BigDecimal		税额(原币)
untaxedAmount	BigDecimal		未税金额
originUntaxedAmount	BigDecimal		未税金额（原币）
amount	BigDecimal		价税合计
originAmount	BigDecimal		价税合计（原币）
remark	String		详情备注

（3）请求示例

{ "code": "PO00000009", "accountbookCode": "AC003"}

（4）返回示例

{ "success": true, "msg": "操作成功", "result": { "id": "2c91e3028c1d394b018c1e427bd02252", "templateId": "40288147883d4a6f01883d6a19aa0092", "code": "PO00000009", "accountbookId": "2c91e3028b44d4df018b4bdbc3cd7437", "accountbookName": "XX公司", "accountbookCode": "AC003", "submitterDepartmentId": "2c91e3028b63cb8a018b65f97ff331bb", "submitterDepartmentName": "技术部", "requisitionDepartmentId": "2c91e3028b63cb8a018b65f97ff331bb", "purchaseUserId": "2c91e3028b63cb8a018b6b4204ce0b74", "requisitionUserId": "2c91e3028b63cb8a018b6b4204b90b70", "purchaseUserName": "张恒", "supplierDetailId": "2c91e3028b8789dd018ba88339122d2a", "supplierName": "胡森", "supplierId": null, "accountbookIdReceive": "2c91e3028b44d4df018b4bdbc3cd7437", "accountbookIdReceiveName": "XX公司", "accountbookCodeReceive": null, "currencyTypeId": 1, "currencyTypeName": "人民币", "exchangeRate": 1, "originAmount": 2500, "businessDateTime": "2023-11-30 00:00:01", "deliveryDate": "2023-11-30 00:00:00", "amount": 2500, "type": null, "submitStockStatus": 20, "submitStockStatusName": "部分提交", "stockStatus": 20, "stockStatusName": "部分入库", "closeStatus": 1, "status": 30, "statusName": "已审批", "terminateStatus": 1, "terminateStatusName": "进行中", "oaModule": null, "pushDownCount": null, "oaBillUserNodeListJson": null, "remark": "", "submitterId": "2c91e3028b44d4df018b4b635f2466b0", "submitterName": "张三", "reviewerId": null, "submitDateTime": "2023-11-30 11:25:23", "billDetailList": [ { "id": "2c91e3028c1d394b018c1e427bd52253", "fieldValueMap": null, "orderId": "2c91e3028c1d394b018c1e427bd02252", "goodsCode": "1001003001", "goodsId": "2c91e3028bb13693018bb382844f35ea", "goodsName": "机制砂0-3", "goodsSpecs": null, "auxiliaryAttributeName": null, "goodsBrand": null, "goodsUnitName": null, "unitCode": null, "unitId": "2c91e3028b44d4df018b4bf6882a7834", "warehouseId": "2c91e3028b63cb8a018b852ca3954495", "warehouseName": "原材料仓库", "warehouseCode": null, "unitAmount": 50, "price": 50, "invoiceType": 1, "invoiceName": "普票", "discountRate": null, "discountAmount": null, "taxRate": null, "taxAmount": null, "originTaxAmount": null, "untaxedAmount": 2500, "originUntaxedAmount": 2500, "amount": 2500, "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 2500, "remark": "", "notSubmitNumber": 20, "inStockNumber": 30, "stockStatus": 20, "unitName": "吨", "baseNumber": 50, "baseUnit": "2c91e3028b44d4df018b4bf6882a7834", "valueFlag": null } ] } }

3．获取采购订单终止状态

接口描述	获取采购订单终止状态
HTTP URL	/openapi/purchase?getPurchaseOrderTerminateStatusList
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

名称	类型	必填	示例值	描述
operatetime_begin	String	是	2023-12-01 00:00:00	开始时间
operatetime_end	String	是	2023-12-01 23:59:59	结束时间

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果
	Id	String	是		id
	billId	String	是	默认值 2c91e302887ca4d80188806f6eec3bf0	单据id
	operatetime	String	是	1900-01-01 00:00:01	操作日期
	operatetype	Integer	是	终止状态 1 进行中 2 已终止 3 已完成	终止状态
	billType	Integer	是	102 销售订单 101 采购订单	单据类型
	logcontent	String	否		操作内容

（3）请求示例

{ "operatetime_begin": "2023-11-30 11:25:23", "operatetime_end": "2023-11-30 11:25:23" }

（4）返回示例

{ "success": true, "msg": "操作成功", "code": 200, "obj": { "page": 1, "rows": 1000000, "sort": null, "order": "asc", "field": null, "treefield": null, "results": [ { "id": "2c91e3029374de1c01938683af7a6ea6", "userid": "2c91e3028ccc4602018cd3bcca6120c5", "realname": "XX艳", "operatetime": "2024-12-02 16:36:37", "operatetime_begin": null, "operatetime_end": null, "operatetype": 2, "billType": 101, "billId": "2c91e3028e6317fb018e64c514e13836", "logcontent": "销售订单已终止" }, { "id": "2c91e3029374de1c01938a7f1efa1de9", "userid": "2c91e3028ccc4602018cd3bbca5e20bc", "realname": "XX楠", "operatetime": "2024-12-03 11:10:07", "operatetime_begin": null, "operatetime_end": null, "operatetype": 2, "billType": 101, "billId": "2c91e3028ea0ed64018eabbcbf641c6b", "logcontent": "销售订单已终止" } ], "total": 2, "footer": null, "footerSeparator": ",", "sqlbuilder": null, "dataStyle": "easyui" }, "result": null, "attributes": null }

十二、 采购入库单

1．批量新增

接口描述	批量新增采购入库单
HTTP URL	/openapi/purchase? batchAddPurchaseWarehousingOrder
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	长度	必填	示例值	描述
code	String	32	是		单据编号
templateId	String	32	是	默认值 2c91e302887ca4d80188806f6eec3bf0	模板id
businessDateTime	String	32	是	1900-01-01 00:00:01	业务日期
accountbookId	String	32	否		采购组织
accountbookCode	String	32	是		采购组织编码
accountbookIdReceive	String	32	否		收货组织
accountbookCodeReceive	String	32	是		收货组织编码
supplierId	String	32	否		供应商
supplierName	String	32	是		供应商
purchaseUserId	String	32	否		采购人
purchaseUserName	String	32	是		采购人
submitterDepartmentId	String	32	否		采购部门
submitterDepartmentName	String	32	是		采购部门
amount	BigDecimal	20	是	(20,2)	采购金额
originAmount	BigDecimal	20	是	(20,2)	采购金额（原币）
currencyTypeId	Integer	1	是	接口获取（不涉及外币，填1）	币种
status	Integer	3	是	10 暂存 20 提交	单据状态
exchangeRate	BigDecimal	20	是	（不涉及外币，填1）	汇率
fieldValueMap	Map<String, Object>	value长度500	是	Key->billField0001Value->String	自定义字段
remark	String	500	否		备注
billDetailList	[]		是		采购入库单详情集合
valueFlag	Integer	1	是	0：不取参考价 1：取参考价	取参考价标志
sourceBillId	String	32	否	有关联单据时必填	关联采购订单Id
code	String	32	否	有关联单据时必填	关联采购订单编码
orderDetailId	String	32	否	有关联单据时必填	关联采购订单明细Id
sourceBillType	Integer	32	否	固定值 101没有关联单据的情况下不用填	关联采购订单类型
warehouseId	String	32	否		仓库
warehouseCode	String	32	是		仓库编码
goodsCode	String	32	是		商品编码
goodsBrand	String	32	否		商品品牌
goodsId	String	32	否		商品id
unitId	String	32	否		单位
unitCode	String	32	是		单位编码
unitAmount	BigDecimal	22	是	(22,8)	计价数量
price	BigDecimal	22	是	(22,8)	含税单价
invoiceType	Integer	1	是	1=普票 2=专票	发票类型
discountRate	BigDecimal	22	否	80.01	折扣率（%）
discountAmount	BigDecimal	22	否	19.99	折扣额
taxRate	BigDecimal	22	否		税率(%)
taxAmount	BigDecimal	22	否		税额
originTaxAmount	BigDecimal	22	是		税额(原币)
untaxedAmount	BigDecimal	22	是		未税金额
originUntaxedAmount	BigDecimal	22	是		未税金额（原币）
amount	BigDecimal	22	是		价税合计
originAmount	BigDecimal	22	是		价税合计（原币）
fieldValueMap	Map<String, Object>	value长度500	是	Key->billDetailField0001Value->String	自定义字段
remark	String	500	否		详情备注

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（3）请求示例

[ { "code": "20220101101050888123", "templateId": "40288157888051a40188843d9fec0072", "accountbookCode": "AC0002", "accountbookCodeReceive": "AC0001", "submitterDepartmentName": "采购部门", "purchaseUserName": "XX采购人", "supplierName": "XX供应商", "currencyTypeId": 1, "exchangeRate": 1, "status": 20, "amount": 200, "originAmount": 200, "businessDateTime": "2022-01-12 00:00:01", "remark": "接口测试", "fieldValueMap": { "billField0001": "SS个人", "billField0002": "CC工程", "billField0005": "XXX商贸有限公司" }, "billDetailList": [ { "goodsCode": "SP001", "valueFlag ": 1, "unitCode": "DW001", "warehouseCode": "CK001", "unitAmount": 10, "price": 10, "invoiceType": 1, "discountRate": "", "discountAmount": "", "taxRate": "", "originTaxAmount": "", "originUntaxedAmount": 100, "originAmount": 100, "fieldValueMap": { "billDetailField0002": "京A57", "billDetailField0001": 0 }, "remark": "接口测试详情" }, { "goodsCode": "SP001", "valueFlag ": 1, "unitCode": "DW001", "warehouseCode": "CK001", "unitAmount": 10, "price": 10, "invoiceType": 1, "discountRate": "", "discountAmount": "", "taxRate": "", "originTaxAmount": "", "originUntaxedAmount": 100, "originAmount": 100, "fieldValueMap": { "billDetailField0002": "京A57", "billDetailField0001": 0 }, "remark": "接口测试详情" } ] } ]

（4）返回示例

{ "success": true, "msg": "操作成功"}

十三、 采购退货单

1. 批量新增

接口描述	批量新增采购退货单
HTTP URL	/openapi/purchase?batchAddPurchaseReturnOrder
HTTP Method	POST

i. 请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	长度	必填	示例值	描述
templateId	String	32	是	默认值 402881c18842364c01884286bffe0063	模板id
code	String	32	是		单据编号
businessDateTime	String	32	是	1900-01-01 00:00:01	业务日期
accountbookId	String	32	否		采购组织
accountbookCode	String	32	是		采购组织编码
accountbookIdReceive	String	32	否		收货组织
accountbookCodeReceive	String	32	是		收货组织编码
supplierId	String	32	否		供应商
supplierName	String	32	是		供应商
purchaseUserId	String	32	否		采购人
purchaseUserName	String	32	是		采购人
submitterDepartmentId	String	32	否		采购部门
submitterDepartmentName	String	32	是		采购部门
amount	BigDecimal	20	是	(20,2)	采购金额
originAmount	BigDecimal	20	是	(20,2)	采购金额（原币）
currencyTypeId	Integer	1	是	接口获取（不涉及外币，填1）	币种
status	Integer	3	是	10 暂存 20 提交	单据状态
exchangeRate	BigDecimal	20	是	（不涉及外币，填1）	汇率
fieldValueMap	Map<String, Object>	value长度500	是	Key->billField0001Value->String	自定义字段
remark	String	500	否		备注
billDetailList	[]		是		采购入库单详情集合
valueFlag	Integer	1	是	0：不取参考价 1：取参考价	取参考价标志
code	String	32	否	关联采购入库单时必填	关联采购入库单编码
orderDetailId	String	32	否	关联采购入库单时必填	关联采购入库单详情id
warehouseId	String	32	否		仓库
warehouseCode	String	32	是		仓库编码
goodsCode	String	32	是		商品编码
goodsBrand	String	32	否		商品品牌
goodsId	String	32	否		商品id
unitId	String	32	否		单位
unitCode	String	32	是		单位编码
unitAmount	BigDecimal	22	是	(22,8)	计价数量
price	BigDecimal	22	是	(22,8)	含税单价
invoiceType	Integer	1	是	1=普票 2=专票	发票类型
discountRate	BigDecimal	22	否	80.01	折扣率（%）
discountAmount	BigDecimal	22	否	19.99	折扣额
taxRate	BigDecimal	22	否		税率(%)
taxAmount	BigDecimal	22	否		税额
originTaxAmount	BigDecimal	22	是		税额(原币)
untaxedAmount	BigDecimal	22	是		未税金额
originUntaxedAmount	BigDecimal	22	是		未税金额（原币）
amount	BigDecimal	22	是		价税合计
originAmount	BigDecimal	22	是		价税合计（原币）
fieldValueMap	Map<String, Object>	value长度500	是	Key->billDetailField0001Value->String	自定义字段
remark	String	500	否		详情备注

ii. 响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果

iii. 请求示例

iv. 返回示例

{ "success": true, "msg": "操作成功"}

八、

九、

十、

十一、

十四、 销售订单

1．批量获取销售订单

接口描述	批量获取销售订单
HTTP URL	/openapi/sale?getJxcSaleOrderList
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	必填	示例值	描述
page	String	否	默认 1	分页页码
rows	String	否	默认 500	每页条数
submitDateTime_begin	String	是	2023-12-01 00:00:00	开始时间
submitDateTime_end	String	是	2023-12-01 23:59:59	结束时间
templateId	String	是		模板id
accountbookCode	String	是		销售组织编码
accountbookCodeSend	String	否		发货组织编码

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果
code	String		单据编号
templateId	String	默认值 40288157888051a40188843d9fec0072	模板id
businessDateTime	String	1900-01-01 00:00:01	业务日期
accountbookCode	String		销售组织
accountbookCodeSend	String		发货组织
customerName	String		客户
saleUserName	String		销售人
submitterDepartmentName	String		销售部门
amount	BigDecimal	(20,2)	销售金额
originAmount	BigDecimal	(20,2)	销售金额（原币）
currencyTypeId	Integer	接口获取（不涉及外币，填1）	币种
exchangeRate	BigDecimal	（不涉及外币，填1）	汇率
status	Integer	10 暂存 20 提交	单据状态
remark	String		备注
billDetailList	[]		销售出库库单详情集合
valueFlag	Integer	0：不取参考价 1：取参考价	取参考价标志
id	String		详情id
warehouseCode	String		仓库
goodsCode	String		商品编码
goodsId	String		商品id
unitCode	String		单位
unitAmount	BigDecimal	(22,8)	计价数量
price	BigDecimal	(22,8)	含税单价
invoiceType	Integer	1=普票 2=专票	发票类型
discountRate	BigDecimal	80.01	折扣率（%）
discountAmount	BigDecimal	19.99	折扣额
taxRate	String		税率(%)
taxAmount	BigDecimal		税额
originTaxAmount	BigDecimal		税额(原币)
untaxedAmount	BigDecimal		未税金额
originUntaxedAmount	BigDecimal		未税金额（原币）
amount	BigDecimal		价税合计
originAmount	BigDecimal		价税合计（原币）
remark	String		详情备注

（3）请求示例

{"page": 1,"rows": 20,"submitDateTime_begin": "2023-12-01","submitDateTime_end": "2023-12-07","templateId": "4028812a88710fc601887b9d74aa016c","accountbookCode": "AC005"}

（4）返回示例

{ "success": true, "msg": "操作成功", "code": 200, "obj": { "page": 1, "rows": 100, "results": [ { "page": 1, "rows": 10, "id": "2c91e302967cbc170196859ea3012060", "code": "SO00003617", "businessDateTime": "2025-04-30 00:00:00", "accountbookId": "2c91e3028b44d4df018b4bda82fc7517", "accountbookCode": "AC002", "submitterDepartmentId": "2c91e3028b63cb8a018b65f97fa231a4", "submitterDepartmentName": "经营部", "saleUserId": "2c91e30291a2b0090191b68581f87a2f", "saleUserName": "XX馨", "customerDetailId": "2c91e3028ce46a29018ce6da6edd1564", "customerId": null, "customerName": "北京XX有限公司", "accountbookIdSend": "2c91e3028b44d4df018b4bda82fc7517", "accountbookCodeSend": "AC002", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 450, "amount": 900, "createDate": "2025-04-30 15:34:48", "submitDateTime": "2025-04-30 15:37:03", "status": 30, "submitterId": "2c91e30291a2b0090191b68581f87a3f", "remark": "", "billDetailList": [ { "id": "2c91e302967cbc17019685a0a79621e2", "saleOrderId": "2c91e302967cbc170196859ea3012060", "goodsId": "2c91e3028bb13693018bb382809e3523", "goodsCode": "1001001002", "goodsName": "XX青", "goodsSpecs": "70#", "auxiliaryAttributeName": null, "goodsBrand": null, "unitName": "吨", "warehouseId": "2c91e3028b63cb8a018b852ca3784491", "warehouseCode": "001", "warehouseName": "原材料仓库", "unitAmount": 10, "price": 45, "discountRate": null, "discountAmount": null, "amount": 450, "unitId": "2c91e3028b44d4df018b4bf6882a7833", "unitCode": "U001", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 450, "invoiceType": 1, "invoiceTypeName": "普票", "taxRate": "13", "taxAmount": 51.77, "originTaxAmount": 51.77, "untaxedAmount": 398.23, "originUntaxedAmount": 398.23, "remark": "", "fieldValueMap": { "billDetailField0001": "", "billDetailField0002": "23", "billDetailField0003": "8", "billDetailField0004": "京A15", "billDetailField0005": "" }, "notSubmitNumber": 0, "outNumber": 10 } ], "templateId": "4028812a88710fc601887b9d74aa016c", "accountbookName": "A公司", "accountbookIdSendName": "C公司", "deliveryDate": "2025-04-30 00:00:00", "currencyTypeName": "人民币", "submitterName": "XX馨", "submitStockStatus": 30, "submitStockStatusName": "全部提交", "stockStatus": 50, "stockStatusName": "未出库", "statusName": "已审批", "terminateStatus": 1, "terminateStatusName": "进行中", "fieldValueMap": { "billField0001": "11", "billField0003": "北京", "billField0006": "2025-04-30 00:00:00" } }, { "page": 1, "rows": 10, "id": "2c91e30296ea68de0196f0be526367d1", "code": "SO00003620", "businessDateTime": "2025-05-21 00:00:00", "accountbookId": "2c91e3028b44d4df018b4bda82fc7517", "accountbookCode": "AC002", "submitterDepartmentId": "2c91e3028b44d4df018b4bda83037518", "submitterDepartmentName": "总经理办公室", "saleUserId": "2c91e3028b44d4df018b4b6424c066c0", "saleUserName": "XX颖", "customerDetailId": "2c91e3028ce46a29018ce6da6edd1564", "customerName": "北京XX有限公司", "accountbookIdSend": "2c91e3028b44d4df018b4bda82fc7517", "accountbookCodeSend": "AC002", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 1000, "amount": 1000, "createDate": "2025-05-21 10:48:47", "submitDateTime": "2025-05-21 14:58:49", "status": 30, "submitterId": "2c91e3028b44d4df018b4b6424c06630", "remark": "", "billDetailList": [ { "id": "2c91e30296ea68de0196f1a33d011aa7", "saleOrderId": "2c91e30296ea68de0196f0be526367d1", "goodsId": "2c91e3028bb13693018bb38280f33536", "goodsCode": "1001001008", "goodsName": "高XX", "auxiliaryAttributeName": null, "unitName": "吨", "warehouseId": "2c91e3028b63cb8a018b852ca3783391", "warehouseCode": "001", "warehouseName": "原材料仓库", "unitAmount": 10, "price": 100, "discountRate": null, "discountAmount": null, "amount": 1000, "unitId": "2c91e3028b44d4df018b4bf6882a7833", "unitCode": "U001", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 1000, "invoiceType": 2, "invoiceTypeName": "专票", "taxRate": "13", "taxAmount": 115.04, "originTaxAmount": 115.04, "untaxedAmount": 884.96, "originUntaxedAmount": 884.96, "remark": "", "fieldValueMap": { "billDetailField0001": "", "billDetailField0007": "" }, "notSubmitNumber": 0, "outNumber": 10 } ], "templateId": "4028812a88710fc601887b9d74aa016c", "accountbookName": "C公司", "accountbookIdSendName": "B公司", "deliveryDate": "2025-05-21 00:00:00", "currencyTypeName": "人民币", "submitterName": "XX颖", "submitStockStatus": 30, "submitStockStatusName": "全部提交", "stockStatus": 50, "stockStatusName": "未出库", "statusName": "已审批", "terminateStatus": 1, "terminateStatusName": "进行中", "fieldValueMap": { "billField0001": "0000", "billField0002": "0000" } } ], "total": 2 }, "result": null, "attributes": null }

2．获取销售订单

接口描述	获取销售订单
HTTP URL	/openapi/sale?getJxcSaleOrder
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	必填	示例值	描述
code	String	是		单据编号
accountbookCode	String	是		销售组织编码

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果
code	String		单据编号
templateId	String	默认值 40288157888051a40188843d9fec0072	模板id
businessDateTime	String	1900-01-01 00:00:01	业务日期
accountbookCode	String		销售组织
accountbookCodeSend	String		发货组织
customerName	String		客户
saleUserName	String		销售人
submitterDepartmentName	String		销售部门
amount	BigDecimal	(20,2)	销售金额
originAmount	BigDecimal	(20,2)	销售金额（原币）
currencyTypeId	Integer	接口获取（不涉及外币，填1）	币种
exchangeRate	BigDecimal	（不涉及外币，填1）	汇率
status	Integer	10 暂存 20 提交	单据状态
remark	String		备注
billDetailList	[]		销售出库库单详情集合
valueFlag	Integer	0：不取参考价 1：取参考价	取参考价标志
id	String		详情id
warehouseCode	String		仓库
goodsCode	String		商品编码
goodsId	String		商品id
unitCode	String		单位
unitAmount	BigDecimal	(22,8)	计价数量
price	BigDecimal	(22,8)	含税单价
invoiceType	Integer	1=普票 2=专票	发票类型
discountRate	BigDecimal	80.01	折扣率（%）
discountAmount	BigDecimal	19.99	折扣额
taxRate	String		税率(%)
taxAmount	BigDecimal		税额
originTaxAmount	BigDecimal		税额(原币)
untaxedAmount	BigDecimal		未税金额
originUntaxedAmount	BigDecimal		未税金额（原币）
amount	BigDecimal		价税合计
originAmount	BigDecimal		价税合计（原币）
remark	String		详情备注

（3）请求示例

{"code": "SO00000001","accountbookCode": "AC003"}

（4）返回示例

{ "success": true, "msg": "操作成功", "obj": null, "result": { "id": "2c91e302967cbc170196859ea3012060", "code": "SO00003617", "businessDateTime": "2025-04-30 00:00:00", "accountbookId": "2c91e3028b44d4df018b4bda82fc7517", "accountbookCode": "AC002", "submitterDepartmentId": "2c91e3028b63cb8a018b65f97fa231a4", "submitterDepartmentName": "经营部", "saleUserId": "2c91e30291a2b0090191b68581f87a2f", "saleUserName": "XX馨", "customerDetailId": "2c91e3028ce46a29018ce6da6edd1564", "customerId": null, "customerName": "北京XX有限公司", "accountbookIdSend": "2c91e3028b44d4df018b4bda82fc7517", "accountbookCodeSend": "AC002", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 450, "amount": 900, "createDate": "2025-04-30 15:34:48", "submitDateTime": "2025-04-30 15:37:03", "status": 30, "submitterId": "2c91e30291a2b0090191b68581f87a3f", "remark": "", "billDetailList": [ { "id": "2c91e302967cbc17019685a0a79621e2", "saleOrderId": "2c91e302967cbc170196859ea3012060", "goodsId": "2c91e3028bb13693018bb382809e3523", "goodsCode": "1001001002", "goodsName": "XX青", "goodsSpecs": "70#", "auxiliaryAttributeName": null, "goodsBrand": null, "unitName": "吨", "warehouseId": "2c91e3028b63cb8a018b852ca3784491", "warehouseCode": "001", "warehouseName": "原材料仓库", "unitAmount": 10, "price": 45, "discountRate": null, "discountAmount": null, "amount": 450, "unitId": "2c91e3028b44d4df018b4bf6882a7833", "unitCode": "U001", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 450, "invoiceType": 1, "invoiceTypeName": "普票", "taxRate": "13", "taxAmount": 51.77, "originTaxAmount": 51.77, "untaxedAmount": 398.23, "originUntaxedAmount": 398.23, "remark": "", "fieldValueMap": { "billDetailField0001": "", "billDetailField0002": "23", "billDetailField0003": "8", "billDetailField0004": "京A15", "billDetailField0005": "" }, "notSubmitNumber": 0, "outNumber": 10 } ], "templateId": "4028812a88710fc601887b9d74aa016c", "accountbookName": "A公司", "accountbookIdSendName": "C公司", "deliveryDate": "2025-04-30 00:00:00", "currencyTypeName": "人民币", "submitterName": "XX馨", "submitStockStatus": 30, "submitStockStatusName": "全部提交", "stockStatus": 50, "stockStatusName": "未出库", "statusName": "已审批", "terminateStatus": 1, "terminateStatusName": "进行中", "fieldValueMap": { "billField0001": "11", "billField0003": "北京", "billField0006": "2025-04-30 00:00:00" } } }

3．获取销售订单终止状态

接口描述	获取销售订单终止状态
HTTP URL	/openapi/sale?getJxcSaleOrderTerminateStatusList
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

名称	类型	必填	示例值	描述
operatetime_begin	String	是	2023-12-01 00:00:00	开始时间
operatetime_end	String	是	2023-12-01 23:59:59	结束时间

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息
result	Object		具体返回结果
Id	String		id
billId	String	默认值 2c91e302887ca4d80188806f6eec3bf0	单据id
operatetime	String	1900-01-01 00:00:01	操作日期
operatetype	Integer	终止状态 1 进行中 2 已终止 3 已完成	终止状态
billType	Integer	102 销售订单 101 采购订单	单据类型
logcontent	String		操作内容

（3）请求示例

{ "operatetime_begin": "2023-11-01 00:00:00", "operatetime_end": "2023-11-30 23:59:59" }

（4）返回示例

{ "success": true, "msg": "操作成功", "code": 200, "obj": { "page": 1, "rows": 100, "results": [ { "id": "2c91e3029374de1c01938683af172a6a6", "userid": "2c91e3028ccc4602018cd3bcc22a120c5", "realname": "XX艳", "operatetime": "2024-12-02 16:36:37", "operatetime_begin": null, "operatetime_end": null, "operatetype": 2, "billType": 102, "billId": "2c91e3028e6317fb018e64c51422e836", "logcontent": "销售订单已终止" }, { "id": "2c91e3029374de1c01938a7f122efae9", "userid": "2c91e3028ccc4602018cd3bbc22a20bc", "realname": "XX楠", "operatetime": "2024-12-03 11:10:07", "operatetime_begin": null, "operatetime_end": null, "operatetype": 2, "billType": 102, "billId": "2c91e3028ea0ed64018eabbcb2221c6b", "logcontent": "销售订单已终止" } ], "total": 2 }, "result": null, "attributes": null }

4．批量新增

接口描述	批量新增销售订单
HTTP URL	/openapi/sale?batchAddJxcSaleOrder
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	长度	必填	示例值	描述
code	String	32	是		单据编号
templateId	String	32	是	默认值 40288157888051a40188843d9fec0072	模板id
businessDateTime	String	32	是	1900-01-01 00:00:00	业务日期
deliveryDate	String	32	是	1900-01-01 00:00:00	交货日期
accountbookCode	String	32	是		销售组织
accountbookCodeSend	String	32	是		发货组织
customerName	String	32	是		客户
saleUserName	String	32	是		销售人
submitterDepartmentName	String	32	是		销售部门
amount	BigDecimal	22	是	(20,2)	销售金额
originAmount	BigDecimal	22	是	(20,2)	销售金额（原币）
currencyTypeId	Integer	1	是	接口获取（不涉及外币，填1）	币种
exchangeRate	BigDecimal	22	是	（不涉及外币，填1）	汇率
status	Integer	3	是	10 暂存 20 提交	单据状态
fieldValueMap	Map<String, Object>	value长度500	是	Key->billField0001Value->String	自定义字段
remark	String	500	否		备注
billDetailList	[]		是		销售出库库单详情集合
valueFlag	Integer	1	是	0：不取参考价 1：取参考价；默认0	取参考价标志
warehouseCode	String	32	是		仓库
goodsCode	String	32	是		商品编码
unitCode	String	32	是		单位
unitAmount	BigDecimal	22	是	(22,8)	计价数量
price	BigDecimal	22	是	(22,8)	含税单价
invoiceType	Integer	1	是	1=普票 2=专票	发票类型
discountRate	BigDecimal	22	否	80.01	折扣率（%）
discountAmount	BigDecimal	22	否	19.99	折扣额
taxRate	String	22	是		税率(%)
taxAmount	BigDecimal	22	是		税额
originTaxAmount	BigDecimal	22	是		税额(原币)
untaxedAmount	BigDecimal	22	是		未税金额
originUntaxedAmount	BigDecimal	22	是		未税金额（原币）
amount	BigDecimal	22	是		价税合计
originAmount	BigDecimal	22	是		价税合计（原币）
fieldValueMap	Map<String, Object>	value长度500	是	Key->billDetailField0019Value->String	自定义字段
remark	String	500	否		详情备注

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（3）请求示例

[ { "code": "SO00003619", "businessDateTime": "2025-04-30 00:00:00", "deliveryDate": "2025-04-30 00:00:00", "accountbookCode": "AC002", "submitterDepartmentName": "经营部", "saleUserName": "张XX", "customerName": "北京XX有限公司", "accountbookCodeSend": "AC002", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 450, "amount": 450, "status": 10, "remark": "", "billDetailList": [ { "goodsCode": "1001001002", "warehouseCode": "001", "unitAmount": 10, "price": 45, "valueFlag": 0, "discountRate": null, "discountAmount": null, "amount": 450, "unitCode": "U001", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 450, "invoiceType": 1, "taxRate": "13", "taxAmount": 51.77, "originTaxAmount": 51.77, "untaxedAmount": 398.23, "originUntaxedAmount": 398.23, "remark": "", "fieldValueMap": { "billDetailField0001": "1", "billDetailField0002": "23", "billDetailField0003": "3", "billDetailField0004": "京A12345" } } ], "templateId": "1028812a88710fc601887b9d11aa226c", "fieldValueMap": { "billField0001": "中铁十二局", "billField0002": "11", "billField0003": "北京", "billField0004": "333", "billField0005": "5", "billField0006": "2025-04-30 00:00:00" } }]

（4）返回示例

{ "success": true, "msg": "操作成功"}

十五、 销售出库单

1．批量新增

接口描述	批量新增销售出库单
HTTP URL	/openapi/sale?batchAddJxcSaleOutStock
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	长度	必填	示例值	描述
code	String	32	是		单据编号
templateId	String	32	是	默认值 40288157888051a40188843d9fec0072	模板id
businessDateTime	String	32	是	1900-01-01 00:00:01	业务日期
accountbookCode	String	32	是		销售组织
accountbookCodeSend	String	32	是		发货组织
customerName	String	32	是		客户
saleUserName	String	32	是		销售人
submitterDepartmentName	String	32	是		销售部门
amount	BigDecimal	22	是	(20,2)	销售金额
originAmount	BigDecimal	22	是	(20,2)	销售金额（原币）
currencyTypeId	Integer	1	是	接口获取（不涉及外币，填1）	币种
exchangeRate	BigDecimal	22	是	（不涉及外币，填1）	汇率
status	Integer	3	是	10 暂存 20 提交	单据状态
fieldValueMap	Map<String, Object>	value长度500	是	Key->billField0001Value->String	自定义字段
remark	String	500	否		备注
billDetailList	[]		是		销售出库库单详情集合
valueFlag	Integer	1	是	0：不取参考价 1：取参考价	取参考价标志
saleOrderId	String	32	否	有关联单据时必填	关联销售订单Id
sourceBillCode	String	32	否	有关联单据时必填	关联销售订单编码
saleOrderDetailId	String	32	否	有关联单据时必填	关联销售订单明细Id
sourceBillType	Integer	32	否	固定值 102 没有关联单据的情况下不用填	关联销售订单类型
warehouseCode	String	32	是		仓库
goodsCode	String	32	是		商品编码
unitCode	String	32	是		单位
unitAmount	BigDecimal	22	是	(22,8)	计价数量
price	BigDecimal	22	是	(22,8)	含税单价
invoiceType	Integer	1	是	1=普票 2=专票	发票类型
discountRate	BigDecimal	22	否	80.01	折扣率（%）
discountAmount	BigDecimal	22	否	19.99	折扣额
taxRate	String	22	是		税率(%)
taxAmount	BigDecimal	22	是		税额
originTaxAmount	BigDecimal	22	是		税额(原币)
untaxedAmount	BigDecimal	22	是		未税金额
originUntaxedAmount	BigDecimal	22	是		未税金额（原币）
amount	BigDecimal	22	是		价税合计
originAmount	BigDecimal	22	是		价税合计（原币）
fieldValueMap	Map<String, Object>	value长度500	是	Key->billDetailField0019Value->String	自定义字段
remark	String	500	否		详情备注

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（3）请求示例

[{ "code": "20220101101050888123", "accountbookId": "2c91e3f6838701a4018387238e77006c", "accountbookIdSend": "2c91e3f6838701a4018387238e77006c", "submitterDepartmentId": "0000000000000000000000000000", "saleUserId": "0000000000000000000000000000", "customerId": "2c91e3f683882efb0183886c7eec01fa", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 200.00, "businessDateTime": "2022-01-12 00:00:01", "remark": "接口测试", "billDetailList": [ { "goodsId": "2c91e3f6838c664001838c87abf400ea", "unitId": "2c91e3f6838701a40183872ec0680097", "warehouseId": "2c91e3f6838701a401838734f89a009a", "unitAmount": 10, "price": 10, " valueFlag": 1, "invoiceType": 1, "discountRate": "", "discountAmount": "", "taxRate": "9", "taxAmount": "12", "originUntaxedAmount": 100, "originAmount": 100, "remark": "接口测试详情" }, { "goodsId": "2c91e3f6838c664001838c87abf400ea", "unitId": "2c91e3f6838701a40183872ec0680097", "warehouseId": "2c91e3f6838701a401838734f89a009a", "unitAmount": 10, "price": 10, "invoiceType": 1, "discountRate": "", "discountAmount": "", "taxRate": "6", "taxAmount": "11", "originUntaxedAmount": 100, "originAmount": 100, "remark": "接口测试详情" } ]}]

（4）返回示例

{ "success": true, "msg": "操作成功"}

2．批量新增销售出库单并且下推生成销售应收

接口描述	批量新增销售出库单并且下推生成销售应收
HTTP URL	/openapi/sale?batchAddJxcSaleOutStockAndReceivable
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	长度	必填	示例值	描述
code	String	32	是		单据编号
templateId	String	32	是	默认值 40288157888051a40188843d9fec0072	模板id
businessDateTime	String	32	是	1900-01-01 00:00:01	业务日期
accountbookCode	String	32	是		销售组织
accountbookCodeSend	String	32	是		发货组织
customerName	String	32	是		客户
saleUserName	String	32	是		销售人
submitterName	String	32	否		提交人名称
submitterDepartmentName	String	32	是		销售部门
amount	BigDecimal	22	是	(20,2)	销售金额
originAmount	BigDecimal	22	是	(20,2)	销售金额（原币）
currencyTypeId	Integer	1	是	接口获取（不涉及外币，填1）	币种
exchangeRate	BigDecimal	22	是	（不涉及外币，填1）	汇率
status	Integer	3	是	10 暂存 20 提交	单据状态
fieldValueMap	Map<String, Object>	value长度500	是	Key->billField0001Value->String	自定义字段
remark	String	500	否		备注
billDetailList	[]		是		销售出库库单详情集合
valueFlag	Integer	1	是	0：不取参考价 1：取参考价	取参考价标志
saleOrderId	String	32	否	有关联单据时必填	关联销售订单Id
code	String	32	否	有关联单据时必填	关联销售订单编码
saleOrderDetailId	String	32	否	有关联单据时必填	关联销售订单明细Id
sourceBillType	Integer	3	否	固定值 102 没有关联单据的情况下不用填	关联销售订单类型
warehouseCode	String	32	是		仓库
goodsCode	String	32	是		商品编码
unitCode	String	32	是		单位
unitAmount	BigDecimal	22	是	(22,8)	计价数量
receivableAmount	BigDecimal	22	是	(22,8)	应收数量
price	BigDecimal	22	是	(22,8)	含税单价
invoiceType	Integer	1	是	1=普票 2=专票	发票类型
discountRate	BigDecimal	22	否	80.01	折扣率（%）
discountAmount	BigDecimal	22	否	19.99	折扣额
taxRate	String	22	是		税率(%)
taxAmount	BigDecimal	22	是		税额
originTaxAmount	BigDecimal	22	是		税额(原币)
untaxedAmount	BigDecimal	22	是		未税金额
originUntaxedAmount	BigDecimal	22	是		未税金额（原币）
amount	BigDecimal	22	是		价税合计
originAmount	BigDecimal	22	是		价税合计（原币）
fieldValueMap	Map<String, Object>	value长度500	是	Key->billDetailField0019Value->String	自定义字段
remark	String	500	否		详情备注

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（3）请求示例

[{ "code": "20220101101050888123", "accountbookId": "2c91e3f6838701a4018387238e77006c", "accountbookIdSend": "2c91e3f6838701a4018387238e77006c", "submitterDepartmentId": "0000000000000000000000000000", "saleUserId": "0000000000000000000000000000", "customerId": "2c91e3f683882efb0183886c7eec01fa", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 200.00, "businessDateTime": "2022-01-12 00:00:01", "remark": "接口测试", "billDetailList": [ { "goodsId": "2c91e3f6838c664001838c87abf400ea", "unitId": "2c91e3f6838701a40183872ec0680097", "warehouseId": "2c91e3f6838701a401838734f89a009a", "unitAmount": 10, "price": 10, "valueFlag": 1, "invoiceType": 1, "discountRate": "", "discountAmount": "", "taxRate": "9", "taxAmount": "12", "originUntaxedAmount": 100, "originAmount": 100, "remark": "接口测试详情" }, { "goodsId": "2c91e3f6838c664001838c87abf400ea", "unitId": "2c91e3f6838701a40183872ec0680097", "warehouseId": "2c91e3f6838701a401838734f89a009a", "unitAmount": 10, "price": 10, "invoiceType": 1, "discountRate": "", "discountAmount": "", "taxRate": "6", "taxAmount": "11", "originUntaxedAmount": 100, "originAmount": 100, "remark": "接口测试详情" } ]}]

（4）返回示例

{ "success": true, "msg": "操作成功"}

3．获取销售出库单

接口描述	根据单号获取销售出库单
HTTP URL	/openapi/sale?getJxcSaleOutStock
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述
code	String	是		单据编号
accountbookCode	String	是		销售组织

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（3）请求示例

{"code": "XC231024000104","accountbookCode": "AC002"}

（4）返回示例

{ "success": true, "msg": "操作成功", "code": 200, "obj": null, "result": { "id": "2c91e3028d337ad0018d36258fba7a33", "code": "SOS00000157", "businessDateTime": "2024-01-23 19:47:28", "accountbookId": "2c91e3028b44d4df018b4bdbc3cd7337", "accountbookCode": "AC003", "submitterDepartmentId": "2c91e3028ce46a29018cebe2c92f63f2", "saleUserId": "2c91e3028ce46a29018cec09a5bd72b1", "customerDetailId": "2c91e3028d337ad0018d34e8a4fd5263", "accountbookIdSend": "2c91e3028b44d4df018b4bdc9d54733d", "currencyTypeId": 1, "exchangeRate": 1, "originAmount": 108000, "amount": 108000, "createDate": "2024-01-23 19:47:28", "status": 20, "submitterId": "2c91e3028ce46a29018ce933a16733fb", "remark": "", "billDetailList": [ { "id": "2c91e3028d337ad0018d36258fc77333", "saleOutStockId": "2c91e3028d337ad0018d36258fba3323", "saleOrderId": "2c91e3028d337ad0018d3333e2c55352", "sourceBillCode": "SO00000215", "sourceBillType": 102, "saleOrderDetailId": "2c91e3028d337ad0018d34f12fd9535e", "goodsId": "2c91e3028ce46a29018cedae6c337714", "goodsCode": "1007004014", "goodsName": "CXX物", "goodsSpecs": "AC-13C", "auxiliaryAttributeName": null, "goodsBrand": "XX", "warehouseId": "2c91e3028b63cb8a018b852ca3c3339c", "unitAmount": 300, "receivableAmount": null, "price": 360, "discountRate": null, "discountAmount": null, "amount": 108000, "unitId": "2c91e3028b44d4df018b3336882a7834", "unitCode": null, "originAmount": 108000, "invoiceType": 2, "taxRate": "13", "taxAmount": 12424.78, "originTaxAmount": 12424.78, "originUntaxedAmount": 95575.22, "remark": "", "fieldValueMap": null } ], "templateId": "40288157888051a40188843d9fec0072", "fieldValueMap": null }, "attributes": null }

4．保存签收日期

接口描述	根据销售出库单id保存签收日期
HTTP URL	/openapi/sale?saveJxcSaleOutStockSignInDate
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述
templateId	String	是	默认值 40288157888051a40188843d9fec0072	模板id
billDetailList	[]	是		销售出库库单详情集合
id	String	是		单据详情id
fieldValueMap	Map<String, Object>	是	Key->billDetailField0002Value->yyyy-MM-dd	自定义字段

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（3）请求示例

{ "billDetailList":[ { "id":"2c91e3fc8b648578018b64f4c73b0027", "fieldValueMap":{ "billDetailField0002":"2023-01-01" } } ], "templateId":"40288157888051a40188843d9fec0072"}

（4）返回示例

{ "success": true, "msg": "操作成功"}

十六、 销售应收单

1．批量新增

接口描述	批量新增销售应收单
HTTP URL	/openapi/sale?batchAddJxcSaleReceivable
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	长度	必填	示例值	描述
code	String	32	是		单据编号
templateId	String	32	是	默认值 40288157888051a40188843d9fec0072	模板id
businessDateTime	String	32	是	1900-01-01 00:00:01	业务日期
accountbookCode	String	32	是		销售组织
customerName	String	32	是		客户
submitterDepartmentName	String	32	是		销售部门
saleUserName	String	32	是		销售人
amount	BigDecimal	22	是	(20,2)	销售金额
originAmount	BigDecimal	22	是	(20,2)	销售金额（原币）
currencyTypeId	Integer	1	是	接口获取（不涉及外币，填1）	币种
exchangeRate	BigDecimal	22	是	（不涉及外币，填1）	汇率
status	Integer	3	是	10 暂存 20 提交	单据状态
fieldValueMap	Map<String, Object>	value长度500	是	Key->billField0001Value->String	自定义字段
remark	String	500	否		备注
billDetailList	[]		是		销售出库库单详情集合
valueFlag	Integer	1	是	0：不取参考价 1：取参考价	取参考价标志
sourceBillId	String	32	否	有关联单据时必填	关联销售出库Id
sourceBillCode	String	32	否	有关联单据时必填	关联销售出库编码
sourceBillDetailId	String	32	否	有关联单据时必填	关联销售出库明细Id
sourceBillType	Integer	3	否	固定值 103 没有关联单据的情况下不用填	关联销售订单类型
warehouseCode	String	32	是		仓库
goodsCode	String	32	是		商品编码
unitCode	String	32	是		单位
unitAmount	BigDecimal	22	是	(22,8)	计价数量
price	BigDecimal	22	是	(22,8)	含税单价
invoiceType	Integer	1	是	1=普票 2=专票	发票类型
discountRate	BigDecimal	22	否	80.01	折扣率（%）
discountAmount	BigDecimal	22	否	19.99	折扣额
taxRate	String	22	是		税率(%)
taxAmount	BigDecimal	22	是		税额
originTaxAmount	BigDecimal	22	是		税额(原币)
untaxedAmount	BigDecimal	22	是		未税金额
originUntaxedAmount	BigDecimal	22	是		未税金额（原币）
amount	BigDecimal	22	是		价税合计
originAmount	BigDecimal	22	是		价税合计（原币）
fieldValueMap	Map<String, Object>	value长度500	是	Key->billDetailField0019Value->String	自定义字段
remark	String	500	否		详情备注

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（3）请求示例

（4）返回示例

{ "success": true, "msg": "操作成功"}

十二、

十三、

十四、

十五、

十七、 销售退货单

1．批量新增

接口描述	批量新增销售退货单
HTTP URL	/openapi/sale?batchAddJxcSaleReturnGoods
HTTP Method	POST

（1）请求参数

说明:

BigDecimal 类型字段都为(20,2),除单价\数量外

批量接口每次请求最多支持500条

名称	类型	长度	必填	示例值	描述
code	String	32	是		单据编号
templateId	String	32	是	默认值 40288157888051a4018884470a8100af	模板id
businessDateTime	String	32	是	1900-01-01 00:00:01	业务日期
accountbookCode	String	32	是		销售组织
accountbookCodeSend	String	32	是		发货组织
customerName	String	32	是		客户
saleUserName	String	32	是		销售人
submitterDepartmentName	String	32	是		销售部门
amount	BigDecimal	22	是	(20,2)	销售金额
originAmount	BigDecimal	22	是	(20,2)	销售金额（原币）
currencyTypeId	Integer	1	是	接口获取（不涉及外币，填1）	币种
exchangeRate	BigDecimal	22	是	（不涉及外币，填1）	汇率
status	Integer	3	是	10 暂存 20 提交	单据状态
fieldValueMap	Map<String, Object>	value长度500	是	Key->billField0001Value->String	自定义字段
remark	String	500	否		备注
billDetailList	[]		是		销售出库库单详情集合
valueFlag	Integer	1	是	0：不取参考价 1：取参考价	取参考价标志
saleOutStockId	String	32	否	关联销售出库时必填	关联销售出库单id
saleOutStockDetailId	String	32	否	关联销售出库时必填	关联销售出库单详情id
warehouseCode	String	32	是		仓库
goodsCode	String	32	是		商品编码
unitCode	String	32	是		单位
unitAmount	BigDecimal	22	是	(22,8)	计价数量
price	BigDecimal	22	是	(22,8)	含税单价
invoiceType	Integer	1	是	1=普票 2=专票	发票类型
discountRate	BigDecimal	22	否	80.01	折扣率（%）
discountAmount	BigDecimal	22	否	19.99	折扣额
taxRate	String	22	是		税率(%)
taxAmount	BigDecimal	22	是		税额
originTaxAmount	BigDecimal	22	是		税额(原币)
untaxedAmount	BigDecimal	22	是		未税金额
originUntaxedAmount	BigDecimal	22	是		未税金额（原币）
amount	BigDecimal	22	是		价税合计
originAmount	BigDecimal	22	是		价税合计（原币）
fieldValueMap	Map<String, Object>	value长度500	是	Key->billDetailField0001Value->String	自定义字段
remark	String	500	否		详情备注

（2）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（3）请求示例

（4）返回示例

{ "success": true, "msg": "操作成功"}

十六、库存调拨单

1．批量新增

接口描述	批量新增库存
HTTP URL	openapi/warehouseAllocateBill?doBatchSave
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述	长度	精度
billCode	String	是		单据编号	50
submitterName	String	是		提交人名称	50
departName	String	是		所属部门名称	50
businessDateTime	String	是	1900-01-01 00:00:01	业务日期	0
accountbookCode	String	是		调出组织编码	50
targetAccountbookCode	String	是		调入组织编码	50
remark	String	否		备注	100
billDetailList	[]	是		库存调拨单详情
goodsCode	String	是		商品编码	50
unitName	String	是		单位名称	50
unitAmount	BigDecimal	是		调拨数量	22	8
sourceWarehouseCode	String	是		调出仓库编码	50
targetWarehouseCode	String	是		调入仓库编码	50
remark	String	否		详情备注	100

（2）请求示例

[ { "billCode": "ceshi0001", "submitterName": "测试人员", "departName": "缺省部门", "businessDateTime": "2023-09-25 00:00:01", "accountbookCode": "AC001", "targetAccountbookCode": "AC001", "remark": "测试数据0925", "billDetailList": [ { "goodsCode": "030060018", "unitName": "套", "unitAmount": "1", "sourceWarehouseCode": "CS001", "targetWarehouseCode": "CS002", "remark": "111111" }, { "goodsCode": "030071407", "unitName": "台", "unitAmount": "1", "sourceWarehouseCode": "CS001", "targetWarehouseCode": "CS002", "remark": "2222" } ] }]

（3）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（4）返回示例

{ "success": true, "msg": "操作成功"}

十七、其他入库单

1．批量新增

接口描述	批量新增其他入库单
HTTP URL	openapi/warehouseOtherInBill?doBatchSave
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述	长度	精度
billCode	String	是		单据编号	50
submitterName	String	是		提交人名称	50
departName	String	是		所属部门名称	50
businessDateTime	String	是	1900-01-01 00:00:01	业务日期	0
accountbookCode	String	是		公司主体编码	50
supplierName	String	否		供应商名称	50
inType	Integer	是	1=其他入库2=盘盈4=调拨	业务类型	2
currency	Integer	是	（不涉及外币，填1）	币种	2
exchangeRate	BigDecimal	是	（不涉及外币，填1）	汇率	22	8
remark	String	否		备注	100
templateId	String	是	默认值 40288ae6880480ae018804ea6aa300c7	模板id	50
fieldValueMap	Map<String, Object>	否	Key->billField0001Value->业务员因	自定义字段
billDetailList	[]	是		其他入库单详情
valueFlag	Integer	是	0：不取参考价 1：取参考价	取参考价标志	2
warehouseCode	String	是		仓库编码	50
goodsCode	String	是		商品编码	50
unitName	String	是		单位名称	50
unitAmount	BigDecimal	是		入库数量	22	8
originInUnitPrice	BigDecimal	否		入库单价	22	8
originInTotalPrice	BigDecimal	否		入库金额	22	8
fieldValueMap	Map<String, Object>	否	Key->billDetailField0001Value->商品条码	自定义字段
remark	String	否		详情备注	100

（2）请求示例

[ { "billCode": "ceshi0001", "submitterName": "admin", "departName": "缺省部门", "businessDateTime": "2023-09-25 00:00:01", "accountbookCode": "AC001", "supplierName": "测试供应商", "inType": "1", "currency": "1", "exchangeRate": "1", "remark": "测试数据0925","templateId": "40288ae6880480ae018804ea6aa300c7","fieldValueMap":{ "billField0001":"报损" } "billDetailList": [ { " valueFlag": "1", "warehouseCode": "CS001", "goodsCode": "030060018", "unitName": "套", "unitAmount": "1", "originInUnitPrice": "1", "originInTotalPrice": "1", "remark": "111111","fieldValueMap":{ "billDetailField0001":"1111111111111" }}, { "valueflag": "1", "warehouseCode": "CS002", "goodsCode": "030071407", "unitName": "台", "unitAmount": "2", "originInUnitPrice": "2", "originInTotalPrice": "4", "remark": "222","fieldValueMap":{ "billDetailField0001":"22222222222" } } ] }]

（3）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（4）返回示例

{ "success": true, "msg": "操作成功"}

十八、其他出库单

1．批量新增

接口描述	批量新增其他出库单
HTTP URL	openapi/warehouseOtherOutBill?doBatchSave
HTTP Method	POST

（1）请求参数

名称	类型	必填	示例值	描述	长度	精度
billCode	String	是		单据编号	50
submitterName	String	是		提交人名称	50
departName	String	是		所属部门名称	50
businessDateTime	String	是	1900-01-01 00:00:01	业务日期	0
accountbookCode	String	是		公司主体编码	50
customerName	String	否		客户名称	50
outType	Integer	是	1=其他出库2=盈亏4=调拨	业务类型	2
remark	String	否		备注	100
templateId	String	是	默认值 402881d6887058bd01887196b5360041	模板id	50
fieldValueMap	Map<String, Object>	否	Key->billField0001Value->业务员因	自定义字段
billDetailList	[]	是		其他出库单详情
warehouseCode	String	是		仓库编码	50
goodsCode	String	是		商品编码	50
unitName	String	是		单位名称	50
unitAmount	BigDecimal	是		出库数量	22	8
fieldValueMap	Map<String, Object>	否	Key->billDetailField0003Value->商品条码	自定义字段
remark	String	否		详情备注	100

（2）请求示例

[ { "billCode": "ceshi0001", "submitterName": "admin", "departName": "缺省部门", "businessDateTime": "2023-09-25 00:00:01", "accountbookCode": "AC001", "outType": "1", "remark": "测试数据0925","templateId": "402881d6887058bd01887196b5360041","fieldValueMap":{ "billField0001":"报损" } "billDetailList": [ { "warehouseCode": "CS001", "goodsCode": "030060018", "unitName": "套", "unitAmount": "1", "remark": "111111","fieldValueMap":{ "billDetailField0003":"1111111111111" } }, { "warehouseCode": "CS002", "goodsCode": "030071407", "unitName": "台", "unitAmount": "2", "remark": "222","fieldValueMap":{ "billDetailField0003":"22222222222" } } ] }]

（3）响应

名称	类型	示例值	描述
success	boolean	true/false	是否成功
msg	String		提示信息

（4）返回示例

{ "success": true, "msg": "操作成功"}

💬 评论（0）

登录后参与评论

还没有评论，来抢沙发～