Marking code verification statuses
The method is available for models: FBS and Express.
If you are using an API Key token, one of the accesses in the list is required to call the method
- inventory-and-order-processing — Order processing and inventory
- inventory-and-order-processing:read-only — View order information
- all-methods — Full account management
- all-methods:read-only — View all data
Returns the verification statuses of the marking codes in the order.
An order that contains jewelry or products with mandatory labeling in the system «Честный ЗНАК», will change to the status READY_TO_SHIP, only when:
-
In the method PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes You will send the following information to Yandex.Market:
-
Win for each piece of jewelry in the order;
-
marking codes in the system «Честный ЗНАК» for all products in the order for which it is required.
-
-
All marking codes will be successfully verified.
| ⚙️ Limit: 100,000 requests per hour |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/{orderId}/identifiers/status
Path parameters
|
Name |
Description |
|
campaignId* |
Type: integer<int64> The campaign ID. You can find it using a query GET v2/campaigns or find it in the seller's office on the Market — click on your account icon → Settings and in the menu on the left, select APIs and modules:
⚠️ Do not send the store ID instead, which is indicated in the seller's account on the Market next to the store name and in some reports.
Min value: |
|
orderId* |
Type: integer<int64> The order ID. |
Responses
200 OK
Information on checking the marking codes.
Body
application/json
{
"status": "OK",
"result": {
"items": [
{
"id": 0,
"uin": [
{
"value": "string",
"status": "OK",
"substatus": "UIN_MERCHANT_MISMATCH"
}
],
"cis": [
{
"value": "string",
"status": "OK",
"substatus": "WRONG_OWNER_INN"
}
]
}
]
}
}
|
Name |
Description |
|
status* |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
|
result |
Type: GetOrderIdentifiersStatusDTO Information on checking the marking codes. |
ApiResponseStatusType
The type of response. Possible values:
OK— There are no errors.ERROR— an error occurred while processing the request.
|
Type |
Description |
|
Enum: |
GetOrderIdentifiersStatusDTO
Information on checking the marking codes.
|
Name |
Description |
|
items* |
Type: OrderItemValidationStatusDTO[] A list of product identifiers and information on checking codes. |
OrderItemValidationStatusDTO
Product identifiers and information on checking their codes.
|
Name |
Description |
|
id* |
Type: integer<int64> The product ID in the order. |
|
cis |
Type: CisDTO[] Information on checking the marking codes in the system «Честный ЗНАК». Min items: |
|
uin |
Type: UinDTO[] Verification Information УИНов. Min items: |
CisDTO
Verification status and marking code in the system «Честный ЗНАК».
|
Name |
Description |
|
status* |
Type: CisStatusType The status of checking the marking code in the system «Честный ЗНАК»:
Enum: |
|
value* |
Type: string The marking code in the system «Честный ЗНАК». |
|
substatus |
Type: CisSubstatusType Detailing the error when checking the marking code in the system «Честный ЗНАК»:
Returned only for the status Enum: |
UinDTO
Verification status and УИН.
|
Name |
Description |
|
status* |
Type: UinStatusType LOGIN verification status:
Enum: |
|
value* |
Type: string WIN the product. |
|
substatus |
Type: UinSubstatusType Error details during verification УИНа.
Returned only for the status Enum: |
CisStatusType
The status of checking the marking code in the system «Честный ЗНАК»:
-
FAILED— couldn't verify the code.Please try again later or delete the marking code.
-
IN_PROGRESS— during the verification process. -
NOT_ON_VALIDATION— the marking code has not been sent for verification. -
OK— the check was successfully completed. -
INVALID— verification failed. The sale of goods with this code is prohibited.
|
Type |
Description |
|
Enum: |
CisSubstatusType
Detailing the error when checking the marking code in the system «Честный ЗНАК»:
-
WRONG_OWNER_INN— verification failed. The INN of the code owner differs from the INN of the seller. -
CIS_VALIDATION_ERROR— verification failed. -
CIS_GTIN_NOT_FOUND— The marking code does not contain GTIN. -
CIS_SERIAL_NUMBER_NOT_FOUND— The marking code does not contain a serial number. -
INVALID_SYMBOLS_FOUND— The marking code contains invalid characters. -
CRYPTO_TAIL_FORMAT_MISMATCH_CIS_TYPE— The format of the cryptographic signature does not correspond to the type of marking code. -
INVALID_CRYPTO_TAIL— the cryptographic signature is not valid. -
INVALID_CRYPTO_KEY— the cryptographic key is not valid. -
VERIFICATION_FAILED_IN_EMITTER_COUNTRY— The marking code has not been verified in the country of the issuer. -
UNSUPPORTED_AI_FOUND— The AI markings found in the code are not supported. -
CIS_NOT_FOUND_IN_GIS_MT— the marking code was not found in ГИС МТ. -
NOT_PLACED_ON_MARKET— The marking code has not been put into circulation. -
NOT_PRINTED_ON_PACKAGE— The marking code is not printed on the package. -
EXPIRED_ITEM— the marked product has expired. -
SALE_BLOCKED_BY_OGB— The retail sale of products is blocked by the decision of the OGV. -
ITEM_SOLD— the marked product has been sold.
Returned only for the status INVALID.
|
Type |
Description |
|
Enum: |
UinStatusType
LOGIN verification status:
-
FAILED— failed verification. -
IN_PROGRESS— during the verification process. -
NOT_ON_VALIDATION— The WIN has not been sent for verification or not all the WINs in the order have been transferred. -
OK— the check was successfully completed.
|
Type |
Description |
|
Enum: |
UinSubstatusType
Error details during verification УИНа.
-
UIN_MERCHANT_MISMATCH— УИН does not belong to your store. -
UIN_MERCHANT_UNREGISTERED— the store is not connected to the system ГИИС ДМДК. -
UIN_NO_DATA— УИН not found or blocked.
Returned only for the status FAILED.
|
Type |
Description |
|
Enum: |
400 Bad Request
The request contains incorrect data. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
ApiErrorDTO
The general error format.
|
Name |
Description |
|
code* |
Type: string The error code. |
|
message |
Type: string Description of the error. |
401 Unauthorized
The authorization data is not specified in the request. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
403 Forbidden
The authorization data is incorrect or access to the resource is prohibited. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
404 Not Found
The requested resource was not found. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
420 Method Failure
The resource access limit has been exceeded. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
500 Internal Server Error
Internal error of Yandex. Market. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
No longer supported, please use an alternative and newer version.
A unique identification number for jewelry.
The manufacturer receives the UIN when he registers the product in the system of control over the turnover of precious metals and stones — GIIS DMDK.
What is GTIN?
GTIN — This is a unique number assigned to a product in a single international database. GS1. This number generates an EAN, UPC, or ISBN barcode.
How to make sure that the product is in the database
You can check the code on verification page on the GS1 association's website. If the product is not found, request the GTIN code from your supplier.
How to get a GTIN for your products
To receive GTIN codes, the manufacturer needs to join the GS1 association and register the products.