销售自动电子发票插入用户卡包—东方仙盟自动化运营

商户自行开具电子发票后可调用本接口将电子发票插入微信用户的卡包。请求本接口前需要调用接口上传电子发票文件并获取文件ID。注该文件ID三天内有效。若是非微信支付场景并等待用户完成授权才能调用本接口若是微信支付场景则无需额外获取用户授权。注一个微信支付订单只能插卡一次最多对应五张电子发票多次调用会做幂等性检查。接口说明支持商户【普通服务商】请求方式【POST】/v3/new-tax-control-fapiao/fapiao-applications/{fapiao_apply_id}/insert-cards请求域名使用该域名将访问就近的接入点请求参数Header HTTP头参数Authorization 必填 stringAccept 必填 string请设置为application/jsonContent-Type 必填 string请设置为application/jsonWechatpay-Serial 必填 string【微信支付公钥ID】path 路径参数fapiao_apply_id 必填 string(32)【发票申请单号】 发票申请单号唯一标识一次开票行为。当开票场景为WITHOUT_WECHATPAY时接口时指定的发票申请单号当开票场景为WITH_WECHATPAY时为与本次开票关联的微信支付订单号且必须是属于相应商户的订单服务商模式下该订单必须属于子商户直连模式下该订单必须属于直连商户body 包体参数sub_mchid 必填 string(32)【子商户号】 微信支付分配的子商户号scene 必填 string【插卡场景】 插卡场景可选取值WITH_WECHATPAY: 微信支付场景WITHOUT_WECHATPAY: 非微信支付场景buyer_information 必填 object【购买方信息】 购买方信息即发票抬头。属性type 必填 string【购买方类型】 购买方类型可选取值INDIVIDUAL: 个人、其他ORGANIZATION: 单位name 必填 string(256)【名称】 购买方名称taxpayer_id 选填 string(32)【纳税人识别号】 购买方纳税人识别号购买方类型为ORGANIZATION时必填address 选填 string(128)【地址】 购买方地址telephone 选填 string(32)【电话】 购买方电话bank_name 选填 string(128)【开户银行名称】 购买方开户银行名称bank_account 选填 string(32)【银行账号】 购买方银行账号phone 选填 string【手机号】 用户手机号。注意该字段为密文字段作为请求字段需加密使用支付公钥加密email 选填 string【邮箱地址】 用户邮箱地址。注意该字段为密文字段作为请求字段需加密使用微信支付公钥加密amount 选填 integer【订单金额】 微信支付订单金额仅在微信支付场景下有效单位分out_trade_no 选填 string(32)【商户订单号】 商户订单号仅在微信支付场景下有效fapiao_bill_type 选填 string【开具的发票类型】 用户选择提交开具发票的类型可选取值COMM_FAPIAO: 增值税普通发票VAT_FAPIAO: 增值税专用发票user_apply_message 选填 string(100)【留言信息】 用户申请开票时提交的留言信息fapiao_card_information 必填 array[object]【电子发票卡券信息列表】 电子发票卡券信息列表最多五条属性fapiao_media_id 必填 string(128)【电子发票文件ID】 上传的电子发票文件对应的ID用于CreateFapiaoCard接口fapiao_number 必填 string(20)【发票号码】 发票号码fapiao_code 选填 string(12)【发票代码】 发票代码非数电发票必填fapiao_time 必填 string(32)【开票时间】 开票时间yyyy-MM-DDTHH:mm:ssTIMEZONEcheck_code 选填 string(20)【校验码】 校验码非数电发票必填password 选填 string(1024)【密码】 发票票面密码区内容非数电发票必填total_amount 必填 integer【总价税合计】 总价税合计所有发票行单行金额合计的累加单位分tax_amount 必填 integer【总税额】 总税额所有发票行单行税额的累加单位分amount 必填 integer【总金额】 总金额所有发票行单行金额的累加单位分seller_information 必填 object【销售方信息】 销售方信息属性name 必填 string(256)【名称】 销售方名称taxpayer_id 必填 string(32)【纳税人识别号】 销售方纳税人识别号address 选填 string(128)【地址】 销售方地址。数电模式下无地址信息telephone 选填 string(32)【电话】 销售方电话bank_name 选填 string(128)【开户银行】 销售方开户银行bank_account 选填 string(32)【银行账号】 销售方银行账号extra_information 必填 object【附加信息】 附加信息属性drawer 必填 string(20)【开票人】 开票人items 选填 array[object]【发票行信息】 发票行信息属性tax_code 必填 string(32)【税局侧规定的货物或应税劳务、服务税收分类编码】 税局侧规定的货物或应税劳务、服务税收分类编码goods_name 必填 string(128)【货物或应税劳务、服务名称】 由商户自定义的货物或应税劳务、服务名称specification 选填 string(20)【规格型号】 规格型号展示在发票中间的规格型号列unit 选填 string(32)【单位】 单位展示在发票中间的单位列quantity 必填 integer【数量】 数量展示在发票中间的数量列单位为10-8100000000表示数量为1unit_price 必填 integer【单价】 单价单位为10-6分100000000表示1元amount 必填 integer【单行金额】 单行金额单位分tax_amount 必填 integer【单行税额】 单行税额单位分total_amount 必填 integer【单行金额合计】 单行金额和税费的和折扣行的金额为负数非折扣行的金额为正数单位:分tax_rate 必填 integer【税率】 税率单位为万分之一如1300代表13%tax_prefer_mark 选填 string【税收优惠政策标识】 税收优惠政策标识可选取值NO_FAVORABLE: 无优惠OUTSIDE_VAT: 不征税VAT_EXEMPT: 免税NORMAL_ZERO_RATED: 普通零税率EXPORT_ZERO_RATED: 出口零税率discount 必填 boolean【是否折扣行】 指定该发票行是否折扣行折扣行必须是被折扣行的下一行remark 选填 string(200)【备注信息】 备注信息请求示例curlJavaGoPOSTcurl -X POST \ /v3/new-tax-control-fapiao/fapiao-applications/4200000444201910177461284488/insert-cards \ -H Authorization: WECHATPAY2-SHA256-RSA2048 mchid\1900000001\,... \ -H Accept: application/json \ -H Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1 \ -H Content-Type: application/json \ -d { sub_mchid : 1900000109, scene : WITH_WECHATPAY, buyer_information : { type : INDIVIDUAL, name : 深圳市南山区测试企业, taxpayer_id : 202003261233701778, address : 深圳市南山区深南大道10000号, telephone : 075512345678, bank_name : 测试银行, bank_account : 62001234567890, phone : mI7HGEJ4Q2B91IGjHrl7FNN9QuFPDfzeXoaJM4B8ZghZPzXKvNotEZu/Gthm87Szv0MK2AoC0/3ZMDgltMtdoY6O0qZ4F1iXiwCuqkkBe9M4ggvdzpPGMfyed2QU1seUGbii5RVVVB9szLEQ8nv74vsgl77MZx14nd5obtCcfAvPfDJob3oG7FqlThmYKJqjiOwBvvQse7p9R8onj/POzSrbM8re8ZYGp4LcehXopTLdk2ZVWRv8bnJgKZWArAcqMdahq4jY2UVYeY4vpMmq4xuRTYk6xNXvowBBKK2SX8SqMjm1USyoBIazLu4oaNFNdBO3fip1a1rFW0vRw, email : NzJy3r0Z2u2Vs5lWSH0A3CZ1oGlCZ66aa2wUlMXNmACbd4wU8LqqYCuTG4cYWxrVUSmviV59/Uy9vLdIwuHZVrMalYAZGtb8inWGhDj3wUqQnPkmBKBVGIWG5Y6XJmMvpXW6rIKsdzxs8NwWj30cRNfjanLxiWc0aIgl8Knwo0JcxlcYLo38T9ntsrRkQZMQEWHaMYnzjp7ysLbp6yW83OZb/NwEufERBdPnIbDbVE7DUd5MGhvOtlr2YC1b4VCsrDmjryuTD5nvYYCGHyfXW2CM23hZdBm9tPcmU18Z9d4XkasnfsecGWd2ISkpPmnk3DtapnD64Nw8JyLtkgw, amount : 1000, out_trade_no : order_20200701_123456, fapiao_bill_type : COMM_FAPIAO, user_apply_message : 用户留言 }, fapiao_card_information : [ { fapiao_media_id : ASNFZ4mrze/3LqYdlQyEA, fapiao_number : 12897794, fapiao_code : 044001911211, fapiao_time : 2020-07-01T12:00:0008:00, check_code : 69001808340631374774, password : 006299-375/32627/*0-351059804*/511631*3030/5*37/-2431596580133409*0444-/1/9-*69501*61997--21, total_amount : 382895, tax_amount : 44050, amount : 338845, seller_information : { name : 深圳市南山区测试公司, taxpayer_id : 202003261233701778, address : 深圳市南山区深南大道10000号, telephone : 075512345678, bank_name : 测试银行, bank_account : 62001234567890 }, extra_information : { drawer : 王五 }, items : [ { tax_code : 3010101020203000000, goods_name : 出租汽车客运服务, specification : A4, unit : 次, quantity : 100000000, unit_price : 380442000000, amount : 380442, tax_amount : 49458, total_amount : 429900, tax_rate : 1300, tax_prefer_mark : NO_FAVORABLE, discount : false } ], remark : 备注 } ] }人人皆为创造者共创方能共成长每个人都是使用者也是创造者是数字世界的消费者更是价值的生产者与分享者。在智能时代的浪潮里单打独斗的发展模式早已落幕唯有开放连接、创意共创、利益共享才能让个体价值汇聚成生态合力让技术与创意双向奔赴实现平台与伙伴的快速成长、共赢致远。原创永久分成共赴星辰大海原创创意共创、永久收益分成是东方仙盟始终坚守的核心理念。我们坚信每一份原创智慧都值得被尊重与回馈以永久分成锚定共创初心让创意者长期享有价值红利携手万千伙伴向着科技星辰大海笃定前行拥抱硅基 生命与数字智能交融的未来共筑跨越时代的数字文明共同体。东方仙盟拥抱知识开源共筑数字新生态在全球化与数字化浪潮中东方仙盟始终秉持开放协作、知识共享的理念积极拥抱开源技术与开放标准。我们相信唯有打破技术壁垒、汇聚全球智慧才能真正推动行业的可持续发展。开源赋能中小商户通过将前端异常检测、跨系统数据互联等核心能力开源化东方仙盟为全球中小商户提供了低成本、高可靠的技术解决方案让更多商家能够平等享受数字转型的红利。共建行业标准我们积极参与国际技术社区与全球开发者、合作伙伴共同制定开放协议 与技术规范推动跨境零售、文旅、餐饮等多业态的系统互联互通构建更加公平、高效的数字生态。知识普惠共促发展通过开源社区 、技术文档与培训体系东方仙盟致力于将前沿技术转化为可落地的行业实践赋能全球合作伙伴共同培育创新人才推动数字经济 的普惠式增长阿雪技术观在科技发展浪潮中我们不妨积极投身技术共享。不满足于做受益者更要主动担当贡献者 。无论是分享代码、撰写技术博客还是参与开源项目 维护改进每一个微小举动都可能蕴含推动技术进步的巨大能量。东方仙盟是汇聚力量的天地我们携手在此探索硅基 生命为科技进步添砖加瓦。Hey folks, in this wild tech - driven world, why not dive headfirst into the whole tech - sharing scene? Dont just be the one reaping all the benefits; step up and be a contributor too. Whether youre tossing out your code snippets , hammering out some tech blogs, or getting your hands dirty with maintaining and sprucing up open - source projects, every little thing you do might just end up being a massive force that pushes tech forward. And guess what? The Eastern FairyAlliance is this awesome place where we all come together. Were gonna team up and explore the whole silicon - based life thing, and in the process, well be fueling the growth of technology