用友NC系统与一卡通集成解决方案

1.1 一卡通和NC集成开发

1.1.1 一卡通和NC集成需求说明

一卡通可以获取NC系统已经审批且未完成的采购订单，在一卡通系统进行车辆以及到货安排，一卡通系统在获取磅单信息后需要同步给NC系统的到货单，NC系统自动关联对应的订单信息。具体的结算信息由一卡通系统生成，生成后需把最终的结算信息同步给NC系统，在入库信息中记录最终的结算信息。

1.1.2 采购业务和一卡通对接整体流程

1.1.3 采购业务和一卡通对接整体流程说明

1：在NC系统审批采购订单自动同步视图中，可随时供一卡通系统获取

2：一卡通系统根据订单系统进行排车计划，在过磅之后把磅单信息传给NC系统（不允许传重复的榜单信息），NC系统生成到货单自动匹配对应的订单并审核，如果成功则返回一卡通系统成功的消息，如果失败，NC则将具体报错信息反馈到一卡通系统（此过程不包含逆流程）。

3：一卡通系统接到NC返回过磅信息成功后，进行后续业务操作，在结算的时候把结算信息传给NC系统, NC系统生成入库单自动匹配对应的订单并审核，如果成功则返回一卡通系统成功的消息，如果失败，NC则将具体报错信息反馈到一卡通系统（此过程不包含逆流程）。

1.3.4 订单视图开放

csourcetype,--来源系统

cCreateTime,--制单时间

cMakerName,--制单人

cMakerID,--制单人编号

cVerifyTime,--审核时间

cVerifierName,--审核人

cVerifierID,--审核人编号

cInvFactoryCode,--公司编码

cInvFactoryName,--公司名称

/*'' as cVenCode,--承运单位编码

'' as cVenName,--承运单位*/

cPoCode,--来源单据编码-订单单号

cInvCode,--存货编码

cInvName,--存货名称

cInvStd,--规格型号

cWhCode,--仓库编码

cWhName,--仓库名称

cVenCode,--供应商编码

cVenName,--供应商名称

iStatusFlag,--单据状态 0=自由，1=提交，2=正在审批，3=审批，4=审批不通过，5=输出，

cMemo,--备注

Ts,--外部系统更新时间

cPoID,--来源主表ID

cPoSID,--来源字表ID

iRowNo,--来源单据字表行号

iQuantity,--订单数量 主数量

iPrice,--订单单价 含税 主含税单价

iMoney,--金额含税

cdefinel, --合同号

PK_BILLTYPEID, --订单类型 id

PK_BILLTYPECODE --订单类型编码。

1.3.5 采购到货接收

流程说明

功能说明

NC系统开放采购到货接收接口可供一卡通系统实时调用,一卡通在过磅单完成后传给NC系统生成对应的到货单。NC需要根据回传回来的订单信息自动配对应的订单，单据状态为保存态。

测试接口地址：http://ip:port/uapws/service/nc.bs.Itf.webservice.ImportPONCData

接口方式：webservices

接口名称：importPONCData

接口参数：datatype:23 ,action:01、新增，02、修改，03、删除（红色废弃，黄色属于变更新增）

数据载体：JSON

服务方：NC

调用方：一卡通

接口触发：一卡通实时调用

接口方向：一卡通 è NC

接收张数：NC每次只接收一单

20190907电话会议变更红色废弃变更内容请查看黄色部分

新增修改逻辑说明：

1：传输格式同新增

2：根据vbdef20（磅单号）判断到货单是否已存在，不存在直接报错，是否可以删除不允许删除直接返回报错

3：已存在且允许删除的磅单信息，在NC中先删除对应的到货单，删除后直接走新增逻辑重新建立新的到货单单据为保存态

4：返回报文格式同新增

变更后

1：传输格式同新增

2：根据vbdef20（磅单号）判断到货单是否已存在，不存在直接报错，是否可以删除不允许删除直接返回报错

3：已存在且允许删除的磅单信息，在NC中先删除对应的到货单，删除后返回删除成功消息

响应报文：

成功：

{

"flag": "true",

"errmsg": "磅单号:js03030303在NC中删除成功,NC到货单号:XXX,已删除!"

}

失败：

{

"flag": " false ",

"errmsg": "磅单号:js03030303在NC中删除失败!原因:XXXXXX"

}

JSON格式：

{

"data": {

"pk_org": "xx",

"dbilldate": "2019-07-24",

"orderbillcode": "CD2019080200065879",

"vbdef20": "test1922153213",

"vmemo": "测试单据",

"items": [{

"orderrowno": "10",

"pk_srcmaterial": "jiacun",

"nnum": "1",

"vbdef14": "车牌11111",

"vbdef15": "司机",

"vmemob": "猪蹄",

"vbdef16": "10"

}]

}}

参数说明

名称	类型	是否必须	描述	字段说明
表头信息
pk_org	String	是	库存组织	传输编码
dbilldate	String	是	到货日期
orderbillcode	String	是	订单号
vbdef20	String	是	磅单号	表头自定义项20
vmemo	String	是	备注
表体信息
orderrowno	String	是	订单明细
pk_srcmaterial	String	是	物料信息	传输编码
nnum	String	是	数量
vbdef14	String	是	车牌号	表体自定义项14
vbdef15	String	是	司机	表体自定义项15
vbdef16	String	是	磅单行号	表体自定义项16
vmemob	String	是	行备注

响应报文：

到货成功

{

"flag": "true",

"msg": "单据保存且审批成功!单据号为:DH2019080200000031",

"data": {

"vbdef20": "test1922153213",

"pk_arriveorder": "1001B11000000006KFKP",

"arrivecode": "DH2019080200000031",

"items": [{

"vbdef16": "10",

"pk_arriveorder_b": "1001B11000000006KFKQ",

"arrivecrowno": "10"

}]

}

到货失败，返回格式

{

"flag": "false",

"msg": "XX!",

"data": {}

}

参数说明：

名称	类型	是否必须	描述
flag	String	是	true=NC处理成功，false=NC处理失败
msg	String	是	反馈信息 1：磅单号:xxx在NC中保存成功，NC到货单号:SSS！ 2：磅单号:xxx在NC中保存失败，原因：XX
表头
vbdef20	String	是	磅单号
arrivecode	String	是	到货单号
pk_arriveorder	String	是	表头主键
表体
vbdef16	String	是	磅单行号
arrivecrowno	String	是	到货单行号
pk_arriveorder_b	String	是	表体主键

1.3.6 采购入库接收

流程说明

功能说明

变更后：NC系统开放采购入库新增接口，在一卡通系统确认结算后，把结算信息以及质检信息传给NC系统，NC做采购入库的新增（保存态），并自动匹配对应的到货单把到货在新增前自动审批掉。

测试接口地址：http://ip:port/uapws/service/nc.bs.Itf.webservice.ImportPONCData

接口方式：webservices

接口名称：importPONCData

接口参数：datatype: 45 ,action:01、新增，02、修改，03、删除（红色暂不支持）

数据载体：JSON

服务方：NC

调用方：一卡通

接口触发：一卡通实时调用

接口方向：一卡通 è NC

接收张数：NC每次只接收一单（一张磅单信息上周五会议结论）

20190907电话会议变更红色废弃变更内容请查看黄色部分

新增修改逻辑说明：

1：传输格式同新增

2：根据回传的到货单判断对应的入库单是否已存在，不存在直接返回报错，是否可以删除不允许删除直接返回报错

3：已存在且允许删除的入库信息，在NC中先删除对应的入库单，删除后直接走新增逻辑重新建立新的入库单单据为保存态

4：返回报文格式同新增

变更后

1：传输格式同新增

2：根据回传的到货单判断入库单是否已存在，不存在直接报错，是否可以删除不允许删除直接返回报错

3：已存在且允许删除的磅单信息，在NC中先删除对应的到货单，删除后返回删除成功消息

响应报文：

成功：

{

"flag": "true",

"errmsg": "磅单号:js03030303在NC中删除成功,NC到货单号:XXX,已删除!"

}

失败：

{

"flag": " false ",

"errmsg": "磅单号:js03030303在NC中删除失败!原因:XXXXXX"

JSON格式：

{

"data": {

"pk_org": "xx",

"dbilldate": "2019-08-02",

"vdef19": "js03030303",

"vdef11": "XX",

"vdef12": "XX",

"vdef13": "XX",

"vdef14": "XX",

"vdef15": "XX",

"vdef16": "XX",

"vdef17": "XX",

"vdef18": "XX",

" vmemo ": "XX",

"items": [{

"arrivecode": "DH2019080200000031",

"arrivecrowno": "10",

"pk_arriveorder": "1001B11000000006KFKP",

"pk_arriveorder_b": "1001B11000000006KFKQ",

"pk_srcmaterial": "jiacun",

"nnum": "100",

"norigtaxprice": "66",

"norigtaxmny": "10000",

"vbdef20": "10",

"vmemob": "10行备注"

}]

}

参数说明

名称	类型	是否必须	描述	字段说明
表头信息
pk_org	String	是	库存组织	传输编码
dbilldate	String	是	入库日期
vdef11	String	否	全水分
vdef12	String	否	内水（Mad)
vdef13	String	否	基准热值
vdef14	String	否	硫(St.ad)
vdef15	String	否	挥发分（Vad)
vdef16	String	否	灰熔点(Ft)
vdef17	String	否	灰分(Aad)
vdef18	String	否	质检单号
vdef19	String	是	结算单号
vmemo	String	是	备注
表体信息
arrivecode	String	是	到货单号
arrivecrowno	String	是	到货行号
pk_arriveorder	String	是	到货表头主键
pk_arriveorder_b	String	是	到货表体主键
pk_srcmaterial	String	是	物料信息	传输编码
nnum	String	是	数量
norigtaxmny	String	是	价税合计
norigtaxprice	String	是	含税单价
vbdef20	String	是	数量	结算单行号
vmemob	String	是	行备注

响应报文：

成功：

{

"flag": "true",

"errmsg": "结算单号:js03030303在NC中保存成功,NC入库单号:CR2019080200065829!"

}

失败：

{

"flag": " false ",

"errmsg": "结算单号:js03030303在NC中保存失败,原因：XXXXXXXXXXX!"

}

参数说明：

名称

类型

是否必须

描述

flag

String

是

true=NC处理成功，false=NC处理失败

msg

String

是

反馈信息 1：结算号:xxx在NC中保存成功，NC入库单号:SSS！

2：结算单号:xxx在NC中保存失败，原因：XX

1.3.7 合同视图开放

试图字段同订单的试图字段

1.3.8 转库单接收

流程说明

功能说明

NC系统开放转库单新增接口，在一卡通系统确认过磅后，把过磅信息传给NC系统，NC做转库单的新增（保存态），并自动签字且推式生成转库出库和转库入库。

测试接口地址：http://ip:port/uapws/service/nc.bs.Itf.webservice.ImportPONCData

接口方式：webservices

接口名称：importPONCData

接口参数：datatype: 4K ,action:01、新增，02、修改，03、删除（红色暂不支持）

数据载体：JSON

服务方：NC

调用方：一卡通

接口触发：一卡通实时调用

接口方向：一卡通 è NC

接收张数：NC每次只接收一单（一张磅单信息）

JSON格式：

{

"data": {

"pk_org": "xx",

"cPoID":"1001CS100000000700U2",

"dbilldate": "2019-08-02",

"billmaker": "js03030303",

"vtrantypecode": "XX",

"cwarehouseid": "XX",

"cotherwhid": "XX",

"vdef16": "XX",

"vmemo": "XX",

"items": [{

"cPoSID":"1001CS100000000700U3",

"cmaterialvid": "1001CS1000000006IRPJ",

"nnum": "100",

"vbdef20": "10",

"vmemob": "10行备注"

}]

}

参数说明

名称	类型	是否必须	描述	字段说明
表头信息
pk_org	String	是	库存组织	传输编码
billmaker	String	是	制单人	可传编码可默认
cPoID	String	是	合同表头主键
dbilldate	String	是	转库日期
vtrantypecode	String	是	转库类型	可默认
vdef16	String	是	磅单号
vmemo	String	是	备注
表体信息
cmaterialvid	String	是	物料信息	传输编码
nnum	String	是	数量
vbdef20	String	是	榜单行号	榜单行号
vmemob	String	是	行备注
cPoSID	String	是	合同明细主键

响应报文：

成功：

{

"flag": "true",

"errmsg": "磅单号:XXX在NC中保存成功,NC转库单号:XXX!"

}

失败：

{

"flag": " false ",

"errmsg": "磅单号:XXX在NC中保存失败,原因：XXXXXXXXXXX!"

}

参数说明：

名称

类型

是否必须

描述

flag

String

是

true=NC处理成功，false=NC处理失败

msg

String

是

反馈信息 1：磅单号:xxx在NC中保存成功，NC转库单号:SSS！

2：磅单号:xxx在NC中保存失败，原因：XX

1.3.8 采购订单接收

流程说明

功能说明

NC系统开放采购订单新增接口，在一卡通系统确认结算后，把服务费结算信息以及质检信息传给NC系统，NC做采购订单的新增（保存态），并自动匹配对应的采购合同匹配后自动审批。

测试接口地址：http://ip:port/uapws/service/nc.bs.Itf.webservice.ImportPONCData

接口方式：webservices

接口名称：importPONCData

接口参数：datatype: 21 ,action:01、新增，02、修改，03、删除（红色暂不支持）

数据载体：JSON

服务方：NC

调用方：一卡通

接口触发：一卡通实时调用

接口方向：一卡通 è NC

接收张数：NC每次只接收一单（一张结算单信息）

JSON格式

{

"data": {

"pk_org": "xx",

"dbilldate": "2019-08-02",

" cPoID ": "js03030303",

" vmemo ": "XX",

"items": [{

"vbdef3": "XX",

"vbdef4": "XX",

"vbdef5": "XX",

"vbdef6": "XX",

"vbdef7": "XX",

"vbdef8": "XX",

"vbdef9": "XX",

"vbdef14": "XX",

"vbdef15": "XX",

"vbdef16": "XX",

"vbdef17": "XX",

" pk_srcmaterial ": "100",

"nnum": "100",

" norigtaxprice ": "66",

" norigtaxmny ": "10000",

" cPoSID ": "10",

"vmemob": "10行备注"

}]

}

参数说明

名称	类型	是否必须	描述	字段说明
表头信息
pk_org	String	否	采购组织	从合同获取
dbilldate	String	是	订单日期
cPoID	String	是	合同表头主键
vmemo	String	是	备注
表体信息
vbdef3	String	否	全水分
vbdef4	String	否	内水（Mad)
vbdef5	String	否	基准热值
vbdef6	String	否	硫(St.ad)
vbdef7	String	否	挥发分（Vad)
vbdef8	String	否	灰熔点(Ft)
vbdef9	String	否	灰分(Aad)
vbdef14	String	否	质检单号
vbdef15	String	是	结算单号
vbdef16	String	是	磅单号
vbdef17	String	是	车牌号
pk_srcmaterial	String	是	物料
nnum	String	是	数量
norigtaxprice	String	是	主含税单价	一卡通结算单单价
norigtaxmny	String	是	价税合计	一卡通结算金额
cPoSID	String	是	合同明细主键
vmemob	String	是	行备注

响应报文：

成功：

{

"flag": "true",

"errmsg": "结算单号:js03030303在NC中保存成功,NC采购订单号:CR2019080200065829!"

}

失败：

{

"flag": " false ",

"errmsg": "结算单号:js03030303在NC中保存失败,原因：XXXXXXXXXXX!"

}