服务号
取消
中文
中文
EN
取消
  • 服务端 API

    • # 票据插入用户卡包

    调试工具

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：notaxinvoiceinsert

    执收单位完成用户插卡授权后，向财政局请求给某一个订单号进行领取财政电子票据，财政局须调用该接口对用户进行开票。

    # 1. 调用方式

    # HTTPS 调用

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

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

    • 本接口不支持第三方平台调用。

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填说明
    access_tokenstring是接口调用凭证，可使用 access_token

    # 请求体 Request Payload

    参数名类型必填说明
    order_idstring是财政电子票据order_id
    card_idstring是财政电子票据card_id
    appidstring是该订单号授权时使用的appid，一般为执收单位appid
    card_extobject是财政电子票据具体内容

    # Body.card_ext Object Payload

    财政电子票据具体内容

    参数名类型必填说明
    user_cardobject是用户信息结构体

    # Body.card_ext.user_card Object Payload

    用户信息结构体

    参数名类型必填说明
    feeInt是财政电子票据的金额，以分为单位
    titlestring是财政电子票据的缴费单位
    billing_timeInt是财政电子票据的开票时间，为10位时间戳（utc+8）
    billing_nostring是财政电子票据代码
    billing_codestring是财政电子票据号码
    s_pdf_media_idstring是财政电子票据pdf文件上传到微信财政电子票据平台后，会生成一个财政电子票据s_media_id，该s_media_id可以直接用于开财政电子票据，上传参考“5、上传pdf”

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    codestring财政电子票据code
    openidstring用户标识，即领取到财政电子票据的openid

    # 4. 注意事项

    本接口无特殊注意事项

    # 5. 代码示例

    请求示例

    {
    "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"
}

    返回示例

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

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码

    错误码错误描述解决方案
    40001invalid credential  access_token isinvalid or not latestaccess_token 无效或不为最新获取的 access_token，请开发者确认access_token的有效性

    # 7. 适用范围

    本接口在不同账号类型下的可调用情况：
    公众号服务号
    需申请 需申请
    • 需申请：表示该账号类型需提交此场景的申请并审核通过后方可调用
    • 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口；