12月1日5 个商品组的新要求:干货食品、动物饲料、服装和家用纺织品等 5 个商品组 · 需要做什么
ZH
登录免费试用

与 1C 集成

Truemark API:供 1C 外部处理程序使用的 UTD 和标识码

目前 Truemark API 为我们的 1C 外部处理程序服务:它凭令牌获取 UTD 和标识码层级,无需电子签名登录。面向大型企业的 API 扩展可按需洽谈。

3 个方法
UTD 列表、单据 XML、标识码层级
120
每个令牌每分钟的请求数
OpenAPI
账户中有请求和响应的说明
0
1C 中的证书和 CryptoPro

方法

三个请求用于记账和仓储

目前使用这些请求的是 Truemark 的 1C 外部处理程序:UTD 列表、单据 XML 和标识码嵌套结构。如需为其他系统提供数据,API 扩展可按需洽谈,请告诉我们您的任务。选择一个方法,查看请求和响应。

GET /integration/v1/upd
GET https://api.truemark.ru/integration/v1/upd?page=1
Authorization: Bearer ••••••••••••••••

200 OK
{
  "data": [{
    "id": 1022,
    "number": "UTD-1022",
    "date": "2026-11-20",
    "counterparty": { "name": "Baltika Opt 有限公司" },
    "count": 96,
    "isXmlReady": true
  }],
  "pagination": { "page": 1, "total": 48 }
}

接入

令牌一分钟搞定

带图的分步说明见如何获取 API 令牌。

  1. 1

    打开“API”标签页

    在 Truemark 账户中:个人资料 →“设置”→“API”

  2. 2

    生成令牌

    完整令牌只显示一次:请把它复制到 1C 外部处理程序中

  3. 3

    在请求头中传递令牌

    Authorization: Bearer 加令牌本身。服务地址为 api.truemark.ru,请求以 /integration/v1 开头。

  4. 4

    打开文档

    同一标签页上的“文档”按钮:OpenAPI 说明中有请求参数和响应格式

安全

  • 只读凭令牌无法订购标识码、将商品投入流通或签署单据:这些操作只能在账户中完成
  • 一个令牌每家公司只有一个有效令牌。“重新生成”会立即替换,“撤销”会将其停用。
  • 不以明文存储Truemark 只存储令牌的校验和,因此无法再次显示,只能创建新的
  • 谁在调用一目了然账户中的“最后使用”显示最近一次使用令牌请求的日期
  • 每分钟 120 次请求每个令牌的上限,超出后返回“请求次数超出限制”
  • 无需证书系统不需要电子签名登录:签署和与 Chestny ZNAK 的数据交换都留在 Truemark 中

1C

1C 接入无需程序员

基于同一 API 的 1C 外部处理程序已就绪:在“API”标签页下载,粘贴令牌,含标识码的 UTD 就会加载到 1C。支持六种配置,包括 1C:Fresh。

  • UTD 列表在 1C 中标注“已入账”
  • 单据 XML1C 中的销售单据
  • 标识码层级包装和单件,条码进入 1C 数据库

为您定制开发

Chestny ZNAK 集成商:按您的流程定制开发

缺少某个功能?我们就是您的外包开发团队:自 2019 年起的 Chestny ZNAK 官方集成商,会对接您的系统,并实现您业务流程的自动化。

自建集成

直接集成:光 True API 就有 1,488 页

自己把记账系统接入 Chestny ZNAK 是可以的。但要弄懂好几个系统的文档,还要跟进它们的变化。

我得啃完 1,488 页 True API 文档,而 11 月又出了三个新版本

Truemark

规则变了:更新的是 Truemark,含标识码的 UTD 通过我们的外部处理程序进入 1C

订购标识码还得掌握另一个系统:OMS 及其各种限额

Truemark

在 Truemark 中已经可以订购标识码:最多 1,000,000 个标识码和 500 个 GTIN 一个订单搞定

不想研究国家目录的卡片和属性,每个商品组都不一样

Truemark

商品卡片自动从国家目录同步,无需手动录入

我还得开发 EDI 交换:UTD、买方签署部分、通知和修正

Truemark

所有套餐都包含 EDO Lite:来件 UTD 自动出现,发出的 UTD 在 Truemark 中签署并发送

我怕顾不过来 CryptoPro、员工证书和令牌 GIS MT 和 OMS

Truemark

1C 中不需要电子签名登录:签署和与 Chestny ZNAK 的数据交换都留在 Truemark 中

每份单据 30,000 个标识码,订单限额和几十种错误代码,全都得自己处理

Truemark

一百万个标识码自动拆分成每份 30,000 个的单据,报告连续签署

篇幅依据《True API 说明》759.0 版,docs.crpt.ru 上的 PDF,2026 年 11 月。

问题

常见问题

没找到答案?请给我们留言,专家平均 15 分钟内回复。关于令牌见知识库。

Truemark API 能做什么?

目前 API 为我们的 1C 外部处理程序服务:它凭令牌获取公司的 UTD 列表、所选 UTD 的 XML 以及标识码层级,即托盘、箱、组包装和套装里装了什么。

可以接入自己的记账系统而不是 1C 吗?

目前 API 是为我们的 1C 外部处理程序设计的。面向大型企业的扩展可按需洽谈:请告诉我们需要哪些数据、接入哪个系统。

可以通过 API 订购标识码或将商品投入流通吗?

不可以。凭令牌只能读取。订购标识码、投入流通和签署单据都在 Truemark 账户中完成。

文档在哪里?

在账户设置的“API”标签页,点击“文档”按钮。那里有 OpenAPI 说明中的请求参数和响应格式。

如何传递令牌?

在 Authorization 请求头中:Bearer 一词,空格后接令牌。服务地址为 https://api.truemark.ru,请求以 /integration/v1 开头。

可以发送多少请求?

每个令牌每分钟最多 120 次请求。超出后 API 返回“请求次数超出限制”。

令牌有有效期吗?

没有。令牌一直有效,直到您用“重新生成”按钮替换或将其撤销。

标识码层级请求返回什么?

对请求中的每个标识码返回嵌套树,包含节点类型(单件、SSCC、KIGU、套装)、GTIN、在 Chestny ZNAK 中的状态和所有者,还有汇总:多少标识码完整解析、部分解析和出错。

1C 集成是基于这个 API 运行的吗?

是的。1C 外部处理程序使用同样的请求:UTD 列表、单据 XML 和标识码层级。

把 1C 接入 Truemark

外部处理程序和令牌在账户设置的“API”标签页。需要接入其他系统,请告诉我们您的任务,API 扩展可按需洽谈。7 天完整功能免费试用。

免费试用销售部:+7 812 765-02-50 · info@truemark.ru

或者提交咨询

我们会解答数量、套餐和接入方面的问题。在咨询窗口留下电话或邮箱以及您的问题。