# The note inserted into the user card package

Debugging Tools

Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide

Interface name: notaxinvoiceinsert

After completing the user's card authorization, the collecting unit requests the financial bureau to collect a financial electronic bill for a certain order number, and the financial office must call the interface to open the bill for the user.

# 1. How to call

# HTTPS calls

POST https://api.weixin.qq.com/nontax/insertbill?access_token=ACCESS_TOKEN

# Cloud Calls

This interface does not support cloud calls

# Third party invocation

Third Party Platform calls are not supported by this interface.

# 2. Request parameters

# Query parameters`Query String parameters`

Parameter Name	type	Required to fill in	Introductions
access_token	string	yes	Interface invoke credentials, using access_token

# Request Body`Request Payload`

Parameter Name	type	Required to fill in	Introductions
order_id	string	yes	Financial electronic bill order_id
card_id	string	yes	Financial electronic bill card_id
appid	string	yes	AppID used when the order number is authorized, usually appid
card_ext	object	yes	Specific content of financial electronic instruments

# Body.card_ext`Object Payload`

Specific content of financial electronic instruments

Parameter Name	type	Required to fill in	Introductions
user_card	object	yes	User Information Structures

# Body.card_ext.user_card`Object Payload`

User Information Structures

Parameter Name	type	Required to fill in	Introductions
fee	Int	yes	The amount of financial electronic notes divided into units
title	string	yes	Unit of payment for financial electronic instruments
billing_time	Int	yes	Invoicing time for fiscal electronic bills, with 10-digit time stamps (UTC + 8)
billing_no	string	yes	Fiscal electronic note code
billing_code	string	yes	Fiscal electronic note number
s_pdf_media_id	string	yes	Upload a financial e-bill pdf file to WeChat When the financial entity platform generates a Financial e-Bill s_media_id, which can be used directly to open the financial paper. Upload reference to "5, upload pdf"

# 3. Return Parameters

# `Response Payload`

Parameter Name	type	Introductions
errcode	number	Error code
errmsg	string	Error message
code	string	Financial electronic bill code
openid	string	User ID, that is, the openid that receives the financial electronic bill

# 4. Note

There are no special considerations for this interface

# 5. Code examples

Example Requests

{
    "order_id" : "1511169724",
    "card_ext" : {
        "user_card" : {
            "invoice_user_data" : {
                "billing_time" : "1511169724",
                "billing_code" : "aabbccdd",
                "billing_no" : "1511169724",
                "s_pdf_media_id" : "s_pdf_media_id",
                "fee" : 123,
                "title" : "灌哥发票"
            }
        }
    },
    "card_id" : "pjZ8Yt7xiy3b9UfffRIA4Tm2xTnw",
    "appid" : "wxc0b84a53ed8e8d29"
}

Return an example

{
    "errcode": 0, 
    "errmsg": "ok", 
    "code": "682xxxx661927", 
    "openid": "ojZ8Ytz4lESxxxx_R1TvB2Kds"
}

# 6. Error code

The following is a list of error codes for this interface, other error codes can refer to General error codes

Error code	Error Description	Solutions
40001	invalid credential access_token isinvalid or not latest	access_token Invalid or not recently acquired access_token, please confirm the validity of the access_token

# 7. Scope of application

How this interface can be invoked under different account types:

Official Account	Service Account
Application required	Application required

Requires application: indicates that the account type needs to submit an application for this scenario and be approved before it can be invoked
Other account types that are not expressly stated may not be called on this interface without special instructions;