系统交付工具之
上海鼎晶生物科技股份有限公司
金蝶 Cloud 与鼎晶 CMS
接口规范定义
文档作者: 交付中心
创建日期: 2017-10-22
确认日期: 2016-10
当前版本: 1.0
拷贝数量: 1
审批签字:
客户方项目经理:
交付方项目经理:
接口规范定义
文档控制
修改记录
日期
作者
2017/10/22 杨绕
参考版本
版本
V1.0
备注
新建
2
接口规范定义
1.1.
1.2.
1.3.
1.4.
2.1.
2.2.
2.3.
目录
1.
2.
3.
金蝶 Cloud 接口基本定义 ................................................................................................4
金蝶接口方式 ............................................................................................................4
金蝶 Cloud 接口连接信息 ........................................................................................4
金蝶 Cloud 接口单据列表 ........................................................................................4
金蝶 Cloud 接口操作列表 ........................................................................................4
金蝶 Cloud 接口数据定义 ................................................................................................5
组织机构(测试) ....................................................................................................5
应收单........................................................................................................................ 5
2.2.1. 数据结构 ............................................................................................................5
2.2.2. 接口调用 ............................................................................................................6
Json 参考格式(保存)...................................................................................6
2.2.3.
Json 参考格式(提交/审核).........................................................................8
2.2.4.
收款单(RECEIVEBILL) ..........................................................................................9
2.3.1. 数据结构 ............................................................................................................9
2.3.2. 接口调用 ..........................................................................................................10
Json 参考格式(保存).................................................................................10
2.3.3.
Json 参考格式(提交/审核).......................................................................11
2.3.4.
金蝶 Cloud 接口 php 调用示例 ......................................................................................11
3
接口规范定义
1. 金蝶 Cloud 接口基本定义
1.1. 金蝶接口方式
采用 http+Json 方式
1.2. 金蝶 Cloud 接口连接信息
序号 连接项
1
2
3
4
5
POST_K3CloudURL
帐套 Id
用户名
密码
语言 id
值
备注
http://121.42.181.98:81/k3cloud/ 测试
5982b23995277e
测试
admin
123456
2052
测试
测试
1.3. 金蝶 Cloud 接口单据列表
序号
单据
1
2
3
应收单
收款单
收款退款单
FormId
AR_receivable
AR_RECEIVEBILL
AR_REFUNDBILL
类型
业务单据
业务单据
业务单据
注:暂时不考虑收款退款单,如果以后增加收款退款单的接口,需要额外技术支持。
1.4. 金蝶 Cloud 接口操作列表
序号
操作
操作 ID
1
2
3
4
5
新增/修改
查看
提交
审核
反审核
Save
View
Submit
Audit
UnAudit
4
接口规范定义
2. 金蝶 Cloud 接口数据定义
2.1. 组织机构(测试)
2.2. 应收单
2.2.1. 数据结构
序号 类型
字段
字段描述
数据类型
赋值说明
基本:AR_receivable
1 基本
2 基本
3 基本
FBillTypeID
FBillNo
FDate
4 基本
FENDDATE_H
单据类型
单据编号
日期
日期
Varchar(80)
固定:YSD01_SYS
Varchar(80)
发票号码
smalldatetime 开票时间
YYYY-MM-DD
smalldatetime 月结:开票时间+月
5 基本
FCUSTOMERID
客户代码
Varchar(80)
6 基本
7 基本
8 基本
9 基本
10 基本
FCURRENCYID
FPayConditon
FSETTLEORGID
FSALEORGID
FPAYORGID
币种
收款条件
结算组织
销售组织
收款组织
Varchar(80)
Varchar(80)
Varchar(80)
Varchar(80)
Varchar(80)
结时间
周结:开票时间+周
结时间
现结:开票时间+现
结时间
YYYY-MM-DD
个人:统一客户代码
“0000-个人”
企业:选择的开票客
户的代码,必须与金
蝶的客户代码一致。
人民币:PRE001
条件代码
组织机构代码
组织机构代码
组织机构代码
5
接口规范定义
11 基本
FSALEERID
销售员
Varchar(80)
客户的销售人员的
12 基本
FBUSINESSTYPE
业务类型
Varchar(80)
财务:AR_receivable__FsubHeadFinc
代码(员工工号)
固定: BZ
1 财务
2 财务
3 财务
4 财务
FSettleTypeID
FMAINBOOKSTDCURRID 本位币
FEXCHANGETYPE
FExchangeRate
汇率
结算方式
汇率类型
Varchar(80)
Varchar(80)
Varchar(80)
Decimal(18,6) 人民币:默认 1
结算方式代码
人民币:PRE001
固定:HLTX01_SYS
明细:AR_receivable__FEntityDetail
产品代码
计量单位
Varchar(80)
S0001-检测费
S0002-技术服务费
Varchar(80)
默认:Pcs
Decimal(18,6) 默认值:1
数量
不含税单价 Decimal(18,6) 不含税金额/数量
含税单价
税率%
不含税金额 Decimal(18,2) 不含税金额
基本单位
Decimal(18,6) 开票金额/数量
Decimal(18,6) 税率:3 代表 3%
Varchar(80)
Varchar(255)
备注
销售订单号 Varchar(80)
税额
默认:Pcs
备注
Decimal(18,2) 税额
Decimal(18,2) 开票金额
Decimal(18,2) 默认值:1
1 明细
FMATERIALID
2 明细
3 明细
4 明细
5 明细
6 明细
7 明细
8 明细
9 明细
10 明细
11 明细
12 明细
13 明细
FSalUnitId
FSalQty
FPrice
FTaxPrice
FEntryTaxRate
FNoTaxAmountFor_D
FBASICUNITID
FComment
FORDERNUMBER
FTAXAMOUNTFOR_D
FALLAMOUNTFOR_D
FBASICUNITQTY
价税合计
计价基本数
量
1
计划
FPAYRATE
付款比例
Decimal(18,2) 默认值:100
计划:AR_receivable__FEntityPlan
2.2.2. 接口调用
保存提交审核
2.2.3.
Json 参考格式(保存)
{
"Creator": "0",
"NeedUpDateFields": [],
"Model": {
"FBillTypeID": {
"FNumber": "YSD01_SYS"
},
6
"FBillNo": "AR201710268888",
"FDATE": "2017-11-17",
"FENDDATE_H ": "2017-11-17",
"FCUSTOMERID": {
"FNUMBER": "0000"
},
"FCURRENCYID": {
"FNumber": "PRE001"
},
"FPayConditon": {
"FNUMBER": ""
},
"FSETTLEORGID": {
"FNUMBER": "100"
},
"FSALEORGID": {
"FNUMBER": "100"
},
"FPAYORGID": {
"FNUMBER": "100"
},
"FSALEERID": {
"FNumber": ""
},
"FBUSINESSTYPE": "BZ",
"AR_receivable__FsubHeadFinc": {
"FSettleTypeID": {
"FNumber": ""
},
"FMAINBOOKSTDCURRID": {
"FNumber": "PRE001"
},
"FEXCHANGETYPE": {
"FNumber": "HLTX01_SYS"
},
"FExchangeRate": 1
},
"AR_receivable__FEntityDetail": [
{
"FMATERIALID": {
"FNumber": "S0001"
},
"FSalUnitId": {
接口规范定义
7
"FNumber": "Pcs"
},
"FSalQty": 1,
"FTaxPrice": 1170,
"FPrice": 1000,
"FEntryTaxRate": 17,
"FNoTaxAmountFor_D": 1000,
"FComment": "备注 11",
"FTAXAMOUNTFOR_D": 170,
"FORDERNUMBER": "",
"FALLAMOUNTFOR_D": 1170,
"FBASICUNITQTY": 1
"FMATERIALID": {
"FNumber": "S0002"
},
"FSalUnitId": {
"FNumber": "Pcs"
},
"FSalQty": 1,
"FTaxPrice": 1170,
"FPrice": 1000,
"FEntryTaxRate": 17,
"FNoTaxAmountFor_D": 1000,
"FComment": "备注 11",
"FTAXAMOUNTFOR_D": 170,
"FORDERNUMBER": "",
"FALLAMOUNTFOR_D": 1170,
"FBASICUNITQTY": 1
},
{
}
],
"AR_receivable__FEntityPlan": [
{
}
"FPAYRATE": 100
]
}
}
2.2.4.
Json 参考格式(提交/审核)
接口规范定义
8