发票云(智能特性)
旗舰版标准版智能特性生态版
旗舰版标准版智能特性生态版
  1. 统一反馈
  • 整体介绍
  • 开发指南
  • 授权
    • token获取
      POST
  • 智能特性
    • 文档信息识别
      • 国际发票识别
      • 国际发票识别(明细)
      • 文档信息识别(反馈)
      • 银行回单识别
    • 三单匹配
      • 三单匹配-同步接口
      • 三单匹配-异步匹配任务提交
      • 三单匹配-异步匹配结果查询
      • 三单匹配-异步数据入库
      • 三单匹配-异步数据入库结果查询
      • 三单匹配-异步标注数据导入
      • 三单匹配-异步标注数据导入结果查询
      • 三单匹配-异步训练接口
      • 三单匹配-异步训练结果查询
      • 三单匹配-异步模型一键部署接口
      • 三单匹配-异步模型一键部署查询接口
    • 统一反馈
      • 三单匹配反馈详细说明
      • 算法服务统一反馈接口
        POST
    • 文档分类(区分发票、附件)
      POST
    • 智能赋码税收分类编码识别
      POST
  • 文档中心
    • 外部文件上传接口
      POST
  • 国际发票
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
  1. 统一反馈

算法服务统一反馈接口

开发中
POST
/ai/knowledge/aiService/feedback

一、接口描述#

统一反馈接口用于收集用户对 AI 任务结果的反馈。
当前支持的任务类型:
✅ three_way_match(三单匹配)- 详见项目文档《三单匹配反馈详细说明》
接口设计特点:
通用性:通过 taskType 参数区分不同任务类型
抽象化:通用字段与任务特定数据分离
可扩展:支持后续添加新的任务类型

二、输入参数#

1.
taskType(string):任务类型。必填字段
当前支持:"three_way_match"
其他类型待扩展
2.
clientId(string):客户ID。必填字段
用于多租户隔离
3.
taskData(object):任务特定的反馈数据。必填字段
根据 taskType 而定
具体结构见对应任务类型的详细文档

三、输出参数#

输出参数类型参数说明
errcodestring返回码("0000" 表示成功)
descriptionstring操作信息描述
dataobject扩展信息,无返回数据时为 null
traceIdstring请求唯一标识,用于追踪和关联一次请求的整个生命周期

请求参数

Query 参数

Header 参数

Body 参数application/json

示例
{
    "taskType": "three_way_match",
    "clientId": "client_001",
    "taskData": {
        "supplierId": "supplier_001",
        "targetDocId": "invoice_A",
        "userResult": [
            {
                "targetItemId": "A1",
                "feedbackType": "ACCEPT",
                "sourceTaskId": "task_1",
                "candidateItem": [
                    {
                        "candidateItemId": "C1",
                        "candidateDocId": "receipt_1",
                        "allocatedAmount": 1200,
                        "allocatedQuantity": 30
                    }
                ]
            },
            {
                "targetItemId": "A2",
                "feedbackType": "MODIFY",
                "sourceTaskId": "task_2",
                "candidateItem": []
            },
            {
                "targetItemId": "A3",
                "feedbackType": "MANUAL",
                "sourceTaskId": null,
                "candidateItem": [
                    {
                        "candidateItemId": "C3",
                        "candidateDocId": "receipt_3",
                        "allocatedAmount": 100,
                        "allocatedQuantity": 2
                    }
                ]
            }
        ],
        "extraTargetUrl": "https://files.example.com/invoice_A.csv",
        "extraCandidateUrl": "https://files.example.com/receipts.csv",
        "settings": {
            "matchMode": "2"
        }
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --globoff '/ai/knowledge/aiService/feedback?access_token={{access_token}}' \
--header 'client-platform: common' \
--header 'Content-Type: application/json' \
--data '{
    "taskType": "three_way_match",
    "clientId": "client_001",
    "taskData": {
        "supplierId": "supplier_001",
        "targetDocId": "invoice_A",
        "userResult": [
            {
                "targetItemId": "A1",
                "feedbackType": "ACCEPT",
                "sourceTaskId": "task_1",
                "candidateItem": [
                    {
                        "candidateItemId": "C1",
                        "candidateDocId": "receipt_1",
                        "allocatedAmount": 1200,
                        "allocatedQuantity": 30
                    }
                ]
            },
            {
                "targetItemId": "A2",
                "feedbackType": "MODIFY",
                "sourceTaskId": "task_2",
                "candidateItem": []
            },
            {
                "targetItemId": "A3",
                "feedbackType": "MANUAL",
                "sourceTaskId": null,
                "candidateItem": [
                    {
                        "candidateItemId": "C3",
                        "candidateDocId": "receipt_3",
                        "allocatedAmount": 100,
                        "allocatedQuantity": 2
                    }
                ]
            }
        ],
        "extraTargetUrl": "https://files.example.com/invoice_A.csv",
        "extraCandidateUrl": "https://files.example.com/receipts.csv",
        "settings": {
            "matchMode": "2"
        }
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "errcode": "0000",
    "description": "Success",
    "data": null,
    "traceId": "7003feb05690a2b34"
}
修改于 2026-09-18 05:39:51
上一页
三单匹配反馈详细说明
下一页
文档分类(区分发票、附件)
Built with