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?authorization_id=…&expires=…&signature=…",
      "downloadExpiresAt": "2026-09-08 18:45:00",
      "dataExpiresAt": "2026-10-08 18:30:00"
    }
  ]
}

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

下载

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

1.5.29 起可直接下载

downloadUrl 自带短期签名，可直接在浏览器打开或用客户端 GET，无需渠道请求头。 完整保留 authorization_id、expires、signature，不要自行拼接或改写。

curl -f -sS -L -o tax-result.xlsx -D headers.txt "$RAW_ARTIFACT_DOWNLOAD_URL"

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

RAW_ARTIFACT_DOWNLOAD_URL 填入鉴权订单查询返回的完整 artifacts[].downloadUrl。地址最长有效 15 分钟，且不超过资料截止时间；失效后重新鉴权查询订单获取新地址。

旧的不带签名地址仍需 X-Channel-Key。只要提交任一签名参数，就必须提供完整有效的签名，不会因带了 Key 而忽略无效签名。当前生产与测试均已支持签名下载，见环境范围。

响应头：

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

开放范围

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

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

保留期与过期

新策略订单的资料到期后立即停止读取，返回 410 ORDER_DATA_ACCESS_EXPIRED；后台按周期清理文件。数据库记录仍在但文件已清理时返回 410 RAW_ARTIFACT_EXPIRED。历史订单兼容规则及三类期限见期限说明。

HTTP	code	含义
403	RAW_ARTIFACT_LINK_EXPIRED	签名不完整、无效或过期，重新查询订单获取完整地址
410	ORDER_DATA_ACCESS_EXPIRED / ORDER_DATA_ACCESS_REVOKED	资料到期或权限撤销，刷新地址不会恢复权限
404	CHANNEL_ORDER_NOT_FOUND	订单不存在
404	RAW_ARTIFACT_NOT_AVAILABLE	该文件不在本单开放范围内
410	RAW_ARTIFACT_EXPIRED	文件已按保留期清理

需要长期留存就自己存

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

与 SM4 加密的关系

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