销售自动开票获取用户填写抬头信息—东方仙盟

商户调用本接口检查用户是否已完成抬头填写并获取用户填写的抬头信息。在微信支付场景下若该笔订单在下单时指定在支付凭证上展示开票入口则也可以调用本接口查询用户填写的抬头。接口说明支持商户【普通服务商】请求方式【GET】/v3/new-tax-control-fapiao/user-title请求参数Header HTTP头参数Authorization 必填 stringAccept 必填 string请设置为application/jsonquery 查询参数sub_mchid 必填 string(32)【子商户号】 微信支付分配的子商户号【开票场景】 开票场景可选取值WITH_WECHATPAY: 微信支付场景WITHOUT_WECHATPAY: 非微信支付场景fapiao_apply_id 必填 string(32)【发票申请单号】 发票申请单号唯一标识一次开票行为。当开票场景为WITHOUT_WECHATPAY时为调用请求示例curlJavaGoGETcurl-XGET\/v3/new-tax-control-fapiao/user-title?sub_mchid1900000109sceneWITH_WECHATPAYfapiao_apply_id4200000444201910177461284488\-HAuthorization: WECHATPAY2-SHA256-RSA2048 mchid\1900000001\,...\-HAccept: application/json应答参数200 OKtype 必填 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)【留言信息】 用户申请开票时提交的留言信息应答示例200 OK{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:用户留言}错误码状态码错误码描述解决方案400PARAM_ERROR参数错误请根据错误提示正确传入参数400INVALID_REQUESTHTTP 请求不符合微信支付 APIv3 接口规则401SIGN_ERROR验证不通过500SYSTEM_ERROR系统异常请稍后重试请稍后重试400INVALID_REQUEST请求参数符合参数格式但不符合业务规则请使用正确的参数重新调用403NO_AUTH商户无权限请检查是否已经开通电子发票产品相关功能权限并检查子商户是否接受了服务商的邀请404RESOURCE_NOT_EXISTS用户尚未完成发票抬头的填写请在接收到微信支付侧的【用户已申请开票】通知后重新调用或者等待一段时间后重新调用429FREQUENCY_LIMITED频率超限请降低请求接口频率人人皆为创造者共创方能共成长每个人都是使用者也是创造者是数字世界的消费者更是价值的生产者与分享者。在智能时代的浪潮里单打独斗的发展模式早已落幕唯有开放连接、创意共创、利益共享才能让个体价值汇聚成生态合力让技术与创意双向奔赴实现平台与伙伴的快速成长、共赢致远。原创永久分成共赴星辰大海原创创意共创、永久收益分成是东方仙盟始终坚守的核心理念。我们坚信每一份原创智慧都值得被尊重与回馈以永久分成锚定共创初心让创意者长期享有价值红利携手万千伙伴向着科技星辰大海笃定前行拥抱硅基 生命与数字智能交融的未来共筑跨越时代的数字文明共同体。东方仙盟拥抱知识开源共筑数字新生态在全球化与数字化浪潮中东方仙盟始终秉持开放协作、知识共享的理念积极拥抱开源技术与开放标准。我们相信唯有打破技术壁垒、汇聚全球智慧才能真正推动行业的可持续发展。开源赋能中小商户通过将前端异常检测、跨系统数据互联等核心能力开源化东方仙盟为全球中小商户提供了低成本、高可靠的技术解决方案让更多商家能够平等享受数字转型的红利。共建行业标准我们积极参与国际技术社区与全球开发者、合作伙伴共同制定开放协议 与技术规范推动跨境零售、文旅、餐饮等多业态的系统互联互通构建更加公平、高效的数字生态。知识普惠共促发展通过开源社区 、技术文档与培训体系东方仙盟致力于将前沿技术转化为可落地的行业实践赋能全球合作伙伴共同培育创新人才推动数字经济 的普惠式增长阿雪技术观在科技发展浪潮中我们不妨积极投身技术共享。不满足于做受益者更要主动担当贡献者 。无论是分享代码、撰写技术博客还是参与开源项目 维护改进每一个微小举动都可能蕴含推动技术进步的巨大能量。东方仙盟是汇聚力量的天地我们携手在此探索硅基 生命为科技进步添砖加瓦。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