POST

📍How to choose a site? See API Endpoint Guide

OpenAPI Viewer

Request Body Parameters

application/json

Common Request Parameters

bizContent

• requestIdString(64)Required

  Unique request ID, globally unique.
• invoiceIdString(64)Required

  Invoice ID.

Request Body Example

{
  "clientId": "20250101123456",
  "accId": "ACC001",
  "signType": "MD5",
  "sign": "SIGN_VALUE",
  "version": "4.0",
  "bizContent": {
    "requestId": "req_20260507_0012",
    "invoiceId": "INV-260507100000000001"
  }
}

Responses Body Parameters

application/json

Common Response Parameters

bizContent

• requestIdString(64)Required

  Unique request ID, echoed from the request.
• invoiceIdString(64)Required

  Invoice ID.
• invoiceNumberString(64)Required

  Invoice number.
• versionIntegerRequired

  Invoice version that the file corresponds to.
• formatString(16)Required

  File format, currently PDF.
• downloadUrlString(512)Required

  Download URL, valid for 30 days.
• downloadUrlExpiresAtString(10)Required

  URL expiration time as a 10-digit second-level timestamp string.

Request Body Example

{
  "clientId": "20250101123456",
  "accId": "ACC001",
  "signType": "MD5",
  "sign": "SIGN_VALUE",
  "code": "000000",
  "description": "SUCCESS",
  "bizContent": {
    "requestId": "req_20260507_0012",
    "invoiceId": "INV-260507100000000001",
    "invoiceNumber": "INV-2605070001",
    "version": 1,
    "format": "PDF",
    "downloadUrl": "https://example.com/invoice/INV-2605070001.pdf",
    "downloadUrlExpiresAt": "2026-06-06T00:00:00Z"
  }
}

Previous pageInvoice Details

Next pageReceipt Details