Worker 原始文件

当某个产品的 tax_data_types 或 invoice_data_types 中包含 WORKER_RAW 时， 平台会开放该产品当前成功批次的 Worker 原始表格文件（通常是 XLSX）。

什么时候用

场景	建议
需要税局原始版式、留痕存档	WORKER_RAW
需要程序化消费字段	ALL 或 STANDARD
需要对平台加工结果做交叉验证	三者同选

WORKER_RAW 与 ALL / STANDARD 不互斥，可以同时选择。

在哪里拿到下载地址

订单查询、产品查询、组合结果接口和采集结束回调都会在 artifacts（文件清单）中列出：

{
  "dataDeliveryMode": "WORKER_RAW",
  "artifacts": [
    {
      "id": "artifact-id",
      "kind": "TAX_DATA",
      "filename": "001-tax-result.xlsx",
      "size": 102400,
      "sha256": "<64 位 SHA-256>",
      "downloadUrl": "https://rpa-api.xiaowu005.xyz/api/v1/channel/orders/BANK-20260812-0001/artifacts/artifact-id/download"
    }
  ]
}

kind 为 TAX_DATA 或 INVOICE_DATA。产品查询只返回属于该产品的文件。

下载

GET /api/v1/channel/orders/{external_order_id}/artifacts/{artifact_id}/download

与其他下载接口不同

Worker 原始文件的 downloadUrl 需要携带本渠道 X-Channel-Key。 PDF 报告和发票分片用的是自带签名的链接，不带请求头 —— 不要混淆。

curl -sS -L -o tax-result.xlsx -D headers.txt \
  "$RPA_BASE_URL/api/v1/channel/orders/BANK-20260812-0001/artifacts/artifact-id/download" \
  -H "X-Channel-Key: $RPA_CHANNEL_KEY"

grep -i x-content-sha256 headers.txt
shasum -a 256 tax-result.xlsx

响应头：

头	用途
X-Content-SHA256	文件内容 SHA-256，下载后必须校验
ETag	与 SHA-256 一致的强校验标签
Accept-Ranges: bytes	支持断点续传
Cache-Control: private, no-store	禁止缓存

开放范围

平台只开放当前有效批次中与本单采集范围匹配的数据文件。以下内容不会开放：

• MANIFEST 清单文件
• 诊断日志
• 未通过质量检查而被隔离的发票文件

保留期与过期

文件随本订单的 data_retention_days 到期清理。数据库记录仍在但文件已清理时， 接口返回 HTTP 410 RAW_ARTIFACT_EXPIRED。

HTTP	code	含义
404	CHANNEL_ORDER_NOT_FOUND	订单不存在
404	RAW_ARTIFACT_NOT_AVAILABLE	该文件不在本单开放范围内
410	RAW_ARTIFACT_EXPIRED	文件已按保留期清理

需要长期留存就自己存

如果业务要求长期保留原始表格，应在采集完成后尽快下载并转存到自己的存储， 不要依赖平台的保留期。需要更长窗口时，在创建授权时把 data_retention_days 调大（最大 365 天）。

与 SM4 加密的关系

output_encryption=SM4 只加密 JSON 响应与回调信封， 不改写原始表格文件的字节。下载得到的仍是可直接打开的 XLSX。