国际发票异步识别任务查询（新版）
设计中
POST
/doc-ai/ai/knowledge/nlpService/tasks/query
| status | statusDesc | result | errorMessage |
|---|---|---|---|
| PENDING | Pending | null | null |
| COMPLETED | Completed | JSON 字符串 | null |
| FAILED | Failed | null | 失败原因 |
| 查询顶层 errcode | 说明 | legacyErrcode |
|---|---|---|
| 0000 | 查询调用成功 | 0000 |
| A0301 | 未授权或令牌不可用 | 4004 |
| A0410 | taskIds 未传、不是数组或有效值为空 | 4008 |
| A0426 | 超过 10 个有效任务 ID | 空字符串 |
| 1999 | 查询失败 | 5000 |
查询成功：三种任务状态（示意数据）
{
"errcode": "0000",
"description": "成功",
"data": {
"11111111-1111-4111-8111-111111111111": {
"taskId": "11111111-1111-4111-8111-111111111111",
"status": "PENDING",
"statusDesc": "Pending",
"requestParams": {
"templateId": "7",
"countryCode": "MY",
"language": "auto",
"fileName": "invoice.pdf"
},
"result": null,
"errorMessage": null
},
"22222222-2222-4222-8222-222222222222": {
"taskId": "22222222-2222-4222-8222-222222222222",
"status": "COMPLETED",
"statusDesc": "Completed",
"requestParams": {
"templateId": "7",
"countryCode": "MY",
"language": "auto",
"fileName": "invoice.pdf"
},
"result": "{\"errcode\": \"0000\", \"description\": \"Success\", \"data\": [{\"header\": {\"basic\": {\"sourceFileHash\": \"example-file-hash\", \"docType\": \"invoice\", \"nameOfInvoice\": \"\", \"invoiceType\": \"\", \"invoiceNumber\": \"INV-2026-001\", \"invoiceCode\": \"\", \"invoiceDate\": \"2026-10-23\", \"totalNetAmount\": \"100.00\", \"totalAmount\": \"106.00\", \"totalTaxAmount\": \"6.00\", \"currency\": \"MYR\", \"page\": [\"1\"], \"remark\": \"\"}, \"billTo\": {\"billToName\": \"Example Buyer\", \"billToComposite\": \"\", \"billToCity\": \"\", \"billToStateOrProvince\": \"\", \"billToCountry\": \"\", \"billToCountryCode\": \"\", \"billToFax\": \"\", \"billToPostalCode\": \"\", \"billToTelephone\": \"\", \"billToTaxIdentificationNumber\": \"\", \"billToRecipient\": \"\", \"billToBankAccount\": \"\", \"billToBankOfAccount\": \"\", \"billToEmail\": \"\"}, \"billFrom\": {\"billFromName\": \"Example Supplier\", \"billFromComposite\": \"\", \"billFromCity\": \"\", \"billFromStateOrProvince\": \"\", \"billFromCountry\": \"\", \"billFromCountryCode\": \"\", \"billFromFax\": \"\", \"billFromPostalCode\": \"\", \"billFromTelephone\": \"\", \"billFromTaxIdentificationNumber\": \"\", \"billFromBusinessRegistrationNumber\": \"\", \"billFromBankAccount\": \"\", \"billFromBankOfAccount\": \"\", \"billFromEmail\": \"\"}, \"bussiness\": {\"purchaseOrderNumber\": \"\", \"contractNumber\": \"\", \"startDate\": \"\", \"endDate\": \"\", \"salesOrderNumber\": \"\", \"deliveryOrderNumber\": \"\"}, \"payment\": {\"paymentMethod\": \"\", \"paymentStatus\": \"\", \"paymentTerms\": \"\", \"dueDate\": \"\", \"paymentCurrency\": \"\", \"exchangeRate\": \"\", \"paidAmount\": \"\"}}, \"detail\": {\"detailOfGoodsOrServices\": [{\"articleID\": \"\", \"articleName\": \"Service\", \"description\": \"\", \"quantity\": \"1\", \"unitOfMeasure\": \"\", \"unitPrice\": \"100.00\", \"netAmount\": \"100.00\", \"taxRate\": \"6\", \"tax\": \"6.00\", \"grossAmount\": \"106.00\", \"orderNumber\": \"\", \"salesOrderNumber\": \"\", \"deliveryOrderNumber\": \"\", \"purchaseOrderNumber\": \"\"}], \"detailOfTaxSummary\": [{\"taxCategory\": \"SST\", \"taxRate\": \"6\", \"netTaxableAmount\": \"100.00\", \"tax\": \"6.00\"}], \"originalInvoiceReferences\": []}}], \"traceId\": \"example-trace-id\", \"docPages\": 1}",
"errorMessage": null
},
"33333333-3333-4333-8333-333333333333": {
"taskId": "33333333-3333-4333-8333-333333333333",
"status": "FAILED",
"statusDesc": "Failed",
"requestParams": {
"templateId": "7",
"countryCode": "MY",
"language": "auto",
"fileName": "invoice.pdf"
},
"result": null,
"errorMessage": "Document processing failed. Please retry later or contact support."
}
},
"traceId": "example-query-trace",
"legacyErrcode": "0000"
}查询失败：缺少任务 ID（示意数据）
{
"errcode": "A0410",
"description": "taskIds must not be empty.",
"data": {},
"traceId": "example-query-trace",
"legacyErrcode": "4008"
}请求参数
Query 参数
Header 参数
Body 参数application/json必填
请求示例代码
返回响应
修改于 2026-10-24 01:48:01