1 tháng 12Yêu cầu mới cho 5 nhóm: sản phẩm tạp hóa, thức ăn cho vật nuôi, quần áo và đồ vải gia dụng, và 2 nhóm khác · Cần làm gì
VI
Đăng nhậpDùng thử miễn phí

Tích hợp với 1C

API của Truemark: UTD và mã đánh dấu cho tiện ích 1C

Hiện API của Truemark phục vụ tiện ích 1C của chúng tôi: bằng token, tiện ích nhận UTD và cấu trúc mã đánh dấu mà không cần đăng nhập bằng chữ ký điện tử. Việc mở rộng API cho nhu cầu của các công ty lớn được trao đổi theo yêu cầu.

3 phương thức
danh sách UTD, XML của chứng từ, cấu trúc mã
120
truy vấn mỗi phút trên một token
OpenAPI
mô tả truy vấn và phản hồi trong tài khoản
0
chứng thư số và CryptoPro trong 1C

Phương thức

Ba truy vấn cho kế toán và kho

Hiện các truy vấn này được dùng bởi tiện ích Truemark cho 1C: danh sách UTD, XML của chứng từ và cấu trúc lồng nhau của mã. Cần dữ liệu cho hệ thống khác? Việc mở rộng API được trao đổi theo yêu cầu: hãy cho biết nhiệm vụ của bạn. Chọn một phương thức để xem truy vấn và phản hồi.

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": "Công ty TNHH Baltika Opt" },
    "count": 96,
    "isXmlReady": true
  }],
  "pagination": { "page": 1, "total": 48 }
}

Kết nối

Token trong một phút

Từng bước có hình minh họa: cách lấy token API.

  1. 1

    Mở thẻ “API”

    Hồ sơ → “Cài đặt” → “API” trong tài khoản Truemark

  2. 2

    Tạo token

    Token đầy đủ chỉ hiển thị một lần: hãy sao chép vào tiện ích 1C

  3. 3

    Truyền token trong tiêu đề

    Authorization: Bearer và chính token. Địa chỉ dịch vụ là api.truemark.ru, các truy vấn bắt đầu bằng /integration/v1.

  4. 4

    Mở tài liệu

    Nút “Tài liệu” trên cùng thẻ đó: tham số truy vấn và định dạng phản hồi trong bản mô tả OpenAPI

Bảo mật

  • Chỉ đọcKhông thể đặt mã, đưa hàng vào lưu thông hay ký chứng từ bằng token: các thao tác đó chỉ làm trong tài khoản
  • Một tokenMỗi công ty có một token còn hiệu lực. “Tạo lại” thay token ngay lập tức, “Thu hồi” vô hiệu hóa token.
  • Không lưu ở dạng mởTruemark lưu tổng kiểm tra của token, nên không thể hiển thị token lần thứ hai, chỉ có thể tạo token mới
  • Biết ai đang truy cập“Lần dùng gần nhất” trong tài khoản cho biết ngày của truy vấn gần nhất bằng token
  • 120 truy vấn mỗi phútGiới hạn cho một token; vượt quá thì phản hồi là “Đã vượt giới hạn truy vấn”
  • Không cần chứng thư sốHệ thống không cần đăng nhập bằng chữ ký điện tử: việc ký và trao đổi với Chestny ZNAK vẫn nằm trong Truemark

1C

1C kết nối không cần lập trình viên

Đã có sẵn tiện ích cho 1C trên cùng API: tải tiện ích ở thẻ “API”, dán token, và UTD có mã được tải vào 1C. Sáu cấu hình, trong đó có 1C:Fresh.

  • Danh sách UTDcó nhãn “Đã ghi sổ” trong 1C
  • XML của chứng từchứng từ bán hàng trong 1C
  • Cấu trúc mãbao bì và đơn chiếc, mã vạch trong cơ sở dữ liệu 1C

Phát triển theo yêu cầu

Đơn vị tích hợp của Chestny ZNAK: phát triển theo quy trình của bạn

Thiếu tính năng? Chúng tôi là đội ngũ phát triển thuê ngoài của bạn: đơn vị tích hợp chính thức của Chestny ZNAK từ năm 2019 sẽ tích hợp với hệ thống của bạn và tự động hóa quy trình kinh doanh của bạn.

Tích hợp tự làm

Tích hợp trực tiếp: 1.488 trang chỉ riêng True API

Bạn có thể tự kết nối hệ thống kế toán với Chestny ZNAK. Nhưng sẽ phải tìm hiểu tài liệu của nhiều hệ thống và theo dõi khi tài liệu thay đổi.

Tôi phải đọc 1.488 trang True API, trong khi tháng 11 lại có thêm ba phiên bản

Truemark

Quy định thay đổi: Truemark được cập nhật, còn UTD có mã về 1C qua tiện ích của chúng tôi

Để đặt mã, tôi phải học thêm một hệ thống nữa là OMS với các giới hạn của nó

Truemark

Đặt mã đã có trong Truemark: tối đa 1.000.000 mã và 500 GTIN trong một đơn hàng

Tôi không muốn mất công với thẻ sản phẩm và thuộc tính của Danh mục Quốc gia, mỗi nhóm một kiểu

Truemark

Thẻ sản phẩm từ Danh mục Quốc gia tự được tải về, không cần nhập tay

Tôi còn phải viết phần trao đổi EDI: UTD, phần ký của người mua, thông báo và bản sửa

Truemark

EDO Lite có trong mọi gói cước: UTD đến tự xuất hiện, UTD gửi đi được ký và gửi từ Truemark

Tôi sợ không theo kịp CryptoPro, chứng thư số của nhân viên và token GIS MT và OMS

Truemark

Không cần đăng nhập bằng chữ ký điện tử trong 1C: việc ký và trao đổi với Chestny ZNAK vẫn nằm trong Truemark

30.000 mã mỗi chứng từ, giới hạn đơn hàng và hàng chục mã lỗi: tất cả đều do tôi lo

Truemark

Một triệu mã tự chia thành các chứng từ 30.000 mã, và các báo cáo được ký liên tiếp

Số trang: theo “Mô tả True API”, phiên bản 759.0, tệp PDF trên docs.crpt.ru, tháng 11 năm 2026.

Câu hỏi

Câu hỏi thường gặp

Chưa tìm thấy câu trả lời? Hãy nhắn cho chúng tôi, chuyên gia sẽ trả lời trung bình trong 15 phút. Về token: trong cơ sở kiến thức.

API của Truemark làm được gì?

Hiện API phục vụ tiện ích 1C của chúng tôi: bằng token, tiện ích nhận danh sách UTD của công ty, XML của UTD đã chọn và cấu trúc mã đánh dấu, tức là những gì nằm trong pallet, thùng, bao bì nhóm và bộ sản phẩm.

Có thể kết nối hệ thống kế toán của riêng tôi thay cho 1C không?

Hiện API được làm cho tiện ích 1C của chúng tôi. Việc mở rộng cho nhu cầu của các công ty lớn được trao đổi theo yêu cầu: hãy cho biết bạn cần dữ liệu gì và cho hệ thống nào.

Có thể đặt mã hoặc đưa hàng vào lưu thông qua API không?

Không. Token chỉ cho quyền đọc. Đặt mã, đưa vào lưu thông và ký chứng từ được thực hiện trong tài khoản Truemark.

Tài liệu ở đâu?

Ở thẻ “API” trong cài đặt tài khoản, nút “Tài liệu”. Ở đó có tham số truy vấn và định dạng phản hồi trong bản mô tả OpenAPI.

Truyền token thế nào?

Trong tiêu đề Authorization: từ Bearer và token, cách nhau một dấu cách. Địa chỉ dịch vụ là https://api.truemark.ru, các truy vấn bắt đầu bằng /integration/v1.

Có thể gửi bao nhiêu truy vấn?

Tối đa 120 truy vấn mỗi phút trên một token. Vượt quá mức đó, API phản hồi “Đã vượt giới hạn truy vấn”.

Token có thời hạn không?

Không. Token hoạt động cho đến khi bạn thay bằng nút “Tạo lại” hoặc thu hồi.

Truy vấn cấu trúc mã trả về gì?

Với mỗi mã trong truy vấn: cây lồng nhau với loại nút (đơn chiếc, SSCC, KIGU, bộ sản phẩm), GTIN, trạng thái và chủ sở hữu trong Chestny ZNAK, cùng bản tóm tắt: bao nhiêu mã được phân tích đầy đủ, một phần và có lỗi.

Tích hợp với 1C có chạy qua API này không?

Có. Tiện ích cho 1C dùng cùng các truy vấn đó: danh sách UTD, XML của chứng từ và cấu trúc mã.

Kết nối 1C với Truemark

Tiện ích và token nằm ở thẻ “API” trong cài đặt tài khoản. Cần hệ thống khác? Hãy cho biết nhiệm vụ của bạn, việc mở rộng API được trao đổi theo yêu cầu. 7 ngày dùng đầy đủ miễn phí.

Dùng thử miễn phíBộ phận kinh doanh: +7 812 765-02-50 · info@truemark.ru

Hoặc để lại yêu cầu

Chúng tôi sẽ trả lời về khối lượng, gói cước và cách kết nối. Hãy để lại số điện thoại hoặc email và câu hỏi trong biểu mẫu yêu cầu.