发票云(智能特性)
旗舰版标准版智能特性
旗舰版标准版智能特性
🤖 AI Support​​
  1. 智能特性
  • 整体介绍
  • 开发指南
  • 授权
    • token获取
      POST
  • 智能特性
    • 文档信息识别
      • 国际发票识别
      • 国际发票识别(明细)
      • 文档信息识别(反馈)
      • 银行回单识别
    • 文档分类(区分发票、附件)
      POST
    • 智能赋码税收分类编码识别
      POST
    • 三单匹配-同步接口
      POST
    • 三单匹配-异步任务提交
      POST
    • 三单匹配-异步结果查询
      GET
  • 文档中心
    • 外部文件上传接口
      POST
  • 国际发票
  1. 智能特性

三单匹配-异步结果查询

开发中
GET
/ai/knowledge/nlpService/item/match/query/{taskId}

一、接口描述#

三单匹配异步接口的结果查询接口

二、路径参数#

1. taskId: 任务的唯一标识符,用于查询该任务的匹配结果。

三、主要输出参数#

1.data: 输出结果。
taskId: 任务唯一标识。
status:任务状态。
COMPLETED:任务已完成。可以直接获取result字段的匹配结果。
PROCESSING:任务还在处理中。
FAILED:任务失败。可以查看error字段的错误原因。
result: 三单匹配结果,只有 status = COMPLETED 才会返回。
error: 任务错误原因,只有 status = FAILED 才会返回。
result参数详解:
包含匹配的入库单信息和每一行发票明细的匹配情况。如果没有匹配到入库单,matchDocIds/matchDetails 返回空列表;如果匹配到入库单,则返回发票与入库单的匹配信息。匹配信息包含以下字段:
matchDocIds: 该发票匹配的入库单 IDs,,若无匹配,返回空列表;若有匹配,返回一个包含所有匹配入库单 ID 的数组。入库单 ID 来源于入库单文件中的 doc_id 字段。
matchDetails: 发票与入库单的明细匹配信息列表。每个明细项包含以下字段:
targetItemId: 发票的明细 ID,来源于发票文件中的 item_id 字段。
candidateItem: 候选入库单明细信息列表。每个候选项是一个对象,包含:
candidateDocId: 该明细所属的入库单 ID。(doc_id)
candidateItemId: 该明细的 ID。

请求参数

Path 参数
taskId
string 
必需
任务的唯一标识符,用于查询该任务的匹配结果。
示例值:
8a99a18a3ca66a8fb332c66130b09f44
Query 参数
access_token
string 
必需
授权token,由前置脚本生成,失效的调用一下获取授权接口即可
示例值:
{{access_token}}
Header 参数
client-platform
string 
必需
示例值:
common

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/ai/knowledge/nlpService/item/match/query/8a99a18a3ca66a8fb332c66130b09f44?access_token={{access_token}}' \
--header 'client-platform: common'

返回响应

🟢200成功
application/json
Body
接口返回的完整数据结构
errcode
string 
必需
接口返回的错误码,0000代表正常返回成功
description
string 
接口返回描述
必需
data
object 
必需
数据部分,包含匹配的入库单信息和明细
taskId
string 
任务的唯一标识符
必需
status
string 
必需
任务的状态,包含COMPLETED,PROCESSING,FAILED
result
object 
可选
匹配结果,状态为COMPLETED的情况下,会返回
error
string 
可选
错误描述,状态为FAILED的情况下,会返回
traceId
string 
必需
请求唯一标识,用于追踪和关联一次请求的整个生命周期
示例
{
    "errcode": "0000",
    "description": "Success",
    "data": {
        "taskId": "c5a2e4ac8db8c605e5e150f40ff2a643",
        "status": "COMPLETED",
        "result": {
            "matchDocIds": [
                "100134098",
                "100128678",
                "100134926",
                "100134921",
                "100133644"
            ],
            "matchDetails": [
                {
                    "targetItemId": "24322000000227078655_1",
                    "candidateItem": [
                        {
                            "candidateDocId": "100134098",
                            "candidateItemId": "100134098_1"
                        }
                    ]
                },
                {
                    "targetItemId": "24322000000227078655_2",
                    "candidateItem": [
                        {
                            "candidateDocId": "100128678",
                            "candidateItemId": "100128678_1"
                        }
                    ]
                },
                {
                    "targetItemId": "24322000000227078655_3",
                    "candidateItem": [
                        {
                            "candidateDocId": "100134921",
                            "candidateItemId": "100134921_1"
                        }
                    ]
                },
                {
                    "targetItemId": "24322000000227078655_4",
                    "candidateItem": [
                        {
                            "candidateDocId": "100133644",
                            "candidateItemId": "100133644_1"
                        }
                    ]
                },
                {
                    "targetItemId": "24322000000227078655_5",
                    "candidateItem": [
                        {
                            "candidateDocId": "100134926",
                            "candidateItemId": "100134926_1"
                        }
                    ]
                }
            ]
        }
    },
    "traceId": "21c996b57d834de9bfc10f7b8312f530"
}
上一页
三单匹配-异步任务提交
下一页
外部文件上传接口
Built with