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

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

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

​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

      单长海

      增加定制接口



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