LOGO OA教程 ERP教程 模切知识交流 PMS教程 CRM教程 开发文档 其他文档  
 
网站管理员

SAP、百望,进项发票一体化对接

admin
2024年11月3日 7:19 本文热度 1548

​SAPSRM-百望接口

  • 思路

SAPSRM相关页面中加按钮‘导入发票号,实现单点登录百望界面,百望开发选择发票号界面,选择完成后调用接口,实现保存发票号,对SAP中参照、分配等进行赋值或对srm相关字段进行赋值。

SAP中发票预制凭证导入功能,同时保存进百望系统。

  • SAMSRM相关界面

SRM相关页面

 

百望反馈:

根据以上说明,先整理以下:

 

1.指定单点登录规则,校验身份的方式,和SAP提供的接口。

a)如何获取校验身份的token

b)SAP提供接口,根据返回字段标明身份验证成功或失败

 

2.百望提供页面:

a)百望提供页面url

b)参数:购方名称,发票时间范围起和止,其他参数?

c)页面:发票需要显示哪些列?实际业务中,最多可能有多少张发票?默认是否是都打勾?默认根据开票日期排序?是否需要分页?显示合计信息:发票张数,金额之和,税额之和?

d)点击确定按钮之后,通过何种方式将这些发票信息传给SAP?通过js传递给父窗口,还是在后台通过接口传递?

 

 效果图:

ZBADI_FDCB_SUBBAS04_BADI  MIR7屏幕增强增加按钮  SE80ZMRM_HEADER_CHECK  未接入百望发票保存报错消息  SE19ZINVOICE_UPDATE  预制成功更新底表  SE19LFDCBFM0  参照和分配字段返回  SE38LMR1MF2Y  每次执行事务MIR7清空ZLTB  SE38


执行MIR7事务同时清空当前用户ZLTBW的数据                MIR7预制发票跳转百望发票搜索平台                多次检索完毕返回MIR7界面同时更新临时自建表ZLTBW                MIR7若未接入百望发票预制报消息提示                MIR7预制成功后更新到自建表ZMMBW                执行ZDMM002事务同时清空当前用户ZLTBW数据                ZDMM002上载文本后ALV显示数据                ZDMM002预制发票跳转百望发票搜索平台                多次检索完毕返回ZDMM002界面同时更新临时自建表ZLTBW                ZDMM002若未接入百望发票预制报消息提示                ZDMM002预制成功后更新到自建表ZMMBW                

百望进项标准版

对接服务接口文档说明

一、进项介绍  

  百望进项管理系统是百望开发的为企业管理进项发票的系统,从发票的入库、查验、认证都进行数字化管控,大大增加了企业内部发票流转的效率,提高财税人员的工作效率。

本接口文档是百望进项标准版接口文档,客户入驻标准版本后,都可使用本接口跟百望进项标准版进行交互,系统根据税号为客户提供进项数据接口服务。

二、加密规则  

    每个接入用户提供一个用户名AccessKeyID、秘钥AccessKeySecret;使用秘钥基于HMC-SHA1算法进行请求内容的加密和解密;

三、URL生成  

调用URL地址:

         /?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0Signature=D29569843EB9DFA0F59E921F32D24973

        1>           为调用服务地址,单独给出,不写入此文档。

        2>           为接口名称

        3>版本号,默认为1.0(参考文档版本的前两位数字)    

4> URL字符说明:

Ÿ对于字符 A-Z、a-z、0-9 以及字符“-”、“_”、“.”、“~”不编码;

Ÿ对于其他字符编码成 “%XY” 的格式

Ÿ对于扩展的 UTF-8 字符,编码成 “%XY%ZA…” 的格式

Ÿ需要说明的是英文空格( )要被编码是 %20,而不是加号(+)

Ÿ时间类型"yyyy-MM-dd'T'HH:mm:ss'Z'"

ŸSignatureNonce为32位随机数UUID,时效为10分钟。

       

5> Signature生成规则:

Ÿ连接内容排序:将本URL中,除Signature外其他所有参数,按照参数名称的字典顺序

Ÿ使用AccessKeySecret基于HMC-SHA1算法加密

Ÿ对加密结果用MD5加密

          

举例参数:

ŸAccessKeyID=userid

ŸAccessKeySecret=password

ŸTimeStamp=2016-02-23 12:46:24

ŸSignatureNonce=123456

Ÿ根据参数名排序后:

AccessKeyID=userid&SignatureNonce=123456&TimeStamp=2016-02-23T12:46:24

Ÿ使用AccessKeySecret基于HMC-SHA1算法加密及MD5加密算法示范:    

Ÿ输出结果:D29569843EB9DFA0F59E921F32D24973

          

四、标准接口列表  

(一)初始化数据  

说明:    

初始化发票数据,当前申报期内可认证所有发票状态改成“未同步”。

          

请求地址

                 /init?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法类型

HTTPS POST

ContentType

application/json; charset=utf-8

入参

JSON

出参

JSON

          

入参说明

参数

类型

长度

必填

描述

TaxNo

String

20

购方税号

          

          

JSON入参说明:

{

       “TaxNo”:””                  //初始化发票的税号

}

          

JSON出参说明:

成功:

{

    "model": {

        Success:"",              //调用API是否成功:true/false

              Code:"",                     //返回码(见附表一)

              Message:""              //返回码对应信息(见附表一)

    }, 

    "request_id": "b560f311-4e29-48b9-9bc1-f378bca02516",

    "message": {    

        "success_message": "调用[初始化]接口成功!"

    }, 

"success": true

}

          

失败:

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --请求ID,用于定位问题

"message": {

        "error_code": "",      --失败的CODE

        "error_message": ""   --失败提示语

    }, 

"success": false  --失败标志

}

          

出参说明:

参数

类型

长度

描述

Success

Boolean

5

是否成功(True/false)

Code

String

4

返回码

Message

String

200

返回信息

          

(二)取数  

说明:

    获取任务结果,一次最多返回一千条发票;每天调用一次、初始化成功后调用。可获取当前申报期内可认证的所有发票。

请求地址

                 /sync?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973        

方法类型

HTTPS POST

ContentType

application/json; charset=utf-8

入参

JSON

出参

JSON

          

入参说明

参数

类型

长度

必填

描述

TaxNo

String

20

购方税号

          

          

JSON入参说明:

{

       “TaxNo”:””                      //取数税号

}

          

JSON出参说明:

成功:

{

    "model": {

        TaskNo:””,                     //任务编号

              InvoiceQuantity:””,              //发票数量

              PeriodYear:””,                     //当前税款所属期年份

              PeriodMonth:””,              //当前税款所属期月份

              OperationDateBegin:””,       //当前可操作时间起(YYYY-MM-DD)

OperationDateEnd:””,       //当前可操作时间止(YYYY-MM-DD)

DateFrameBegin:“”,              //当前可操作时间范围起(YYYY-MM-DD)    

DateFrameEnd:“”,              //当前可操作时间范围止(YYYY-MM-DD)

FollowTask:””,                     //是否有后续任务true/false;无后续任务则不需要再次获取

Success:””,                     //调用API是否成功:true/false

Code:“”,                            //返回码(见附表一)

Message:””,                     //返回码对应信息(见附表一)

InvoiceList:[                     //发票列表

       {

              No:””,                     //序号

       InvoiceCode:"",       //发票代码

InvoiceNumber:"",       //发票号码

InvoiceType:””,              //发票种类01-增值税专用发票 02-货运运输业增值税专用发票 03-机动车销售统一发票 14-通行费增值税电子普通发票

BillingDate:" ",        //开票日期:YYYY-MM-DD

State:"1",                     //发票状态(0-正常1-失控 2-作废 3-红冲 4-异常)

PurchaserTaxNo:"",       //购方税号

TotalAmount:””,       //合计金额

TotalTax:””,              //合计税额

SalesTaxNo:"",              //销方税号

SalesTaxName:"",       //销方名称

Deductible:””,              //是否认证 0-未认证 1-已认证

DeductibleDate:””,       //认证日期 如果已认证则为YYYY-MM-DD,未认证则为空    

DeductiblePeriod:””,//税款所属期 如果已认证则为YYYYMM,未认证则为空

"IsAgencyRebate": "0", // 是否代办退税(1为是,0为否)

"CertificationType":"1"//认证类型 1为抵扣,2为出口退税,3为代理出口退税

},

]

          

},

    "request_id": "",

    "message": {

        "success_message": "调用[取数]接口成功!"

    }, 

"success": true

}

          

失败:

{

"request_id": "", --请求ID,用于定位问题

"message": {

        "error_code": "",      --失败的CODE

        "error_message": ""   --失败提示语

    }, 

"success": false  --失败标志

}

出参说明:

ID

类型

长度

描述

TaskNo

String

32

任务编号

InvoiceQuantity        

String

10

发票数量

PeriodYear

String

4

当前税款所属期年份YYYY

PeriodMonth

String

4

当前税款所属期月份MM

OperationDateBegin

String

10

当前可操作时间起:格式:YYYY-MM-DD

OperationDateEnd

String

10

当前可操作时间止:格式:YYYY-MM-DD

DateFrameBegin

String

10

当前可操作时间范围起:格式:YYYY-MM-DD

DateFrameEnd

String

10

当前可操作时间范围止:格式:YYYY-MM-DD

FollowTask

Boolean

~

是否有后续任务:true/false;无后续任务则不需要再次获取

Success

Boolean

5

调用API是否成功:true/false

Code

String

4

返回码

Message

String

200

返回码对应信息

InvoiceList

list

~

发票列表

└ No

String

10

发票序号

└ InvoiceCode

String

10-12

发票代码:返回多个发票信息及任务号

└ InvoiceNumber

String

8

发票号码

└ InvoiceType

String

2

发票种类:01-增值税专用发票02-货运运输业增值税专用发票03-机动车销售统一发票

└ BillingDate        

String

10

开票日期:YYYY-MM-DD

└ State

String

1

发票状态:0-正常1-失控2-作废3-红冲4-异常

└ PurchaserTaxNo

String

20

购方税号

└ TotalAmount

String

17

合计金额

└ TotalTax

String

17

合计税额

└ SalesTaxNo

String

20

销方税号

└ SalesTaxName

String

150

销方名称

└ Deductible

String

0

是否认证:0-未认证1-已认证

└ DeductibleDate

String

10

认证日期:如果已认证则为YYYY-MM-DD,未认证则为空

└ DeductiblePeriod

String

10

税款所属期:如果已认证则为YYYYMM,未认证则为空

└ IsAgencyRebate

String

10

是否代办退税:0:是,1:否

└ CertificationType

String

10

认证类型:1为抵扣,2为出口退税,3为代理出口退税

└CertificationWay

String

2

认证方式:0为勾选认证,1为扫描认证

          

              

(三)取数任务接收成功反馈  

说明:

    当前任务号获取成功

请求地址

                 /syncResult?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法类型

HTTPS POST

ContentType

application/json; charset=utf-8

入参

JSON

出参

JSON

          

入参说明:

参数

类型

长度

必填

描述

TaxNo

String

20

购方税号

TaskNo

String

32

任务号

          

          

JSON入参说明:

{

       “TaxNo”:””,                      //通知取数成功税号

       “TaskNo”:””,            //任务号

}

          

JSON出参说明:

成功:

{

    "model": {    

        Success:"",              //调用API是否成功:true/false

              Code:"",                     //返回码(见附表一)

              Message:""              //返回码对应信息(见附表一)

    }, 

    "request_id": "b560f311-4e29-48b9-9bc1-f378bca02516",

    "message": {

        "success_message": "调用[取数成功反馈]接口成功!"

    }, 

"success": true

}

          

失败:

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --请求ID,用于定位问题

"message": {

        "error_code": "",      --失败的CODE

        "error_message": ""   --失败提示语

    }, 

"success": false  --失败标志

}

出参说明:

参数

类型

长度

描述

Success

Boolean

5

是否成功(True/false)

Code

String

4

返回码

Message

String

200

返回信息

              

(四)认证抵扣申请  

说明:

确认当前税款所属期抵扣,申请提交后,接口会根据web端设置的一步认证标识进行判断,如为开启状态,则直接提交税局认证。如为关闭状态,则本接口中的发票进入待认证列表,需要去web端进行确认后完成认证。

请求地址

                 /deductible?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法类型

HTTPS POST

ContentType

application/json; charset=utf-8

入参

JSON

出参

JSON

          

入参说明:

参数

类型

长度

必填

描述

taxNo

String

20

税号

Period

String

6

税款所属期(YYYYMM)

invoiceList

List



└ InvoiceCode

String

10-12

发票代码

└ InvoiceNumber

String

8

发票号码

└ BuyTaxNo

String

20

购方税号

└ CertificationType

String

2

认证类型:1为抵扣,2为出口退税,3为代理出口退税

              

JSON入参说明:(JSON串)

{

       “TaxNo”:””,                     //税号

“Period”:””,                     //税控所属期       (YYYYMM)

“InvoiceList”:[

{

InvoiceCode:"",       //发票代码

InvoiceNumber:"",       //发票号码

PurchaserTaxNo:"",       //购方税号

CertificationType:"" //认证类型 1为抵扣,2为出口退税,3为代理出口退税

}

]

}

          

JSON出参说明:

成功:

{

    "model": {

        TaskList:[             

                     {

                     InvoiceCode:"",       //发票代码

                     InvoiceNumber:"",       //发票号码

                     TaskNo:""                     //任务号

                     },

              ]

              Success:””,              //调用API是否成功:true/false

              Code:"",                     //返回码(见附表一)    

              Message:””              //返回码对应信息(见附表一)

    }, 

    "request_id": "b560f311-4e29-48b9-9bc1-f378bca02516",

    "message": {

        "success_message": "调用[申请抵扣]接口成功!"

    }, 

       "success": true

}

          

失败:

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --请求ID,用于定位问题

"message": {

        "error_code": "",      --失败的CODE

        "error_message": ""   --失败提示语

    }, 

"success": false  --失败标志

}

出参说明:

参数

类型

长度

描述

Success

Boolean

5

调用API是否成功(ture/false)

Code

String

4


Message

String

200


TaskList

List



└ InvoiceCode

String

10-12

发票代码

└ InvoiceNumber

String

8

发票号码

└ TaskNo        

String

32

任务编号

          

          

(五)认证抵扣结果同步  

说明:

    获取抵扣结果

请求地址

                 /result?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法类型

HTTPS POST

ContentType

application/json; charset=utf-8

入参

JSON

出参

JSON

          

入参说明

参数

类型

长度

必填

描述

taxNo

String

20

购方税号

InvoiceCode

String

10-12

发票代码

InvoiceNumber

String

8

发票号码

taskNo

String

32

任务编号

          

JSON入参说明:(JSON串)

{

“TaxNo”:””,                     //税号

“InvoiceCode”:"",       //发票代码    

“InvoiceNumber”:"",       //发票号码

“TaskNo”:””              //任务号

}

          

JSON出参说明:

成功:

{

    "model": {

              TaxNo:””,                     //税号

              Success: ””,              //调用API是否成功:true/false

              Code: ””,                     //返回码(见附表一)

              Message: ””,              //返回码对应信息(见附表一)

              InvoiceCode:"",       //发票代码

              InvoiceNumber:"",       //发票号码

              TaskNo: ””,              //任务号

              ResultCode: ””,       //处理结果 1-成功 2-无此票 3-该票异常无法认证 4-该票已经认证 5-该票已经逾期无法认证 6-该票已经申请认证 7-申请认证月份已过期 8-其它异常 11-该票已作废 12 –该发票已红冲 13-未到申报期 14-该发票税号不匹配 15-红字发票不可认证 16-认证类型错误0-任务执行中

              DeductibleDate: ””,       //认证日期 如果已认证则为YYYY-MM-DD,未认证则为空

              DeductiblePeriod: ””,//税款所属期 如果已认证则为YYYYMM,未认证则为空

              CertificationType:"" //认证类型 1为抵扣,2为出口退税,3为代理出口退    

       },

    "request_id": "b560f311-4e29-48b9-9bc1-f378bca02516",

    "message": {

        "success_message": "调用[获取抵扣结果]接口成功!"

    }, 

       "success": true

}

          

失败:

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --请求ID,用于定位问题

"message": {

        "error_code": "",      --失败的CODE

        "error_message": ""   --失败提示语

    }, 

"success": false  --失败标志

}

出参说明

参数

类型

长度

描述

TaxNo

String

20

购方税号

Success

Boolean

5

调用API是否成功(ture/false)

Code

String

4

返回码

Message

String

200

返回信息

InvoiceCode

String

10-12

发票代码

InvoiceNumber

String

8

发票号码

TaskNo

String

32

任务编号

ResultCode        

String

2

处理结果:1-成功2-无此票3-该票异常无法认证4-该票已经认证5-该票已经逾期无法认证6-该票已经申请认证7-申请认证月份已过期8-其它异常9-发票未到期(需切换税期)11-该票已作废12–该发票已红冲13-未到申报期14-该发票税号不匹配15-红字发票不可认证16-认证类型错误0-任务执行中

DeductibleDate

String

32

认证日期:如果已认证则为YYYYMM,未认证则为空

DeductiblePeriod

String

32

税款所属期:如果已认证则为YYYYMM,未认证则为空

CertificationType

String

2

认证类型:1为抵扣,2为出口退税,3为代理出口退

          

          

(六)发票查验  

请求地址

                 /collect?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法类型

HTTPS POST

ContentType

application/json; charset=utf-8

入参

JSON属性见入参

出参

JSON属性见出参

          

入参说明

参数

类型

长度

必填

描述

taxNo

String

20

购方税号

InvoiceCode        

String

10-12

发票代码

InvoiceNumber

String

8

发票号码

BillingDate

String

10

开票日期

CheckCode_6

String

6

校验码后6位(普票、电子普票、卷式普票必填)

TotalAmount

String

20

合计不含税金额,必须精确到两位小数(专票、货运专票、机动车专票必填)

          

JSON入参说明:

{

“TaxNo”:””,                     //税号

“InvoiceCode”:””,           //发票代码

“InvoiceNumber”:””,       //发票号码

“BillingDate”:””,              //开票日期:YYYY-MM-DD

“CheckCode_6”:””,           //校验码后6位(普票、电子普票、卷式普票必填)

“TotalAmount”:””           //合计金额,必须精确到两位小数(专票、货运专票、机动车专票必填)

}

          

          

          

JSON出参说明:

成功:

{

    "model": 

       //1、增值税专用发票    

       {

              InvoiceType:"01",              //增值税专用发票             

              Data:                           

              {                           

                     AdministrativeDivisionNo:””,//所属行政区编码

                     AdministrativeDivisionName:””,//所属行政区名称

                     InvoiceCode:"",              //发票代码      

                     InvoiceNumber:"",              //发票号码      

                     BillingDate:"",               //开票日期:YYYY-MM-DD      

                     PurchaserName:"",              //购方名称      

                     PurchaserTaxNo:"",              //购方税号      

                     PurchaserBank:"",              //购方开户行账户      

                     PurchaserAddressPhone:"",//购方地址电话      

                     SalesName:"",                     //销方名称      

                     SalesTaxNo:"",                     //销方税号      

                     SalesAddressPhone:"",       //销方地址电话      

                     SalesBank:"",                     //销方开户行账户      

                     TotalAmount:"",              //合计金额      

                     TotalTax:"",                     //合计税额      

                     AmountTax:"",                     //价税合计      

                     AmountTaxCN:"",              //价税合计_中文      

                     Remarks:"",                     //备注      

                     MachineCode:"",              //机器编码      

                     CheckCode:"",                     //校验码          

                     State:"",                            //发票状态(1:正常;2:作废;)      

                     InvoiceList:[                     //发票详细信息列表      

                            {             

                            RowNo:"",                            //行号(从1开始)

                            CommodityCode:"",              //商品编码

                            CommodityName:"",              //货物或应税劳务名称

                            SpecificationModel:"",              //规格型号

                            Unit:"",                                   //单位

                            Quantity:"",                            //数量

                            UnitPrice:"",                            //单价

                            Amount:"",                            //金额

                            TaxRate:"",                            //税率

                            Tax:""                                   //税额

                            },             

                     ]                    

              },                           

              Success:"",              //调用API是否成功:true/false             

              Code:"",              //返回码(见附表一)             

              Message:""              //返回码对应信息(见附表一)             

       }      

          

       //2、货运运输业增值税专用发票      

       {                                  

              InvoiceType:"02",              //货运运输业增值税专用发票             

              Data:                           

              {                           

                     AdministrativeDivisionNo:””,//所属行政区编码    

                     AdministrativeDivisionName:””,//所属行政区名称

                     InvoiceCode:"",              //发票代码      

                     InvoiceNumber:"",              //发票号码      

                     BillingDate:"",               //开票日期:YYYY-MM-DD      

                     CarrierName:"",               //承运人名称      

                     CarrierTaxNo:"",               //承运人识别号      

                     DraweeName:"",              //受票方名称      

                     DraweeTaxNo:"",               //受票方识别号      

                     PurchaserName:"",              //收货人名称      

                     PurchaserTaxNo:"",              //收货人识别号       

                     SalesName:"",                     //发货人名称      

                     SalesTaxNo:"",                     //发货人识别号      

                     TotalAmount:"",              //合计金额      

                     CargoInformation:"",       //运输货物信息      

                     TransportRoute:"",              //起运地、经由、到达地      

                     TaxRate:"",                     //税率      

                     TotalTax:"",                     //合计税额      

                     MachineCode:"",              //税控盘号      

                     AmountTax:"",                     //价税合计      

                     AmountTaxCN:"",              //价税合计_中文

                     AutomobileType:"",       //车种车号      

                     Tonnage:"",                     //车船吨位          

                     TaxAuthorityNo:"",              //主管税务机关      

                     TaxAuthorityName:"",       //主管税务名称      

                     Remarks:"",                     //备注      

                     State:"",                            //发票状态(1:正常;2:作废;)      

                     InvoiceList:[                    

                            {             

                            RowNo:"",                     //行号(从1开始)\

                            CommodityCode:"",              //商品编码

                            CommodityName:"",       //费用项目

                            Amount:""                     //金额

                            },             

                     ]                    

              },                           

              Success:"",              //调用API是否成功:true/false             

              Code:"",                     //返回码(见附表一)             

              Message:""              //返回码对应信息(见附表一)             

       }                                  

          

       //3、机动车销售统一发票

       {                           

              InvoiceType:"03",              //机动车销售统一发票      

              Data:                    

              {                    

                     AdministrativeDivisionNo:””,//所属行政区编码

                     AdministrativeDivisionName:””,//所属行政区名称

                     InvoiceCode:"",              //发票代码

                     InvoiceNumber:"",              //发票号码    

                     BillingDate:"",               //开票日期:YYYY-MM-DD

                     MachineCode:"",              //机器编码

                     PurchaserName:"",              //购方名称

                     IDCardNo:"",                     //身份证号码/组织机构代码

                     PurchaserTaxNo:"",              //购方税号

                     VehicleType:"",              //车辆类型

                     BrandModel:"",              //厂牌型号

                     OriginPlace:"",                     //产地

                     CertificateNo:"",              //合格证号

                     Amount:"",                     //不含税价

                     InspectionListNo:"",       //商检单号

                     EngineNo:"",                     //发动机号

                     VehicleNo:"",                     //车辆识别代号/车架号码

                     ImportCertificateNo:"",       //进口证明书号

                     SalesName:"",                     //销方名称

                     SalesPhone:"",                     //销方地址电话

                     SalesTaxNo:"",                     //销方税号

                     SalesBankNo:"",              //账号

                     SalesAddress:"",              //销方地址

                     SalesBank:"",                     //销方开户行账户

                     TaxRate:"",                     //税率

                     Tax:""                            //税额    

                     TaxAuthorityNo:"",              //主管税务机关

                     AmountTax:"",                     //价税合计

                     AmountTaxCN:"",              //价税合计_中文

                     PaymentVoucherNo:"",       //完税凭证号码

                     Tonnage:"",                     //吨位

                     PassengersLimited:"",       //限乘人数

                     State:"",                            //发票状态(1:正常;2:作废;)

                     TaxAuthorityName:"",       //主管税务名称

              },                    

              Success:"",              //调用API是否成功:true/false      

              Code:"",                     //返回码(见附表一)      

              Message:""              //返回码对应信息(见附表一)      

       }                           

          

       //4、增值税普通发票

       {                                  

              InvoiceType:"04",              //增值税普通发票             

              Data:                           

              {                           

                     AdministrativeDivisionNo:””,//所属行政区编码

                     AdministrativeDivisionName:””,//所属行政区名称

                     InvoiceCode:"",              //发票代码      

                     InvoiceNumber:"",              //发票号码      

                     BillingDate:"",               //开票日期:YYYY-MM-DD      

                     SalesName:"",                     //销方名称          

                     SalesTaxNo:"",                     //销方税号      

                     SalesAddressPhone:"",       //销方地址电话      

                     SalesBank:"",                     //销方开户行账户      

                     PurchaserName:"",              //购方名称      

                     PurchaserTaxNo:"",              //购方税号      

                     PurchaserBank:"",              //购方开户行账户      

                     PurchaserAddressPhone:"",//购方地址电话      

                     CheckCode:"",                     //校验码      

                     TotalTax:"",                     //合计税额      

                     AmountTax:"",                     //价税合计      

                     AmountTaxCN:"",              //价税合计_中文

                     Remarks:"",                     //备注      

                     MachineCode:"",              //机器编码      

                     TotalAmount:"",              //合计金额      

                     State:"",                            //作废标志(1:正常;2:作废;)      

                     InvoiceList:[                     //发票详细信息列表      

                            {             

                            RowNo:"",                            //行号(从1开始)

                            CommodityCode:"",              //商品编码

                            CommodityName:"",              //货物或应税劳务名称

                            SpecificationModel:"",              //规格型号

                            Unit:"",                                   //单位

                            Quantity:"",                            //数量    

                            UnitPrice:"",                            //单价

                            Amount:"",                            //金额

                            TaxRate:"",                            //税率

                            Tax:""                                   //税额

                            },             

                     ]                    

              },                           

              Success:"",              //调用API是否成功:true/false             

              Code:"",                     //返回码(见附表一)             

              Message:""              //返回码对应信息(见附表一)

       }                                         

          

       //5、增值税电子普通发票

       {                                  

              InvoiceType:"10",              //增值税电子普通发票             

              Data:                           

              {                           

                     AdministrativeDivisionNo:””,//所属行政区编码

                     AdministrativeDivisionName:””,//所属行政区名称

                     InvoiceCode:"",              //发票代码      

                     InvoiceNumber:"",              //发票号码      

                     BillingDate:"",               //开票日期:YYYY-MM-DD      

                     SalesName:"",                     //销方名称      

                     SalesTaxNo:"",                     //销方税号      

                     SalesAddressPhone:"",       //销方地址电话      

                     SalesBank:"",                     //销方开户行账户          

                     PurchaserName:"",              //购方名称      

                     PurchaserTaxNo:"",              //购方税号      

                     PurchaserBank:"",              //购方开户行账户      

                     PurchaserAddressPhone:"",//购方地址电话      

                     CheckCode:"",                     //校验码      

                     TotalTax:"",                     //合计税额      

                     AmountTax:"",                     //价税合计      

                     AmountTaxCN:"",              //价税合计_中文

                     Remarks:"",                     //备注      

                     MachineCode:"",              //机器编码      

                     TotalAmount:"",              //合计金额      

                     State:"",                            //发票状态(1:正常;2:作废;)      

                     InvoiceList:[                     //发票详细信息列表      

                            {             

                            RowNo:"",                            //行号(从1开始)

                            CommodityCode:"",              //商品编码

                            CommodityName:"",              //货物或应税劳务名称

                            SpecificationModel:"",              //规格型号

                            Unit:"",                                   //单位

                            Quantity:"",                            //数量

                            UnitPrice:"",                            //单价

                            Amount:"",                            //金额

                            TaxRate:"",                            //税率    

                            Tax:""                                   //税额

                            },             

                     ]                    

              },                           

              Success:"",              //调用API是否成功:true/false             

              Code:"",                     //返回码(见附表一)             

              Message:""              //返回码对应信息(见附表一)             

       }                                  

          

       //6、增值税普通发票(卷式)

       {                                  

              InvoiceType:"11",              //增值税普通发票(卷式)             

              Data:                           

              {                           

                     AdministrativeDivisionNo:””,//所属行政区编码

                     AdministrativeDivisionName:””,//所属行政区名称

                     InvoiceCode:"",              //发票代码      

                     InvoiceNumber:"",              //发票号码      

                     BillingDate:"",               //开票日期:YYYY-MM-DD      

                     SalesName:"",                     //销方名称      

                     SalesTaxNo:"",                     //销方税号      

                     PurchaserName:"",              //购方名称      

                     PurchaserTaxNo:"",              //购方税号      

                     CheckCode:"",                     //校验码      

                     TotalTax:"",                     //合计税额      

                     AmountTax:"",                     //价税合计          

                     AmountTaxCN:"",              //价税合计_中文

                     Remarks:"",                     //备注      

                     MachineCode:"",              //机器编码      

                     TotalAmount:"",              //合计金额      

                     TotalAmountCN:"",              //合计金额_中文

                     ReceivingClerk:"",              //收货员      

                     State:"",                            //发票状态(1:正常;2:作废;)      

                     InvoiceList:[                     //发票详细信息列表      

                            {             

                            RowNo:"",              //行号(从1开始)

                            CommodityCode:"",              //商品编码

                            CommodityName:"",//项目

                            Quantity:"",              //数量

                            UnitPrice:"",              //含税单价

                            Amount:""              //含税金额

                            },             

                     ]                    

              },                           

              Success:"",              //调用API是否成功:true/false             

              Code:"",                     //返回码(见附表一)             

              Message:""              //返回码对应信息(见附表一)             

       }      

          

    }, 

    "request_id": "b560f311-4e29-48b9-9bc1-f378bca02516",

    "message": {

        "success_message": "调用[全票面]接口成功!"    

    }, 

"success": true

}

失败:

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --请求ID,用于定位问题

"message": {

        "error_code": "",      --失败的CODE

        "error_message": ""   --失败提示语

    }, 

"success": false  --失败标志

}

          

          

//7、增值税电子普通发票(通行费)

{

InvoiceType:"14",//增值税电子普通发票(通行费)

Data:

{

AdministrativeDivisionNo:"",//所属行政区编码

AdministrativeDivisionName:"",//所属行政区名称

InvoiceCode:"",//发票代码

InvoiceNumber:"",//发票号码

BillingDate:"", //开票日期:YYYY-MM-DD

SalesName:"", //销方名称

SalesTaxNo:"", //销方税号

SalesAddressPhone:"", //销方地址电话

SalesBank:"", //销方开户行账户    

PurchaserName:"",//购方名称

PurchaserTaxNo:"",//购方税号

PurchaserBank:"",//购方开户行账户

PurchaserAddressPhone:"",//购方地址电话

CheckCode:"", //校验码

TotalTax:"", //合计税额

AmountTax:"", //价税合计

AmountTaxCN:"",//价税合计_中文

Remarks:"", //备注

MachineCode:"",//机器编码

TotalAmount:"",//合计金额

State:"", //发票状态(1:正常;2:作废;)

TollSign: "06"//通行费标志(06-可抵扣通行费,07-不可抵扣通行费)

InvoiceList:[ //发票详细信息列表

{

RowNo:"",//行号(从1开始)

CommodityCode:"",//商品编码

CommodityName:"",//货物或应税劳务名称

Amount: 7.61, //金额

TaxRate:"",//税率

Tax:""//税额

CurrentDateEnd: "20171211", //通行日起止

CurrentDateStart: "20171211", //通行日期起    

LicensePlateNum: "粤ATST10", //车牌号

Type: "货车"//类型

},

]

},

Success:"",//调用API是否成功:true/false

Code:"", //返回码(见附表一)

Message:""//返回码对应信息(见附表一)

}

出参说明:

参数

类型

长度

描述

InvoiceType

String

3

发票类型

AdministrativeDivisionNo

String

32

所属行政区编码

AdministrativeDivisionName

String

150

所属行政区名称

InvoiceCode

String

10-12

发票代码

InvoiceNumber

String

8

发票号码

BillingDate

String

14

开票日期:YYYY-MM-DD

PurchaserName

String        

100

购方名称

PurchaserTaxNo

String

20

购方税号

PurchaserBank

String

150

购方开户行账户

PurchaserAddressPhone

String

150

购方地址电话

SalesName

String

100

销方名称

SalesTaxNo

String

20

销方税号

SalesAddressPhone

String

150

销方地址电话

SalesBank

String

150

销方开户行账户

TotalAmount

String

17

合计金额

TotalTax

String

17

合计税额

AmountTax

String

17

价税合计

AmountTaxCN

String        

64

价税合计_中文

MachineCode

String

32

机器编码

CheckCode

String

64

校验码

State

String

2

发票状态:是否作废(1:正常;2:作废;)

InvoiceList

String

-

发票详细信息列表

RowNo

String

10

行号:从1开始

CommodityCode

String

40

商品编码

CommodityName

String

150

货物或应税劳务名称

SpecificationModel

String

32

规格型号

Unit

String

32

单位

Quantity

String

10

数量

UnitPrice

String        

17

单价

Amount

String

17

金额

TaxRate

String

10

税率

Tax

String

17

税额

CarrierName

String

150

承运人名称

CarrierTaxNo

String

32

承运人识别号

DraweeName

String

100

受票方名称

DraweeTaxNo

String

20

受票方识别号

CargoInformation

String

150

运输货物信息

TransportRoute

String

100

起运地、经由、到达地

MachineCode

String

32

税控盘号

AutomobileType

String        

64

车种车号

Tonnage

String

10

车船吨位

TaxAuthorityNo

String

32

主管税务机关

TaxAuthorityName

String

100

主管税务名称

Remarks

String

184

备注

IDCardNo

String

32

身份证号码/组织机构代码

PurchaserTaxNo

String

20

购方税号

VehicleType

String

32

车辆类型

BrandModel

String

32

厂牌型号

OriginPlace

String

100

产地

CertificateNo

String

32

合格证号

InspectionListNo

String        

64

商检单号

EngineNo

String

32

发动机号

VehicleNo

String

32

车辆识别代号/车架号码

ImportCertificateNo

String

64

进口证明书号

SalesPhone

String

150

销方地址电话

SalesTaxNo

String

20

销方税号

SalesBankNo

String

64

账号

SalesAddress

String

150

销方地址

PaymentVoucherNo

String

32

完税凭证号码

PassengersLimited

String

10

限乘人数

TollSign

String

2

通行费标志(06-可抵扣通行费,07-不可抵扣通行费)

ZeroTaxRateSign        

String

2

零税率标志(空:非零税率, 1:税率栏位显示“免税”, 2:税率栏位显示“不征收”, 3:零税率)

CurrentDateEnd

String

20

通行日起止

CurrentDateStart

String

20

通行日期起

LicensePlateNum

String

20

车牌号

Type

String

10

类型

          

          

(七)发票信息查询  

说明:

通过接口查询发票的相关内容。

请求地址

                 /findInvoice?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法类型

HTTPS POST

ContentType

application/json; charset=utf-8

入参

JSON

出参

JSON

              

入参说明:

参数

类型

长度

必填

描述

TaxNo

String

20

购方税号

InvoiceCode

String

10-12

发票代码

InvoiceNumber

String

8

发票号码

          

          

JSON入参说明:(JSON串)

{

       “TaxNo”:””,                         //税号

    “InvoiceCode”:"",                 //发票代码

       “InvoiceNumber”:""              //发票号码

}

          

JSON出参说明:

成功:

{

    "model": {

        TaskNo:””,                     //任务编号

Success:””,                     //调用API是否成功:true/false

Code:“”,                            //返回码(见附表一)

Message:””,                     //返回码对应信息(见附表一)

           InvoiceCode:"",       //发票代码

        InvoiceNumber:"",       //发票号码

   InvoiceType:””,              //发票种类01-增值税专用发票 02-货运运输业增值税专用发票 03-机动车销售统一发票 14-通行费增值税电子普通发票    

         BillingDate:" ",        //开票日期:YYYY-MM-DD

         State:"1",                     //发票状态(0-正常1-失控 2-作废 3-红冲 4-异常)

         PurchaserTaxNo:"",       //购方税号

         TotalAmount:””,       //合计金额

         TotalTax:””,              //合计税额

         SalesTaxNo:"",              //销方税号

         SalesTaxName:"",       //销方名称

         Deductible:””,              //是否认证 0-未认证 1-已认证

         DeductibleDate:””,       //认证日期 如果已认证则为YYYY-MM-DD,未认证则为空

         DeductiblePeriod:””,//税款所属期 如果已认证则为YYYYMM,未认证则为空

},

},

    "request_id": "",

    "message": {

        "success_message": "调用[发票信息查询]接口成功!"

    }, 

"success": true

}

          

失败:

{

"request_id": "", --请求ID,用于定位问题

"message": {

        "error_code": "",      --失败的CODE    

        "error_message": ""   --失败提示语

    }, 

"success": false  --失败标志

}

          

出参说明:

参数

类型

长度

描述

TaskNo

String

32

任务编号

Success

Boolean

5

是否成功:True/false

Code

String

4

返回码

Message

String

200

返回信息

InvoiceCode

String

10-12

发票代码:返回多个发票信息及任务号

InvoiceNumber

String

8

发票号码

InvoiceType

String

2

发票种类:01-增值税专用发票02-货运运输业增值税专用发票03-机动车销售统一发票

BillingDate

String

10

开票日期:YYYY-MM-DD

State

String

1

发票状态:0-正常1-失控2-作废3-红冲4-异常

PurchaserTaxNo

String

20

购方税号

TotalAmount

String

17

合计金额

TotalTax

String

17

合计税额

SalesTaxNo        

String

20

销方税号

SalesTaxName

String

150

销方名称

Deductible

String

0

是否认证:0-未认证1-已认证

DeductibleDate

String

10

认证日期:如果已认证则为YYYY-MM-DD,未认证则为空

DeductiblePeriod

String

10

税款所属期:如果已认证则为YYYYMM,未认证则为空

IsAgencyRebate

String

10

是否代办退税:0:是,1:否

CertificationType

String

10

认证类型:1为抵扣,2为出口退税,3为代理出口退税

CertificationWay

String

2

认证方式:0为勾选认证,1为扫描认证

checkstatus

String

2

查验结果 1未查验 2查验中 3查无此票 4已验真

downloadUrl

String

200

发票图像存储地址

          

(八)获取当前系统时间  

说明:

获取当前系统时间,便于时间戳的校验

请求地址

                 /getTime?AccessKeyID=userid&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法类型

HTTPS GET

ContentType

application/json; charset=utf-8

入参        

JSON

出参

JSON

          

特殊说明:此处Signature生成不包括TimeStamp的值。

          

JSON入参说明:(JSON串)

          

          

JSON出参:

          

成功:

{

"model": {

       SystemTime:””,                     //当前系统时间"yyyy-MM-dd'T'HH:mm:ss'Z'"

 SystemTimeLong:””,              //当前系统时间CurrentTimeMills

              Success:””,                 //调用API是否成功:true/false

              Code:"",                     //返回码(见附表一)

              Message:””              //返回码对应信息(见附表一)

    }, 

    "request_id": "b560f311-4e29-48b9-9bc1-f378bca02516",

    "message": {

        "success_message": "调用[获取系统时间]成功!"

    }, 

       "success": true

}

          

失败:

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --请求ID,用于定位问题    

"message": {

        "error_code": "",      --失败的CODE

        "error_message": ""   --失败提示语

    }, 

"success": false  --失败标志

}

          

出参说明

参数

类型

长度

描述

SystemTime

String

32

当前系统时间"yyyy-MM-dd'T'HH:mm:ss'Z'"

SystemTimeLong

String

32

当前系统时间CurrentTimeMills

Success

Boolean

5

True/false

Code

String

4


Message

String

200


          

五、定制接口列表  

(一)单据关联发票  

说明:

嵌入SAP流程,通过参数获取发票列表

请求地址

                 /select?AccessKeyID=userid&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973&参数列表

方法类型        

HTTPS GET

出参

XML

          

特殊说明:此处Signature生成不包括TimeStamp的值。

          

入参说明:URL

PurchaserName:"",              //购方名称,不能为空

       PurchaserTaxNo:"",              //购方税号,可以为空

InvoiceNumberRang:””       //发票号码,不能为空,只能是数字或-/,

//多个号码段以 / 分隔,最多4个/,例如:

//12345601-09/12345620/12345631-12345640

//解析时先以/分隔,在按下面逻辑解析

//如果有”-”,则自动解析发票号码范围

//36230244-50,则-后面的号码,自动填充到第一个号码的长度

//解析为:36230244到36230250的范围

//如果没有-,则完全匹配发票号码

BillingDateStart:””              //格式:yyyy-MM-dd

BillingDateEnd:””              //格式:yyyy-MM-dd

          

XML出参:

          

成功:

         

<request_id>b560f311-4e29-48b9-9bc1-f378bca02516request_id>

         true    

         

<success_message>调用成功!success_message>

         

                       //调用API是否成功:true/false

                     //返回码(见附表一)

<Success>true       //返回码对应信息(见附表一)

         

                                     //发票信息,参考取数结果里的发票信息

         

.....

          

失败:         

         

<request_id>b560f311-4e29-48b9-9bc1-f378bca02516request_id>

         false             

<error_code>error_code>

<error_message>error_message>

          

(二)单据反馈接口

(一)附表一:错误信息表  

返回码(CODE)

返回码对应信息Message

0

执行成功

-1

未知错误

001

签名结果错误

002

版本号不正确

003

时间差异超出范围

004

SignatureNonce值已被使用过

005

请求参数不正确

006

IP不在授权范围内

101

身份验证失败

102

未开通该接口

103

授权已过期

104

不能操作该税号

105        

不能操作该发票

206

此税号下没有税期信息

207

传入的税款所属期与系统税款所属期不一致

231

获取发票全票面,查验成功,信息不完整

232

获取发票全票面,查验成功,信息有误

233

获取发票全票面,查验成功,不属于当前公司

234

重复插入凭证号

402

超过该张票当天查验次数

404

超过服务器最大请求数

405

请求不合法

406

查验成功发票不一致

409

所查发票不存在

415

查询发票不规范

416

查验异常

498

不支持查询该地区的发票

499

不支持该发票种类

701

TaskNo不存在

702

TaskNo与InvoiceCode、InvoiceNumber不匹配

703

TaxNo不存在

704

请求json入参为空

              

(二)附表二:发票种类  

对应信息

01

增值税专用发票

02

货运运输业增值税专用发票

03

机动车增值税专用发票

04

增值税普通发票

10

增值税电子普通发票

11

增值税普通发票(卷式)

14

增值税电子普通发票(通行费)

          

          

          

文档修改记录:

          

版本号

修改后版本号

修改时间

修改人

修改内容

V1.0.0

V1.0.1

2018-01-19

周晓明

1、增加了查询企业信息的接口

2、接口入参增加了版本号

V1.0.1

V1.0.2

2018-02-26

周晓明

增加了增值税电子普通发票(通行费)的支持

V1.0.2

V1.0.3

2018-03-19

周晓明

1、增加了发票查询、获取系统时间接口。

2、将版本号放在公共参数中。

V1.0.3        

V1.0.4

2018-05-10

单长海

增加定制接口


该文章在 2025/4/30 16:18:40 编辑过
关键字查询
相关文章
正在查询...
点晴ERP是一款针对中小制造业的专业生产管理软件系统,系统成熟度和易用性得到了国内大量中小企业的青睐。
点晴PMS码头管理系统主要针对港口码头集装箱与散货日常运作、调度、堆场、车队、财务费用、相关报表等业务管理,结合码头的业务特点,围绕调度、堆场作业而开发的。集技术的先进性、管理的有效性于一体,是物流码头及其他港口类企业的高效ERP管理信息系统。
点晴WMS仓储管理系统提供了货物产品管理,销售管理,采购管理,仓储管理,仓库管理,保质期管理,货位管理,库位管理,生产管理,WMS管理系统,标签打印,条形码,二维码管理,批号管理软件。
点晴免费OA是一款软件和通用服务都免费,不限功能、不限时间、不限用户的免费OA协同办公管理系统。
Copyright 2010-2025 ClickSun All Rights Reserved