微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 上传国补订单发票信息

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

    接口英文名：upload_invoice_info

    1. order_id必须是使用了国补的订单id。
    2. 该接口只能在订单确认收货之后调用。
    3. 同一笔订单最多可以上传5次

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/channels/ec/subsidy/upload_invoice_info?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

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

    # 2. 请求参数

    # 查询参数 Query String parameters

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

    # 请求体 Request Payload

    参数名类型必填说明枚举
    order_idstring是订单id-
    invoice_codestring否发票代码, 发票类型为90可以选填。-
    invoice_nostring是发票号码-
    invoice_datestring是开票时间，秒级时间戳，要求小于当前时间-
    invoice_media_idstring是media_id, 需要调用上传国补订单发票上传获得-
    invoice_typestring是发票类型 枚举值
    invoice_check_codestring否发票校验码; 发票类型为10或者04时，校验码必填; 发票类型01、09、90时，校验码选填;-
    invoice_total_amountnumber是税价合计, 单位(分)-
    invoice_tax_amountnumber是发票税额, 单位(分)-
    sales_enterprise_namestring是销售企业名称-
    tax_payerstring是销售方纳税人识别号-
    numnumber是数量-
    service_namestring是货物或应税劳务服务名-

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误描述

    # 4. 枚举信息

    # Body.invoice_type Enum

    发票类型

    枚举值描述
    01增值税专用发票
    04纸质普通发票
    09数电专票
    10电子普通发票
    90数电普票

    # 5. 注意事项

    本接口无特殊注意事项

    # 6. 代码示例

    请求示例

    {
    "order_id": "3729018433211599360", 
    "invoice_code": "10000000000", 
    "invoice_no": "20000000000", 
    "invoice_date": 1753186232, 
    "invoice_media_id": "P42MmBrcV9r0wWbiMtu33ARIVKtlRsl_HP0HD6zrIn1Ozjq-ZnNlhEL9cvIp2scj", 
    "invoice_type": "10",
    "invoice_check_code": "07718630802331862941", 
    "invoice_total_amount": 1000, 
    "invoice_tax_amount": 100, 
    "sales_enterprise_name": "销售企业名称", 
    "tax_payer": "5311000006963655XX", 
    "num": 1, 
    "service_name": "笔记本"
}

    返回示例

    {
    "errcode": 0,
    "errmsg": "ok"
}

    # 7. 错误码

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

    错误码错误描述解决方案
    987100102订单非国补订单
    987100116订单查找失败
    987100117上传发票信息达到最大次数
    987100118发票链接无效
    987100121无效的 media_id
    987100122请检查 media_id 对应的文件类型
    987100126获取开票信息失败, 订单未确认收货

    # 8. 适用范围

    本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。