系统级别输入参数
参数名称 | 说明 |
---|---|
appkey | 客户端标识 (由fesco技术部提供给调用方一对appkey与appsecret) |
sign | 调用方签名后的字符串 |
format | (json/jsonp)如果该参数不传递,默认返回json |
timeStamp | 时间戳(毫秒值,1534225991898) |
methodName | 方法名 |
接口概述 | |
---|---|
开发者 | 郭勇 |
方法名 | entinfocollection.updateVATColltForMis |
说明 |
说明: 服务端接口增加判断业务客户下是否有通知单模板级别的纳税信息,如果有,则返回异常提示:已维护通知单模板级别的发票信息 |
应用级输入参数
名称 | 类型 | 是否必须 | 描述 | 示例值 | 默认值 |
---|---|---|---|---|---|
![]() |
|
是 | 应用级别参数对象Json序列化后的字符串 | {'custId':'10086','custName':'IBM','busiCustId':'10010','busiCustName':'IBM中国','suppId':'','suppName':'','suppOrCust':'1','matAddrOne':'123','matAddrTwo':'456','matAddrThr':'789','vatTaxerType':'1','vatTaxerNum':'9099—1234','vatName':'纳税客户名称','vatAddr':'北京市海淀区XX号','vatPhone':'20209909','vatBankBillNo':'1322332323232323','creTime':'2016-01-01 13:00:00','depId':'102','depName':'业务一部','repId':'991','repName':'王端','remark':'XXXYYY','name':'IBM-Hr','email':'123@163.com','phone':'10010'} | |
└ custId |
|
否 | 客户ID | 类型为客户必传 | |
└ custName |
|
否 | 客户名称 | 类型为客户必传 | |
└ busiCustId |
|
否 | 业务客户ID | 类型为客户必传 | |
└ busiCustName |
|
否 | 业务客户名称 | 类型为客户必传 | |
└ suppId |
|
否 | 供应商ID | 类型为供应商必传 | |
└ suppName |
|
否 | 供应商名称 | 类型为供应商必传 | |
└ suppOrCust |
|
是 | 客商类型 | 字典值(1客户 2 供应商 ) | |
└ matAddrOne |
|
否 | 营业执照副本 (编号1) | 纳税人类别为一般纳税人(1)时,必填 信息传递为64编码串。 | |
└ matAddrTwo |
|
否 | 税务登记证正本 (编号2) | 纳税人类别为一般纳税人(1)时,必填 信息传递为64编码串。 | |
└ matAddrThr |
|
否 | 税务登记证副本 (编号3) | 纳税人类别为一般纳税人(1)时,必填 信息传递为64编码串。 | |
└ matAddrFou |
|
否 | 税务登记证副本 (编号4) | 纳税人类别为一般纳税人(1)时,必填 信息传递为64编码串。 | |
└ matAddrFiv |
|
否 | 银行开户许可证(编号5) | 信息传递为64编码串。 | |
└ vatBankName |
|
是 | 开户银行名称 | 无须字典值。客户直接维护 | |
└ vatTaxerType |
|
是 | 纳税人类别 | 字典值(1.一般纳税人、2.小规模纳税人) | |
└ vatTaxerNum |
|
是 | 纳税人识别号 | VARCHAR2(18) 税控端目前限制位数如此,因此在采集时,长度不可超过此限制。 | |
└ vatName |
|
是 | 增值税业务客户名称 | Varchar2(100) 税控端目前限制位数如此,因此在采集时,长度不可超过此限制。 | |
└ vatAddr |
|
是 | 增值税开票地址 | Varchar2(200),因此在采集时无须限制,税控端会自行处理 | |
└ vatPhone |
|
是 | 增值税开票电话 | Varchar2(200),因此在采集时无须限制,税控端会自行处理 | |
└ vatBankBillNo |
|
是 | 增值税账户号 | Varchar2(80) 税控端目前限制位数如此,因此在采集时,长度不可超过此限制。 | |
└ creTime |
|
是 | 创建时间 | YYYY-MM-dd hh:mm:ss | |
└ depId |
|
是 | 业务部ID | ||
└ depName |
|
是 | 业务部名称 | ||
└ repId |
|
是 | 业务代表角色实例ID | ||
└ repName |
|
是 | 业务代表名称 | ||
└ remark |
|
是 | 备注 | ||
└ name |
|
是 | 联系人名称 | ||
|
是 | 联系人邮箱 | |||
└ phone |
|
是 | 联系人电话 | ||
└ isEffect |
|
否 | 纳税信息是否有效(1.有效 0无效) | 网络端功能维护时,该条件维护方式只有【有效->无效】,并传递新系统此值为0,网络端则需要对此纳税信息做无效操作。(不传或为空,新系统视为有效) |
返回结果
名称 | 类型 | 描述 |
---|---|---|
code |
|
0为成功,其他为失败 |
errorMsg |
|
失败原因 |
![]() |
|
成功数据集合 |
errorResult |
|
失败数据集合 |
status |
|
1为中间库成功,2为新系统成功,3为新系统失败(新系统业务处理异常,不插入中间库) |
piCallRecId |
|
中间表主键id(根据中间表主键id查询返回正确业务数据的json串) |
errorStack |
|
错误堆栈 |
调用示列
/* 网络端客户调用时: 红字参数需要必填 1. 业务客户ID('busiCustId')在纳税数据存在,则新系统做更新、生成数据操作。 更新、创建范围:除红字外所有信息 新系统需要判断: */ {'custId':'10086','custName':'IBM','busiCustId':'10010','busiCustName':'IBM中国','suppId':'','suppName':'','suppOrCust':'1','matAddrOne':'123','matAddrTwo':'456','matAddrThr':'789','vatTaxerType':'1','vatTaxerNum':'9099—1234','vatName':'纳税客户名称','vatAddr':'北京市海淀区XX号 Hr','email':'123@163.com','phone':'10010'}','vatPhone':'20209909','vatBankBillNo':'1322332323232323','creTime':'2016-01-01 13:00:00','depId':'102','depName':'业务一部','repId':'991','repName':'王端 ','remark':'XXXYYY','name':'IBM- /* 网络端供应商调用时: 红字参数需要必填 新系统需要判断: 1. 供应商ID('suppId')在纳税数据存在,则新系统做更新、生成数据操作。 更新、创建范围:除红字外所有信息 {'custId':'','custName':'','busiCustId':'','busiCustName':'','suppId':'90','suppName':'上海外企德科','suppOrCust':'2','matAddrOne':'123','matAddrTwo':'456','matAddrThr':'789','vatTaxerType':'1','vatTaxerNum':'9099—1234','vatName':'纳税客户名称','vatAddr':'北京市海淀区XX号','vatPhone':'20209909','vatBankBillNo':'1322332323232323','creTime':'2016-01-01 13:00:00','depId':'102','depName':'业务一部','repId':'991','repName':'王端','remark':'XXXYYY','name':'IBM-Hr','email':'123@163.com','phone':'10010'}
错误码
错误编码 | 错误描述 | 错误原因 | 解决方案 |
---|