当前位置: 首页 > news >正文

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

商户自行开具电子发票后,可调用本接口将电子发票插入微信用户的卡包。

请求本接口前需要调用接口上传电子发票文件并获取文件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

【购买方类型】 购买方类型

可选取值

  • 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:ss+TIMEZONE


check_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-8,100000000表示数量为1


unit_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)

【备注信息】 备注信息

请求示例

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

http://www.cnnetsun.cn/news/3788449.html

相关文章:

  • Vin象棋:重新定义中国象棋AI辅助体验的智能解决方案
  • 基于NVIDIA Jetson与Llama2的本地语音聊天机器人全栈部署指南
  • NVIDIA Profile Inspector终极指南:3步解锁隐藏显卡性能的完整解决方案
  • 【Zynq7100实战】H3-CZ08P-7100 基于QT的LCD触控屏方案开发全流程
  • We0.ai:重新定义AI原生网站生成的下一代开发范式
  • AI 公司批量抢购 2022 年前的旧书:互联网被 AI 污染后,干净语料成了最后的矿脉
  • Puppet模块管理神器librarian-puppet:支持Forge、Git与本地路径的完整方案
  • 2026年横评:16款降AI率软件实测,这款让导师都夸“原创性强”!
  • 公司信息高效采集终极方案:gh_mirrors/co/company-crawler爬虫框架全解析
  • Kimi K3 架构篇:一文详解 2.8 万亿参数的巨型怪兽
  • 基于PlatformIO开发XIAO ePaper墨水屏:从环境搭建到网络天气站实战
  • 商谈类播客怎么存进Obsidian知识库?从播客转文字到知识库的实操方案
  • 从0到99分NPS:AI应用体验优化全流程,含3套已落地的A/B测试模板
  • 通俗易懂:以开车场景来理解训练网络框架
  • 打通“销-采-存-产-质-设”全链路,重塑制造企业运营中枢
  • 2026离散制造生产管理系统选型指南:定制方案如何破解生产痛点?
  • 2026手持SLAM设备怎么选?后处理软件与数据兼容性评测
  • MiniMax M3 震撼开源:百万上下文+原生多模态,AI 编码与智能体的新标杆
  • 【Kimi图表可信度红皮书】:基于137份真实业务报告的交叉验证,揭示4类“看似合理实则危险”的视觉欺骗模式
  • 2026六盘水黄金回收白银回收铂金回收市民首选无隐形扣费正规备案回收门店联系方式推荐
  • Ubuntu安装GDAL
  • HEXOSKIN科研采购指南
  • AI数据看板搭建到底难在哪?3大认知误区正在拖垮你的数字化转型进度
  • 计算机单片机毕设实战-基于 STC89C52RC 的环境阈值声光报警硬件系统设计 基于 LCD1602 的室内甲醛温湿度监测控制系统开发(017801)
  • 3分钟拯救杂乱桌面!NoFences开源桌面分区神器深度体验
  • Better Streaming Assets API详解:FileExists到LoadAssetBundle的完整调用示例
  • 魔兽争霸3终极帧率优化指南:5步让你的游戏体验丝滑如新
  • SDC命令详解:使用set_wire_load_model命令进行约束
  • 终极指南:3分钟解决Windows系统iPhone USB网络共享驱动安装难题
  • 企业审计数字化落地:解决多源数据、标准不统一、结果不稳定等审计痛点