查詢文件折開後識別結果
POST https://api.peperwork.ai/api/identify/file/v2/identifyResultMultiple
概觀
DOCAI文件識別接口返回標準的消息格式。fieldList定義了文件的鍵值格式中的鍵值對字段類型。itemList通常定義表格字段，不同的模型調用識別接口將返回不同的字段
這個介面會同時返回多個識別結果.適用於一份檔案包含多張發票的情况，會返回根據模型配寘折開後每張發票的結果，同時該介面也相容一份檔案一張發票的情况，囙此建議優先選擇該介面
路徑參數
| 名稱 | 類型 | 是否必填 | 描述 |
|---|---|---|---|
| fileIdList | 對象數組 | 是 | 上傳文件的唯一標識 |
| modelId | 字串 | 是 | 模型的唯一標識 |
| returnOcrResult | 字串 | 否 | 是否回傳 OCR 結果,預設值: 0。1: 回傳 OCR 結果,0: 不回傳 OCR 結果。 |
響應主體
| 名稱 | 類型 | 是否必填 | 描述 |
|---|---|---|---|
| fileId | 字串 | 是 | 上傳文件的唯一標識 |
| recognizeStatus | 字串 | 是 | 上傳文件識別狀態，0 失敗 1 成功 2 識別中 |
| resultList | 對象數組 | 是 | 識別結果清單 |
結果消息格式
| 名稱 | 類型 | 是否必填 | 描述 |
|---|---|---|---|
| taskId | 字串 | 否 | 檔案折開每份的唯一標識 |
| fieldList | 對象數組 | 否 | 從檔案中選取的欄位清單 |
| pageNumber | 整數 | 否 | 檔案中所在的頁數 |
| key | 字串 | 否 | 選取欄位的欄位名 |
| value | 字串 | 否 | 選取欄位的欄位名值 |
| itemList | 對象數組 | 否 | 檔案中提前的明細行資訊 |
| pageNumber | 整數 | 否 | 檔案中所在的頁數 |
| key | 字串 | 否 | 明細行的欄位名 |
| value | 字串 | 否 | 明細行的欄位值 |
示例請求
curl -i -X POST api.peperwork.ai/api/identify/file/v2/identifyResultMultiple \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DOCAI_API_KEY" \
-d '{"fileIdList":["2310091711378393918074800"],"modelId":"Your model Id"}'
示例響應
{
"code": 200,
"message": null,
"costTime": null,
"data": [
{
"fileId": "2312151735497780509798400",
"errorMessage": null,
"recognizeStatus": "1",
"resultList": [
{
"wholeTextList": [],
"taxList": [
[
{
"pageNumber": 1,
"key": "taxBase",
"value": "145.0"
},
{
"pageNumber": 1,
"key": "taxType",
"value": "Sales Tax"
},
{
"pageNumber": 1,
"key": "taxValue",
"value": "9.06"
},
{
"pageNumber": 1,
"key": "taxPercentage",
"value": "0.0625"
}
]
],
"fieldList": [
{
"pageNumber": 1,
"key": "supplierAddress",
"value": "1912 Harvest Lane"
},
{
"pageNumber": 1,
"key": "paymentTerms",
"value": "Payment is due within 15 days"
},
{
"pageNumber": 1,
"key": "invoiceDate",
"value": "2019-02-11"
},
{
"pageNumber": 1,
"key": "subAmount",
"value": "145.00"
},
{
"pageNumber": 1,
"key": "supplierCompany",
"value": "East Repair Inc."
},
{
"pageNumber": 1,
"key": "documentType",
"value": "invoice"
},
{
"pageNumber": 1,
"key": "invoiceNumber",
"value": "US-001"
},
{
"pageNumber": 1,
"key": "totalTax",
"value": "9.06"
},
{
"pageNumber": 1,
"key": "customerCompany",
"value": "John Smith"
},
{
"pageNumber": 1,
"key": "dueDate",
"value": "2019-02-26"
},
{
"pageNumber": 1,
"key": "paymentCurrency",
"value": "USD"
},
{
"pageNumber": 1,
"key": "supplierCountry",
"value": ""
},
{
"pageNumber": 1,
"key": "discountAmount",
"value": ""
},
{
"pageNumber": 1,
"key": "grossAmount",
"value": ""
},
{
"pageNumber": 1,
"key": "freightCharge",
"value": ""
},
{
"pageNumber": 1,
"key": "customerCountry",
"value": ""
},
{
"pageNumber": 1,
"key": "dueAmount",
"value": ""
},
{
"pageNumber": 1,
"key": "additionalFees",
"value": ""
}
],
"itemList": [
[
{
"pageNumber": 1,
"key": "taxAmount",
"value": "0.0"
},
{
"pageNumber": 1,
"key": "totalPriceInclTax",
"value": "100.0"
},
{
"pageNumber": 1,
"key": "unitPrice",
"value": "100.0"
},
{
"pageNumber": 1,
"key": "quantity",
"value": "1.0"
},
{
"pageNumber": 1,
"key": "description",
"value": "Front and rear brake cables"
},
{
"pageNumber": 1,
"key": "totalPriceExclTax",
"value": "100.0"
},
{
"pageNumber": 1,
"key": "purchaseOrderNumber",
"value": "2312/2019"
},
{
"pageNumber": 1,
"key": "taxRate",
"value": "0.0625"
},
{
"pageNumber": 1,
"key": "unit",
"value": ""
},
{
"pageNumber": 1,
"key": "POLineItem",
"value": ""
},
{
"pageNumber": 1,
"key": "materialCode",
"value": ""
}
],
[
{
"pageNumber": 1,
"key": "taxAmount",
"value": "0.0"
},
{
"pageNumber": 1,
"key": "totalPriceInclTax",
"value": "30.0"
},
{
"pageNumber": 1,
"key": "unitPrice",
"value": "15.0"
},
{
"pageNumber": 1,
"key": "quantity",
"value": "2.0"
},
{
"pageNumber": 1,
"key": "description",
"value": "New set of pedal arms"
},
{
"pageNumber": 1,
"key": "totalPriceExclTax",
"value": "30.0"
},
{
"pageNumber": 1,
"key": "taxRate",
"value": "0.0625"
},
{
"pageNumber": 1,
"key": "unit",
"value": ""
},
{
"pageNumber": 1,
"key": "POLineItem",
"value": ""
},
{
"pageNumber": 1,
"key": "purchaseOrderNumber",
"value": ""
},
{
"pageNumber": 1,
"key": "materialCode",
"value": ""
}
],
[
{
"pageNumber": 1,
"key": "taxAmount",
"value": "0.0"
},
{
"pageNumber": 1,
"key": "totalPriceInclTax",
"value": "15.0"
},
{
"pageNumber": 1,
"key": "unitPrice",
"value": "5.0"
},
{
"pageNumber": 1,
"key": "quantity",
"value": "3.0"
},
{
"pageNumber": 1,
"key": "description",
"value": "Labor 3hrs"
},
{
"pageNumber": 1,
"key": "totalPriceExclTax",
"value": "15.0"
},
{
"pageNumber": 1,
"key": "taxRate",
"value": "0.0625"
},
{
"pageNumber": 1,
"key": "unit",
"value": ""
},
{
"pageNumber": 1,
"key": "POLineItem",
"value": ""
},
{
"pageNumber": 1,
"key": "purchaseOrderNumber",
"value": ""
},
{
"pageNumber": 1,
"key": "materialCode",
"value": ""
}
]
],
"taskId": "2312151735497780509798400"
}
]
}
],
"requestId": "d6856af734f74a07ba0b9675c470a9f1",
"currentTimeMillis": 1702622461945
}