捐赠票据开票协议

使用场景：公益侧提供第三方开捐赠票据能力。

调用凭证： 应用签名

请求地址: https://test-oapi.gongyi.qq.com/api/open_invoice/ApplyInvoice

请求方法: POST （ HTTPS ）

请求参数:

参数	类型	必填	说明
donate_info	object	是	捐赠人信息
donate_info.title	string	是	发票抬头
donate_info.uscc	string	是	企业社会信用编码
donate_info.email	string	是	邮箱
donate_info.phone	string	是	电话号码
donate_info.address	string	是	详细地址
donate_info.name	string	是	收件人名称
invoice_type	int32	是	1-个人电子，2-企业电子，3-个人纸质，4-企业纸质当前开放接口仅支持4
invoice_flow_type	int32	是	1-个人捐赠流水 2-企业捐赠流水当前开放接口仅支持2
project_list	object list	是	项目、流水列表
project_list[].project_no	string	是	项目ID
project_list[].project_name	string	是	项目名称
project_list[].org_no	string	是	机构ID
project_list[].trans_list	object list	是	捐款流水列表
project_list[].trans_list[].amount	int32	是	当前这笔流水的金额, 单位分
project_list[].trans_list[].trans_code	int32	是	当前这笔流水的流水号
project_list[].trans_list[].donate_time	int32	是	当前这笔流水的捐款时间

返回参数:

参数	类型	说明
code	int	返回码：0表示成功，其他值表示错误，请参考错误码说明
msg	string	错误信息
data	object	返回数据

data内容:

参数	类型	说明
application_number	string	申请编号（一个申请编号可以对应多条票据单，如多个项目流水申请场景）

请求示例:

{
  "donate_info": {
    "title": "测试企业名称",
    "uscc": "123xxx456yyy789zzz",
    "email": "123450@qq.com",
    "phone": "18800001111",
    "address": "广东省深圳市南山区海天二路33号",
    "name": "张三"
  },
  "invoice_type": 4,
  "invoice_flow_type": 2,
  "project_list": [
    {
      "project_no": "3007860",
      "project_name": "测试8-开票成功",
      "org_no": "100027",
      "trans_list": [
        {
          "amount": 1,
          "trans_code": "158985291120250108AEAGBBNOXX",
          "donate_time": "2025-01-08 01:09:24"
        }
      ]
    }
  ]
}

返回示例:

{
  "code": 0,
  "msg": "Success",
  "data": {
    "application_number": "0000020250108010924QTQDMYJXX"
  }
}

使用场景：公益侧提供第三方通过申请编号查询申请列表。

调用凭证： 应用签名

请求地址: https://test-oapi.gongyi.qq.com/api/open_invoice/GetInvoice

请求方法: POST （ HTTPS ）

请求参数:

参数	类型	必填	说明
application_number	string	是	申请编号（一个申请编号可以对应多条票据单，如多个项目流水申请场景）

返回参数:

参数	类型	说明
code	int	返回码：0表示成功，其他值表示错误，请参考错误码说明
msg	string	错误信息
data	object	返回数据

data内容:

参数	类型	说明
total	int32	总列表条数
ticket_list	object list	申请开票信息列表
ticket_list[].project_no	string	项目ID
ticket_list[].org_no	string	机构ID
ticket_list[].express_number	string	物流编号
ticket_list[].express_company	string	物流信息
ticket_list[].invoice_ticket_url	string	发票链接，电子票才有
ticket_list[].invoice_status	int32	1-已开票 2-开票中 7-开票失败
ticket_list[].invoice_ticket_url	string	发票链接，电子票才有
ticket_list[].phone	string	电话号码
ticket_list[].email	string	邮箱
ticket_list[].invoice_type	int32	1-个人电子，2-企业电子，3-个人纸质，4-企业纸质当前开放接口仅支持4
ticket_list[].trans_list	object list	捐款流水列表
ticket_list[].trans_list[].amount	int32	流水的金额, 单位分
ticket_list[].trans_list[].trans_code	string	流水的流水号
ticket_list[].trans_list[].donate_time	string	流水的捐款时间

请求示例:

{
  "application_number": "0000020250108010924QTQDMYJXX"
}

返回示例:

{
  "code": 0,
  "msg": "Success",
  "data": {
    "total": 1,
    "ticket_list": [
      {
        "project_no": "3007860",
        "org_no": "100027",
        "express_number": "xxx",
        "express_company": "EMS",
        "invoice_ticket_url": "https://xxx.pdf",
        "invoice_status": 1,
        "phone": "18800001111",
        "email": "123450@qq.com",
        "invoice_type": 4,
        "trans_list": [
          {
            "amount": 1,
            "trans_code": "158985291120250108AEAGBBNOXX",
            "donate_time": "2025-01-08 01:09:24"
          }
        ]
      }
    ]
  }
}

注：返回http status为非200均需要重试。

data.code 错误码如下，该错误码为逻辑内部错误，其中参数错误需要检查请求参数，其他错误均为逻辑内部错误。

捐赠票据开票协议

results matching ""

No results matching ""

results matching ""

No results matching ""