December 1New requirements for 5 groups: grocery products, animal feed, clothing and household linen, and 2 more · What to do
EN
Sign inTry for free

1C integration

Truemark API: UTDs and marking codes for the 1C add-on

Right now the Truemark API serves our 1C add-on: with a token, it gets UTDs and the marking code hierarchy without signing in with an electronic signature. Extending the API for large companies’ tasks is discussed on request.

3 methods
the UTD list, the document XML, the code hierarchy
120
requests per minute per token
OpenAPI
request and response descriptions in the account
0
certificates and CryptoPro in 1C

Methods

Three requests for accounting and the warehouse

Right now these requests are used by the Truemark add-on for 1C: the UTD list, the document XML and the code nesting. Need data for another system? Extending the API is discussed on request: tell us about the task. Choose a method to see the request and response.

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 LLC" },
    "count": 96,
    "isXmlReady": true
  }],
  "pagination": { "page": 1, "total": 48 }
}

Connecting

Token in a minute

Step by step with pictures: how to get an API token.

  1. 1

    Open the “API” tab

    Profile → “Settings” → “API” in the Truemark account

  2. 2

    Generate a token

    The full token is shown once: copy it into the 1C add-on

  3. 3

    Pass the token in the header

    Authorization: Bearer and the token itself. The service address is api.truemark.ru; requests start with /integration/v1.

  4. 4

    Open the documentation

    The “Documentation” button on the same tab: request parameters and response formats in the OpenAPI description

Security

  • Read onlyYou can’t order codes, put goods into circulation or sign a document with the token: such actions are only in the account
  • One tokenA company has one active token. “Regenerate” replaces it immediately; “Revoke” disables it.
  • Not stored in plain formTruemark stores the token’s checksum, so it can’t be shown a second time; you can only create a new one
  • You see who connects“Last used” in the account shows the date of the last request with the token
  • 120 requests per minuteThe limit per token; beyond it, the response “Request limit exceeded”
  • No certificateThe system doesn’t need to sign in with an electronic signature: signing and the exchange with Chestny ZNAK stay in Truemark

1C

1C connects with no programmer

1C has a ready add-on on the same API: download it on the “API” tab, paste the token, and UTDs with codes load into 1C. Six configurations, including 1C:Fresh.

  • UTD listmarked “Posted” in 1C
  • Document XMLsales document in 1C
  • Code hierarchypackages and units, barcodes in the 1C database

Custom development

Chestny ZNAK integrator: custom work for your process

Missing a feature? We are your outsourced development team: an official Chestny ZNAK integrator since 2019 will integrate with your systems and automate your business process.

Your own integration

Integrating directly: 1,488 pages of True API alone

You can connect your accounting system to Chestny ZNAK yourself. But you’ll have to understand the documentation of several systems and keep track of its changes.

I have to work through 1,488 pages of True API, and three more versions came out in November

Truemark

The rules change: Truemark gets updated, and UTDs with codes arrive in 1C via our add-on

To order codes, I’ll have to learn one more system, the OMS with its limits

Truemark

Code orders are already in Truemark: up to 1,000,000 codes and 500 GTINs in one order

I don’t want to deal with National Catalog cards and attributes, each group has its own

Truemark

Cards come in from the National Catalog on their own, with nothing to enter by hand

I still have to write the EDI exchange: UTDs, buyer titles, notices and corrections

Truemark

EDO Lite is on every plan: incoming UTDs appear on their own, outgoing ones are signed and sent from Truemark

I’m afraid I won’t keep track of CryptoPro, employee certificates and tokens GIS MT and OMS

Truemark

No electronic signature sign-in needed in 1C: signing and the exchange with Chestny ZNAK stay in Truemark

30,000 codes per document, order limits and dozens of error codes: all on me

Truemark

A million codes split into documents of 30,000 on their own, and reports are signed in a row

Volume: “True API description”, version 759.0, a PDF on docs.crpt.ru, November 2026.

Questions

Frequently asked questions

Didn’t find an answer? Write to us, and an expert will reply in 15 minutes on average. About the token: in the knowledge base.

What can the Truemark API do?

Right now the API serves our 1C add-on: with a token, it gets the company’s UTD list, the XML of a selected UTD and the marking code hierarchy, that is, what’s nested in pallets, boxes, group packages and sets.

Can I connect my own accounting system instead of 1C?

Right now the API is built for our 1C add-on. Extending it for large companies’ tasks is discussed on request: tell us what data you need and in which system.

Can I order codes or put goods into circulation via the API?

No. The token gives read-only access. Code orders, introduction into circulation and document signing are done in the Truemark account.

Where is the documentation?

On the “API” tab in the account settings, the “Documentation” button. It has request parameters and response formats in the OpenAPI description.

How do I pass the token?

In the Authorization header: the word Bearer and the token, separated by a space. The service address is https://api.truemark.ru; requests start with /integration/v1.

How many requests can I send?

Up to 120 requests per minute per token. Beyond that, the API responds “Request limit exceeded”.

Does the token expire?

No. The token works until you replace it with the “Regenerate” button or revoke it.

What does the code hierarchy request return?

For each code in the request: the nesting tree with the node type (unit, SSCC, KIGU, set), GTIN, status and owner in Chestny ZNAK, plus a summary of how many codes were resolved fully, partially and with an error.

Does the 1C integration work through this API?

Yes. The 1C add-on uses the same requests: the UTD list, the document XML and the code hierarchy.

Connect 1C to Truemark

The add-on and the token are on the “API” tab in the account settings. Need another system? Tell us about the task; extending the API is discussed on request. 7 days of full access for free.

Try for freeSales: +7 812 765-02-50 · info@truemark.ru

Or leave a request

We’ll answer about volumes, pricing and getting started. Leave your phone or email and your question in the request form.