吉客云对接打通金蝶云星空入库单查询接口与销售退货新增接口

接通系统：吉客云

杭州吉客云网络技术有限公司是经国家认定的高新技术企业，是国内领先的SaaSERP软件服务商，致力于为企业提供安全稳定、高可用性和高扩展性的一站式数字化解决方案。

接入系统：金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

多系统对接方案配置

通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将吉客云、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。

吉客云接口明细

• 调用接口：erp.storage.goodsdocin

• 接口名称：入库单查询

• 方法：POST

请求参数

字段	字段名称	类型	配置值
pageIndex	分页页码	string
pageSize	分页页数	string	20
goodsDocNo	入库单号	string
startDate	创建时间的起始时间	string	_function DATE_FORMAT(DATE_ADD(NOW(),INTERVAL - 3 DAY),'%Y-%m-%d 00:00:00')
endDate	创建时间的结束时间	string	{{CURRENT_TIME datetime}}
inouttype	入库类型	string	103
warehouseId	仓库ID	string
warehouseCode	仓库编号	string
vendId	供应商ID(往来单位)	string
vendCode	供应商编号(往来单位)	string
billNo	上游单据号(关联单号)	string
userName	创建人名称	string

响应参数

字段	字段名称	类型	配置值
recId	入库单ID	string
goodsdocNo	入库单号	string
billNo	上游单据号(关联单号)	string
inOutDate	入库时间	string
gmtCreate	创建时间	string
inouttype	入库类型	string
inouttypeName	入库类型	string
vendCustomerCode	往来单位编号	string
vendCustomerName	往来单位名称	string
currencyCode	币种编号	string
currencyRate	币种汇率	string
userName	业务员名字	string
warehouseCode	仓库编号	string
warehouseName	仓库名字	string
comment	备注	string
memo	收货备注	string
logisticName	物流公司	string
logisticNo	物流单号	string
companyId	公司id	string
companyName	公司名称	string
logisticType	物流类型	string
logisticCode	物流公司编码	string
inOutReason	入库原因	string
sourceBillNo	来源单号	string
channelId	渠道ID	string
channelCode	渠道编号	string
channelName	渠道名称	string
redStatus	红冲状态：1蓝单（未红冲）；2被冲蓝单；9红冲单	string
field1	自定义字段1	string
field2	自定义字段2	string
field3	自定义字段3	string
field4	自定义字段4	string
field5	自定义字段5	string
financeBillStatus	财务状态	string
goodsDocDetailList	入库单详情	array
goodsDocDetailList.recId	入库单明细ID	string
goodsDocDetailList.goodsId	货品ID	string
goodsDocDetailList.goodsNo	货品编号	string
goodsDocDetailList.goodsName	货品名称	string
goodsDocDetailList.skuId	规格ID	string
goodsDocDetailList.skuName	规格名称	string
goodsDocDetailList.skuBarcode	条码	string
goodsDocDetailList.unitName	单位	string
goodsDocDetailList.cuPrice	单价	string
goodsDocDetailList.cuValue	金额	string
goodsDocDetailList.caseNumber	箱号	string
goodsDocDetailList.rowRemark	明细备注	string
goodsDocDetailList.assistUnit	辅助单位显示	string
goodsDocDetailList.estCost	含税金额	string
goodsDocDetailList.estTax	税额	string
goodsDocDetailList.estPrice	含税单价	string
goodsDocDetailList.estPriceNoTax	含税单价	string
goodsDocDetailList.estCostNoTax	无税金额	string
goodsDocDetailList.taxRate	税率	string
goodsDocDetailList.batchNo	批次编号	string
goodsDocDetailList.serialNo	序列号	string
goodsDocDetailList.productionDate	生产日期	string
goodsDocDetailList.expirationDate	到期日期	string
goodsDocDetailList.shelfLife	质保期	string
goodsDocDetailList.shelfLiftUnit	质保期单位	string
goodsDocDetailList.sourceDetailId	来源单据明细Id	string
goodsDocDetailList.transNoTaxPrice	无税单价（原币种）	string
goodsDocDetailList.transNoTaxAmount	无税金额（原币种）	string
goodsDocDetailList.transHasTaxPrice	含税单价（原币种）	string
goodsDocDetailList.transHasTaxAmount	含税金额（原币种）	string
goodsDocDetailList.transTaxAmount	税额（原币种）	string
goodsDocDetailList.detailField1	自定义字段1	string
goodsDocDetailList.detailField2	自定义字段2	string
goodsDocDetailList.detailField3	自定义字段3	string
goodsDocDetailList.detailField4	自定义字段4	string
goodsDocDetailList.detailField5	自定义字段5	string
goodsDocDetailList.isCertified	是否正品0	string
goodsDocDetailList.registrationNumber	批准文号	string
goodsDocDetailList.approvalDate	批文有效期	string
goodsDocDetailList.productionDepart	生产单位	string
goodsDocDetailList.batchNumber	生产批号	string
goodsDocDetailList.quantity	数量	string
goodsDocDetailList.applyCompanyId	申请人公司ID	string
goodsDocDetailList.applyCompanyName	申请人公司名称	string
goodsDocDetailList.applyCompanyCode	申请人公司编号	string
goodsDocDetailList.applyDepartId	申请人部门id	string
goodsDocDetailList.applyDepartName	申请人部门名称	string
goodsDocDetailList.outBillNo	外部单号	string

金蝶云星空接口明细

• 调用接口：batchSave

• 接口名称：销售退货新增

• 方法：POST

请求参数

字段	字段名称	类型	配置值
FBillTypeID	单据类型	string	XSTHD01_SYS
FBillNo	单据编号	string	{{goodsdocNo}}
FSaleOrgId	销售组织	string	function case '{{channelCode}}' when '10002480' then '104' else '103' end
FDate	日期	string	_function FROM_UNIXTIME( ( {{gmtModified}} / 1000 ) ,'%Y-%m-%d %T' )
FStockOrgId	库存组织	string	103
FRetcustId	退货客户	string	{{channelCode}}
FXSLX	销售类型	string
FAPI	API	string	true
F_sht_Note	备注	string	错漏调整
FEntity	明细信息	array	goodsDocDetailList
FEntity.FMaterialId	物料编码	string	{{goodsDocDetailList.goodsNo}}
FEntity.FUnitID	库存单位	string	findCollection find FPurchaseUnitId_FNumber from 44da707b-4d02-3e20-ad97-fdd69ff7a37d where FNumber={{goodsDocDetailList.goodsNo}}
FEntity.FRealQty	实退数量	string	{{goodsDocDetailList.quantity}}
FEntity.FPriceUnitId	计价单位	string	_findCollection find FPurchaseUnitId_FNumber from 44da707b-4d02-3e20-ad97-fdd69ff7a37d where FNumber={{goodsDocDetailList.goodsNo}}
FEntity.FSalUnitID	销售单位	string	findCollection find FPurchaseUnitId_FNumber from 44da707b-4d02-3e20-ad97-fdd69ff7a37d where FNumber={{goodsDocDetailList.goodsNo}}
FEntity.FTaxPrice	含税单价	string	{{goodsDocDetailList.cuPrice}}
FEntity.FEntryTaxRate	税率%	string	13
FEntity.FOwnerTypeId	货主类型	string	BD_OwnerOrg
FEntity.FOwnerId	货主	string	103
FEntity.FStockId	仓库	string	{{warehouseCode}}
FEntity.FLot	批次号	string	{{goodsDocDetailList.batchNo}}
FEntity.FProduceDate	生产日期	string	_function FROM_UNIXTIME( ( {{productionDate}} / 1000 ) ,'%Y-%m-%d %T' )
FEntity.FExpiryDate	有效期至	string
FEntity.FNote	备注	string
FEntity.FOrderNo	订单单号	string
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	string	_function case '{{channelCode}}' when '10002480' then '104' else '103' end
FEntity.SubHeadEntity.FThirdBillNo	第三方单据编号	string	{{tradeNo}}
FEntity.SubHeadEntity.FThirdBillId	第三方单据平台单号	string	{{sourceTradeNos}}
FEntity.SubHeadEntity.FormId	业务对象表单Id	string	SAL_RETURNSTOCK
FEntity.SubHeadEntity.Operation	执行的操作	string	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	true
FEntity.SubHeadEntity.SubSystemId	系统模块	string	21

系统集成总览

采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。