将电子发票插入微信用户卡包

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

请求参数	类型	描述
fapiao_apply_id	string	发票申请单号
json	object	声明请求的`JSON`数据结构
sub_mchid	string	子商户号
scene	string	插卡场景 `WITH_WECHATPAY` \| `WITHOUT_WECHATPAY` 枚举值之一
buyer_information	object	购买方信息
type	string	购买方类型 `INDIVIDUAL` \| `ORGANIZATION` 枚举值之一
name	string	名称
taxpayer_id	string	纳税人识别号
address	string	地址
telephone	string	电话
bank_name	string	开户银行
bank_account	string	银行账号
phone	string	手机号
email	string	邮箱地址
amount	integer	订单金额
out_trade_no	string	商户订单号
fapiao_bill_type	string	开具的发票类型 `COMM_FAPIAO` \| `VAT_FAPIAO` 枚举值之一
user_apply_message	string	留言信息
fapiao_card_information	object[]	电子发票卡券信息列表
fapiao_media_id	string	电子发票文件ID
fapiao_number	string	发票号码
fapiao_code	string	发票代码
fapiao_time	string	开票时间
check_code	string	校验码
password	string	密码
total_amount	integer	总价税合计
tax_amount	integer	总税额
amount	integer	总金额
seller_information	object	销售方信息
name	string	名称
taxpayer_id	string	纳税人识别号
address	string	地址
telephone	string	电话
bank_name	string	开户银行
bank_account	string	银行账号
extra_information	object	附加信息
payee	string	收款人
reviewer	string	复核人
drawer	string	开票人
items	object[]	发票行信息
tax_code	string	货物或应税劳务、服务编码
goods_name	string	货物或应税劳务、服务名称
specification	string	规格型号
unit	string	单位
quantity	integer	数量
unit_price	integer	单价
amount	integer	单行金额
tax_amount	integer	单行税额
total_amount	integer	单行金额合计
tax_rate	integer	税率
tax_prefer_mark	string	税收优惠政策标识 `NO_FAVORABLE` \| `OUTSIDE_VAT` \| `VAT_EXEMPT` \| `NORMAL_ZERO_RATED` \| `EXPORT_ZERO_RATED` 枚举值之一
discount	boolean	是否折扣行
remark	string	备注信息
headers	object	声明请求的头参数
Wechatpay-Serial	string	微信支付公钥ID/平台证书序列号

php

$instance->v3->newTaxControlFapiao->fapiaoApplications->_fapiao_apply_id_->insertCards->postAsync([
  'fapiao_apply_id' => '4200000444201910177461284488',
  'json' => [
    'sub_mchid'               => '1900000109',
    'scene'                   => 'WITH_WECHATPAY',
    'buyer_information'       => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => '18507550000',
      'email'              => '123110@qq.com',
      '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-+<3510',
      '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'  => [
        'payee'    => '张三',
        'reviewer' => '李四',
        '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'        => true,
      ],],
      'remark'             => '备注',
    ],],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r($response->getStatusCode() === 202);
})
->wait();

php

$instance->chain('v3/new-tax-control-fapiao/fapiao-applications/{fapiao_apply_id}/insert-cards')->postAsync([
  'fapiao_apply_id' => '4200000444201910177461284488',
  'json' => [
    'sub_mchid'               => '1900000109',
    'scene'                   => 'WITH_WECHATPAY',
    'buyer_information'       => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => '18507550000',
      'email'              => '123110@qq.com',
      '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-+<3510',
      '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'  => [
        'payee'    => '张三',
        'reviewer' => '李四',
        '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'        => true,
      ],],
      'remark'             => '备注',
    ],],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r($response->getStatusCode() === 202);
})
->wait();

php

$instance['v3/new-tax-control-fapiao/fapiao-applications/{fapiao_apply_id}/insert-cards']->postAsync([
  'fapiao_apply_id' => '4200000444201910177461284488',
  'json' => [
    'sub_mchid'               => '1900000109',
    'scene'                   => 'WITH_WECHATPAY',
    'buyer_information'       => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => '18507550000',
      'email'              => '123110@qq.com',
      '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-+<3510',
      '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'  => [
        'payee'    => '张三',
        'reviewer' => '李四',
        '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'        => true,
      ],],
      'remark'             => '备注',
    ],],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r($response->getStatusCode() === 202);
})
->wait();

php

$response = $instance->v3->newTaxControlFapiao->fapiaoApplications->_fapiao_apply_id_->insertCards->post([
  'fapiao_apply_id' => '4200000444201910177461284488',
  'json' => [
    'sub_mchid'               => '1900000109',
    'scene'                   => 'WITH_WECHATPAY',
    'buyer_information'       => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => '18507550000',
      'email'              => '123110@qq.com',
      '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-+<3510',
      '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'  => [
        'payee'    => '张三',
        'reviewer' => '李四',
        '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'        => true,
      ],],
      'remark'             => '备注',
    ],],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r($response->getStatusCode() === 202);

php

$response = $instance->chain('v3/new-tax-control-fapiao/fapiao-applications/{fapiao_apply_id}/insert-cards')->post([
  'fapiao_apply_id' => '4200000444201910177461284488',
  'json' => [
    'sub_mchid'               => '1900000109',
    'scene'                   => 'WITH_WECHATPAY',
    'buyer_information'       => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => '18507550000',
      'email'              => '123110@qq.com',
      '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-+<3510',
      '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'  => [
        'payee'    => '张三',
        'reviewer' => '李四',
        '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'        => true,
      ],],
      'remark'             => '备注',
    ],],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r($response->getStatusCode() === 202);

php

$response = $instance['v3/new-tax-control-fapiao/fapiao-applications/{fapiao_apply_id}/insert-cards']->post([
  'fapiao_apply_id' => '4200000444201910177461284488',
  'json' => [
    'sub_mchid'               => '1900000109',
    'scene'                   => 'WITH_WECHATPAY',
    'buyer_information'       => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => '18507550000',
      'email'              => '123110@qq.com',
      '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-+<3510',
      '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'  => [
        'payee'    => '张三',
        'reviewer' => '李四',
        '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'        => true,
      ],],
      'remark'             => '备注',
    ],],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r($response->getStatusCode() === 202);

返回字典	类型	描述
空字符串(无返回内容)

参阅官方文档官方文档官方文档

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

腾讯数电发票模式

区块链电子发票

自建/三方模式

二级商户授权

即时(需用户确认)模式

预约模式

电子回单

免确认

免确认

直连商户模式

合作伙伴模式