开具成品油行业电子发票

商户完成收款后，调用本接口开具成品油行业电子发票并插入微信用户的卡包。请求的交易信息必须真实存在。注意：本接口成功返回仅代表开票请求已被受理，当开票完成时，微信支付会根据商户配置的回调地址进行回调通知，商户也可以通过【查询电子发票】接口获取开票结果及开票信息。蓝字发票开具失败时，可以通过更换fapiao_information.fapiao_id，重新填写发票信息进行重试。每个申请单可至多重试4次。

请求参数	类型	描述
json	object	声明请求的`JSON`数据结构
sub_mchid	string	子商户号
fapiao_apply_id	string	发票申请单号
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_information	object	需要开具的数电发票信息
fapiao_id	string	商户发票单号
total_amount	integer	总价税合计
items	object[]	发票行信息
tax_code	string	税局侧规定的货物或应税劳务、服务税收分类编码
goods_name	string	货物或应税劳务、服务名称
specification	string	规格型号
unit	string	成品油单位 `TON` \| `LETER` 枚举值之一
quantity	integer	数量
total_amount	integer	单行金额合计
tax_rate	number	税率
discount	boolean	是否折扣行
preferential_policy_code	integer	优惠政策标识 `1` \| `2` \| `3` \| `4` \| `5` \| `6` \| `7` \| `8` \| `9` \| `10` \| `11` \| `12` \| `13` \| `14` \| `15` \| `16` \| `17` \| `18` 枚举值之一
refined_oil_information	object	成品油行业额外信息
station	string	成品油站点
trade_time	string	交易时间
gun_number	string	加油枪号码
export_business_policy_code	integer	出口业务适用政策代码 `1` \| `2` \| `3` 枚举值之一
vat_refund_levy_code	integer	增值税即征即退代码 `1` \| `2` \| `3` \| `4` \| `5` \| `6` \| `7` \| `8` \| `9` \| `10` \| `11` \| `12` 枚举值之一
billing_person_id	string	开票人ID
billing_person	string	开票人名称
fapiao_bill_type	string	发票类型 `COMM_FAPIAO` \| `VAT_FAPIAO` 枚举值之一
transaction_information	object[]	交易信息
pay_channel	string	支付渠道 `WECHAT_PAY` 枚举值
transaction_id	string	支付订单号
out_trade_no	string	支付商户订单号
amount	integer	交易金额
remark	string	发票备注
headers	object	声明请求的头参数
Wechatpay-Serial	string	微信支付公钥ID/平台证书序列号

php

$instance->v3->newTaxControlFapiao->fapiaoApplications->issueRefinedOil->postAsync([
  'json' => [
    'sub_mchid'          => '1900000109',
    'fapiao_apply_id'    => '4200000444201910177461284488',
    'buyer_information'  => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'email'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'amount'             => 1000,
      'out_trade_no'       => 'order_20200701_123456',
      'fapiao_bill_type'   => 'COMM_FAPIAO',
      'user_apply_message' => '用户留言',
    ],
    'fapiao_information' => [
      'fapiao_id'                   => '20200701123456',
      'total_amount'                => 382895,
      'items'                       => [[
        'tax_code'                 => '3010101020203000000',
        'goods_name'               => '出租汽车客运服务',
        'specification'            => 'A4',
        'unit'                     => 'TON',
        'quantity'                 => 100000000,
        'total_amount'             => 429900,
        'tax_rate'                 => 1300,
        'discount'                 => true,
        'preferential_policy_code' => 1,
        'refined_oil_information'  => [
          'station'    => '中国石油(江北红旗河沟加油站)',
          'trade_time' => '2025-07-01T00:00:00+08:00',
          'gun_number' => '1号枪',
        ],
      ],],
      'export_business_policy_code' => 1,
      'vat_refund_levy_code'        => 1,
      'billing_person_id'           => '187776276864872',
      'billing_person'              => '**伟 0020',
      'fapiao_bill_type'            => 'COMM_FAPIAO',
      'transaction_information'     => [[
        'pay_channel'    => 'WECHAT_PAY',
        'transaction_id' => '4200000008202508080512076713',
        'out_trade_no'   => 'order_20200701_123456',
        'amount'         => 382895,
      ],],
      '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/issue-refined-oil')->postAsync([
  'json' => [
    'sub_mchid'          => '1900000109',
    'fapiao_apply_id'    => '4200000444201910177461284488',
    'buyer_information'  => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'email'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'amount'             => 1000,
      'out_trade_no'       => 'order_20200701_123456',
      'fapiao_bill_type'   => 'COMM_FAPIAO',
      'user_apply_message' => '用户留言',
    ],
    'fapiao_information' => [
      'fapiao_id'                   => '20200701123456',
      'total_amount'                => 382895,
      'items'                       => [[
        'tax_code'                 => '3010101020203000000',
        'goods_name'               => '出租汽车客运服务',
        'specification'            => 'A4',
        'unit'                     => 'TON',
        'quantity'                 => 100000000,
        'total_amount'             => 429900,
        'tax_rate'                 => 1300,
        'discount'                 => true,
        'preferential_policy_code' => 1,
        'refined_oil_information'  => [
          'station'    => '中国石油(江北红旗河沟加油站)',
          'trade_time' => '2025-07-01T00:00:00+08:00',
          'gun_number' => '1号枪',
        ],
      ],],
      'export_business_policy_code' => 1,
      'vat_refund_levy_code'        => 1,
      'billing_person_id'           => '187776276864872',
      'billing_person'              => '**伟 0020',
      'fapiao_bill_type'            => 'COMM_FAPIAO',
      'transaction_information'     => [[
        'pay_channel'    => 'WECHAT_PAY',
        'transaction_id' => '4200000008202508080512076713',
        'out_trade_no'   => 'order_20200701_123456',
        'amount'         => 382895,
      ],],
      '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/issue-refined-oil']->postAsync([
  'json' => [
    'sub_mchid'          => '1900000109',
    'fapiao_apply_id'    => '4200000444201910177461284488',
    'buyer_information'  => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'email'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'amount'             => 1000,
      'out_trade_no'       => 'order_20200701_123456',
      'fapiao_bill_type'   => 'COMM_FAPIAO',
      'user_apply_message' => '用户留言',
    ],
    'fapiao_information' => [
      'fapiao_id'                   => '20200701123456',
      'total_amount'                => 382895,
      'items'                       => [[
        'tax_code'                 => '3010101020203000000',
        'goods_name'               => '出租汽车客运服务',
        'specification'            => 'A4',
        'unit'                     => 'TON',
        'quantity'                 => 100000000,
        'total_amount'             => 429900,
        'tax_rate'                 => 1300,
        'discount'                 => true,
        'preferential_policy_code' => 1,
        'refined_oil_information'  => [
          'station'    => '中国石油(江北红旗河沟加油站)',
          'trade_time' => '2025-07-01T00:00:00+08:00',
          'gun_number' => '1号枪',
        ],
      ],],
      'export_business_policy_code' => 1,
      'vat_refund_levy_code'        => 1,
      'billing_person_id'           => '187776276864872',
      'billing_person'              => '**伟 0020',
      'fapiao_bill_type'            => 'COMM_FAPIAO',
      'transaction_information'     => [[
        'pay_channel'    => 'WECHAT_PAY',
        'transaction_id' => '4200000008202508080512076713',
        'out_trade_no'   => 'order_20200701_123456',
        'amount'         => 382895,
      ],],
      '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->issueRefinedOil->post([
  'json' => [
    'sub_mchid'          => '1900000109',
    'fapiao_apply_id'    => '4200000444201910177461284488',
    'buyer_information'  => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'email'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'amount'             => 1000,
      'out_trade_no'       => 'order_20200701_123456',
      'fapiao_bill_type'   => 'COMM_FAPIAO',
      'user_apply_message' => '用户留言',
    ],
    'fapiao_information' => [
      'fapiao_id'                   => '20200701123456',
      'total_amount'                => 382895,
      'items'                       => [[
        'tax_code'                 => '3010101020203000000',
        'goods_name'               => '出租汽车客运服务',
        'specification'            => 'A4',
        'unit'                     => 'TON',
        'quantity'                 => 100000000,
        'total_amount'             => 429900,
        'tax_rate'                 => 1300,
        'discount'                 => true,
        'preferential_policy_code' => 1,
        'refined_oil_information'  => [
          'station'    => '中国石油(江北红旗河沟加油站)',
          'trade_time' => '2025-07-01T00:00:00+08:00',
          'gun_number' => '1号枪',
        ],
      ],],
      'export_business_policy_code' => 1,
      'vat_refund_levy_code'        => 1,
      'billing_person_id'           => '187776276864872',
      'billing_person'              => '**伟 0020',
      'fapiao_bill_type'            => 'COMM_FAPIAO',
      'transaction_information'     => [[
        'pay_channel'    => 'WECHAT_PAY',
        'transaction_id' => '4200000008202508080512076713',
        'out_trade_no'   => 'order_20200701_123456',
        'amount'         => 382895,
      ],],
      'remark'                      => '备注',
    ],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r($response->getStatusCode() === 202);

php

$response = $instance->chain('v3/new-tax-control-fapiao/fapiao-applications/issue-refined-oil')->post([
  'json' => [
    'sub_mchid'          => '1900000109',
    'fapiao_apply_id'    => '4200000444201910177461284488',
    'buyer_information'  => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'email'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'amount'             => 1000,
      'out_trade_no'       => 'order_20200701_123456',
      'fapiao_bill_type'   => 'COMM_FAPIAO',
      'user_apply_message' => '用户留言',
    ],
    'fapiao_information' => [
      'fapiao_id'                   => '20200701123456',
      'total_amount'                => 382895,
      'items'                       => [[
        'tax_code'                 => '3010101020203000000',
        'goods_name'               => '出租汽车客运服务',
        'specification'            => 'A4',
        'unit'                     => 'TON',
        'quantity'                 => 100000000,
        'total_amount'             => 429900,
        'tax_rate'                 => 1300,
        'discount'                 => true,
        'preferential_policy_code' => 1,
        'refined_oil_information'  => [
          'station'    => '中国石油(江北红旗河沟加油站)',
          'trade_time' => '2025-07-01T00:00:00+08:00',
          'gun_number' => '1号枪',
        ],
      ],],
      'export_business_policy_code' => 1,
      'vat_refund_levy_code'        => 1,
      'billing_person_id'           => '187776276864872',
      'billing_person'              => '**伟 0020',
      'fapiao_bill_type'            => 'COMM_FAPIAO',
      'transaction_information'     => [[
        'pay_channel'    => 'WECHAT_PAY',
        'transaction_id' => '4200000008202508080512076713',
        'out_trade_no'   => 'order_20200701_123456',
        'amount'         => 382895,
      ],],
      'remark'                      => '备注',
    ],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r($response->getStatusCode() === 202);

php

$response = $instance['v3/new-tax-control-fapiao/fapiao-applications/issue-refined-oil']->post([
  'json' => [
    'sub_mchid'          => '1900000109',
    'fapiao_apply_id'    => '4200000444201910177461284488',
    'buyer_information'  => [
      'type'               => 'ORGANIZATION',
      'name'               => '深圳市南山区测试企业',
      'taxpayer_id'        => '202003261233701778',
      'address'            => '深圳市南山区深南大道10000号',
      'telephone'          => '075512345678',
      'bank_name'          => '测试银行',
      'bank_account'       => '62001234567890',
      'phone'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'email'              => 'pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zB',
      'amount'             => 1000,
      'out_trade_no'       => 'order_20200701_123456',
      'fapiao_bill_type'   => 'COMM_FAPIAO',
      'user_apply_message' => '用户留言',
    ],
    'fapiao_information' => [
      'fapiao_id'                   => '20200701123456',
      'total_amount'                => 382895,
      'items'                       => [[
        'tax_code'                 => '3010101020203000000',
        'goods_name'               => '出租汽车客运服务',
        'specification'            => 'A4',
        'unit'                     => 'TON',
        'quantity'                 => 100000000,
        'total_amount'             => 429900,
        'tax_rate'                 => 1300,
        'discount'                 => true,
        'preferential_policy_code' => 1,
        'refined_oil_information'  => [
          'station'    => '中国石油(江北红旗河沟加油站)',
          'trade_time' => '2025-07-01T00:00:00+08:00',
          'gun_number' => '1号枪',
        ],
      ],],
      'export_business_policy_code' => 1,
      'vat_refund_levy_code'        => 1,
      'billing_person_id'           => '187776276864872',
      'billing_person'              => '**伟 0020',
      'fapiao_bill_type'            => 'COMM_FAPIAO',
      'transaction_information'     => [[
        'pay_channel'    => 'WECHAT_PAY',
        'transaction_id' => '4200000008202508080512076713',
        'out_trade_no'   => 'order_20200701_123456',
        'amount'         => 382895,
      ],],
      'remark'                      => '备注',
    ],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r($response->getStatusCode() === 202);

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

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

腾讯数电发票模式

区块链电子发票

自建/三方模式

二级商户授权

即时(需用户确认)模式

预约模式

电子回单

免确认

免确认

直连商户模式

合作伙伴模式