TT GIS v21 API Description Contents Revision History ......................................................................................................................... 5 List of Acronyms and Abbreviations .......................................................................................... 9 1. General provisions ................................................................................................................ 11 1.1. Principles of Interaction with API ................................................................................. 11 1.1.1. Requirements for Exchange Files ........................................................................... 13 1.1.1.1. Responses from TT GIS REST API may contain additional utility json attributes which are not specified in documentation. Unknown attributes shall be ignored. ......................................................................................................................... 14 1.1.1.2. Maximum size of the document to be transmitted via API shall not exceed 30 megabytes. .................................................................................................................... 14 1.1.1.3. All attribute values in JSON and CSV formats expressed in money terms (prices, taxes etc.) are set in kopecks without delimiters.............................................. 14 1.1.2. Screening................................................................................................................. 14 1.1.3. Type of Content to be Returned by API Methods .................................................. 15 1.2. Authentication ................................................................................................................ 15 1.2.1. Request for Authorisation ....................................................................................... 16 1.2.2. Receiving an Authentication Token........................................................................ 16 2. Methods................................................................................................................................. 18 2.1. General Methods ............................................................................................................ 18 2.1.1. Method of receiving the MC list with detailed information on MC using set filter 18 2.1.2. Method of receiving detailed information on a certain MC (GET) ........................ 27 2.1.3. Method of receiving the list of goods using set filter ............................................. 33 2.1.4. Method of receiving brief information on IC\IC list (public) ................................. 42 2.1.5. Method of receiving the IC list by identifier .......................................................... 47 2.1.6. Method of receiving information on goods item by Goods code ........................... 50 2.1.7. Catalog on CMG ..................................................................................................... 53 2.1.8. Catalog on CMG with additional parameters from TT GIS and FCS .................... 57 2.1.9. Method of receiving the list of documents pre-loaded in TT GIS .......................... 60 2.1.10. Method for searching a receipt by identifier ......................................................... 64 2.1.11. Method for searching a receipt body by identifier ................................................ 68 2.1.12. Method of receiving the list of receipts pre-loaded in TT GIS ............................. 72
223
Embed
Track and Trace Government Information System API v18žписание+API.+Release_16.2_en.pdf · 4 1 General Provisions 1.1 Principles of Interaction with API Interaction of goods
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
TT GIS v21 API Description
Contents Revision History ......................................................................................................................... 5 List of Acronyms and Abbreviations .......................................................................................... 9 1. General provisions ................................................................................................................ 11
1.1. Principles of Interaction with API ................................................................................. 11 1.1.1. Requirements for Exchange Files ........................................................................... 13
1.1.1.1. Responses from TT GIS REST API may contain additional utility json attributes which are not specified in documentation. Unknown attributes shall be ignored. ......................................................................................................................... 14 1.1.1.2. Maximum size of the document to be transmitted via API shall not exceed 30 megabytes. .................................................................................................................... 14 1.1.1.3. All attribute values in JSON and CSV formats expressed in money terms (prices, taxes etc.) are set in kopecks without delimiters. ............................................. 14
1.1.2. Screening................................................................................................................. 14 1.1.3. Type of Content to be Returned by API Methods .................................................. 15
1.2. Authentication ................................................................................................................ 15 1.2.1. Request for Authorisation ....................................................................................... 16 1.2.2. Receiving an Authentication Token ........................................................................ 16
2. Methods................................................................................................................................. 18 2.1. General Methods ............................................................................................................ 18
2.1.1. Method of receiving the MC list with detailed information on MC using set filter 18 2.1.2. Method of receiving detailed information on a certain MC (GET) ........................ 27 2.1.3. Method of receiving the list of goods using set filter ............................................. 33 2.1.4. Method of receiving brief information on IC\IC list (public) ................................. 42 2.1.5. Method of receiving the IC list by identifier .......................................................... 47 2.1.6. Method of receiving information on goods item by Goods code ........................... 50 2.1.7. Catalog on CMG ..................................................................................................... 53 2.1.8. Catalog on CMG with additional parameters from TT GIS and FCS .................... 57 2.1.9. Method of receiving the list of documents pre-loaded in TT GIS .......................... 60 2.1.10. Method for searching a receipt by identifier ......................................................... 64 2.1.11. Method for searching a receipt body by identifier ................................................ 68 2.1.12. Method of receiving the list of receipts pre-loaded in TT GIS ............................. 72
2
2.1.13. Method of receiving the content of document pre-loaded in TT GIS ................... 76 2.1.14. Method of receiving the list of goods using document number ............................ 80 2.1.15. Method of receiving the list of 10-digit FEACN codes ........................................ 83 2.1.16. Method of generating consent to provision of information on marking codes for non-owners ........................................................................................................................ 84 2.1.17. Method of document cancellation based on the current published consent document ........................................................................................................................... 85 2.1.18. Method of receiving the information on MC according to the MC list with prior consent .............................................................................................................................. 86 2.1.19. Method of receiving the information on marked goods ........................................ 88 2.1.20. Method of receiving the information on marked goods by MC beginning .......... 94 2.1.21. Method of receiving the list of goods using document number .......................... 101 2.1.22. Method of receiving the list of obtained MC with filter option .......................... 104 2.1.23. Method of receiving the number obtained MC with filter option ....................... 110 2.1.24. Method of receiving the list of transferred MC with filter option ...................... 112 2.1.25. Method of receiving the number of transferred MC with filter option ............... 118 2.1.26. Requesting information on goods circulation participant by INN ...................... 120 2.1.27. Method of receiving the information on identification means by MC beginning......................................................................................................................... 122 2.1.28. Method of receiving MC and all internal MC .................................................... 128 2.1.29. Method of receiving the information on identification tool (POST) .................. 130 Method of receiving the number of MC with filter option ............................................. 136 2.1.31. Method of receiving IC by identifier .................................................................. 139 2.1.32. Method of receiving the number of MC with filter option ................................. 142 2.1.33. Method of receiving the list of MC using document number ............................. 144 2.1.34. Method of searching document content by document identifier ........................ 144
2.2. Document Methods ...................................................................................................... 145 2.2.1. Single method of document creation .................................................................... 145 2.2.2. Description of remains .......................................................................................... 147 2.2.3. Aggregation........................................................................................................... 149
2.2.4. Introduction into circulation ................................................................................. 154 2.2.4.1. Introduction into circulation. Manufacture in the Russian Federation .......... 154
3
2.2.4.2. Introduction into circulation. Received from individuals. ............................. 157 2.2.4.3. Introduction into circulation. Manufacturing outside of EEU ....................... 158 2.2.4.4. Introduction into circulation. Cross-border trading ....................................... 161 2.2.4.5. Introduction into circulation. In the territory of EEU countries (contract manufacturing) ............................................................................................................ 164 2.2.4.6. Introduction into circulation. Remains marking ............................................ 167 2.2.4.7. Introduction into circulation. Contract manufacturing in the Russian Federation..................................................................................................................................... 169 2.2.4.8. Introduction into circulation. Import with FCS ............................................. 171
2.2.5. ACC aggregation .................................................................................................. 174 2.2.6. ACC reaggregation ............................................................................................... 176 2.2.7. ACC disaggregation .............................................................................................. 177 2.2.8. Return into circulation .......................................................................................... 178 2.2.9. Shipping ................................................................................................................ 182 2.2.10. Shipping with withdrawal from circulation ........................................................ 183 2.2.11. Shipment at cross-border trading ........................................................................ 186 2.2.12. Cancelling shipment ............................................................................................ 188 2.2.13. Cancelling shipment at cross-border trading ...................................................... 188 2.2.14. Acceptance .......................................................................................................... 189 2.2.15. Withdrawal from circulation ............................................................................... 192 2.2.16. Writing off MC ................................................................................................... 197
2.2.16.1. Writing off not applied MCs ........................................................................ 197 2.2.16.2. Writing off applied MCs .............................................................................. 199
2.2.17. Remarking ........................................................................................................... 201 2.2.18. UTD for shipment ............................................................................................... 205 2.2.19. Automatic introduction into circulation. OMS ................................................... 205 2.2.20. MC order. OMS .................................................................................................. 205
3. Reference books .................................................................................................................. 206 3.1. Catalogue - List of supported product groups.............................................................. 206 3.2. Catalogue - Types of documents .................................................................................. 206 3.3. Catalogue - MC statuses .............................................................................................. 211 3.4. Catalogue - Types of production .................................................................................. 212 3.5. Catalogue - Types of packing ...................................................................................... 212 3.6. Catalogue - Order statuses ........................................................................................... 213 3.7. Catalogue - Document statuses .................................................................................... 213
4
3.8. Catalogue - Response statuses ..................................................................................... 213 3.9. Catalogue - Types of organisations .............................................................................. 215 3.10. Catalogue - GCP statuses ........................................................................................... 215 3.11. Catalogue - Statuses of request for GCP registration ................................................ 216 3.12. Catalogue - Document statuses in SD life cycle ........................................................ 216 3.13. Catalogue - Status model ........................................................................................... 216 3.14. Catalogue - Additional parameters for PG ................................................................. 217
3.14.1. Additional parameters for PG ’Footwear’ .......................................................... 217 3.14.2. Additional parameters for PG ‘Clothing, bed linen, table linen, bath and kitchen linen’ ............................................................................................................................... 218 3.14.3. Additional parameters for PG ‘Photo cameras (except for cine cameras), flash lights and flash bulbs’ ..................................................................................................... 218 3.14.4. Additional parameters for PG ‘Bicycles and bicycle frames’ ............................ 218 3.14.5. Additional parameters for PG ’Wheelchairs’ ..................................................... 219 3.14.6. Additional parameters for PG ‘Perfume and eau de toilette’ .............................. 219 3.14.7. Additional parameters for PG ‘New pneumatic rubber tires and tire casings’ ... 219 3.14.8. Additional parameters for PG ‘Dairy products’ .................................................. 220
4. Examples of authentication with EQES / Signing of documents ....................................... 221 4.1. Example of token receiving during authorisation with attached signature / signing of documents with detached signature in 1C .......................................................................... 221 4.2. Example of token receiving during authorisation via REACT JS. .............................. 222 4.3. Example of token receiving during authorisation with attached signature / signing of documents with detached signature via Java. ..................................................................... 222 4.4. Description of plug-in methods: .................................................................................. 223
5
Revision History Date Version Changes
20.03.2020 17 Initial version
13.04.2020 18 Mandatory status was changed for the ’cancelling shipment’ document
Method of obtaining the list of receipts pre-loaded in TT GIS (para. 2.1.10);
Obtaining the IC list by identifier (para. 2.1.6);
Introduction into circulation. Cross-border trading (contract manufacturing) (para. 2.2.5.5).
Changed Remarking method.
Added Drinking Water PG.
Added packings: package.
Added reason of withdrawal from circulation: ‘Errors in goods description found’.
Described types of primary document.
24.04.2020 18.1 Added the following methods:
Method of consent document creation (para. 2.1.13);
Method of cancellation document creation based on the current published consent document (para. 2.1.14);
Method of obtaining information on the MC according to MC list (para. 2.1.15).
Renamed method Introduction into circulation. ‘Cross-border trade’ (contract production) to ‘Introduction into circulation’. In the territory of EEU countries (contract production) cl.2.2.5.5
Added List of Acronyms and Abbreviations Used in Description of TT GIS API Documentation.
10.06.2020 18.2 productGroup parameter is added to the reply for the following methods: - Method of receiving the MC list with detailed information on MC using set filter; - [Method of receiving detailed information on a certain MC]; - Method of receiving brief information on IC\IC list (public); - Method of receiving the IC list by identifier; - Method of receiving the information on marked goods.
The following methods are added: - Method of receiving the information on MC according to the MC list with prior consent; - Method of receiving the information on marked goods; - Method of receiving the information on marked goods by MC beginning; - Method of receiving the list of obtained MC with filter option; - Method of receiving the number obtained MC with filter option; - Method of receiving the list of transferred MC with filter option; - Method of receiving the number of transferred MC with filter option; - Shipment at cross-border trading; - Cancelling shipment at cross-border trading; - Introduction into circulation. Import with FCS; - ACC Generation; - Disaggregation of ACC; - ACC reaggregation.
Added ‘DISAGGREGATION’ status for method Method of receiving the MC list with detailed information on MC using set filter.
6
Date Version Changes
Added ‘lastDocType’ parameter for method Method of receiving detailed information on a certain MC. Added ‘CONFORMITY_CERTIFICATE_OR_DECLARATION’ value for ‘certificateType’ parameter. Deleted recursion for ‘childrenMap’ and ‘childrenDetails’ parameters. Added description ‘Method is available only for EEU operators’ for methods with cross-border trading description. Added ‘TurnoverType’ parameter for method Method of receiving the IC list by identifier. Added Catalogue - List of supported product groups. Added link to the catalog in description for ‘productGroup’ parameter. Deleted ‘offset’ parameter for method Method of receiving the list of 10-digit FEACN codes. Added parameters for method Method of receiving the content of document pre-loaded in TT GIS. Added ‘name’ parameter for document type ’Reaggregation’. Added PG restriction for document type ’Remarking’. cisChildren parameter added for the following methods: Method of receiving the MC list with detailed information on MC using set filter; Method of receiving the list of goods by the set filter; Method of receiving the list of obtained MC with filter option; Method of receiving the list of transferred MC with filter option.
Changed response parameters for method Method of receiving the information on marked goods. Added Examples of authentication with EQES / Signing of documents. Added request parameters for method Method of receiving the MC list with detailed information on MC using set filter. Replaced ‘clothes’ designation with ‘lp’ designation for ‘Clothing, bed linen, table linen, bath and kitchen linen’ product group in Catalogue - List of supported product groups. Added nested parameters for childs in method Method of receiving the information on MC according to the MC list with prior consent. Added ‘DISAGGREGATION’ parameter for ‘status’ and ‘cisStatus’ parameters. Added package type: aggregated customs code (ACC). Added values for ’StatusExt’ and ’cisStatus’: FTS_RESPOND_NOT_OK - negative resolution of FCS; FTS_RESPOND_WAITING - awaiting acknowledgement from FCS; FTS_CONTROL - controlled by FCS. Added return option for goods with damaged/missing IM at retail and remote trading for document type Remarking
30.06.2020 18.3 Introduction into circulation. Manufacturing outside of EEUmethod shall be considered deprecated and will be supported for 3 months. In place of deprecated Introduction into circulation. Manufacturing outside of EEU method, Introduction into circulation. Import with FCS method is used. In Introduction into circulation. Import with FCS method, colour and productSize fields are now optional.
06.07.2020 19 Added the following methods: Method for searching a receipt by identifier; Method for searching a receipt body by identifier; [Method of receiving the list of available requests with filter option]; Requesting information on goods circulation participant by INN; Method of receiving the information on identification means by MC beginning; Method of receiving the list of MC and all internal MC;
7
Date Version Changes
Method of receiving the information on identification tool (POST); Method of receiving the number of MC with filter option; [Method of receiving a list of participants by specified organisation name]; Method of receiving IC by identifier; Method of receiving the number of MC with filter option; Method of receiving the list of MC by document number; Method of searching document content by document identifier. For ’status’ parameter, ‘MC written off’ value is added (WRITTEN_OFF). ‘Withdrawal of a goods item from circulation when selling it to end consumers’ document is renamed <withdrawal>. Added description of ’orderedColumnValue’ parameter. Added v4 endpoints for the following methods: Method of receiving the MC list with detailed information on MC using set filter; Catalog on CMG; Method of receiving information in goods item by Goods code; Method of receiving the IC list by identifier; Method of receiving detailed information on a certain MC (GET). The following methods shall be considered deprecated: Method of receiving the MC list with detailed information on MC using set filter; Method of receiving the IC list by identifier; Method of receiving detailed information on a certain MC (GET). Reply parameters for Method of receiving the list of goods by the set filter are updated. For ‘Method of receiving the content of document pre-loaded in TT GIS’, the following parameters are added: ‘Number of ICs in reply’, ‘Identifier of state contract’, ‘reason for withdrawal’. For ’orderColumn’ parameter, valid value is changed from ’docDate’ to ’receivedAt’. List of abbreviations used in the documents is updated. Changed ’Acceptance’ document creation. For IC status, wrong parameter ‘WAIT_FOR_CONTINUATION’ is eliminated. For Introduction into circulation. In the territory of EEU countries (Contract manufacturing) document type, a notice is added that this only applies to ‘Dairy products’ GG. A mandatory ‘Shipping number’ field is added for ’Acceptance’ document types
17.07.2020 20 For Searching a receipt body by identifier and Searching a receipt by identifier methods, ‘Identifier of state contract’ and ‘Reason for withdrawal’ parameters are added. Removed error values for ‘cisStatus’: FTS_RESPOND_NOT_OK - negative resolution of FCS; FTS_RESPOND_WAITING - awaiting acknowledgement from FCS; FTS_CONTROL - controlled by FCS. ]Receiving the list of available requests with filter option] method is deprecated, ]Search in action log] method shall be used instead. URL of stands is modified, URL for v4 stands is added. Added notes describing the logic of Introduction into circulation Manufacturing outside of EEU and Introduction into circulation. Import with FCS methods. For Introduction into circulation. Import with FCS method, description of cis parameter is updated in JSON (IC or SPIC or ATC is specified). Drinking Water GG is renamed as ‘Bottled water’. For Receiving the IC list by identifier method, FEACN parameter (tnVed10) is added. For Introduction into circulation. In the territory of EEU countries (Contract manufacturing) method, ‘VAT amount’ and ‘Price per unit’ parameters are removed. For IC (ki) parameter of ACC Generation method, the following restriction is added: ‘Only IC numbers are specified. Entering SPIC or IC included in SPIC or other ATC is not allowed in this field’.
8
Date Version Changes
In Receiving the list of goods by the set filter method, values of ‘Additional goods item status’ (statusExt) parameter are modified. For ‘Document download status’ (downloadStatus) parameter, a reference to ‘Document statuses’ catalogue is added. ‘Method of receiving a list of participants by specified organisation name’ is deleted.
31.07.2020 21 For Method of receiving the list of obtained MC with filter option, Method of receiving the number of MC with filter option, Method of receiving the list of transferred MC with filter option, Method of receiving the number of transferred MC with filter option methods, values of ‘Additional goods item status’ (statusExt) parameter are modified. Possible accepted values of ‘Reason for withdrawal’ (withdrawReason) parameter are modified. For Single method of docunets creation ‘Goods Group’ (pg) parameter required to be filled. The following methods are deleted: Search in action log method; Method of receiving the list of available requests with filter option. For Remarking method the restriction on product groups has been removed. For ‘Dairy products’ and ‘Bottled water’ PG, Code of reason for repeated marking (remarking_cause) shall only have the following values: KM_SPOILED – IM with MC spoiled or lost; DESCRIPTION_ERRORS - Errors in goods description found. For Return into circulation method, restriction on mandatory initial documents provision is added. For Description of remains method, limitation on creating document types for’Footwear’ PG is added. For Introduction into circulation. Import with FCS method, the minimum declaration date for the products has been changed from 2020-07-01 to 2020-08-01.
9
List of Acronyms and Abbreviations Abbreviation Description
API Application Programming Interface
Base64 standard for binary data coding using only 64 ASCII symbols
CSV Comma-Separated Values (text format for presentation of table data)
gtin Goods code
JSON JavaScript Object Notation (text format of data exchange based on JavaScript)
MIME Multipurpose Internet Mail Extensions (standard describing transmission of various types of data by e-mail)
pdf Portable Document Format (cross platform open format of electronic documents)
RFC Request for Comments (document from the series of numbered information documents of Internet containing specifications and standards widely used in world wide web)
SGTIN Serialised Global Trade Item Number used for tracking in (GTIN + individual serial number of the secondary (user) packing or initial packing, in case of absence of the secondary)
URL Uniform Resource Locator
UTF-8 Unicode Transformation Format, 8-bit
XML eXtensible Markup Language
XSD XML Schema definition (language describing the document XML structure)
TT GIS Track and Trace Government Information System
CD Customs declaration
EEU Eurasian Economic Union
INN Tax Identification Number
IC Identification code
SPIC Shipping Package Identification Code
MC Marking code
VAT Value Added Tax
OKSM All-Russian Classifier of Countries of the World
PG Goods Group
EEU FEACN Foreign Economic Activity Commodity Nomenclature of the Eurasian Economic Union
EQES Enhanced Qualified Electronic Signature
GCP Goods circulation participant
10
Abbreviation Description
UTD Universal transfer document
UTD(c) Universal transfer document (corrected)
FCS Federal Customs Service
EDM Electronic Document Management
11
1. General provisions
1.1. Principles of Interaction with API
Interaction of goods circulation participants (hereinafter referred to as GCP) with the Track and Trace Government Information System (hereinafter referred to as TT GIS) is carried out in electronic format. Exchange of documents in hard copy is not provided.
Electronic interaction is arranged in one of the two ways:
1. Submission of information, i.e. exchange of electronic documents, based on which the information may be entered in TT GIS registers. Submission of information is defined as responsibility of GCP.
2. Request of information, i.e. exchange, when the information from TT GIS registers is provided to GCP in compliance with the established permits to receive the information. This does not lead to changes in registers. Request and further provision of information from TT GIS are initiated by GCP at their discretion and applied, for example, to check the MC statuses or GCP registration status.
Electronic interaction is performed through exchange of electronic documents according to the established procedure. Enhanced qualified electronic signature (EQES) is used for legally binding electronic documents. The EQES is submitted together with the electronic document. Electronic interaction is carried out using the TT GIS application programming interfaces (API) and the information systems of goods circulation participants.
In case of interaction via API, the following requirements are met:
1. GCP authentication and authorisation (assigning permissions for electronic interaction) are carried out by means of EQES.
2. When providing and requesting information, the data transmitted are protected by TLS/HTTPS (GOST 28147-89) by encoding the data transmission channel to the Operator’s address by CIP certified in the Russian Federation (GOST R 34.10-2012).
API does not provide for categorization of goods circulation participants.
ATTENTION: when displaying data on non-residents, INN will be replaced with its equivalent in EEU country.
Information on nested parameters
The parameter is considered nested if it is not aligned along the left margin of the table.
Nest example:
Parameter Description
results:
12
Parameter Description
agentInn
*children:
**brand
Read as:
’*’ - nesting level of parameter. The ’results’ parameter contains ’agentInn’ and ’children’ parameters, while ’children’ parameter contains ’brand’ parameter.
Information on stands:
1. https://ismp.crpt.ru/api/v3 – base address of production environment of TT GIS (hereinafter referred to as <stand url>);
2. https://demo.lp.crpt.tech/api/v3 – base address of demonstration environment of TT GIS (hereinafter referred to as <stand url>);
3. https://ismp.crpt.ru/api/v4 – base address of production environment of TT GIS (hereinafter referred to as <stand url>);
4. https://demo.lp.crpt.tech/api/v4 – base address of demonstration environment of TT GIS (hereinafter referred to as <v4 stand url>)
Information on errors occurring when requesting API methods has the following format:
(for details, see Catalogue - Response statuses)
Error example:
Status code: 403 Content-Type: application/json
{ ‘error_message’: ‘<No access to resource >‘ }
Status code: 401
error information returns in XML format
Methods of National catalogue return messages on errors that can be in both XML and JSON formats depending on the request format selected
The exchange file shall be signed with EQES of a person authorised to act on behalf of the goods circulation participant without the power of attorney and comply with the following requirements:
1. File in JSON format:
– exchange with TT GIS uses json of RFC 7159 standard (https://tools.ietf.org/html/rfc7159);
– uses UTF-8 coding;
– resulting JSON can also contain a set of fields specific for a certain goods item.
2. Exchange file in CSV format:
– meets RFC 4180 standard;
– uses UTF-8 coding
– contains ’,’ symbol in the file content as a delimiter.
3. Exchange file in XML format:
– XML format is described in xsd schemes. For updated xsd schemes, refer to Help section;
– contains information that is fully included in the block with ’File’ XML-tag;
– contains a single copy of electronic document;
– uses UTF-8 coding;
– contains the first string of type <?xml version=‘1.0’ encoding=‘utf-8’?>;
– determines standard types of data as per ISO (for the standard description, refer to ISO https://www.w3schools.com/xml/schema_dtypes_date.asp);
– is checked for correctness based on XSD scheme - a logic model for data exchange describing logical elements and attributes of XML files.
ATTENTION: the ’curl’ requests in the examples are executed and checked in UNIX systems; to ensure correct operation in other operating systems, replacement of individual symbols may be required.
1.1.1.1. Responses from TT GIS REST API may contain additional utility json attributes which are not specified in documentation. Unknown attributes shall be ignored. 1.1.1.2. Maximum size of the document to be transmitted via API shall not exceed 30 megabytes. 1.1.1.3. All attribute values in JSON and CSV formats expressed in money terms (prices, taxes etc.) are set in kopecks without delimiters.
1.1.2. Screening
Screening is replacement of control symbols in the text with relevant text substitutions. Screening is intended to separate text from code and control symbols. Screening is used when transferring parameters of API method requests according to the following standards:
• when parameters are transmitted in the Uniform Resource Locator (URL), i.e. request URL, screening shall be applied according to the standard rfc3986 (for description of the standard, refer to para. 2.1 https://www.protocols.ru/WP/rfc3986/);
• when parameters are transmitted in the JSON string of the URL request body, screening shall be applied according to the standard rfc8259 (for description of the standard, refer to para. 7 https://www.protocols.ru/WP/rfc8259/);
• when CSV files are used for screening the symbol ' (apostrophe), the symbol '' (double apostrophe) is used;
• when parameters are transmitted in the XML string of the URL request body, screening shall be applied according to the standard W3C (for description of the standard, refer to https://www.w3.org/TR/xml/).
Example:
• screening for JSON according to rfc8259 standard:
1.1.3. Type of Content to be Returned by API Methods
API methods return mainly responses in JSON format, i. e. MIME‑type application/json. Some methods return the binary content (e.g. documents in zip): MIME-type application/zip or application/octet-stream in case of correct response, or an error description in JSON format in case of error. Thus, the same method can return different types of content depending on the situation.
For correct operation of API methods, ’Accept’ parameter of request heading shall be set so that all possible server responses were taken into account, i. e. both application/zip and application/json. The simplest option is to use a universal template:
Accept: /
To limit the set of returned types of content, you can specify more than one request headings of methods:
Accept: application/octet-stream
Accept: application/json
If the list of request headings of API methods appears to have none meeting the response generated by the server, then API will return a response with code = 406 (Not Acceptable) with empty response body.
1.2. Authentication
To use API interface, register in TT GIS SUA: at the production stand (https://markirovka.crpt.ru/) or integration (demo) stand (https://markirovka.demo.crpt.tech) and have a user account with at least one TT GIS goods group connected (see Catalogue - Types of documents).
Function of this method is to receive the authentication token for the EQES:
• As a result of this method, the user receives the ‘uuid – data’ pair, where ’uuid’ is an identifier of the current authentication, and ’data’ is a string to be signed by the user
• The server responds to the request with either a message with code 200 (OK) and a token, or an error message (for details, see Catalogue - Response statuses).
IMPORTANT!
All API methods of interaction with TT GIS require transmission in the parameter heading
'Authorisation: Bearer <token>'
where token is an authentication token received as a result of method of receiving the token.
Parameter is mandatory in case of successful response
code string - Error code Parameter is mandatory in case of non-successful response
error_message string - Error message
description string - Error description
IMPORTANT!
All API methods of interaction with TT GIS require transmission in the parameter heading
'Authorisation: Bearer <token>',
where token is an authentication token received as a result of method of receiving the authentication token.
18
2. Methods Set of attributes which is unique for different product groups is given in Catalogue - Additional parameters for PG.
2.1. General Methods
This section describes the methods applicable for goods of all types.
2.1.1. Method of receiving the MC list with detailed information on MC using set filter
This method returns the list of MC with details currently available to the goods circulation participant (INN will be determined by the token), according to the set filter.
URL: /api/v3/facade/identifytools/listV2 - a deprecated option, from now use: /api/v4/facade/identifytools/listV2
Method: GET
Request example: curl -X GET '<v4 stand url>/facade/identifytools/listV2?\ limit=10&order=DESC&orderColumn=emd&\ uit=010469022978096621qSF7qjA3aRIqM2406402&\ orderedColumnValue=2019-01-23T08:42:17.593Z&pageDir=NEXT' \ -H 'Authorisation: Bearer <TOKEN>'
This request will return next ('pageDir’ parameter) 10 ('limit’ parameter) entries starting from the emission date 2019-01-23T08:42:17.593Z ('orderedColumnValue’ parameter) and marking code 010469022978096621qSF7qjA3aRIqM2406402 ('uit’ parameter). Sorting will be performed by emission date ('orderColumn' parameter) and (always) by marking code itself (regardless of transmitted parameters) using DESC ('order' parameter). Values of emission date and marking code shall be taken from the last string (for 'pageDir NEXT') or from the first string (for 'pageDir PREV') in order to transfer between pages.
*emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
*pageDir - Pagination direction selection: PREV – previous section; NEXT – next section
*uit string - IC value – a reference point (record where sampling starts) used to sort records. Only to be used together with orderedColumnValue parameter
*orderColumn string - Name of column used to sort records. Acceptable value of emd - emission date
*orderedColumnValue string - Column value, a reference point (record where sampling starts) used to sort records. Only to be used together with uit parameter
*limit integer - The value sets the number of records in a reply (maximum is 10000 records, default is 10)
*cisAggregationState enum - IC/SPIN: PACKED- in aggregate (aggregated); NOT_PACKED – not in aggregate (disaggregated); ANY – any state (default value)
*packs string - Filtering by goods groups: ALL – goods and packings; UNIT – goods only; PACK – packings only
20
Parameter Type Mandatory Description
*aggregation boolean - Displaying goods and goods packings with the same status for aggregation
*countChildren integer (int32)
- Number of children ICs
*tree string - IC/SPIN list tree output method: NO_TREE – do not return nested ICs; ONE_LEVEL – return only the first nesting level; ALL_TREE – return the entire tree
*uituStatus string - SPIC status
*cache boolean - Cache flag. If the flag is enabled, the GCP receives a response with not more than the set limit of marking code of 1524
*prVetDocument string - Accompanying production veterinary document
*docType string - see Catalogue - Types of documents
*statusExt enum - Additional status of IC: CANCELLATION_APPLIED – Written off after application on goods; REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Written off; DONATION – Gratuitous transfer of goods; STATE_ENTERPRISE – Acquisition by a state enterprise; NO_RETAIL_USE – Use for purposes of buyer; BEYOND_EEC_EXPORT – Export outside EEU countries; REMOTE_SALE – Sale by sample, remote sale; EEC_EXPORT – Export to EEU countries; RETURN – Return to individual; DAMAGE_LOSS – Loss or damage; DESTRUCTION – Destruction; CONFISCATION – Confiscation; LIQUIDATION – Liquidation of business; FTS_RESPOND_NOT_OK - Unfavorable decision by FCS; FTS_RESPOND_WAITING - Awaiting confirmation by FCS; FTS_CONTROL - Controlled by FCS
*cisStatus string - Current IC status: APPLIED – emitted. Received; EMITTED – emitted. Released; INTRODUCED – in circulation; RETIRED – dropped off; DISAGGREGATION – disaggregated (for packings only)
*withdrawReason string - Reason for withdrawal: KM_SPOILED – Spoiled; LOST - IM KM_LOST – Lost; KM_DESTROYED – Destroyed; DESCRIPTION_ERRORS - Errors in goods description found; RETAIL – Retail sale; EEC_EXPORT – Export to EEU countries; BEYOND_EEC_EXPORT – Export outside EEU countries; RETURN – Return to individual;
21
Parameter Type Mandatory Description
REMOTE_SALE – Sale by sample, remote sale; DAMAGE_LOSS – Loss or damage; DESTRUCTION – Destruction; CONFISCATION – Confiscation; LIQUIDATION – Liquidation of business; DONATION – Gratuitous transfer; STATE_ENTERPRISE – Acquisition by a state enterprise; NO_RETAIL_USE – Use for purposes of buyer; ENTERPRISE_USE – Use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
*documentId string - Document registration number. Shall be specified when searching IC in the document
*tnVedEaesGroup string - EEU FEACN code of goods item
*productName string - Goods name on the label
23
Parameter Type Mandatory Description
*emissionDate string (date-time)
+ IC emission date. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*producedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*participantInn string - INN of goods circulation participant
*participantName string - Name of goods circulation participant
*producerInn string - INN of goods manufacturer
*producerName string - Goods manufacturer
*ownerInn string - INN of goods owner
*ownerName string - Name of goods owner
*statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
*lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
*lastDocType string + Type of the last document. See Catalogue - Types of documents
*emissionType string + Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
*receiptDate string (date-time)
- Date of withdrawal from circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IM KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage;
24
Parameter Type Mandatory Description
DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
*prevCises string - Previous IС numbers. In case of goods remarking
*nextCises [string] - Next IС numbers. In case of goods remarking
*status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
*packType string + Packing type see Catalogue - Types of packing
*children: - IC in aggregate
**cis string + Goods IC
**gtin string - Goods code
**producerName string - Goods manufacturer
**status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
**emissionDate string (date-time)
+ Emission date. In yyyy-MM-ddTHH:mm:ss.SSS’Z format
**producedDate string (date-time)
- Date of application. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**packageType string + Packing type see Catalogue - Types of packing
25
Parameter Type Mandatory Description
**ownerInn string - INN of goods owner
**ownerName string - Name of goods owner
**productName string - Goods name
**brand string - Brand
**prevCises [string] - Previous IСs. In case of goods remarking
**nextCises [string] - Next IС numbers. In case of goods remarking
**statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
**children: [string] - All children ICs. Looks like a JSON array
**childrenMap [string] - Brief information on children ICs
**countChildren integer - Number of children ICs
**parent string - Identification code of the packing where the goods are aggregated
**lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
**expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
**prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
**introducedDate string (date-time)
- Date of introduction into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**exporterName string - Name of the exporter
**exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
**agentInn string - INN of the current goods owner
**agentName string - Name of the current goods owner
**lastStatusChangeDate string (date-time)
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*productGroup string + Goods group. see Catalogue - List of supported product groups
total string + Number of returned responses
docErrors [string] - List of errors of document processing. Is returned in case of an error
27
2.1.2. Method of receiving detailed information on a certain MC (GET)
URL: /api/v3/facade/identifytools/info - a deprecated option, from now use: /api/v4/facade/identifytools/info
Method: GET
The method returns detailed information about the requested MC (1 MC per 1 request) which is currently available to the goods circulation participant (INN of the organisation is specified in the token).
Request example: curl -X GET '<v4 stand url>/facade/identifytools/info?cis=010405915570452921HXRNJW15asPkB2406405' -H 'Authorisation: Bearer <TOKEN>'
tnVedEaesGroup string - EEU FEACN code of goods item
productName string - Goods name on the label
emissionDate string (date-time)
+ IC emission date. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
producedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
participantInn string - INN of goods circulation participant
participantName string - Name of goods circulation participant
producerInn string - INN of goods manufacturer
producerName string - Goods manufacturer
ownerInn string - INN of goods owner
ownerName string - Name of goods owner
statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
lastDocType string + Type of the last document. See Catalogue - Types of documents
emissionType string + Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF;
30
Parameter Type Mandatory Description
REMAINS – remains marking; CROSSBORDER – imported from EEU countries
receiptDate string (date-time)
- Date of withdrawal from circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IM KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
prevCises string - Previous IС numbers. In case of goods remarking
nextCises [string] - Next IС numbers. In case of goods remarking
status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
packType string + Packing type see Catalogue - Types of packing
children: - IC in aggregate
*cis string + Goods IC
*gtin string - Goods code
31
Parameter Type Mandatory Description
*producerName string - Goods manufacturer
*status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
*emissionDate string (date-time)
+ Emission date. In yyyy-MM-ddTHH:mm:ss.SSS’Z format
*producedDate string (date-time)
- Date of application. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*packageType string + Packing type see Catalogue - Types of packing
*ownerInn string - INN of goods owner
*ownerName string - Name of goods owner
*productName string - Goods name
*brand string - Brand
*prevCises [string] - Previous IСs. In case of goods remarking
*nextCises [string] - Next IС numbers. In case of goods remarking
*statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
*children: [string] - All children ICs. Looks like a JSON array
*childrenMap [string] - Brief information on children ICs
*countChildren integer - Number of children ICs
*parent string - Identification code of the packing where the goods are aggregated
*lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
*expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
*prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
32
Parameter Type Mandatory Description
*introducedDate string (date-time)
- Date of introduction into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*exporterName string - Name of the exporter
*exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
*agentInn string - INN of the current goods owner
*agentName string - Name of the current goods owner
*lastStatusChangeDate string (date-time)
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
productGroup string + Goods group. see Catalogue - List of supported product groups
2.1.3. Method of receiving the list of goods using set filter
The method returns a list of goods with details currently available to the goods circulation participant (INN of organisation is in the token), according to the set filter.
*emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
*pageDir enum - Pagination direction selection: PREV – previous section; NEXT – next section
*uit string - IC value – a reference point (record where sampling starts) used to sort records. Only to be used together with orderedColumnValue parameter
*orderColumn string - Name of column used to sort records. Acceptable value of emd - emission date
*orderedColumnValue string - Column value, a reference point (record where sampling starts) used to sort records. Only to be used together with uit parameter
*limit integer - The value sets the number of records in a reply (maximum is 10000 records, default is 10)
*cisAggregationState enum - IC state: PACKED- in aggregate (aggregated); NOT_PACKED – not in aggregate (disaggregated); ANY – any state
*packs string - Filtering by goods groups: ALL – goods and packings; UNIT – goods only; PACK – packings only
*aggregation boolean - Displaying goods and goods packings with the same status for aggregation
*countChildren integer (int32)
- Number of children ICs
*tree string - IC/SPIN list tree output method: NO_TREE – do not return nested ICs;
35
Parameter Type Mandatory Description
ONE_LEVEL – return only the first nesting level; ALL_TREE – return the entire tree
*uituStatus string - SPIC status
*prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
*doctype string - Type of document. See Catalogue - Types of documents
*cisStatus string - Current IC status: APPLIED – emitted. Received; EMITTED – emitted. Released; INTRODUCED – In circulation; RETIRED – Dropped off
*statusExt enum - Extended goods item status: WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking); WITHDRAW – withdrawal; REMARK_RETIRED – Remarked
*statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
*docNum string - Document registration number
*emissionDate string (date-time)
+ IC emission date. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*producedDate string (date-time)
- Date of application. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*introducedDate string (date-time)
- Date of introduction into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
*prodOrderType enum - Type of production order: SELF_MADE - home manufacturing; OPERATOR - contract manufacturing
39
Parameter Type Mandatory Description
*lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
*name string - Goods name
*brand string - Brand
*model string - Goods manufacturer
*certDoc - Certificate
**date string - Date of certificate. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**number string - Number of certificate
**type string - Type of certificate
*prevCises [string] - Previous IСs. In case of goods remarking
*nextCises [string] - Next IС numbers. In case of goods remarking
*status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
*remarks - List of the goods remarking processes
**curr string - Current goods IC
**date string - Date of remarking. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**prev string - Previous goods ICs
*cisChildren [string] - List of children ICs
*children: - IC in aggregate
**cis string + Goods IC
**gtin string - Goods code
**producerName string - Goods manufacturer
**status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; RETIRED – dropped off; DISAGGREGATION – disaggregated (for packings only)
**emissionDate string (date-time)
+ Emission date. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**producedDate string (date-
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
40
Parameter Type Mandatory Description
time)
**packageType string + Packing type. Catalogue - Types of packing
**ownerInn string - INN of goods owner
**ownerName string - Name of goods owner
**productName string - Goods name on the label
**brand string - Brand
**nextCises [string] - Next IС numbers. In case of goods remarking
**prevCises string - Previous IС numbers. In case of goods remarking
**statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
**children: [string] - All ICs in aggregate. Looks like a JSON array
**childrenMap [string] - Brief information on children ICs
**countChildren integer (int32)
- Number of children ICs
**parent string - Identification code of the packing where the goods are aggregated
**lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
**expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
**prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
**introducedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**exporterName string - Name of the exporter
**exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
**agentName string - INN of the current goods owner
**agentInn string - Name of the current goods owner
**lastStatusChangeDate string (date-time)
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**productGroup string + Goods group. see Catalogue - List of supported product groups
*childrenDetails [array] - Marked goods
*countChildren integer (int32)
- Number of children ICs
*uitu string - SPIC of the upper level
*parent string - Identification code of the packing where the goods are aggregated
*packType string + Packing type. Catalogue - Types of packing
*withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IM KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
*receiptDate string (date-time)
- Date of withdrawal from circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
42
Parameter Type Mandatory Description
*prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
*exporterName string - Name of the exporter
*exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
*certificateType string - Type of the document that confirms the conformity: Possible values: CONFORMITY_CERTIFICATE – conformity certificate); CONFORMITY_DECLARATION – conformity declaration); CONFORMITY_CERTIFICATE_OR_DECLARATION - conformity certificate or declaration)
*certificateNumber string - Number of document confirming compliance
*certificateDate string - Date of document confirming compliance. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*productGroup string + Goods group. see Catalogue - List of supported product groups
*colour string - Colour. Mandatory for PG ’Footwear’
*productSize string - Size. Mandatory for PG ’Footwear’
total string + Number of returned responses
docErrors [string] - List of errors of document processing. Is returned in case of an error
2.1.4. Method of receiving brief information on IC\IC list (public)
cis string + Identification code used to filter the MC list
gtin string - Goods code
producerName string - Goods manufacturer
status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
emissionDate string (date-time)
+ Date of IC emission. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
producedDate string (date-time)
- Date of application. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
packageType string + Packing type see Catalogue - Types of packing
ownerName string - Name of the current goods owner
ownerInn string - INN of goods owner
productName string - Goods name
brand string - Brand
prevCises [string] - Previous IС numbers. In case of goods remarking
nextCises [string] - Next IС numbers. In case of goods remarking
statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off;
45
Parameter Type Mandatory Description
WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
children [string] - IC in aggregate
childrenMap [string] - Brief information on children ICs
*brand string - Brand
*children: [string] - All children ICs. Looks like a JSON array
*childrenMap [string] - Brief information on children ICs
*cis string + Goods IC
*countChildren integer (int32)
- Number of children ICs
*emissionDate string (date-time)
+ Emission date. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
*exporterName string - Name of the exporter
*exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
*sgtin string - Goods code and IC serial number
*introducedDate string (date-time)
- Date of introduction into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
*nextCises [string] - Next IC numbers in case of remarking
*ownerInn string - INN of goods owner
*ownerName string - Name of goods owner
*packageType string + Packing type see Catalogue - Types of packing
*parent string - Identification code of the packing where the goods are aggregated
*prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
*prevCises [string] - Previous IСs (remarking)
*producedDate string (date-time)
- Date of application. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*producerName string - Goods manufacturer
*productName string - Goods name
46
Parameter Type Mandatory Description
*status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
*statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
cis string + Identification code used to filter the MC list
gtin string - Goods code
producerName string - Goods manufacturer
status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
emissionDate string (date-time)
+ Date of IC emission. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
producedDate string (date-time)
- Date of application. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
packType + Packing type see Catalogue - Types of packing
49
Parameter Type Mandatory Description
ownerName string - Name of the current goods owner
ownerInn string - INN of goods owner
productName string - Goods name
brand string - Brand
prevCises [string] - Previous IС numbers. In case of goods remarking
nextCises [string] - Next IС numbers. In case of goods remarking
statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
children [string] - IC in aggregate
countChildren integer (int32)
- Number of children ICs
parent string - SPIC of the upper level
lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
introducedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
exporterName string - Name of the exporter
exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
agentInn string - INN of the current goods owner
agentName string - Name of the current goods owner
lastStatusChangeDate string (date-time)
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
productGroup string + Goods group. see Catalogue - List of supported product groups
tnVed10 string - FEACN code (10 symbols)
50
Parameter Type Mandatory Description
Note: for non-owner, reply depends on MC:
• If MC is emitted. Received or In circulation, all data is returned;
• If MC is Disposed, all MC data is returned, except for information about GCP that disposed of MC;
• If aggregate is aggregated, all details and IC list are returned in the level 1 aggregate;
• If aggregate is disaggregated, aggregate status and IC list are returned in the level 1 aggregate.
2.1.6. Method of receiving information on goods item by Goods code
As a result of successful request execution according to the Goods code list, the response returns an array with information on goods by the requested goods codes.
Note: resulting JSON can also contain a set of fields specific for a certain goods item (see Catalogue - Additional parameters for PG).
A request can be submitted with two methods:
URL: /product/info
Method: GET
Request example 1: curl -X GET '<stand url>/product/info? gtins=04690257113712,04690257113712' -H 'Authorisation: Bearer <TOKEN>'
Request example 2: curl -X GET '<v4 stand url>/product/info? gtins=04690257113712,04690257113712' -H 'Authorisation: Bearer <TOKEN>'
Request parameters:
Parameter Type Mandatory Description
gtins array + List of goods codes
create boolean - Create a goods item if it is not in DB true-yes; false-no
- Date of document, to Set in yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z format. E.g., 2019-01-01T03:00:00.000Z
did string - Value of document number - a reference point (record where sampling starts) used to sort records. Only to be used together with orderedColumnValue parameter
documentFormat string - Document type: MANUAL – json format; UPD – Electronic Document Management; XML – XML format; CSV – CSV format
documentStatus enum - Document status. see Catalogue - Document statuses
documentType array[string] - see Catalogue - Types of documents
orderColumn string - Name of column used to sort records. Acceptable value of receivedAt - emission date
orderedColumnValue string - Column value, a reference point (record where sampling starts) used to sort records. Only to be used together with did parameter
pageDir enum - Direction selection: PREV – Previous section; NEXT – Next section
participantInn string - INN of goods circulation participant
pg string - Goods group: the parameter must be specified for the following goods groups: milk – ‘Dairy products’; water – ’Bottled water’
+ Document date. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z format
receivedAt string (date-time)
- Date and time of document receipt
Is returned in yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z format. Example 2019-01-01T03:00:00.000Z
type string + Document type See Catalogue - Types of documents
status string + Document processing status
See Catalogue - Document statuses
externalId string - Document Id in the external EDM system
senderName string + Name of document sender
receiverName string - Name of document receiver
invoiceNumber string - Number of invoice, Universal Correcting Document
invoiceDate string (date-time)
- Date of invoice, Universal Correcting Document
Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format.
total Number - Total document amount in kopecks
vat Number - Total document VAT amount in kopecks
downloadStatus string - Document loading status
See Catalogue - Document statuses
downloadDesc string - Description of document loading
In case of error during document loading
body Object - Document content Body of the sent document in JSON format. See Document methods cl.2.2
content string - Document content Original content of document
input boolean - Attribute of incoming/outgoing document
Possible values are: true - input; false - output
67
Parameter Type Mandatory Description Comment
pdfFile string - Link to PDF file
errors [string] - Errors. The parameter returns in case of error.
docErrors [string] - List of errors of document processing. Is returned in case of an error
sender string - Sender
*name string - Name
*address string - Address
*inn string - INN
*kpp string - KPP tax registration reason code
receiver string - Receiver
*name string - Name
*address string - Address
*inn string - INN
*kpp string - KPP tax registration reason code
contractId string - Government contract identifier
eliminationReason string - Withdrawal reason Possible values: KM_SPOILED – spoiled; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – Retail sale; EEC_EXPORT – Export to EEU countries; BEYOND_EEC_EXPORT – export outside the EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; INSTALMENT - installment contract; DONATION – non-compensatory transfer;
68
Parameter Type Mandatory Description Comment
STATE_ENTERPRISE – acquisition by state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
2.1.11. Method for searching a receipt body by identifier
+ Document date. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z format
receivedAt string (date-time)
- Date and time of document receipt
Is returned in yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z format. Example 2019-01-01T03:00:00.000Z
type string + Document type See Catalogue - Types of documents
status string + Document processing status
See Catalogue - Document statuses
externalId string - Document Id in the external EDM system
senderName string + Name of document sender
receiverName string - Name of document receiver
invoiceNumber string - Number of invoice, Universal Correcting Document
invoiceDate string (date-time)
- Date of invoice, Universal Correcting Document
Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format.
total Number - Total document amount in kopecks
vat Number - Total document VAT amount in kopecks
downloadStatus string - Document loading status
See Catalogue - Document statuses
downloadDesc string - Description of document loading
In case of error during document loading
body Object + Document content Body of the document sent by FDO in JSON format
content string + Document content Original content of document
input Boolean + Attribute of incoming/outgoing document
Possible values are: true - input; false - output
pdfFile string - Link to PDF file
errors [string] - Errors. The parameter returns in case of error.
71
Parameter Type Mandatory Description Comment
docErrors [string] - List of errors of document processing. Is returned in case of an error
sender string - Sender
*name string - Name
*address string - Address
*inn string - INN
*kpp string - KPP tax registration reason code
receiver string - Receiver
*name string - Name
*address string - Address
*inn string - INN
*kpp string - KPP tax registration reason code
contractId string - Government contract identifier
eliminationReason string - Withdrawal reason Possible values: KM_SPOILED – spoiled; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – Retail sale; EEC_EXPORT – Export to EEU countries; BEYOND_EEC_EXPORT – export outside the EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; INSTALMENT - installment contract; DONATION – non-compensatory transfer; STATE_ENTERPRISE – acquisition by state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of
72
Parameter Type Mandatory Description Comment
time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
2.1.12. Method of receiving the list of receipts pre-loaded in TT GIS
did string - Value of document number - a reference point (record where sampling starts) used to sort records. Only to be used together with orderedColumnValue parameter
limit integer - The value sets the number of records in a reply (maximum is 10000 records, default is 10)
pageDir enum - Direction selection: PREV – Previous section; NEXT – Next section
orderColumn string - Name of column used to sort records. Acceptable value of receivedAt - emission date
orderedColumnValue string - Column value, a reference point (record where sampling starts) used to sort records. Only to be used together with did parameter
pg string - Goods group: the parameter must be specified for the following goods groups: milk – ‘Dairy products’; water – ’Bottled water’
Possible values: KM_SPOILED – spoiled; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – Retail sale; EEC_EXPORT – Export to EEU countries; BEYOND_EEC_EXPORT – export outside the EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; INSTALMENT - installment contract; DONATION – non-compensatory transfer; STATE_ENTERPRISE – acquisition by state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
cisTotal integer + Number of IC in reply
2.1.14. Method of receiving the list of goods using document number
*product_cost_without_tax number - Product cost without tax
*excise number - Excise tax
*no integer -
*children array - Nested MC
**cis string - Identification code
**gtin string - Goods code
**name string - Goods item name
*products_number number - Product number
*products_number_before number - Product number before
*products_number_after number - Product number after
*add_info string - Additional information
total integer + Number of returned responses
docErrors [string] + List of errors of document processing. Only if failed
2.1.15. Method of receiving the list of 10-digit FEACN codes
As a result of successful request execution for receiving the list of FEACN codes with indication of the FEACN prefix array and pagination parameters, the response returns the information array on the FEACN codes that meet the request and the total number of elements of this array.
limit integer - Value determines the number of records in response, but not more than 10000 records
84
Parameter Type Mandatory Description
page integer (int32)
- Number of response page, initial value - 0
pg string - Goods group: the parameter must be specified for the following goods groups: milk – ‘Dairy products’; water – ’Bottled water’
prefix string - List of goods items one of which shall be the start of desired FEACN codes. It is used to filter the product group. For example, '6401,6402,6403,6404,6405'.
*description string + Text description of FEACN code
total integer (int64) + Total number of FEACN codes meeting the filtering parameters
2.1.16. Method of generating consent to provision of information on marking codes for non-owners
The method generates only a draft document which shall be signed with EQES of the General Director in the User Account. The system may have only one valid consent document.
trustedInns [string] + Trust list of INNs (of counterparties)
Response example:
1 If successful - code 201:
Document is generated successfully.
2 If failed - code 400
[ { ‘message’: ‘For the published consent revision, there is a cancellation document in \’under preparation\ status’’ , ‘object’: [ ] } , { ‘message’: ‘INNs not registered in the system’ , ‘object’: [ ‘string’ ] } ]
2.1.17. Method of document cancellation based on the current published consent document
The method cancels the latest successfully generated consent document.
[ { ’message’: ‘User already has a consent withdrawal document in 'Generated' status’, ‘object’: [] } ]
2.1.18. Method of receiving the information on MC according to the MC list with prior consent
The method provides for submission by a GCP of a request for the information on ownership and status of MCs owned by his/her counterparty; TT GIS verificates if a valid consent for granting access has been given by this counterparty to the requesting GCP. In reply, GCP receives the information or a denial to provide the information.
statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
docNum string - Document registration number
emissionDate string (date-time)
+ IC emission date. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
producedDate string (date-time)
- Date of application. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
introducedDate string (date-time)
- Date of introduction into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
91
Parameter Type Mandatory Description
emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
prodOrderType enum - Type of production order: SELF_MADE - home manufacturing; OPERATOR - contract manufacturing
lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
name string - Goods name
brand string - Brand
model string - Goods manufacturer
certDoc - Certificate
*date string - Date of certificate. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*number string - Number of certificate
*type string - Type of certificate
prevCises [string] - Previous IСs. In case of goods remarking
nextCises [string] - Next IС numbers. In case of goods remarking
status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
remarks - List of the goods remarking processes
*curr string - Current goods IC
*date string - Date of remarking. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*prev string - Previous goods ICs
cisChildren [string] - List of children ICs
children: - IC in aggregate
*cis string + Goods IC
*gtin string - Goods code
*producerName string - Goods manufacturer
*status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation;
92
Parameter Type Mandatory Description
WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
*emissionDate string (date-time)
+ Emission date. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*producedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*packageType string + Packing type. Catalogue - Types of packing
*ownerInn string - INN of goods owner
*ownerName string - Name of goods owner
*productName string - Goods name on the label
*brand string - Brand
*nextCises [string] - Next IС numbers. In case of goods remarking
*prevCises string - Previous IС numbers. In case of goods remarking
*statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
*children: [string] - All ICs in aggregate. Looks like a JSON array
*childrenMap [string] - Brief information on children ICs
*countChildren integer - Number of children ICs
*parent string - Identification code of the packing where the goods are aggregated
*lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
*expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
*prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
*introducedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*exporterName string - Name of the exporter
*exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer
93
Parameter Type Mandatory Description
accounting system
*agentName string - INN of the current goods owner
*agentInn string - Name of the current goods owner
*lastStatusChangeDate string (date-time)
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*productGroup string + Goods group. see Catalogue - List of supported product groups
childrenDetails [array] - Marked goods
countChildren integer (int32)
- Number of children ICs
uitu string - SPIC of the upper level
parent string - Identification code of the packing where the goods are aggregated
packType string + Packing type. Catalogue - Types of packing
withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IMKM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
receiptDate string - Date of withdrawal from circulation. Is returned in yyyy-MM-
94
Parameter Type Mandatory Description
(date-time)
ddTHH:mm:ss.SSS’Z format
expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
exporterName string - Name of the exporter
exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
certificateType string - Type of the document that confirms the conformity: Possible values: CONFORMITY_CERTIFICATE – conformity certificate); CONFORMITY_DECLARATION – conformity declaration); CONFORMITY_CERTIFICATE_OR_DECLARATION - conformity certificate or declaration)
certificateNumber string - Number of document confirming compliance
certificateDate string - Date of document confirming compliance. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
productGroup string + Goods group. see Catalogue - List of supported product groups
colour string - Colour. Mandatory for PG ‘Footwear’
productSize string - Size. Mandatory for PG ‘Footwear’
2.1.20. Method of receiving the information on marked goods by MC beginning
statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
docNum string - Document registration number
emissionDate string (date-time)
+ IC emission date. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
producedDate string (date-time)
- Date of application. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
introducedDate string (date-time)
- Date of introduction into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
prodOrderType enum - Type of production order: SELF_MADE - home manufacturing;
98
Parameter Type Mandatory Description
OPERATOR - contract manufacturing
lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
name string - Goods name
brand string - Brand
model string - Goods manufacturer
certDoc - Certificate
*date string - Date of certificate. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*number string - Number of certificate
*type string - Type of certificate
prevCises [string] - Previous IСs. In case of goods remarking
nextCises [string] - Next IС numbers. In case of goods remarking
status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
remarks - List of the goods remarking processes
*curr string - Current goods IC
*date string - Date of remarking. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*prev string - Previous goods ICs
cisChildren [string] - List of children ICs
children: - IC in aggregate
*cis string + Goods IC
*gtin string - Goods code
*producerName string - Goods manufacturer
*status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
*emissionDate string (date-time)
+ Emission date. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
99
Parameter Type Mandatory Description
*producedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*packageType string + Packing type. Catalogue - Types of packing
*ownerInn string - INN of goods owner
*ownerName string - Name of goods owner
*productName string - Goods name on the label
*brand string - Brand
*nextCises [string] - Next IС numbers. In case of goods remarking
*prevCises string - Previous IС numbers. In case of goods remarking
*statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
*children: [string] - All ICs in aggregate. Looks like a JSON array
*childrenMap [string] - Brief information on children ICs
*countChildren integer (int32)
- Number of children ICs
*parent string - Identification code of the packing where the goods are aggregated
*lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
*expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
*prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
*introducedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*exporterName string - Name of the exporter
*exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
*agentName string - INN of the current goods owner
*agentInn string - Name of the current goods owner
*lastStatusChangeDate string (date-
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*productGroup string + Goods group. see Catalogue - List of supported product groups
childrenDetails [array] - Marked goods
countChildren integer (int32)
- Number of children ICs
uitu string - SPIC of the upper level
parent string - Identification code of the packing where the goods are aggregated
packType string + Packing type. Catalogue - Types of packing
withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IMKM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
receiptDate string (date-time)
- Date of withdrawal from circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
101
Parameter Type Mandatory Description
prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
exporterName string - Name of the exporter
exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
certificateType string - Type of the document that confirms the conformity: Possible values: CONFORMITY_CERTIFICATE – conformity certificate); CONFORMITY_DECLARATION – conformity declaration); CONFORMITY_CERTIFICATE_OR_DECLARATION - conformity certificate or declaration)
certificateNumber string - Number of document confirming compliance
certificateDate string - Date of document confirming compliance. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
productGroup string + Goods group. see Catalogue - List of supported product groups
colour string - Colour. Mandatory for PG ’Footwear’
productSize string - Size. Mandatory for PG ’Footwear’
2.1.21. Method of receiving the list of goods using document number
URL: /facade/doc/{docId}/products
Method: GET
Request example: curl -X POST ‘<stand url>/facade/doc/docId/products?limit=2 -H ’Authorisation: Bearer<TOKEN>
Request parameters:
Parameter Type Mandatory Description Comment
docId string + Document number
filter object + Request filter
*docId string - Document number
*column string - Column
*columnValue string - Column value
*orderColumn string - Name of column used for sorting
*orderDir string - Sorting order Possible values: ASC – ascending; DESC –
102
Parameter Type Mandatory Description Comment
descending
*cis string - Goods IC
*name string - Goods item name
*page integer - Page number
*limit integer - Value determines the number of records in response, but not more than 10000 records
cisMatchMode string - Filtering by MC mode: EQ - equal to; LIKE - contains; Start_with - starts with
producerInn string - INN of manufacturer
agent string - INN of the current goods owner
prevAgent string - INN of the previous goods owner
emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
emissionDateFrom date-time
- Date of emission from Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format Example 2019-01-01T03:00:00.000Z
emissionDateTo date-time
- Date of emission to Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format Example 2019-01-01T03:00:00.000Z
cisAggregationState enum - IC state: PACKED- in aggregate (aggregated); NOT_PACKED – not in aggregate (disaggregated); ANY – any state
statusExt enum - Extended IC status: WITHDRAW – withdrawal; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
cisStatus string - Current IC status: APPLIED – emitted. Received; EMITTED – emitted. Released; INTRODUCED – In circulation; RETIRED – Dropped off; DISAGGREGATION - disaggregated
limit string - The value sets the number of records in a reply (maximum is 10000 records, default is 10)
page string - Number of response page, initial value - 0
pg string - Goods group: the parameter must be specified for the following goods groups: milk – Dairy products; water – Water
withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IM KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at
106
Parameter Type Mandatory Description
retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
aggregation boolean - Displaying goods and goods packings with the same status for aggregation
*status enum - Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; RETIRED – dropped off; WRITTEN_OFF – MC written off; DISAGGREGATION – disaggregated (for packings only)
*emissionDate string (date-time)
- IC emission date. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
*packType string - Packing type see Catalogue - Types of packing
*children array - IC in aggregate
**cis string - Goods IC
**gtin string - Goods code
**producerName string - Goods manufacturer
**status enum - Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; RETIRED – dropped off; DISAGGREGATION – disaggregated (for packings only)
**emissionDate string (date-time)
- Emission date. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**producedDate string (date-time)
- Date of application. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**packageType enum - Packing type see Catalogue - Types of packing
**ownerInn string - INN of goods owner
**ownerName string - Name of goods owner
109
Parameter Type Mandatory Description
**productName string - Goods name on the label
**brand string - Brand
**prevCises [string] - Previous IСs (remarking)
**nextCises [string] - Next IC numbers in case of remarking
**statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
**children: [string] - All children ICs. Looks like a JSON array
**childrenMap [string] - Brief information on children ICs
**countChildren integer (int32)
- Number of children ICs
**parent string - Identification code of the packing where the goods are aggregated
**lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
**expireDate string (date-time)
- Date of shelf life expiration. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ’milk’)
**prVetDocument string - Production accompanying veterinary document (mandatory for PG ’milk’)
**introducedDate string (date-time)
- Date of introduction into circulation. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**exporterName string - Name of the exporter
**exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
**agentInn string - INN of the current goods owner
**agentName string - Name of the current goods owner
**lastStatusChangeDate string (date)
- Date of the last status change. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**productGroup string - Goods group. see Catalogue - List of supported product groups
*countChildren integer - Number of children ICs
110
Parameter Type Mandatory Description
(int32)
*nextCises [string] - Next IC numbers in case of remarking
*prevCises [string] - Previous IС numbers
cisChildren string - List of children ICs
total integer + Number of returned responses
docErrors array - List of errors
2.1.23. Method of receiving the number obtained MC with filter option
URL: /api/v3/facade/agent/received/count
Method: GET
Request example:
curl -X GET ‘<url of stand> /api/v3/facade/agent/received/count?cis=string&cisMatchMode=EQ&producerInn=string&agent=string&prevAgent=string&emissionType=INVALID_VALUE&emissionDateFrom=0&emissionDateTo=0>in=string&sn=string&turnoverType=SELLING&cisAggregationState=PACKED&statusExt=WAIT_SHIPMENT&cisStatus=INTRODUCED&limit=0&page=0&pg=string’ -H ‘accept: */*’ -H ’Authorisation: Bearer <Token>
Request parameters:
Parameter Type Mandatory Description
cis string - Identification code
cisMatchMode string - Filtering by MC mode: EQ - equal to; LIKE - contains; Start_with - starts with
producerInn string - INN of manufacturer
agent string - INN of the current goods owner
prevAgent string - INN of the previous goods owner
emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
emissionDateFrom date-time
- Date of emission from Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format Example 2019-01-01T03:00:00.000Z
emissionDateTo date-time
- Date of emission to Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format Example 2019-01-01T03:00:00.000Z
cisAggregationState enum - IC state: PACKED- in aggregate (aggregated); NOT_PACKED – not in aggregate (disaggregated); ANY – any state
statusExt enum - Extended IC status: WITHDRAW – withdrawal; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
cisStatus string - Current IC status: APPLIED – emitted. Received; EMITTED – emitted. Released; INTRODUCED – In circulation; RETIRED – Dropped off; DISAGGREGATION - disaggregated
limit string - The value sets the number of records in a reply (maximum is 10000 records, default is 10)
page string - Number of response page, initial value - 0
pg string - Goods group: the parameter must be specified for the following goods groups: milk – Dairy products; water – Water
withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IM KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise;
112
Parameter Type Mandatory Description
KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
aggregation boolean - Displaying goods and goods packings with the same status for aggregation
Response example:
{ ‘count’: 0 }
Response parameters:
Parameter Type Mandatory Description
count integer + Number of obtained MCs
2.1.24. Method of receiving the list of transferred MC with filter option
URL: /api/v3/facade/agent/given/list
Method: GET
Request example:
curl -X GET ‘<url of stand> /api/v3/facade/agent/given/list?cis=string&cisMatchMode=EQ&producerInn=string&agent=string&prevAgent=string&emissionType=INVALID_VALUE&emissionDateFrom=0&emissionDateTo=0>in=string&sn=string&turnoverType=SELLING&cisAggregationState=PACKED&statusExt=WAIT_SHIPMENT&cisStatus=INTRODUCED&limit=0&page=0&pg=string’ -H ‘accept: */*’ -H ‘Authorisation: Bearer <Token>
Request parameters:
Parameter Type Mandatory Description
cis string - Identification code
cisMatchMode string - Filtering by MC mode: EQ - equal to; LIKE - contains; Start_with - starts with
113
Parameter Type Mandatory Description
producerInn string - INN of manufacturer
agent string - INN of the current goods owner
prevAgent string - INN of the previous goods owner
emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
emissionDateFrom date-time
- Date of emission from Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format Example 2019-01-01T03:00:00.000Z
emissionDateTo date-time
- Date of emission to Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format Example 2019-01-01T03:00:00.000Z
cisAggregationState enum - IC state: PACKED- in aggregate (aggregated); NOT_PACKED – not in aggregate (disaggregated); ANY – any state
statusExt enum - Extended IC status: WITHDRAW – withdrawal; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
cisStatus string - Current IC status: APPLIED – emitted. Received; EMITTED – emitted. Released; INTRODUCED – In circulation; RETIRED – Dropped off; DISAGGREGATION - disaggregated
limit string - The value sets the number of records in a reply (maximum is 10000 records, default is 10)
page string - Number of response page, initial value - 0
pg string - Goods group: the parameter must be specified for the following goods groups: milk – Dairy products; water – Water
withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IM KM_LOST – lost;
114
Parameter Type Mandatory Description
KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
aggregation boolean - Displaying goods and goods packings with the same status for aggregation
*status enum - Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; RETIRED – dropped off; WRITTEN_OFF – MC written off; DISAGGREGATION – disaggregated (for packings only)
*emissionDate string (date-time)
- IC emission date. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
*packType string - Packing type see Catalogue - Types of packing
*children array - IC in aggregate
**cis string - Goods IC
**gtin string - Goods code
117
Parameter Type Mandatory Description
**producerName string - Goods manufacturer
**status enum - Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; WRITTEN_OFF – MC written off; RETIRED – dropped out; DISAGGREGATION – disaggregated (for packings only)
**emissionDate string (date-time)
- Emission date. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**producedDate string (date-time)
- Date of application. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
**packageType enum - Packing type see Catalogue - Types of packing
**ownerInn string - INN of goods owner
**ownerName string - Name of goods owner
**productName string - Goods name on the label
**brand string - Brand
**prevCises [string] - Previous IСs (remarking)
**nextCises [string] - Next IC numbers in case of remarking
**statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
**children: [string] - All children ICs. Looks like a JSON array
**childrenMap [string] - Brief information on children ICs
**countChildren integer (int32)
- Number of children ICs
**parent string - Identification code of the packing where the goods are aggregated
**lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
**expireDate string (date-time)
- Date of shelf life expiration. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ’milk’)
**prVetDocument string - Production accompanying veterinary document (mandatory for PG ’milk’)
**introducedDate string (date-time)
- Date of introduction into circulation. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
118
Parameter Type Mandatory Description
**exporterName string - Name of the exporter
**exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
**agentInn string - INN of the current goods owner
**agentName string - Name of the current goods owner
**lastStatusChangeDate string (date)
- Date of the last status change. Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
cisMatchMode string - Filtering by MC mode: EQ - equal to; LIKE - contains;
119
Parameter Type Mandatory Description
Start_with - starts with
producerInn string - INN of manufacturer
agent string - INN of the current goods owner
prevAgent string - INN of the previous goods owner
emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
emissionDateFrom date-time
- Date of emission from Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format Example 2019-01-01T03:00:00.000Z
emissionDateTo date-time
- Date of emission to Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format Example 2019-01-01T03:00:00.000Z
cisAggregationState enum - IC state: PACKED- in aggregate (aggregated); NOT_PACKED – not in aggregate (disaggregated); ANY – any state
statusExt enum - Extended IC status: WITHDRAW – withdrawal; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
cisStatus string - Current IC status: APPLIED – emitted. Received; EMITTED – emitted. Released; INTRODUCED – In circulation; RETIRED – Dropped off; DISAGGREGATION - disaggregated
limit string - The value sets the number of records in a reply (maximum is 10000 records, default is 10)
page string - Number of response page, initial value - 0
pg string - Goods group: the parameter must be specified for the following goods groups: milk – Dairy products; water – Water
withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled;
120
Parameter Type Mandatory Description
LOST - IM KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
aggregation boolean - Displaying goods and goods packings with the same status for aggregation
Response example:
{ ’count’: 0 }
Response parameters:
Parameter Type Mandatory Description
count integer + Number of obtained MCs
2.1.26. Requesting information on goods circulation participant by INN
As a result of successful request execution by one INN of goods circulation participant (GCP), the response returns the information on the requested participant.
URL: /facade/participants/{inn}
Method: GET
121
Request parameters:
Parameter Type Mandatory Description
inn array [string] + List of INNs (not more than 1000 of INNs)
pg string - Goods group: the parameter must be specified for the following goods groups: milk – ‘Dairy products’; water – ’Bottled water’
Response parameters:
Parameter Type Mandatory Description Comment
id integer($int64)
- Identifier
inn string - INN
name string - Name
shortName string - Short name
fullName string - Full name
type string - Organisation type
status string - Status REGISTERED - Registered; NOT_REGISTERED - Not registered; REMOVED - Deleted; RESTORED - Restored; BLOCKED - Blocked.
kpp string - KPP
ogrn string - OGRN
head [string] - Managers
legalAddress string - Registered address
actualAddress string - Actual address
email string - Email
registrationDate integer ($int64)
- Registration
organisationForm string - Organisation Form: LE, PE, IE
emissionRegistrars string - Emission registrar
dissolved boolean - Organisation existence
122
Parameter Type Mandatory Description Comment
attribute
roles [string] - Organisation roles
phone string - Phone
Request example: For public type of privacy <url of stand>/facade/participants/0000000000 Authorisation: Bearer <TOKEN>
tnVedEaesGroup string - EEU FEACN code of goods item
productName string - Goods name on the label
emissionDate string (date-time)
+ IC emission date. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
producedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
participantInn string - INN of goods circulation participant
participantName string - Name of goods circulation participant
producerInn string - INN of goods manufacturer
producerName string - Goods manufacturer
ownerInn string - INN of goods owner
ownerName string - Name of goods owner
statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
lastDocType string + Type of the last document. See Catalogue - Types of documents
emissionType string + Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
receiptDate string (date-time)
- Date of withdrawal from circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IM KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found;
126
Parameter Type Mandatory Description
RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
prevCises string - Previous IС numbers. In case of goods remarking
nextCises [string] - Next IС numbers. In case of goods remarking
status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; RETIRED – dropped off; DISAGGREGATION – disaggregated (for packings only)
packType string + Packing type see Catalogue - Types of packing
children: - IC in aggregate
*cis string + Goods IC
*gtin string - Goods code
*producerName string - Goods manufacturer
*status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; RETIRED – dropped off; DISAGGREGATION – disaggregated (for packings only)
*emissionDate string (date-time)
+ Emission date. In yyyy-MM-ddTHH:mm:ss.SSS’Z format
*producedDate string (date-
- Date of application. Is returned in yyyy-MM-
127
Parameter Type Mandatory Description
time) ddTHH:mm:ss.SSS’Z format
*packageType string + Packing type see Catalogue - Types of packing
*ownerInn string - INN of goods owner
*ownerName string - Name of goods owner
*productName string - Goods name
*brand string - Brand
*prevCises [string] - Previous IСs. In case of goods remarking
*nextCises [string] - Next IС numbers. In case of goods remarking
*statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
*children: [string] - All children ICs. Looks like a JSON array
*childrenMap [string] - Brief information on children ICs
*countChildren integer - Number of children ICs
*parent string - Identification code of the packing where the goods are aggregated
*lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
*expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
*prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
*introducedDate string (date-time)
- Date of introduction into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*exporterName string - Name of the exporter
*exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
*agentInn string - INN of the current goods owner
*agentName string - Name of the current goods owner
*lastStatusChangeDate string (date-time)
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
tnVedEaesGroup string - EEU FEACN code of goods item
productName string - Goods name on the label
emissionDate string (date-time)
+ IC emission date. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
producedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
participantInn string - INN of goods circulation participant
participantName string - Name of goods circulation participant
producerInn string - INN of goods manufacturer
producerName string - Goods manufacturer
ownerInn string - INN of goods owner
ownerName string - Name of goods owner
statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods
133
Parameter Type Mandatory Description
(Goods awaiting remarking)
lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
lastDocType string + Type of the last document. See Catalogue - Types of documents
emissionType string + Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
receiptDate string (date-time)
- Date of withdrawal from circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IM KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period; KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
prevCises string - Previous IС numbers. In case of goods remarking
nextCises [string] - Next IС numbers. In case of goods remarking
status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; RETIRED – dropped off;
packType string + Packing type see Catalogue - Types of packing
children: - IC in aggregate
*cis string + Goods IC
*gtin string - Goods code
*producerName string - Goods manufacturer
*status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; RETIRED – dropped off; DISAGGREGATION – disaggregated (for packings only)
*emissionDate string (date-time)
+ Emission date. In yyyy-MM-ddTHH:mm:ss.SSS’Z format
*producedDate string (date-time)
- Date of application. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*packageType string + Packing type see Catalogue - Types of packing
*ownerInn string - INN of goods owner
*ownerName string - Name of goods owner
*productName string - Goods name
*brand string - Brand
*prevCises [string] - Previous IСs. In case of goods remarking
*nextCises [string] - Next IС numbers. In case of goods remarking
*statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
*children: [string] - All children ICs. Looks like a JSON array
*childrenMap [string] - Brief information on children ICs
*countChildren integer - Number of children ICs
*parent string - Identification code of the packing where the goods are aggregated
*lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
135
Parameter Type Mandatory Description
*expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
*prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
*introducedDate string (date-time)
- Date of introduction into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*exporterName string - Name of the exporter
*exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
*agentInn string - INN of the current goods owner
*agentName string - Name of the current goods owner
*lastStatusChangeDate string (date-time)
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
*pageDir - Pagination direction selection: PREV – previous section; NEXT – next section
*uit string - IC value – a reference point (record where sampling starts) used to sort records. Only to be used together with orderedColumnValue parameter
*orderColumn string - Name of column used to sort records. Acceptable value of emd - emission date
*orderedColumnValue string - Column value, a reference point (record where sampling starts) used to sort records. Only to be used together with uit parameter
*limit integer - The value sets the number of records in a reply (maximum is 10000 records, default is 10)
*cisAggregationState enum - IC/SPIN: PACKED- in aggregate (aggregated); NOT_PACKED – not in aggregate (disaggregated); ANY – any state (default value)
*packs string - Filtering by goods groups: ALL – goods and packings; UNIT – goods only; PACK – packings only
*aggregation boolean - Displaying goods and goods packings with the same status for aggregation
*countChildren integer (int32)
- Number of children ICs
*tree string - IC/SPIN list tree output method: NO_TREE – do not return nested ICs; ONE_LEVEL – return only the first nesting level; ALL_TREE – return the entire tree
*uituStatus string - SPIC status
138
Parameter Type Mandatory Description
*cache boolean - Cache flag. If the flag is enabled, the GCP receives a response with not more than the set limit of marking code of 1524
*prVetDocument string - Accompanying production veterinary document
*docType string - see Catalogue - Types of documents
*statusExt enum - Additional status of IC: CANCELLATION_APPLIED – Written off after application on goods; REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Written off; DONATION – Gratuitous transfer of goods; STATE_ENTERPRISE – Acquisition by a state enterprise; NO_RETAIL_USE – Use for purposes of buyer; BEYOND_EEC_EXPORT – Export outside EEU countries; REMOTE_SALE – Sale by sample, remote sale; EEC_EXPORT – Export to EEU countries; RETURN – Return to individual; DAMAGE_LOSS – Loss or damage; DESTRUCTION – Destruction; CONFISCATION – Confiscation; LIQUIDATION – Liquidation of business; FTS_RESPOND_NOT_OK - Unfavorable decision by FCS; FTS_RESPOND_WAITING - Awaiting confirmation by FCS; FTS_CONTROL - Controlled by FCS
*cisStatus string - Current IC status: APPLIED – emitted. Received; EMITTED – emitted. Released; INTRODUCED – In circulation; RETIRED – Dropped off
*withdrawReason string - Reason for withdrawal: KM_SPOILED – spoiled; LOST - IM KM_LOST – lost; KM_DESTROYED – destroyed; DESCRIPTION_ERRORS - errors in goods description found; RETAIL – retail sale; EEC_EXPORT – export to EEU countries; BEYOND_EEC_EXPORT – export outside EEU countries; RETURN – return to individual; REMOTE_SALE – sale by sample, remote sale; DAMAGE_LOSS – loss or damage; DESTRUCTION – destruction; CONFISCATION – confiscation; LIQUIDATION – liquidation of business; DONATION – gratuitous transfer; STATE_ENTERPRISE – acquisition by a state enterprise; NO_RETAIL_USE – use for purposes of buyer; ENTERPRISE_USE – use for purposes of enterprise; KM_SPOILED_OR_LOST - IM with MC spoiled or lost; KM_CANCELLATION - cancellation of MCs not converted in IM due to expiration of time period;
139
Parameter Type Mandatory Description
KM_CANCELLATION_BY_TERM - cancellation of unconverted MC (labeling) due to expiration of established shelf life; RETAIL_RETURN - Return of goods with damaged/missing IM at retail; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sales
*documentId string - Document registration number. Shall be specified when searching IC in the document
Response example: { ’count’: 678 }
Response parameters:
Parameter Type Mandatory Description
count string + MC Quantity
2.1.31. Method of receiving IC by identifier
URL: /facade/cis/info
Method: GET
Request example: curl -X POST ’<v4 stand url>/facade/cis/info?cisId=81635161684’ -H 'Authorisation: Bearer <TOKEN>' -H 'content-type: application/json'
cis string + Identification code used to filter the MC list
gtin string - Goods code
producerName string - Goods manufacturer
status enum + Type of goods/IC status: EMITTED – emitted. Released; APPLIED – emitted. Received; INTRODUCED – in circulation; RETIRED – dropped off; DISAGGREGATION – disaggregated (for packings only)
emissionDate string (date-time)
+ Date of IC emission. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
producedDate string (date-time)
- Date of application. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
packType + Packing type see Catalogue - Types of packing
141
Parameter Type Mandatory Description
ownerName string - Name of the current goods owner
ownerInn string - INN of goods owner
productName string - Goods name
brand string - Brand
prevCises [string] - Previous IС numbers. In case of goods remarking
nextCises [string] - Next IС numbers. In case of goods remarking
statusEx enum - Extended IC status: EMPTY – None; WAIT_SHIPMENT – Awaiting acceptance; WAIT_TRANSFER_TO_OWNER – Awaiting transfer to owner (contract manufacturing); REMARK_RETIRED – Remarked; RETIRED_CANCELLATION – Writing off; WAIT_REMARK – IC written off after application on goods (Goods awaiting remarking)
children [string] - IC in aggregate
countChildren integer (int32)
- Number of children ICs
parent string - SPIC of the upper level
lastDocId string - Latest registration number of the document recorded in TT GIS by this IC
expireDate string (date-time)
- Date of shelf life expiration. Returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format (mandatory for PG ‘Dairy products’)
prVetDocument string - Accompanying production veterinary document (mandatory for PG ‘Dairy products’)
introducedDate string (date-time)
- Date of introduction of goods with IC into circulation. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
exporterName string - Name of the exporter
exporterTaxpayerId string - Unique identifier of the exporter in the national taxpayer accounting system
agentInn string - INN of the current goods owner
agentName string - Name of the current goods owner
lastStatusChangeDate string (date-time)
+ Date of the last status change. Is returned in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*emissionType string - Emission type: LOCAL – manufactured in RF; FOREIGN – imported into RF; REMAINS – remains marking; CROSSBORDER – imported from EEU countries
*pageDir - Pagination direction selection: PREV – previous section; NEXT – next section
143
Parameter Type Mandatory Description
*uit string - IC value – a reference point (record where sampling starts) used to sort records. Only to be used together with orderedColumnValue parameter
*orderColumn string - Name of column used to sort records. Acceptable value of emd - emission date
*orderedColumnValue string - Column value, a reference point (record where sampling starts) used to sort records. Only to be used together with uit parameter
*limit integer - The value sets the number of records in a reply (maximum is 10000 records, default is 10)
*cisAggregationState enum - IC/SPIN: PACKED- in aggregate (aggregated); NOT_PACKED – not in aggregate (disaggregated); ANY – any state (default value)
*packs string - Filtering by goods groups: ALL – goods and packings; UNIT – goods only; PACK – packings only
*aggregation boolean - Displaying goods and goods packings with the same status for aggregation
*countChildren integer (int32)
- Number of children ICs
*tree string - IC/SPIN list tree output method: NO_TREE – do not return nested ICs; ONE_LEVEL – return only the first nesting level; ALL_TREE – return the entire tree
*uituStatus string - SPIC status
*cache boolean - Cache flag. If the flag is enabled, the GCP receives a response with not more than the set limit of marking code of 1524
*prVetDocument string - Accompanying production veterinary document
*docType string - see Catalogue - Types of documents
Response example: { ’count’: 678 }
144
Response parameters:
Parameter Type Mandatory Description
count string + MC Quantity
2.1.33. Method of receiving the list of MC using document number
URL: /facade/cis/docNum/{docNum}
Method: GET
Request example: curl -X GET '<v4 stand url>/facade/cis/docNum/186161351’ -H 'Authorisation: Bearer <TOKEN>'
The methods described in this subsection are intended to receive the information on all PGs except for MTTP and MDLP.
The following types of documents are used in non-tobacco and non-medicine methods:
• Description of remains;
• Aggregation;
• UTD for shipment;
• Introduction into circulation;
• Return into circulation;
• Shipping;
• Cancelling shipment;
• Acceptance;
• Withdrawal from circulation;
• MC order. OMS;
• Writing off MC;
• Remarking;
• ACC aggregation;
• ACC reaggregation;
• ACC disaggregation.
2.2.1. Single method of document creation
URL: /lk/documents/create
Method: POST
Type of privacy: private
Request example:
146
POST <stand url>/lk/documents/create?pg=lp Authorisation: Bearer <TOKEN> Content-Type: application/json { ‘document_format’: ‘string’, ‘product_document’: ‘<Document in Base64 format>‘, ‘type’: ‘string’, ‘signature’: ‘<Detached EES in Base64 format>‘ }
Request parameters:
Parameter Type Mandatory Description Comment
pg string + Goods Group see Catalogue - List of supported product groups
Request body parameters:
Parameter Type Mandatory Description Comment
document_format string + Document type Values: MANUAL – JSON format; XML – XML format; CSV – CSV format
product_document string + Document body translated into BASE64
see Catalogue - Types of documents
signature string + Detached signature (EQES) in BASE64 format
type string + Document type see Catalogue - Types of documents
Response example:
1 Code 200 If the document is created successfully, TT GIS returns a unique ID of the document:
9abd3d41-76bc-4542-a88e-b1f7be8130b5
2 If failed:
2.1. Code 401 If token is not specified:
{ <UnauthorisedException> <error>unauthorised</error> <error_description>Full authentication is required to access this resource</error_description> </UnauthorisedException> }
2.2. Code 400 If JSON structure in the request body is incorrect:
147
{ ‘error_message’: ‘JSON parse error: Cannot deserialize value of type’ }
2.3. Code 400 If the document_format field in the request body is missing:
{ ‘error_message’: ‘Document type not specified: MANUAL, CSV, XML’ }
2.4. Code 403 If PG functions are unavailable when there is a response body from medicine component:
{ ‘error_message’: ‘Remarking is not available for <GG name> GG’ }
2.5. Code 403 If PG functions are unavailable when there is no response body from medicine component:
{ ‘error_message’: ‘No access to resource’ }
2.6. Code 400 If the URL request parameter ’pg’ = ‘tobacco’:
{ ‘error_message’: ‘Method does not work with Tobacco GG’ }
2.2.2. Description of remains
Goods remains are described according to a reduced attribution.
Type of document:
Type Description
OST_DESCRIPTION Description of goods remains in JSON (MANUAL)
OST_DESCRIPTION_CSV Description of goods remains in CSV
OST_DESCRIPTION_XML Description of goods remains in XML
Starting from August 1, 2020, it is prohibited to create the above types of documents in the "Unified method of creating documents" (/lk/documents/create) for ’Footwear’ PG.
*consumer_age string - Age group Mandatory for clothing items, bed, table, bath and kitchen linens
Possible values:
149
Parameter Type Mandatory Description Comment
‘BABY’ - Baby; ‘ADULT’ - Adult; ‘NO_AGE’ - No age
*model string - Model Mandatory for ‘New pneumatic rubber tires and tire casings’ goods group
Example of document body in CSV format:
INN of economic agent,Version 1111111111,2 Goods list,,,,,, Goods nomenclature code (2 characters),Trade Mark Brand ,Goods item name,Target gender,Method for introducing a goods item into circulation,Consumer age,Model/ manufacturer SKU 00,trademark,product_name,male,Manufactured in RF,Baby,model
aggregationUnits array + List of created aggregates
*unitSerialNumber string + SPIC code of aggregate
Shipping package identification code is generated as per SPIC standard (18 digits)
*aggregationType string + Aggregation type code
Value can be only ’AGGREGATION’
*sntins array[string] + List of ICs included in the aggregate
Statuses of MCs or Aggregate shall be identical
Note: Aggregation may be either before or after the introduction into circulation. If the aggregation was before the introduction into circulation, the aggregates should be specified in the document of introduction into circulation instead of MC, otherwise the aggregates disaggregate. To introduce remains into circulation, generate introduction of remains into circulation first, and then perform aggregation, otherwise the aggregates would disaggregate.
participant_inn string + INN of goods circulation participant
reaggregation_type string + Operation type code Possible values: REMOVING – withdrawal; ADDING – addition
uitu string + Code of aggregate to be modified
uit_uitu_list array + List of aggregates to be added/removed
*uit_uitu string + Marking codes to be added/removed
*name string - Goods name
Example of document body in CSV format: Economic agent INN,Transformation type,Shipment packing individual code (SPIC),Version 0000000000,Withdrawal,000000000000000000,2 List of shipment packings or goods IC,SPIC ‘00000000000000000000000000000000000000’, ‘11111111111111111111111111111111111111’, ,’222222222222222222’
Automatic aggregate disaggregation is performed for any operations with IC in SPIC, except for cases where size and colour data are provided in ‘Introduction into circulation’ document for an imported goods item with FCS interaction (Introduction into circulation. Import with FCS).
*uit_code string - Unique identifier of goods item
Mandatory if uitu_code is not specified
*uitu_code string - Unique identifier of shipping package
Mandatory if uit_code is not specified
156
Example of document body in CSV format:
Document type,Economic agent INN,Date of manufacture,Goods manufacturer INN,Goods owner INN,Production order type, Request for putting goods into circulation (in-house manufacturing),0000000000,12.04.2019,0000000000,0000000000,In-house manufacturing, List of goods IC,SPIC,EEU FEACN code,Date of manufacture of the goods item,mandatory certification document,Document number,Document date, ‘11111111111111111111111111111111111111’,’000000000000000000’,0000000000,12.04.2019,Compliance certificate,111,12.04.2019, ’11111111111111111111111111111111111112’,’000000000000000000’,0000000000,12.04.2019,Compliance declaration,111,12.04.2019,
2.2.4.3. Introduction into circulation. Manufacturing outside of EEU
The method shall be considered deprecated; it will be supported till October 2020 for goods groups where unmarked products circulation prohibition date has not occurred.
When information is provided with LP_GOODS_IMPORT ‘Introduction into circulation. Manufacturing outside of EEU‘ method, declaration date for the product is verified. If the declaration date for the product is earlier than 2020-08-01, the document is processed with LP_GOODS_IMPORT ‘Introduction into circulation. Manufacturing outside of EEU‘ method; otherwise, it is processed with LP_FTS_INTRODUCE (Introduction into circulation. Import with FCS) and LP_GOODS_IMPORT (Introduction into circulation. Import outside EAEU) method.
159
Type of document:
Type Description
LP_GOODS_IMPORT Introduction into circulation. Import. JSON (MANUAL)
LP_GOODS_IMPORT_CSV Introduction into circulation. Import. CSV
LP_GOODS_IMPORT_XML Introduction into circulation. Import. XML
participant_inn string + INN of participant who emitted MC
declaration_date string + CD registration date
Set in yyyy-MM-dd format
declaration_number string + CD registration number
customs_code string + Customs authority code
160
Parameter Type Mandatory Description Comment
decision_code string + Code of decision made
Can have the following values: 10 - goods release permitted; 11 - goods release provided that payment of customs duties is ensured; 12 - goods release with special features stipulated in Article 121 of the Customs Code of the Eurasian Economic Union; 13 - goods release with special features stipulated in Article 122 of the Customs Code of the Eurasian Economic Union; 14 - goods release with special features stipulated in Article 123 of the Customs Code of the Eurasian Economic Union; 20 - conditional release of goods
pdfFile string - Attached PDF file. In Base64
products array + List of data on MC for introduction into circulation
*certificate_document string - Type code of document on mandatory certification
Possible values: CONFORMITY_CERTIFICATE – certificate of conformity; CONFORMITY_DECLARATION – declaration of conformity
*certificate_document_number string - Number of document on mandatory certification
*certificate_document_date string - Date of document on mandatory certification
2.2.4.8. Introduction into circulation. Import with FCS
When information is provided with LP_FTS_INTRODUCE ‘Introduction into circulation Import with FCS‘ method, declaration date is verified. If the declaration date is earlier than 2020-08-01, the document is processed with LP_GOODS_IMPORT ‘Introduction into circulation. Manufacturing outside of EEU‘ method; otherwise, it is processed with LP_FTS_INTRODUCE (Introduction into circulation. Import with FCS) and and LP_GOODS_IMPORT (Introduction into circulation. Import outside EAEU) method.
ATC or SPIC are not disaggregated in describing colour and size for ’Footwear’ goods group.
172
Type of document:
Type Description
LP_FTS_INTRODUCE Introduction into circulation. Import with FCS. JSON (MANUAL)
LP_FTS_INTRODUCE_CSV Introduction into circulation. Import with FCS. CSV
LP_FTS_INTRODUCE_XML Introduction into circulation. Import with FCS. XML
trade_participant_inn string + INN of participant who emitted MC
declaration_number string + CD registration number
declaration_date string + CD registration date
Set in dd.mm.yyyy format. Range of dates from 01.01.2000 till the document creation date
products_list: + List of goods for introduction into circulation
*cis string + Unique identifier of goods item
IC or SPIC or ATC is specified "Note: in the current implementation of the import document functionality, it is only possible to specify the IC"
*packType string + Package type UNIT - IC; LEVEL1-99 - SPIC; ATK - aggregated customs code
*colour string - Colour Colour value containing 1-1024 letters in English or Russian is specified. Only Footwear GG is used
*productSize string - Size in the stitch system as per GOST 11373-88
A single size can be specified; specifying a range is not available. Size can be specified in decimal point format. A multiple of 0.5 in 14.5 - 47 range. Only Footwear GG is used
*children: array - Goods in packing
**cis string + Unique identifier of goods item
IC or SPIC or ATC is specified "Note: in the current implementation of the import document functionality, it is only possible to specify the IC"
**packType string - Package type UNIT - IC; LEVEL1-99 - SPIC; ATK - aggregated customs code
**colour string - Colour Colour value containing 1-1024 letters in English or Russian is specified. Only Footwear GG is used
**productSize string - Size in the stitch system as per GOST 11373-88
A single size can be specified; specifying a range is not available. Size can be specified in decimal point format. A multiple of 0.5 in 14.5 - 47 range. Only Footwear GG is used
The method is not applicable for goods groups ‘Dairy products’, ‘Bottled water’, ‘Bicycles and bicycle frames’, ‘Wheelchairs’ and ‘Alternative tobacco products’.
The method is not applicable for goods groups ‘Dairy products’, ‘Bottled water’, ‘Bicycles and bicycle frames’, ‘Wheelchairs’ and ‘Alternative tobacco products’.
trade_participant_inn string + INN of goods circulation participant
atk string + Aggregated customs code to be reaggregated
transformation_type string + Type of reaggregation Removal – REMOVING; Addition – ADDING
products_list array + List of identification codes
*ki string + Identification code
177
Example of document body in CSV format:
Economic agent INN,transformation type,aggregated customs code,Version 1111111111,Withdrawal,1111111111111111111111111,2 List of goods IC 22222222222222222222222222222222222222 33333333333333333333333333333333333333
The method is not applicable for goods groups ‘Dairy products’, ‘Bottled water’, ‘Bicycles and bicycle frames’, ‘Wheelchairs’ and ‘Alternative tobacco products’.
*uit_code string - Unique identifier of goods item
Mandatory if uitu_code is not specified
*uitu_code string - Unique identifier of shipping package
Mandatory if uit_code is not specified
*product_cost integer - Unit price Cost is specified in kopecks, including VAT.
*product_tax integer - VAT amount
receiver_inn string + INN of receiver
185
Parameter Type Mandatory Description Comment
request_type string + Document type Parameter value shall be = SHIPMENT
transfer_date string + Date of transfer of marked goods
Set in yyyy-MM-dd format
turnover_type string + Shipping type code Possible values: SELLING – selling
sender_inn string - INN of sender
st_contract_id string - Identifier of state contract
Mandatory if ‘withdrawal_type’ = ‘STATE_ENTERPRISE’
to_not_participant boolean - Attribute of shipping to non-participant
Possible values: true – shipping to non-participant; false – shipping to participant
withdrawal_date string + Date of withdrawal from circulation
Set in yyyy-MM-dd format
withdrawal_type enum + Reason for withdrawal from circulation
Reason for withdrawal from circulation: DONATION – non-compensatory transfer; STATE_ENTERPRISE – acquisition by a government-owned enterprise; NO_RETAIL_USE – used by customer for internal purposes
Example of document body in CSV format:
Sender INN,Receiver INN,Shipment date,Source document number,Source document date,Goods circulation type,Reason for withdrawal,Withdrawal date,State contract ID,Shipment to non-participant,Version 1111111111,2222222222,06.05.2020,123,06.05.2020,Sale,Acquisition by a state enterprise,06.05.2020,12345678912345678912,No,5 Goods parameters IC,SPIC,Price per unit,VAT amount ‘000000000000000000qqqqqqqqqqqqq’,,10000,0
document_number string - Number of primary document
request_type string + Document type Parameter value shall be = ‘ACCEPTANCE’
reject_all boolean - Reject all If value is true, specifying goods list is not required: rejects all
document_date string (date-time)
- Date of primary document
Set in yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z format
accept_all boolean - Accept all If value is true, specifying goods list is not required: accepts all
trade_sender_name string - Sender name
transfer_date string (date-time)
- Date of goods transfer
Set in yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z format
acceptance_date string (date-time)
+ Date of goods acceptance
Set in yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z format
trade_sender_inn string + INN of sender
trade_recipient_inn string + INN of receiver
turnover_type string - Shipping type Possible values: SELLING – selling;
191
Parameter Type Mandatory Description Comment
code COMMISSION – commission; AGENT – agent
release_order_number string + Shipment number
products array + List of information on goods
*accepted boolean + Goods acceptance attribute
*uit_code string - Unique identifier of goods item
Mandatory if uitu_code is not specified
*uitu_code string - Unique identifier of goods item
Mandatory if uit_code is not specified
*product_cost integer - Unit price Cost is specified in kopecks, including VAT.
*product_tax integer - VAT amount VAT amount is specified in kopecks
*product_description string - Goods description
*children array - IC in aggregate Information about nested MC for partial acceptance
*count_children integer (int32)
- Number of children ICs
exporter_taxpayer_id string - Unique identifier of the exporter in the national taxpayer accounting system
Parameter is only specified for acceptance of Cancelling shipment at cross-border trading document
exporter_name string - Name of the exporter
Parameter is only specified for acceptance of Cancelling shipment at cross-border trading document
release_method string - Code of method of introduction into circulation
This parameter is only specified for Shipment at cross-border trading document acceptance, and it must be equal to ‘CROSSBORDER’
Note: in Acceptance document, only IC/SPIC eligible for this shipment may be specified; unspecified IC/SPIC are not accepted by default. If a non-integral SPIC is accepted, only IC which will be accepted in SPIC may also be specified
action enum + Reason for withdrawal from circulation
Reason for withdrawal fro circulation: RETAIL – Retail sale; EEC_EXPORT – Export to EEU countries; BEYOND_EEC_EXPORT – Export outside the EEU countries; RETURN – Return to individual; REMOTE_SALE – Sale by sample, remote sale; DAMAGE_LOSS – Loss or damage; DESTRUCTION – Destruction; CONFISCATION – Confiscation; LIQUIDATION – Liquidation of business; ENTERPRISE_USE – Use for purposes of enterprise
action_date string + Date of withdrawal from circulation
Set in yyyy-MM-dd format
document_date string + Date of primary document
Set in yyyy-MM-dd format
document_number string + Number of primary document
document_type enum + Type of primary document
Type of primary document depends on ’action’ parameter:
RETAIL – retail sale: RECEIPT – register receipt; SALES_RECEIPT – sales receipt; OTHER – Other (with indication of name manually)
EEC_EXPORT – export to EAEU countries: CONSIGNMENT_NOTE – Consignment note; UTD – Universal transfer document; OTHER – Other (with indication of
194
Parameter Type Mandatory Description Comment
name manually)
RETURN – return to a physical entity: OTHER – Other (with indication of name manually)
REMOTE_SALE – sale on sample and remote sales: RECEIPT – Cash register receipt; SALES_RECEIPT – Sale receipt; CONSIGNMENT_NOTE – Packing list; UTD – Universal transfer document; OTHER – Other
DAMAGE_LOSS – Loss or damage: DESTRUCTION_ACT – Certificate of destruction (loss/disposal); OTHER – Other (with indication of name manually)
Destruction: DESTRUCTION – Certificate of destruction (loss/disposal); OTHER – Other (with indication of name manually)
CONFISCATION – Confiscation: CONSIGNMENT_NOTE – Packing list; UTD – Universal transfer document; OTHER – Other
LIQUIDATION – Liquidation of business: CONSIGNMENT_NOTE – Packing list; UTD – Universal transfer document; OTHER – Other
ENTERPRISE_USE – use for the internal business purposes: DESTRUCTION_ACT - Certificate of destruction (loss/disposal); OTHER – Other
inn string + EA INN
kkt_number string - Control and cash register equipment
Cash register number
pdfFile string - Attached PDF file in Base64
195
Parameter Type Mandatory Description Comment
primary_document_custom_name string - Name of primary document
Mandatory if ’Other’ is specified in the ‘Type of primary document’ field
products array + Goods item in request
*cis string + IC IC
*primary_document_date string (date)
- Date of primary document
Set in yyyy-MM-dd format; it shall be specified as required or if it deviates from the value of ‘document_date’ parameter
*primary_document_number string - Number of primary document
It shall be specified as required or if it deviates from the value of ‘document_number’ parameter
*primary_document_type enum - Type of primary document
It shall be specified as required or if it deviates from the value of ‘document_type’ parameter Primary document type depends on ’action’ parameter:
RETAIL – retail sale: RECEIPT – register receipt; SALES_RECEIPT – sales receipt; OTHER – Other (with indication of name manually)
EEC_EXPORT – export to EAEU countries: CONSIGNMENT_NOTE – Consignment note; UTD – Universal transfer document; OTHER – Other (with indication of name manually)
RETURN – return to a physical entity: OTHER – Other (with indication of name manually)
REMOTE_SALE – sale on sample and remote sales: RECEIPT – Cash register receipt; SALES_RECEIPT – Sale receipt; CONSIGNMENT_NOTE – Packing list; UTD – Universal transfer document; OTHER – Other
DAMAGE_LOSS – Loss or damage:
196
Parameter Type Mandatory Description Comment
DESTRUCTION_ACT – Certificate of destruction (loss/disposal); OTHER – Other (with indication of name manually)
Destruction: DESTRUCTION – Certificate of destruction (loss/disposal); OTHER – Other (with indication of name manually)
CONFISCATION – Confiscation: CONSIGNMENT_NOTE – Packing list; UTD – Universal transfer document; OTHER – Other
LIQUIDATION – Liquidation of business: CONSIGNMENT_NOTE – Packing list; UTD – Universal transfer document; OTHER – Other
ENTERPRISE_USE – use for the internal business purposes: DESTRUCTION_ACT - Certificate of destruction (loss/disposal); OTHER – Other
*primary_document _custom_name
string - Name of primary document
It shall be specified as required or if it deviates from the value of ‘primary_document_custom_name’ parameter
*product_cost integer - Unit price Cost is specified in kopecks, including VAT. Mandatory for receipts
trade_participant_inn string + INN of goods circulation participant
Note: to write off an MC in EMITTED status (Emitted. Released), close the order in OMS. This will bring all applied MC to APPLIED status, while others will be written off automatically. Otherwise, wait until MC are written off automatically upon expiration.
<cancellation_document_number>123</cancellation_document_number> <km_list> <!--1 or more repetitions:--> <km> <kit>00000000000000000000000000000000000000</kit> <cancellation_reason>KM_LOST</cancellation_reason> </km> <km> <kitu>000000000000000000</kitu> <cancellation_reason>KM_LOST</cancellation_reason> </km> </km_list> </km_cancellation>
2.2.16.2. Writing off applied MCs
This method is not used for product group ‘Dairy products’.
Is applied to MC in INTRODUCED status (in circulation) when GCP needs to write off an MC without bringing it out of circulation. MC gets status = WRITTEN_OFF and statusEx = WAIT_REMARK (MC is written off upon application to a goods item) (A goods item awaits re-marking). Thus, this MC (statusEx = WAIT_REMARK) can be further used in LK_REMARK scheme with re-marking reason = MC write-off reason in LK_APPLIED_KM_CANCELLATION scheme.
Example of document body in CSV format:
Type of document:
Type Description
LK_APPLIED_KM_CANCELLATION Writing off applied IC. JSON (MANUAL)
LK_APPLIED_KM_CANCELLATION_CSV Writing off applied IC. CSV
LK_APPLIED_KM_CANCELLATION_XML Writing off applied IC. XML
trade_participant_inn string + INN of goods circulation participant
Note: to write off an MC in EMITTED status (Emitted. Released), close the order in OMS. This will bring all applied MC to APPLIED status, while others will be written off automatically. Otherwise, wait until MC are written off automatically upon expiration.
participant_inn string + INN of goods circulation participant
remarking_date string + Date of repeated marking
Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
remarking_cause string + Code of reason for repeated marking
Possible values: KM_SPOILED – IM with MC spoiled or lost; DESCRIPTION_ERRORS – Errors in goods description found; RETAIL_RETURN – Return of goods with damaged/missing IM at retail sale; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sale
products array + List of information on goods
*remarking_date string + Date of repeated marking
Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format
*remarking_cause string + Code of reason for repeated marking
Possible values: KM_SPOILED – IM with MC spoiled or lost; DESCRIPTION_ERRORS – Errors in goods description found; RETAIL_RETURN – Return of goods with damaged/missing IM at retail sale; REMOTE_SALE_RETURN - Return of goods with damaged/missing IM at remote sale
For ‘Dairy products’ and ‘Bottled water’ PG, Code of reason for repeated marking (remarking_cause) shall only have the following values: KM_SPOILED – IM with MC spoiled or lost; DESCRIPTION_ERRORS - Errors in goods description found.
*certificate_document string - Type code of document on mandatory certification
Possible values: CONFORMITY_CERTIFICATE – certificate of conformity; CONFORMITY_DECLARATION – declaration of conformity
203
Parameter Type Mandatory Description Comment
certificate_document_number string - Number of document on mandatory certification
*certificate_document_date string - Date of document on mandatory certification
Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format Range of dates from 2000-01-01 till the document creation date
*last_uin string - Previous unique identifier of goods item
It is not specified if ‘remarking_cause’ = ‘RETAIL_RETURN’ or ‘REMOTE_SALE_RETURN’
*new_uin string + New unique identifier of goods item
*primary_document_type enum - Type of primary document
RECEIPT – Cash register receipt; SALES_RECEIPT – Sales receipt; OTHER – Other. Parameter is mandatory if: remarking_cause = ‘Return of footwear with damaged/missing IM at retail’; remarking_cause = ‘Return with damaged/missing IM at remote sales’ + paid = true; parameter not specified if: remarking_cause = ‘Return with damaged/missing IM at remote sales’ + paid = false
*primary_document_custom_name string - Name of primary document
It shall be filled in if the primary document type is specified as ’OTHER’. Parameter is mandatory if: remarking_cause = ‘Return of footwear with damaged/missing IM at retail’; remarking_cause = ‘Return with damaged/missing IM at remote sales’ + paid = true; parameter not specified if: remarking_cause = ‘Return with damaged/missing IM at remote sales’ + paid = false
*primary_document_date string (date-time)
- Date of primary document
Set in yyyy-MM-ddTHH:mm:ss.SSS’Z format Parameter is mandatory if: remarking_cause = ‘Return of footwear with damaged/missing IM at retail’; remarking_cause = ‘Return with
204
Parameter Type Mandatory Description Comment
damaged/missing IM at remote sales’ + paid = true; parameter not specified if: remarking_cause = ‘Return with damaged/missing IM at remote sales’ + paid = false
*primary_document_number string - Number of primary document
Parameter is mandatory if: remarking_cause = ‘Return of footwear with damaged/missing IM at retail’; remarking_cause = ‘Return with damaged/missing IM at remote sales’ + paid = true; parameter not specified if: remarking_cause = ‘Return with damaged/missing IM at remote sales’ + paid = false
ATK_DISAGGREGATION_CSV ACC disaggregation XML ACC disaggregation. CSV
ATK_DISAGGREGATION_XML ACC disaggregation CSV ACC disaggregation. XML
RECEIPT Receipt Formed by fiscal data operator
211
Code Name Format Document type format description
RECEIPT_RETURN Return receipt Formed by fiscal data operator
Universal documents Universal documents are created in v. 1.2 API EDM lite documentation and are received from commercial electronic document management
LEVEL2 Level 2 package Box Level 2 shipping package (SSCC at the moment)
LEVEL3 Level 3 package Pallet
LEVEL4 Level 4 package
LEVEL 5 Level 5 package
BUNDLE Bundle
ACC Aggregated Customs Code
213
3.6. Catalogue - Order statuses
Code Description
NEW Registered
PRODUCTION Production
VALIDATION_FAILED Error during check
IN PROGRESS Order is under execution process
SUCCESS Order is executed
ERROR Error occurred during order execution
RESULT_EXPIRED Order has expired
3.7. Catalogue - Document statuses
Code Description
IN_PROGRESS Under check
CHECKED_OK Processed
CHECKED_NOT_OK Processed with errors
PROCESSING_ERROR Technical error
UNDEFINED Undefined
CANCELLED Cancelled. Only for ‘Cancelling shipment’ document
ACCEPTED Accepted. Only for ‘Shipment’ document.
WAIT_ACCEPTANCE Awaits acceptance. Only for ’Shipment’ document. It is set in case of successful processing of ‘Goods shipment’ document
WAIT_PARTICIPANT_REGISTRATION Awaiting registration of participant in TT GIS. Only for ’Shipment’ document. It is set in case of successful processing of ‘Goods shipment’ document to unregistered participant
<UnauthorisedException> <error>unauthorised</error> <error_description>Full authentication is required to access this resource</error_description> </UnauthorisedException>
402 ERROR Error in attribute content of request body
403 ERROR Forbidden
Access denied 1 For all methods except for NC methods:
1.1. If a user (GCP) is not granted access to a specific remote service:
{ ‘error_message’: ‘No access to resource’ }
2 For all NC methods:
2.1. If incorrect API key is specified
{ ‘error_message’: ‘No access to resource’ }
404 ERROR Not Found
Requested information is not found in TT GIS
1 For all NC methods:
{ ‘error_message’: Data not found> not found’}
215
Code Name Description Format of error message
2 For all methods except for NC methods:
{ ‘error_message’: ‘<Parameter description> not found’ }
Error in indication of method URL
{‘error_message’: ‘Method with specified URL not found’ }
409 ERROR The request could not be completed due to a conflict with the current state of the resource
410 ERROR The resource was previously available at the specified URL, but now it is deleted and unavailable
413 ERROR Acceptable request body size exceeded
{‘error_message’: ‘Request too big’ }
500 ERROR Internal server Error
Internal error of remote systems (technically detailed description does not return)
{ ‘error_message’: ‘Error during request execution’ }
503 ERROR Service Unavailable
Problem with access to remote system
{‘error_message’: ‘Remote system is not available’ }
504 ERROR Error during receiving the system response
{ error_message: ‘No reply from system’ }
3.9. Catalogue - Types of organisations
Code in DB Code Description
1 TRADE_PARTICIPANT Goods Circulation Participant
2 PRODUCER Goods manufacturer
3 IMPORTER Importer of goods
4 WHOLESALER Wholesale trading
5 RETAIL Retail trading
6 IS_MP_OPERATOR TT GIS operator
7 CEM LABELLING_CENTER
8 OGV State authority
3.10. Catalogue - GCP statuses
Code Description
REGISTERED Registered
216
Code Description
NOT_REGISTERED Not registered
REMOVED Deleted
RESTORED Restored
BLOCKED Blocked
3.11. Catalogue - Statuses of request for GCP registration
No. Code Value
1 IN_PROGRESS Under consideration (check)
2 CHECKED_OK Checked
3 REGISTERED Document is registered (accepted by system)
4 CHECKED_NOT_OK Error
5 PROSECCING_ERROR Error during processing
6 UNDEFINED Undefined
3.12. Catalogue - Document statuses in SD life cycle
Code Description
10 New
20 Agreement
40 Signing
50 Activation
60 Active
100 Invalid
3.13. Catalogue - Status model
Each status has an indication of what type of documents it applies to:
Status Statuses of outgoing documents Statuses of incoming documents
0 Draft -
11 Awaiting sending -
1 Sent -
2 Delivered (signature not required) Signature is not required
12 Viewed (signature not required) Signature is not required (document is viewed)
3 Delivered (awaiting signing) Signature is required
13 Viewed (awaiting signing) Signature is required (document is viewed)
217
Status Statuses of outgoing documents Statuses of incoming documents
4 Signed Signed
5 Rejected Rejected
15 Rejected (request is viewed) Rejected (request is viewed)
6 Revoked Revoked
16 Cancellation requested Awaiting cancellation
17 Awaiting cancellation Cancellation requested
18 Canceled Canceled
19 Cancellation rejected Cancellation rejected
7 Refined Refined
8 Refinement required Awaiting refinement
14 Refinement required (request for refinement is viewed)
Request for refinement is viewed (awaiting refinement)
9 Error in signature Error in signature
10 Error of delivery Error of delivery
3.14. Catalogue - Additional parameters for PG
3.14.1. Additional parameters for PG ’Footwear’
Parameter Description Note
brand Trademark / Brand
productType Footwear type
productTypeDesc Text description of footwear type
name Full product name
productSize Stich size
colour Colour
materialUpper Top material
materialLining Lining material
materialDown Bottom/sole material
model Model / Article of manufacturer
218
3.14.2. Additional parameters for PG ‘Clothing, bed linen, table linen, bath and kitchen linen’
Parameter Description Note
brand Trade mark
name Full product name
type Goods type
size Item size
colour Colour
textileType Textile type
structure Structure
consumer_age User age
gender Target gender
model Model / Article of manufacturer
3.14.3. Additional parameters for PG ‘Photo cameras (except for cine cameras), flash lights and flash bulbs’
Parameter Description Note
brand Trade mark
name Full product name
type Goods type
standardNumber Number of regulation / standard
model Model / Article of manufacturer
3.14.4. Additional parameters for PG ‘Bicycles and bicycle frames’
Parameter Description Note
brand Trademark / Brand
model Model / Article of manufacturer
productKind Goods type
productionYear Year of manufacture
engineType Engine type
enginePower Engine power, hp
electricEnginePower Electric motor power, W
frameSize Frame size
colour Colour
219
Parameter Description Note
weightGross Gross weight
frameMaterial Frame material
rimDiameter Bead seat diameter, inches
sectionWidth Section width, inches
brakeSystemType Brake system type
frontForkType Front fork type
3.14.5. Additional parameters for PG ’Wheelchairs’
Parameter Description Note
brand Trademark / Brand
productKind Goods type
model Model / Article of manufacturer
weightGross Gross weight
maximumLoad Maximum load, kg
seatDepth Seat depth
seatWidth Seat width
seatHeight Seat height
backHeight Back height
3.14.6. Additional parameters for PG ‘Perfume and eau de toilette’
Parameter Description Note
brand Trademark / Brand
perfumeryType Type of perfume
volume Declared volume
packageType Package type
packMaterial Packing material
3.14.7. Additional parameters for PG ‘New pneumatic rubber tires and tire casings’
Parameter Description Note
brand Trade mark
model Model / Article of manufacturer
tireSectionWidth Tire (tube) section width, mm
220
Parameter Description Note
heightWidthRatio Tire section height to width ratio, %
frameConstructionType Tire carcass structure type
tireLoadIndex Load index
speedCategory The velocity category
seasonality Seasonality
frameSealingType Tire type by pressurization method
3.14.8. Additional parameters for PG ‘Dairy products’
Parameter Description Note
brand Trademark / Brand
milkProductType Type of a product
rawOrigin Raw products origin
fat Fat content, %
volumeWeight Declared output / net weight
vetisId Goods identifier in FGIS VetIS
babyFoodProduct Products for baby food
Structure Structure
221
4. Examples of authentication with EQES / Signing of documents
4.1. Example of token receiving during authorisation with attached signature / signing of documents with detached signature in 1C // sThumbprint - thumbprint of the certificate used for signing; string // representing the thumbprint in hexadecimal form // example195934d72dcdf69149901d6632aca4562d8806d8 // SignatureText must be in Base64 format // bDetached - True/False - detached(for document signing)/attached(for obtaining an authorisation token) signature Function SignText(SignatureText, sThumbprint, bDetached) CADESCOM_BASE64_TO_BINARY = 1; // Input data received in Base64 CADESCOM_CADES_TYPE = 1; // Advanced signature type CAPICOM_AUTHENTICATED_ATTRIBUTE_SIGNING_TIME = 0; // Timestamp attribute oSigner = New COMObject(‘CAdESCOM.CPSigner’); // Object that sets the creation parameters and contains information about the advanced signature.oSigner.Certificate = GetCertificateByThumbprint(sThumbprint); oSigningTimeAttr = New COMObject(‘CAdESCOM.CPAttribute’); oSigningTimeAttr.Name = CAPICOM_AUTHENTICATED_ATTRIBUTE_SIGNING_TIME; oSigningTimeAttr.Value = CurrentData(); oSigner.AuthenticatedAttributes2.Add(oSigningTimeAttr); SignatureText= AbbrPP(SignatureText); oSignedData = New COMObject(‘CAdESCOM.CadesSignedData’); // CadesSignedData object provided properties and methods for advanced signature handling. oSignedData.ContentEncoding = CADESCOM_BASE64_TO_BINARY; SignedData.Content = AbbrPP(SignatureText); EncodingType = 0; sSignedMessage = oSignedData.SignCades(oSigner, CADESCOM_CADES_TYPE, bDetached, EncodingType); // The method adds an advanced signature to a message. Return sSignedMessage; // Signature in Base64 format FunctionEnd //Thumbprint- HEX string Function GetCertificateByThumbprint(StringThumbpring) Res = Undefined; // Detected certificate (Com object) CAPICOM_CURRENT_USER_STORE = 2; //2 - Search a certificate in ‘Personal’ branch of the storage. CAPICOM_MY_STORE = ’My’; // Indicate that ‘Personal’ branch is taken from the current user's storage CAPICOM_STORE_OPEN_READ_ONLY = 0; // Open the storage for read only oStore = NewCOMObject(‘CAdESCOM.Store’); // The object describes the certificate storage oStore.Open(CAPICOM_CURRENT_USER_STORE, CAPICOM_MY_STORE, CAPICOM_STORE_OPEN_READ_ONLY); // Open the certificate storage
222
// Option 1: search a certificate by a thumbprint CAPICOM_CERTIFICATE_FIND_SHA1_HASH = 0; Certificates = oStore.Certificates.Find(CAPICOM_CERTIFICATE_FIND_SHA1_HASH, StrThumbprint); Res = Certificates.Item(1); //Option 2: traverse the collection and compare against the thumbprint //For Each CurCertificate From oStore.Certificates Loop //CurThumbprint = CurCertificate.Thumbprint; // Thumbprint in hexadecimal form is returned //If ВРЕГ(CurThumbprint) = ВРЕГ(StrThumbprint) Then//Res= CurCertificate; //Interrupt; //EndIf; //EndLoop; oStore.Close(); // Close the storage and free object 61 Return Res; EndFunction
4.2. Example of token receiving during authorisation via REACT JS. import { CadesPluginer as anyName } from ’@crpt/cades-pluginer’; //or import CadesPluginer from ’@crpt/cades-pluginer’; //usually you will need 2 methods CadesPluginer.getFinalCertsArray().then(certs => { console.log(‘certs’, certs); CadesPluginer.signMessage(‘lalala’, certs[0].certificate).then(signed => console.log(‘signed’, signed); ); });
4.3. Example of token receiving during authorisation with attached signature / signing of documents with detached signature via Java. String data = ...//getting an authorisation code boolean detached = false; // false - attached signature(for obtaining an authorisation token) // true - detached signature(for signing documents) //Generatin a signature KeyStore keyStore = loadKeyStore();//initializing a key storage List<X509CertificateHolder> chain = new ArrayList<>(); List<Certificate> certs = Arrays.asList(keyStore.getCertificateChain(alias)); certs.forEach(cert -> { try { chain.add(new X509CertificateHolder(cert.getEncoded())); } catch (IOException | CertificateEncodingException e) { log.error(‘Error while building certificate chain’, e); } }); PrivateKey privateKey = (PrivateKey) (keyStore.getKey(alias, password)); ByteArrayOutputStream out = new ByteArrayOutputStream(); CAdESSignature signature = new CAdESSignature(detached); signature.setCertificateStore(new CollectionStore(chain)); final Hashtable table = new Hashtable(); Attribute attr = new Attribute(CMSAttributes.signingTime, new DERSet(new Time(new Date()))); // устанавливаем время подписи
223
table.put(attr.getAttrType(), attr); AttributeTable attrTable = new AttributeTable(table); //Adding a signee. Algorithms may differ depending on requirements signature.addSigner(JCP.PROVIDER_NAME, JCP.GOST_DIGEST_OID, JCP.GOST_EL_DH_OID, privateKey, certs, CAdESType.CAdES_BES, null, false, attrTable, null); signature.open(out); signature.update(data); signature.close(); byte[] signedCode = out.toByteArray(); //Use the signed code for token retrieval / generated detached EQES of the document together with the document
4.4. Description of plug-in methods:
Method Description
getFinalCertsArray(): Promise<Cert[]>
Init plugin, create store, . Cert: \{certificate: \{}, info: [] }, certificate is an original cadesplugin Certificate object, info is an array [name, date_from, date_to, serial_number].