关于升级数电发票接口对接指导

YonJiao

1、首先查看开蓝票接口文档。字段说明中有【数电专用】、【数电特殊票种】备注说明
      
2、全电发票类型：枚举值。接口【FPLX】字段传31、32、33、34即为开数电发票

3、【ALLELCUSERNAME】、【ALLELCPASSWORD】字段为数电发票用户名、密码。非必填,如果要实现通过用户名密码自动登录开票，则必填。仅支持登录不需要验证码的地区，通过下载下方附件获取国密4加密工具类、以及验证工具

4、数电登录方式：

     注意：一、账号密码登录方式：可直接接口传入国密4加密的数电账号密码，后台会先根据税号及账号读取税务云缓存判断是否有账号，如没有会用接口传入的账号密码直接登录，登录成功则开票，否则直接提示登录失败。不传时读取【税务基础档案】配置的默认账号，一个税号下只有一个默认账号，如果在线则开票，不在线则用默认账号的账号密码进行登录，成功则开票，否则会保存到开票管理中但是开票失败。 支持地区：广东、天津、浙江、湖北
              二、短信验证码登录方式：接口不能传入数电账号密码，只读取税务基础档案配置的默认账号，如果在线则开票，不在线则会保存到开票管理中但是开票失败。支持地区：除广东、天津、浙江、湖北以外的其他地区
              三、软证书方式：
1100  北京、  1200  天津 、 1400  山西  、1500  内蒙古  、2300  黑龙江、3300  浙江  、3400  安徽、3500  福建、3600  江西、3700  山东、3702  青          岛、4100  河南、4200  湖北、4400  广东、4500  广西、4600  海南、5000  重庆、5100  四川、5200  贵州、6100  陕西、6300  青海、6400  宁夏

     维护位置如下图（详细配置教程咨询项目实施）：

     

5、税务云3.0不支持数电发票，只有YonBIP和YonSuite才支持数电发票，所以优先推荐使用开放平台的对接方式集成，示例代码地址：开放平台对接示例 ，开放平台对接方式没有专门的测试环境，需要单独购买商开环境。
      
     但是由于历史原因，老版本的对接方式(证书+签名的方式)也兼容开具数电票，也支持集成YonBIP和YonSuite，但是并不推荐。税务云老的对接方式示例代码地址：税务云3.0接口示例，可以用yesfp的测试环境测试不需要传用户名和密码也能进行测试全电开票，前提是必须使用测试环境专用的税号、组织编码。销售方纳税人识别号：201609140000001，组织编码ORGCODE：20160914001
      
                  
6、 a、数电全部红冲使用【发票红冲请求】接口，红字信息表编号非必填，除非已经手工在税务云系统申请了红字确认单号，才需要传红字信息表编号。
      入参requetsdatas示例：

1. [
   
2.     {
   
3.         "fpHm": "41718199",//原蓝票号码
   
4.         "fpDm": "202408173942",//原蓝票代码
   
5.         "FPQQLSH": "45346456",
   
6. "FPLX":"32",//传红票的发票类型，专票对应数电专票，普票对应数电普票
   
7.         "HCYY" :"1",//红冲原因必填
   
8. "ORGCODE":"5346645234"
   
9. 
   
10.     }
    
11. ]

复制代码

       b、数电部分红冲使用【发票部分红冲】接口，红字信息表编号非必填，除非已经手工在税务云系统申请了红字确认单号，才需要传红字信息表编号。
            注意事项：a、原蓝票发票代码没有时，传空字符传，示例：fpDm:""
                             b、FPLX字段要传红票的发票类型（此字段文档暂时没写）
                             c、金额和数量都是负数，只有单价、税率是正数。
                             d、且要保证与原蓝票行号一致，明细信息只能修改数量和金额，且不能超过原蓝票金额，数量

7、下载下方word文件，获取更多数电发票特殊票种传参示例





      

BIP749599

目前仅支持部分地区，不需要验证码的情况通过接口可以自动开票，需要验证码的地区通过接口只能提开票申请，这个哪些地区是支持自动开票的？

YonJiao

BIP749599 · 2023-8-7 18:11目前仅支持部分地区，不需要验证码的情况通过接口可以自动开票，需要验证码的地区通过接口只能提开票申请，这个哪些地区是支持自动开票的？

这属于业务问题，咨询项目实施人员吧

BIP749599

YonJiao · 2023-8-9 11:24这属于业务问题，咨询项目实施人员吧

红字信息表编号（hzxxbbh）这个在查询时怎没有看到这个字段命名

YonJiao

BIP749599 · 2023-9-12 17:08红字信息表编号（hzxxbbh）这个在查询时怎没有看到这个字段命名

BIP578701

您好，票据带上数电username password报  {"code":"9999","msg":"数据不合法!"}  如果不带username password 则不会报错
请求地址：https://yesfp.yonyoucloud.com/ou ... ppid=commontesterCA
销售方纳税人识别号： 201609140000001


加密后用户名：9ef4e2baf176d89178652b61c403cd20
加密后密码：acdc63b63a7a35ac57cc761d3507dd7a


解密后username：aaaa
解密后password：123

请问是否存在问题？ 麻烦帮忙看下 谢谢~

YonJiao

BIP578701 · 2024-1-22 10:57您好，票据带上数电username password报  {"code":"9999","msg":"数据不合法!"}  如果不带username password 则不会报错
请求地址：https://yesfp.yonyoucloud.com/output-tax/api/invoiceApply/insertWithSplit?a ...

1. [{
   
2.         "XSF_NSRSBH": "201609140000001",
   
3.         "GMF_NSRSBH": "111222333456111",
   
4.         "FPQQLSH": "453647567345345",
   
5.         "GMF_DH": "购买方电话(数电专用字段)",
   
6.         "XSF_DH": "销售方电话(数电专用字段)",
   
7.         "GMF_YH": "购买方银行(数电专用字段)",
   
8.         "JSHJ": 100,
   
9.         "GMF_ZH": "购买方账号(数电专用字段)",
   
10.         "ALLELCPASSWORD": "3390df84d7627888921a62e3443d5073",
    
11.         "LYID": "123456",
    
12.         "ALLELCUSERNAME": "a254a1c7572bc2b5182c308ac2a6ba86",
    
13.         "ORGCODE": "20160914001",
    
14.         "GMF_MC": "接口测试组织-请勿修改",
    
15.         "GMF_DZ": "购买方地址(数电专用字段)",
    
16.         "XSF_DZ": "销售方地址(数电专用字段)",
    
17.         "FPLX": "32",
    
18.         "BZ": "如数电发票票面需要显示购方、销方的银行账号、地址电话。目前只能放到备注字段中，不超过400个字符。后期规划会在税务云系统增加配置参数【是否将此信息放到票面备注中】，勾选了就会自动将银行账号，地址电话显示到票面的备注中",
    
19.         "items": [{
    
20.                 "GGXH": "25kg/桶",
    
21.                 "XMMC": "POLO衫",
    
22.                 "DW": "千克",
    
23.                 "YHZCBS": 1,
    
24.                 "XMSL": 2,
    
25.                 "XMBM": "202020012",
    
26.                 "SL": 0.0,
    
27.                 "ZZSTSGL": "%E6%8C%893%25%E7%AE%80%E6%98%93%E5%BE%81%E6%94%B6",
    
28.                 "XMJSHJ": 100,
    
29.                 "SPBM": "1090625010000000000"
    
30.         }],
    
31.         "XSF_YH": "销售方银行(数电专用字段)",
    
32.         "XSF_ZH": "销售方账号(数电专用字段)"
    
33. }]

复制代码

我刚试了，报数据不合法不是你说的这个原因，你把参数贴出来，我看下吧。测试环境使用专用税号，不需要传用户名密码也能模拟开数电票

BIP578701

YonJiao · 2024-1-22 11:09我刚试了，报数据不合法不是你说的这个原因，你把参数贴出来，我看下吧。测试环境使用专用税号，不需要传用户名密码也能模拟开数电票

请求参数： {"autoAudit":true,"requestdatas":"[{\"ALLELCPASSWORD\":\"acdc63b63a7a35ac57cc761d3507dd7a\",\"ALLELCUSERNAME\":\"baf176d89178652b61c403cd20\",\"BDCDZ\":null,\"BMB_BBH\":null,\"BZ\":\"12341\",\"FHR\":\"复核人33\",\"FPLX\":\"32\",\"FPQQLSH\":\"WN316404626146013186\",\"GMF_DH\":\"13346346332\",\"GMF_DZ\":\"里斯的地址\",\"GMF_DZDH\":\"里斯的地址13346346332\",\"GMF_MC\":\"测试纳税人\",\"GMF_NSRSBH\":\"201609140000001\",\"GMF_YH\":\"银行卡1\",\"GMF_YHZH\":\"银行卡1232323123123\",\"GMF_ZH\":\"232323123123\",\"HJJE\":null,\"HJSE\":null,\"JSHJ\":1999999.90,\"KDSBZ\":null,\"KPR\":\"账务人\",\"LYID\":null,\"ORGCODE\":null,\"PROJECTCODE\":null,\"SGBZ\":null,\"SKR\":\"那个男人\",\"SLSM\":null,\"TDZZSXMBH\":null,\"TSPZ\":null,\"WXAPPID\":null,\"WXAUTHID\":null,\"WXORDERID\":null,\"XSF_DH\":\"1332232323\",\"XSF_DZ\":\"地址3\",\"XSF_DZDH\":\"地址31332232323\",\"XSF_MC\":\"测试纳税人001\",\"XSF_NSRSBH\":\"201609140000001\",\"XSF_YH\":\"开户行啊啊啊\",\"XSF_YHZH\":\"开户行啊啊啊23123\",\"XSF_ZH\":\"23123\",\"ZDYBZ\":null,\"ZLQQ\":null,\"ZLQZ\":null,\"ZSFS\":null,\"einvoiceApplyTspzs\":null,\"fpDm\":null,\"fpHm\":null,\"items\":[{\"DW\":null,\"FPHXZ\":null,\"GGXH\":null,\"HH\":null,\"KCE\":null,\"LSLBS\":\"\",\"SE\":null,\"SL\":0.130000,\"SPBM\":\"1070223020000000000\",\"XMBM\":\"00000124\",\"XMDJ\":null,\"XMJE\":null,\"XMJSHJ\":1999990.00,\"XMMC\":\"欧舒丹 甜蜜樱花润肤露250Ml(250ml)\",\"XMSL\":\"\",\"YHZCBS\":0,\"YSXMMC\":null,\"ZKHHH\":null,\"ZXBM\":\"00000124\",\"ZZSTSGL\":\"\"},{\"DW\":null,\"FPHXZ\":null,\"GGXH\":null,\"HH\":null,\"KCE\":null,\"LSLBS\":\"\",\"SE\":null,\"SL\":0.130000,\"SPBM\":\"1070223020000000000\",\"XMBM\":\"00000122\",\"XMDJ\":null,\"XMJE\":null,\"XMJSHJ\":9.90,\"XMMC\":\"【个护甄选】雅诗兰黛 特润修护肌透小棕瓶精华液（第七代）50ML\",\"XMSL\":\"\",\"YHZCBS\":0,\"YSXMMC\":null,\"ZKHHH\":null,\"ZXBM\":\"00000122\",\"ZZSTSGL\":\"\"}]},{\"ALLELCPASSWORD\":\"acdc63b63a7a35ac57cc761d3507dd7a\",\"ALLELCUSERNAME\":\"baf176d89178652b61c403cd20\",\"BDCDZ\":null,\"BMB_BBH\":null,\"BZ\":\"\",\"FHR\":\"复核人33\",\"FPLX\":\"1\",\"FPQQLSH\":\"WN316404626150207497\",\"GMF_DH\":\"13346346332\",\"GMF_DZ\":\"里斯的地址\",\"GMF_DZDH\":\"里斯的地址13346346332\",\"GMF_MC\":\"测试纳税人003\",\"GMF_NSRSBH\":\"201609140000003\",\"GMF_YH\":\"银行卡1\",\"GMF_YHZH\":\"银行卡1232323123123\",\"GMF_ZH\":\"232323123123\",\"HJJE\":null,\"HJSE\":null,\"JSHJ\":9.91,\"KDSBZ\":null,\"KPR\":\"账务人\",\"LYID\":null,\"ORGCODE\":null,\"PROJECTCODE\":null,\"SGBZ\":null,\"SKR\":\"那个男人\",\"SLSM\":null,\"TDZZSXMBH\":null,\"TSPZ\":null,\"WXAPPID\":null,\"WXAUTHID\":null,\"WXORDERID\":null,\"XSF_DH\":\"1332232323\",\"XSF_DZ\":\"地址3\",\"XSF_DZDH\":\"地址31332232323\",\"XSF_MC\":\"测试纳税人\",\"XSF_NSRSBH\":\"201609140000001\",\"XSF_YH\":\"开户行啊啊啊\",\"XSF_YHZH\":\"开户行啊啊啊23123\",\"XSF_ZH\":\"23123\",\"ZDYBZ\":null,\"ZLQQ\":null,\"ZLQZ\":null,\"ZSFS\":null,\"einvoiceApplyTspzs\":null,\"fpDm\":null,\"fpHm\":null,\"items\":[{\"DW\":null,\"FPHXZ\":null,\"GGXH\":null,\"HH\":null,\"KCE\":null,\"LSLBS\":\"\",\"SE\":null,\"SL\":0.130000,\"SPBM\":\"1070223030000000000\",\"XMBM\":\"00000118\",\"XMDJ\":null,\"XMJE\":null,\"XMJSHJ\":0.01,\"XMMC\":\"滋源 无患子保湿滋养护发素(中干性)\",\"XMSL\":\"1\",\"YHZCBS\":0,\"YSXMMC\":null,\"ZKHHH\":null,\"ZXBM\":\"00000118\",\"ZZSTSGL\":\"\"},{\"DW\":null,\"FPHXZ\":null,\"GGXH\":null,\"HH\":null,\"KCE\":null,\"LSLBS\":\"\",\"SE\":null,\"SL\":0.130000,\"SPBM\":\"1070223020000000000\",\"XMBM\":\"00000122\",\"XMDJ\":null,\"XMJE\":null,\"XMJSHJ\":9.90,\"XMMC\":\"【个护甄选】雅诗兰黛 特润修护肌透小棕瓶精华液（第七代）50ML\",\"XMSL\":\"\",\"YHZCBS\":0,\"YSXMMC\":null,\"ZKHHH\":null,\"ZXBM\":\"00000122\",\"ZZSTSGL\":\"\"}]}]","sms":"[]","url":"","email":"[]"}

YonJiao

加密后用户名：9ef4e2baf176d89178652b61c403cd20
加密后密码：acdc63b63a7a35ac57cc761d3507dd7a

你的入参用户名和正常加密出来的不一样呀。

BIP578701

YonJiao · 2024-1-22 13:44加密后用户名：9ef4e2baf176d89178652b61c403cd20
加密后密码：acdc63b63a7a35ac57cc761d3507dd7a

我采用的是上面taxcloud-openaip-demo-master  仓库中的 SM4Util .用的是ecb模式，如果您和我用的不一样麻烦发一下Sm4Util的代码

另外我将上面的用户名密码示例放入我的上送报文中 也是报数据不合法



{
        "autoAudit": true,
        "requestdatas": "[{\"ALLELCPASSWORD\":\"3390df84d7627888921a62e3443d5073\",\"ALLELCUSERNAME\":\"a254a1c7572bc2b5182c308ac2a6ba86\",\"BDCDZ\":null,\"BMB_BBH\":null,\"BZ\":\"12341\",\"FHR\":\"复核人33\",\"FPLX\":\"32\",\"FPQQLSH\":\"WN316464619883569162\",\"GMF_DH\":\"13346346332\",\"GMF_DZ\":\"里斯的地址\",\"GMF_DZDH\":\"里斯的地址13346346332\",\"GMF_MC\":\"测试纳税人\",\"GMF_NSRSBH\":\"201609140000001\",\"GMF_YH\":\"银行卡1\",\"GMF_YHZH\":\"银行卡1232323123123\",\"GMF_ZH\":\"232323123123\",\"HJJE\":null,\"HJSE\":null,\"JSHJ\":1999999.90,\"KDSBZ\":null,\"KPR\":\"账务人\",\"LYID\":null,\"ORGCODE\":null,\"PROJECTCODE\":null,\"SGBZ\":null,\"SKR\":\"那个男人\",\"SLSM\":null,\"TDZZSXMBH\":null,\"TSPZ\":null,\"WXAPPID\":null,\"WXAUTHID\":null,\"WXORDERID\":null,\"XSF_DH\":\"1332232323\",\"XSF_DZ\":\"地址3\",\"XSF_DZDH\":\"地址31332232323\",\"XSF_MC\":\"测试纳税人001\",\"XSF_NSRSBH\":\"201609140000001\",\"XSF_YH\":\"开户行啊啊啊\",\"XSF_YHZH\":\"开户行啊啊啊23123\",\"XSF_ZH\":\"23123\",\"ZDYBZ\":null,\"ZLQQ\":null,\"ZLQZ\":null,\"ZSFS\":null,\"einvoiceApplyTspzs\":null,\"fpDm\":null,\"fpHm\":null,\"items\":[{\"DW\":null,\"FPHXZ\":null,\"GGXH\":null,\"HH\":null,\"KCE\":null,\"LSLBS\":\"\",\"SE\":null,\"SL\":0.130000,\"SPBM\":\"1070223020000000000\",\"XMBM\":\"00000124\",\"XMDJ\":null,\"XMJE\":null,\"XMJSHJ\":1999990.00,\"XMMC\":\"欧舒丹 甜蜜樱花润肤露250Ml(250ml)\",\"XMSL\":\"\",\"YHZCBS\":0,\"YSXMMC\":null,\"ZKHHH\":null,\"ZXBM\":\"00000124\",\"ZZSTSGL\":\"\"},{\"DW\":null,\"FPHXZ\":null,\"GGXH\":null,\"HH\":null,\"KCE\":null,\"LSLBS\":\"\",\"SE\":null,\"SL\":0.130000,\"SPBM\":\"1070223020000000000\",\"XMBM\":\"00000122\",\"XMDJ\":null,\"XMJE\":null,\"XMJSHJ\":9.90,\"XMMC\":\"【个护甄选】雅诗兰黛 特润修护肌透小棕瓶精华液（第七代）50ML\",\"XMSL\":\"\",\"YHZCBS\":0,\"YSXMMC\":null,\"ZKHHH\":null,\"ZXBM\":\"00000122\",\"ZZSTSGL\":\"\"}]},{\"ALLELCPASSWORD\":\"3390df84d7627888921a62e3443d5073\",\"ALLELCUSERNAME\":\"a254a1c7572bc2b5182c308ac2a6ba86\",\"BDCDZ\":null,\"BMB_BBH\":null,\"BZ\":\"\",\"FHR\":\"复核人33\",\"FPLX\":\"31\",\"FPQQLSH\":\"WN316464619883569164\",\"GMF_DH\":\"13346346332\",\"GMF_DZ\":\"里斯的地址\",\"GMF_DZDH\":\"里斯的地址13346346332\",\"GMF_MC\":\"测试纳税人003\",\"GMF_NSRSBH\":\"201609140000003\",\"GMF_YH\":\"银行卡1\",\"GMF_YHZH\":\"银行卡1232323123123\",\"GMF_ZH\":\"232323123123\",\"HJJE\":null,\"HJSE\":null,\"JSHJ\":9.91,\"KDSBZ\":null,\"KPR\":\"账务人\",\"LYID\":null,\"ORGCODE\":null,\"PROJECTCODE\":null,\"SGBZ\":null,\"SKR\":\"那个男人\",\"SLSM\":null,\"TDZZSXMBH\":null,\"TSPZ\":null,\"WXAPPID\":null,\"WXAUTHID\":null,\"WXORDERID\":null,\"XSF_DH\":\"1332232323\",\"XSF_DZ\":\"地址3\",\"XSF_DZDH\":\"地址31332232323\",\"XSF_MC\":\"测试纳税人\",\"XSF_NSRSBH\":\"201609140000001\",\"XSF_YH\":\"开户行啊啊啊\",\"XSF_YHZH\":\"开户行啊啊啊23123\",\"XSF_ZH\":\"23123\",\"ZDYBZ\":null,\"ZLQQ\":null,\"ZLQZ\":null,\"ZSFS\":null,\"einvoiceApplyTspzs\":null,\"fpDm\":null,\"fpHm\":null,\"items\":[{\"DW\":null,\"FPHXZ\":null,\"GGXH\":null,\"HH\":null,\"KCE\":null,\"LSLBS\":\"\",\"SE\":null,\"SL\":0.130000,\"SPBM\":\"1070223030000000000\",\"XMBM\":\"00000118\",\"XMDJ\":null,\"XMJE\":null,\"XMJSHJ\":0.01,\"XMMC\":\"滋源 无患子保湿滋养护发素(中干性)\",\"XMSL\":\"1\",\"YHZCBS\":0,\"YSXMMC\":null,\"ZKHHH\":null,\"ZXBM\":\"00000118\",\"ZZSTSGL\":\"\"},{\"DW\":null,\"FPHXZ\":null,\"GGXH\":null,\"HH\":null,\"KCE\":null,\"LSLBS\":\"\",\"SE\":null,\"SL\":0.130000,\"SPBM\":\"1070223020000000000\",\"XMBM\":\"00000122\",\"XMDJ\":null,\"XMJE\":null,\"XMJSHJ\":9.90,\"XMMC\":\"【个护甄选】雅诗兰黛 特润修护肌透小棕瓶精华液（第七代）50ML\",\"XMSL\":\"\",\"YHZCBS\":0,\"YSXMMC\":null,\"ZKHHH\":null,\"ZXBM\":\"00000122\",\"ZZSTSGL\":\"\"}]}]",
        "sms": "[]",
        "url": "省略",
        "email": "[]"
}