综合诊断
供应商中立诊断合同由Hub和Admin共享. 需要 API 综合诊断 迁移和来自协调特征的终点. 该套件不取代本地融合问题或订单出口API.
import {
GetDiagnosticProblems,
GetDiagnosticProblemDetails,
VerifyDiagnosticProblem,
PreviewDiagnosticRecovery,
RequestDiagnosticRecovery,
describeDiagnostic,
} from '@deliverart/sdk-js-integration-diagnostics'
const page = await client.call(new GetDiagnosticProblems(posId, {
query: { state: 'open', page: 1, itemsPerPage: 30 },
}))
const problem = await client.call(new GetDiagnosticProblemDetails(problemId))
const explanation = describeDiagnostic(problem.operations[0]?.evidence ?? null, 'it')
const checked = await client.call(new VerifyDiagnosticProblem(problemId))
// Build this list from the operator's explicit selection, never every open row.
const input = { requestKey: crypto.randomUUID(), operations: selectedOperations }
const preview = await client.call(new PreviewDiagnosticRecovery(posId, input))
// Display eligibility before requesting recovery. The API revalidates again.
const receipt = await client.call(new RequestDiagnosticRecovery(posId, input))
重试提交时保留相同的请求密钥 其HTTP响应被丢失. 已提交的收件或已公布的队列消息 ; 刷新受影响的操作以观察其结果.
GetDiagnosticOverview 将问题计数与唯一受影响的操作区分开来
计数。 永远不要把它们加在一起。 单独核实的问题摘要报告
成功、手工操作和杰出工作:20个假期中的17个
即使在原原因得到纠正的情况下,仍未完成的操作.
VerifyDiagnosticProblem 使用共享冷却进行本地范围检查.
尊重范围、检查/过期时间和 fresh。当前本地绘图确实
无法证明远程可用性或订单交付。 刷新不会重试工作 .
CloseDiagnosticOperation 需要当前修订和不可放弃的理由.
手工处理不同于成功处理,并阻碍今后出口的再发送;
此初始 API 不曝光重开 。 不要用它来对付整个问题
当操作员只选择了一个受影响的操作时.
未知的查找方案成为无效证据和清晰 evidenceComplete。 。 。 .
未知的恢复动作变为无效和不合格的预览, 因此更新服务器
能力不能意外通过更老的客户端执行。 已知证据
保留原因/受影响/背景角色。 资源名称和撰写的说明
是纯文本; 与正常逃逸一起渲染, 绝不是 HTML 。 申请路线,
授权、控制和实时刷新仍为每个消费者所有.
describeDiagnostic, (中文(简体) ), describeVerification 财务报告和审定财务报表 diagnosticResourceName 提供
共享意大利语/英语演示文稿,无需React或MUI版本.
未识别代码得到不完全诊断解释. 这些初始
信件覆盖缺失的 Cassa 修改器映射和大象导入中断
或部分故障,加上分阶段同步超时、部分出错和
未证实完成。 这些解释描述了已知的流程结果,没有
声称有确认的根源。 与未来一起添加作者描述
贡献范围,而不是解析技术例外字符串.
操作行包括可选本地 context,独立于
失败的证据。 未知上下文类型变为无效; 客户端不能构造
来自未识别形状的资源链接. describeDiagnosticOperation 提供
意大利/英国订货标签 同步瞄准镜和进口 顺序标签
使用已授权的本地引用; 路线使用 resourceId从不导出
UUID 或任意的提供者 URL 。 缺少上下文可以读取遗留行 .
分阶段同步上下文可能包括 direction: inbound | outbound | null相对
给送货人 标签说明来源和目的地; 缺失的遗留值
保留“未记录的指令”。 方向是描述性的,从不重试
资格或更改本地同步设置.
diagnosticInvalidationRevision 只接受诊断事件信封
它所要求的POS。 修改为小数字符串以保存 PostgreSQL bigint
精细。 此事件没有结果或总数: 用它来连接重读,
不改变本地计数器。 重新连接并错过后调试快照
即使已经看到修改.
本地菜单验证结果提供特定字段, 作者为意大利语/ 英语 名称、说明、价格、税收、选择限制、图像和 参考文献。 它们确定出版资源而不假定是综合提供者 ID是本地目录UUID. 不完整的证据有自己的明确解释. 提交前的验证不得作为远程出版物确认.
这个 publication_validation 操作上下文识别本地版本
审定。 交付/收集背景资源有本地化标签。 外地
解释允许部分提交 :
报告部分除外。 验证成功绝不是出版成功.
问题援助
援助是人类与诊断问题的对话。 正在完成中
援助不能解决技术原因,不能结束行动,也不能重试.
GetDiagnosticAssistanceHistory 返回受约束的公共请求摘要;
GetDiagnosticAssistanceDetails 返回单独标定的公共时间线.
使用 RequestDiagnosticAssistance 拥有稳定 requestKey,以及
ReplyDiagnosticAssistance 拥有稳定 actionKey 和本订正本.
在HTTP结果不确定后,重新使用相同的钥匙和有效载荷. 冲突要求
重新装入请求; 不要默默生成新密钥并重复动作 .
行政消费者的使用 GetDiagnosticAssistanceInternal 私人笔记
和操作员身份,以及 UpdateDiagnosticAssistance 转让,公开
问题、完成和说明。 默认为 internal; 客户问题
需求 audience: 'public' 和一无所取. 无法选择客户回复
观众。 API 权限仍然具有权威性;导入行政权限
请求类不允许访问 。 公共计划带 意外的身份字段,
但API必须先排除私人事件,然后才标注和序列化.
这些端点返回明确绑定的对象而不是通用的 API 平台
藏书. 所有读取请求接受 page 财务报告和审定财务报表 itemsPerPage (最多100个).
GetDiagnosticAssistanceQueue 是单独的全球超级管理员元数据队列.
它默认打开请求,支持状态/任务/POS/整合过滤器,
并使用标准分解SDK结果. assignment: 'mine' 由
来自当前用户的 API. 队列中没有对话体 。 个人
对话读取,行动保留自己的源访问要求;
排队列不得视为授权能力.
Glovo 结构化的远程预加载验证用途 remote_menu_resource_*_invalid
叙事 这些识别提供者验证,而非本地验证或成功
出版物. remote_menu_validation_details_unavailable 明确报告
不完整的证据;无论是客户端还是共享副本都无法推断免费文本中的项目.
publication_receipt 操作上下文命名本地同步菜单上传.
menu_publication_* 指导区分被拒绝的内容、访问/牵引/配置
问题 供应商出错 限制和穷尽的民调 明确未知的结果
在另一个发送前需要核查。 这些描述并不意味着成功
用于另一个交易或提供不支持的重试能力.
常见 integration_* 发行代码有意大利语/英语解释
认证,权限, 缺少引用, 菜单验证, 拒绝的数据,
每日限制和通用进程故障。 说明已知的分类
即使其确切原因仍未证实。 指导没有发明破损
证书/资源或承诺自动收回。 未知代码保留
安全不完全诊断后退. diagnosticResourceName 接受可选选项
可读集成标签的源服务并翻译已知的操作
范围; 记录的名称/翻译保留相对于倒置标签的优先权.
行动可用性
运行 actions 载有独立的追回/人工关闭决定
evaluatedAt。 。 。 . describeDiagnosticActionAvailability 翻译已知原因
输入意大利语/英语。 未知或畸形可执行元数据解析为无效;
客户端必须禁用动作,直到验证可用性。 可用读取
咨询性:本地提交仍然检查权限、修订和状态.
产品绘图说明和区域资源名称
确认 catalog_product_mapping_missing 意大利语/英语
解释不同于修改失败和未经核实的通用代码.
名称偏好所请求的语言, 然后是匹配的区域目录语言
(接受低分数和BCP-47分隔符),在现有名称/语言之前
堕倒. 区域名称,例如: it_IT 财务报告和审定财务报表 en_GB 不得降解为UUID.
本地映射校正不是远程可用或自动恢复.
经确认的顶级变体和销售模式绘图故障已单独共享 意大利语/英语叙事. 他们不推断产品,付款或捆绑 错误。 未经验证的后遗症编码保留了不完全的后遗症. 运算符 在任何本地更正后,选择仍然明确.
确认 catalog_choice_mapping_missing 意大利语/英语
将选定的选择与其绘图的修改符区分开来的解释
组合。 资源快照确定组和顺序行,恢复后仍保留
明确的运算符选择。 未知或未经证实的证据保留了通用
不完全诊断倒计时.
Bundle 诊断法使用 准确拥有捆绑和修改器。 删除的修改/组成部分定义保留 历史顺序组名称并使用单独的叙事; 盲倒不是 以修复形式提出。 这些解释由Hub/Admin以意大利语和意大利语提供 英文,对未经证实的证据有一般的背书.
describeDiagnosticResourcePath 使用
与主要证据清单相同的本地化资源名称。 它返回无路径
失踪、模棱两可、骑自行车、无名或过深的祖先。 枢纽和管理员
在不解释资源名称的情况下,通过 React 使返回的纯文本生效
作为 HTML 或猜测目录链接.
本地核查副本区分了确认的持续的绘图模糊性 从无定论的重复绘图。 当前检查结果也解释了缺失的原因 制图、没有资源、证据不足、没有证据/没有证据 检查和改变证据。 未知原因使通用安全倒置 永远不要暴露原始原因 缺失的时间戳和陈旧证据优先 所有具体的建议。 这些解释都没有选择或提交追回.
要求的 " 交付 " 菜单工作使用共同的叙述入分点 暂停准备、 发送失败、 上传拒绝、 请求限制的代码, 成果不确定,以前提交文件尚待审查,以及需要审查的正面出版证据。 意大利语和 英文副本从不等于在本地状态下读取完成的恢复 国家或其他未解决的划界案仍未核实。 这些解释是 不启用重试能力; 客户端必须继续使用API的动作守护.
分阶段同步证据可包括 process_step 环境资源,
父为本地进程 。 仅包含记录的允许上市阶段
标识符。 共享标签翻译所有 CassaInCloud/ Tilby 步骤; 未知的未来
步骤显示中性倒置。 记录的阶段不是因果资源或
并不具备恢复能力.
CassaInCloud入境客户回收用途 sync_current_state意大利语和
英文确认 解释这创造了一个新的完整导入, 更新链接
客户,进口缺失的客户,保留之前的尝试. 还有
警告本地客户端更新可以触发其他已配置的同步.
解释从不选择或提交操作; 当前服务器资格
并且仍然需要明确的客户确认。 境外客户回收
且其他相机同步类型不得从其标签中继承这种能力.
资源标签重用本地的闭合同步镜词汇 配置上下文。 未命名进程资源使用本地化进程标签 并作简短的参考;持续的资源名称/译名仍然优先. 这样可以避免暴露出一个赤裸的流程UUID或英语范围密钥作为客户副本.
大象生命周期诊断 integration_lifecycle 操作环境
与整合/重新确定的范围。 意大利语/英语共同叙事
允许的列表操作代码和记录阶段。 未知的远程代码从未
成为作者的建议。 副本不等于已清除错误成功
激活或启用 API 不支持的重试 。 相位标签来自
封闭的原生矿井,与经核实的理由不同.
Tilby 预发订单结果使用马厩 tilby_seller_missing, (中文(简体) ),
tilby_department_mapping_missing, (中文(简体) ), tilby_product_mapping_missing_for_variant, (中文(简体) ),
tilby_variant_mapping_missing, (中文(简体) ), tilby_modifier_mapping_missing 财务报告和审定财务报表
tilby_choice_mapping_missing 密码. describeDiagnostic 共享用品英语
和意大利康复指导。 资源标签保存已保存的目录/顺序名称;
配置标识符有共享名称. 这些调查结果没有授权:
重试、 验证远程存在或覆盖不确定端对齐.
本地 Tilby 校验使用相同的通用校验信封
供养者. 卖方检查区分 configuration_missing 从
local_configuration_present;共享的IT/EN演示文稿明确指出:
本地校正既不工作,也不证明远程配置.
测绘检查保留现有测绘原因. 只有新鲜的本地结果
匹配结果/理由对收到此解释; 未知、 stale 或
远程结果保留了自己的倒数。 消费者必须分开
操作结果和明确的操作者选择.
蒂比的部分财政恢复说明其全部进口增值税/部门进口, 保存的人工绘图分辨率、不可改变的以往历史和单独的顺序 复原。 该解释由准确的原生源/动作对来解开.
供应商标签的使用 diagnosticServiceName 和可选服务理由 describeDiagnosticOperation。未知的服务没有响应。 接收服务元数据是无效的,并且是权限范围.
Tilby 受财政影响资源特性的使用 tilby:vat:<integer> 税收资源 tilby:departments:<integer> 用于配置资源。 共享的叙事使得其完整的外部ID带有IT/EN标签,而未将ID作为本地实体或被确认的原因处理.
已录制的 Tilby 菜单资源标签支持 tilby:categories:<integer>, (中文(简体) ), tilby:components:<integer> 财务报告和审定财务报表 tilby:products:<integer> 包括类别、配置和产品种类。 组件故意使用中性标签,而不是猜测本地映射是物品还是修饰.
选择的蒂比客户恢复使用 tilby_sync_customers 编号 : sync_current_state 说明在IT/EN中:完整的客户导入、保留历史、可能配置的下游更新和单独的订单回收.
已录入卡萨菜单资源使用情况 cassa_in_cloud:<step>:<uuid> 标识符。 共享资源展示支持类别,产品,复合产品,选项,部门和销售模式参考文献使用意大利语和英语,验证类型/步配对,并保持完整的外部UUID可见. 这些标识符不得用作本地目录链接或作为根本原因的证明.
已录制的 Tilby 菜单原因
describeDiagnostic 翻译稳定入境 tilby_menu_* 代码输入
意大利语/英语标题,历史解释和操作者接下来的步骤. 产品
引用可识别受影响的远程项目,而不是本地目录链接。 不支持
变异/组件案例不会推断出确切的修改或选择。 指南保存
当前状态验证分开, 并要求运算符选择回收动作
明确在纠正原因之后 未知的代码保留了共享的后退 .
在提供商的标签和准确度旁边显示抓取的蒂比产品名称 外部身份证明。 这些名字来自记录失败的尝试,而非当前 地图查取. 遗留的无名证据仍仅限身份证明. 标签为 文本; 在提供者名中的标记永远不会变成 HTML。 较新的失败 产品/理由可以在保留本地历史的同时更新显示的快照.
核查可包括可选 findings (最多100个输入结果)。 渲染器
与历史行动分开
证据。 一个 unknown/current_local_blockers 结果描述当前本地
配置而不重建历史失败。 一个
unknown/local_validation_passed 结果无法确认历史更正
或远程送货。 旧回应没有 findings 仍可读取.
只要吃一些回收用途 justeat_menu_submission 与
sync_current_state。共享的意大利语/英语确认语解释完整当前
分类出版物、保存的历史证据以及
请求接受、菜单生成和提供者确认的出版物。 未知
出版结果必须仍然不符合提交另一文件的资格;API拥有
资格和客户不得从这一解释性副本推断许可.
共享出版物的诊断方法使用提供者中性的措辞来表达
多重融合. menu_publication_queue_delivery_failed 描述一个
未证实的内部交货,而不是远程拒绝;其回收指导要求
支持在提交另一份文件之前核查操作.
厨房访问准备失败 kitchen_access_setup_failed 编辑
integration_lifecycle 上下文 access_setup 范围。 共享意大利语/英语
抄本解释 穷尽的陷害尝试 而不坚持技术根源
或现场设备连接。 公共证据不得含有证书
数值。 未知代码继续使用常见的安全倒置.
蒂尔比部门选择使用顺序中节省的税率. 有效的明示
产品部门优先;百分率回落需要完全一个
已经解决的整合部门. tilby_department_mapping_ambiguous
当多个部门相匹配时解释操作者动作. 仅核查
检查当地证据;它从不重复出口或证明交货.
Tilby 命令诊断包括 tilby_product_mapping_ambiguous 用于保留
产品映射,其标识不能安全授权销售书写。 显示
b. 共同叙述与地方 mapping_ambiguous 核查理由。 更正
本地原因不能证明已售出或授权自动重试; 保存
明确每个消费者的操作选择和恢复授权.
tilby_ingredient_mapping_unresolved 识别原始成分/成分
独立于变异/价值协会的关联。 使用共享
语法来命名所保存的成分,解释它不能被一个
相同名称的变异,并保留任何明确选择和授权的回收.
远程调查
问题细节可选择披露 remoteVerification:队列/运行/完成/超状态,请求/检查时间戳,新鲜度,和有边框的打字检查. VerifyDiagnosticProblem 队列支持只读调查;现有客户端和不支持的错误保留本地验证. 远程检查描述的是当前的观测,从来就没有历史因果关系,成功交付订单,或自动恢复. 使用 describeRemoteDiagnosticCheck 意大利语/英语解释。 未知的检查代码必须明确不支持 .
运行时间和编译器库
现有诊断运行时间 Object.hasOwn;消耗的运行时间必须提供它或者兼容的多填充. ES2021 TypeScript目标控制放出语法,不提供内置. 类型检查保存了 ES2021 默认库,仅添加 ES2022.Object 声明; 此编译器对齐不添加运行时间多填充 .