API - Xtrace

Marking Code Order Interface (MCOI)

The Marking Code Order Interface (MCOI) is designed for interaction between product turnover participants (UOT) and the Marking Information System, enabling the following operations with marking codes (MC):

• Registration of orders for the issuance (generation) of MCs, including their transfer to service providers;
• Retrieval (export) of MCs from registered issuance orders;
• Closing of MC issuance orders;
• Viewing and searching for MC issuance orders registered by UOT, including those created through a service provider;
• Registration of reports on MC-related operations, including print quality assessment (validation) of digital identification means, application (use) of MCs, aggregation of marked goods, etc.;
• Searching and viewing registered reports (operations) with MCs, including those registered through a service provider.

To interact with MCOI via API, UOT must log into their Personal Account and create a user (more details on adding a user) with the "technical" type (link to technical user) and define their access rights (more details on assigning roles to a user).

Typical Sequence of MCOI API Calls for Product Marking and Aggregation Processes

1. User authorization;
2. Registration of an MC issuance order;
3. Checking the status of the MC issuance order;
4. Retrieval of ordered MCs;
5. Registration of a report on print quality assessment (validation) of digital identification means;
6. Registration of a report on MC application;
7. Registration of a report on the aggregation of marked goods.

Key Changes

• Authorization scheme updated
• Structure and field names adjusted
• Field composition revised (marking mode added to the order form, country of production moved to the application report form)