NC系统与一卡通集成解决方案(二)

it2026-03-06  24

​​​​​​​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!"

}

 

最新回复(0)