商户自行开具电子发票后，可调用本接口将电子发票插入微信用户的卡包。
请求本接口前需要调用接口上传电子发票文件并获取文件ID。
注：该文件ID三天内有效。
若是非微信支付场景，，并等待用户完成授权才能调用本接口；若是微信支付场景，则无需额外获取用户授权。
注：一个微信支付订单只能插卡一次，最多对应五张电子发票，多次调用会做幂等性检查。
接口说明
支持商户：【普通服务商】
请求方式：【POST】/v3/new-tax-control-fapiao/fapiao-applications/{fapiao_apply_id}/insert-cards
请求域名：使用该域名将访问就近的接入点
请求参数
Header HTTP头参数
Authorization 必填 string
Accept 必填 string
请设置为application/json
Content-Type 必填 string
请设置为application/json
Wechatpay-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 【购买方类型】 购买方类型 可选取值
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 【开具的发票类型】 用户选择提交开具发票的类型 可选取值
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:ss+TIMEZONE check_code 选填 string(20) 【校验码】 校验码，非数电发票必填 password 选填 string(1024) 【密码】 发票票面密码区内容，非数电发票必填 total_amount 必填 integer 【总价税合计】 总价税合计，所有发票行单行金额合计的累加，单位：分 tax_amount 必填 integer 【总税额】 总税额，所有发票行单行税额的累加，单位：分 amount 必填 integer 【总金额】 总金额，所有发票行单行金额的累加，单位：分 seller_information 必填 object 【销售方信息】 销售方信息
extra_information 必填 object 【附加信息】 附加信息
items 选填 array[object] 【发票行信息】 发票行信息
remark 选填 string(200) 【备注信息】 备注信息 |
请求示例
curl
Java
Go
POST
curl -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" : "mI7HGEJ4Q2B91IGjHrl7FNN9QuFPDfzeXoaJM4B8ZghZPzXK+vNotEZu/Gthm87Szv0MK2AoC0/3ZMDgltMtdoY6O0qZ4F1iXiwCuqkkBe+9M4ggvdzpPGM+fyed2QU1seUGbii5RVVVB9s+zLEQ8nv74vsgl77MZx14nd5obtCcfAvPfDJob3oG7FqlThmYKJqjiOwBvvQse7p9R8onj/POzSrbM8re8ZYGp4LcehXopTLdk2ZVWRv8bnJgKZWArAcqMdahq4jY2UVYeY4vpMmq4xuRTYk6xNXvowBBKK2SX8SqM+jm1USyoBIazLu4oaNFNdBO3fip1a1rFW0vRw==", "email" : "NzJy3r0Z2u2Vs5l+WSH0A3CZ1oGlCZ66aa2wUlMXNmACbd4wU8LqqYCuTG4cYWxrVUSmviV59/Uy9vLdIwuHZVrMalYAZGtb8inWGhDj3wUqQnPkmBKBVGIWG5Y6XJmMvpXW6rIKsdzxs8NwWj30cRNfjanLxiWc0aIgl8Knwo0JcxlcYLo38T9ntsrRkQZMQEWHaMYnzjp7ysLbp6yW83OZb/NwEufERBdPnIbDbVE7DUd5MGhvO+tlr2YC1b4VCsrDmjryuTD5nvYYCGHyfXW2CM23hZdBm9tPc+mU18Z9d4XkasnfsecGWd2ISkpPmnk3DtapnD64Nw8JyLtkgw==", "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:00+08:00", "check_code" : "69001808340631374774", "password" : "006>299-375/326>2+7/*0-+<351059<80<4*/5>+<11631+*3030/5*37+/-243159658+013>3409*044>4-/1+/9->*>69501*6++1997--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? Don't just be the one reaping all the benefits; step up and be a contributor too. Whether you're 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. We're gonna team up and explore the whole silicon - based life thing, and in the process, we'll be fueling the growth of technology
