标记代码验证状态

方法适用于模式:FBSExpress.

如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一

按顺序返回标记代码的验证状态。

系统中包含带有强制性标签的珠宝或产品的订单 «Честный ЗНАК»,将更改为状态 READY_TO_SHIP,只有当:

  1. 在方法 PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes 您将向Yandex发送以下信息。街市:

    • [赢](*uin) 对于订单中的每件珠宝;

    • 系统中的标记代码 «Честный ЗНАК» 对于所有产品的顺序,它是必需的。

  2. 所有标记代码将被成功验证。

⚙️ 限制: 每小时100,000次请求

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/{orderId}/identifiers/status

Path parameters

Name

Description

campaignId*

Type: integer<int64>

活动ID。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:

  • 运动ID;
  • 标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要发送商店ID,这是在市场上的卖家帐户旁边的商店名称和一些报告。

Min value: 1

orderId*

Type: integer<int64>

的订单ID。

Responses

200 OK

检查标记代码的信息。

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

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

result

Type: GetOrderIdentifiersStatusDTO

检查标记代码的信息。

ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

GetOrderIdentifiersStatusDTO

检查标记代码的信息。

Name

Description

items*

Type: OrderItemValidationStatusDTO[]

产品标识符和检查代码信息的列表。
产品标识符和检查其代码的信息。

OrderItemValidationStatusDTO

产品标识符和检查其代码的信息。

Name

Description

id*

Type: integer<int64>

订单中的产品ID。

cis

Type: CisDTO[]

有关检查系统中的标记代码的信息 «Честный ЗНАК».
系统中的验证状态和标记代码 «Честный ЗНАК».

Min items: 1

uin

Type: UinDTO[]

核实资料 УИНов.
验证状态和 УИН.

Min items: 1

CisDTO

系统中的验证状态和标记代码 «Честный ЗНАК».

Name

Description

status*

Type: CisStatusType

在系统中检查标记代码的状态 «Честный ЗНАК»:

  • FAILED — 无法验证代码。

    请稍后重试或删除标记代码.

  • IN_PROGRESS — 在验证过程中。

  • NOT_ON_VALIDATION — 标记代码尚未发送以进行验证。

  • OK — 检查成功完成。

  • INVALID — 验证失败。 禁止使用本守则销售商品。

Enum: OK, FAILED, IN_PROGRESS, INVALID, NOT_ON_VALIDATION

value*

Type: string

系统中的标记代码 «Честный ЗНАК».

substatus

Type: CisSubstatusType

在系统中检查标记代码时详细说明错误 «Честный ЗНАК»:

  • WRONG_OWNER_INN — 验证失败。 代码所有者的客栈与卖方的客栈不同.

  • CIS_VALIDATION_ERROR — 验证失败。

  • CIS_GTIN_NOT_FOUND — 标记代码不包含 GTIN.

  • CIS_SERIAL_NUMBER_NOT_FOUND — 标记代码不包含序列号。

  • INVALID_SYMBOLS_FOUND — 标记代码包含无效字符。

  • CRYPTO_TAIL_FORMAT_MISMATCH_CIS_TYPE — 密码签名的格式与标记代码的类型不匹配。

  • INVALID_CRYPTO_TAIL — 加密签名无效。

  • INVALID_CRYPTO_KEY — 加密密钥无效。

  • VERIFICATION_FAILED_IN_EMITTER_COUNTRY — 标记代码尚未在发行人所在国家/地区进行验证。

  • UNSUPPORTED_AI_FOUND — 不支持代码中发现的AI标记。

  • CIS_NOT_FOUND_IN_GIS_MT — 标记代码未在 ГИС МТ.

  • NOT_PLACED_ON_MARKET — 标记码尚未投入流通。

  • NOT_PRINTED_ON_PACKAGE — 包装上不打印标记代码。

  • EXPIRED_ITEM — 标记的产品已过期。

  • SALE_BLOCKED_BY_OGB — OGV的决定阻止了产品的零售销售。

  • ITEM_SOLD — 标记的产品已售出。

仅为状态返回 INVALID.

Enum: WRONG_OWNER_INN, CIS_VALIDATION_ERROR, CIS_GTIN_NOT_FOUND, CIS_SERIAL_NUMBER_NOT_FOUND, INVALID_SYMBOLS_FOUND, CRYPTO_TAIL_FORMAT_MISMATCH_CIS_TYPE, INVALID_CRYPTO_TAIL, INVALID_CRYPTO_KEY, VERIFICATION_FAILED_IN_EMITTER_COUNTRY, UNSUPPORTED_AI_FOUND, CIS_NOT_FOUND_IN_GIS_MT, NOT_PLACED_ON_MARKET, NOT_PRINTED_ON_PACKAGE, EXPIRED_ITEM, SALE_BLOCKED_BY_OGB, ITEM_SOLD

UinDTO

验证状态和 УИН.

Name

Description

status*

Type: UinStatusType

登录验证状态:

  • FAILED — 验证失败。

  • IN_PROGRESS — 在验证过程中。

  • NOT_ON_VALIDATION — 胜利尚未发送以进行验证,或者订单中的所有胜利并非已转移。

  • OK — 检查成功完成。

Enum: OK, IN_PROGRESS, FAILED, NOT_ON_VALIDATION

value*

Type: string

赢得产品。

substatus

Type: UinSubstatusType

验证过程中的错误详细信息 УИНа.

  • UIN_MERCHANT_MISMATCH — УИН 不属于您的商店。

  • UIN_MERCHANT_UNREGISTERED — 商店未连接到系统 ГИИС ДМДК.

  • UIN_NO_DATA — УИН 未找到或阻止。

仅为状态返回 FAILED.

Enum: UIN_MERCHANT_MISMATCH, UIN_MERCHANT_UNREGISTERED, UIN_NO_DATA

CisStatusType

在系统中检查标记代码的状态 «Честный ЗНАК»:

  • FAILED — 无法验证代码。

    请稍后重试或删除标记代码.

  • IN_PROGRESS — 在验证过程中。

  • NOT_ON_VALIDATION — 标记代码尚未发送以进行验证。

  • OK — 检查成功完成。

  • INVALID — 验证失败。 禁止使用本守则销售商品。

Type

Description

CisStatusType

Enum: OK, FAILED, IN_PROGRESS, INVALID, NOT_ON_VALIDATION

CisSubstatusType

在系统中检查标记代码时详细说明错误 «Честный ЗНАК»:

  • WRONG_OWNER_INN — 验证失败。 代码所有者的客栈与卖方的客栈不同.

  • CIS_VALIDATION_ERROR — 验证失败。

  • CIS_GTIN_NOT_FOUND — 标记代码不包含 GTIN.

  • CIS_SERIAL_NUMBER_NOT_FOUND — 标记代码不包含序列号。

  • INVALID_SYMBOLS_FOUND — 标记代码包含无效字符。

  • CRYPTO_TAIL_FORMAT_MISMATCH_CIS_TYPE — 密码签名的格式与标记代码的类型不匹配。

  • INVALID_CRYPTO_TAIL — 加密签名无效。

  • INVALID_CRYPTO_KEY — 加密密钥无效。

  • VERIFICATION_FAILED_IN_EMITTER_COUNTRY — 标记代码尚未在发行人所在国家/地区进行验证。

  • UNSUPPORTED_AI_FOUND — 不支持代码中发现的AI标记。

  • CIS_NOT_FOUND_IN_GIS_MT — 标记代码未在 ГИС МТ.

  • NOT_PLACED_ON_MARKET — 标记码尚未投入流通。

  • NOT_PRINTED_ON_PACKAGE — 包装上不打印标记代码。

  • EXPIRED_ITEM — 标记的产品已过期。

  • SALE_BLOCKED_BY_OGB — OGV的决定阻止了产品的零售销售。

  • ITEM_SOLD — 标记的产品已售出。

仅为状态返回 INVALID.

Type

Description

CisSubstatusType

Enum: WRONG_OWNER_INN, CIS_VALIDATION_ERROR, CIS_GTIN_NOT_FOUND, CIS_SERIAL_NUMBER_NOT_FOUND, INVALID_SYMBOLS_FOUND, CRYPTO_TAIL_FORMAT_MISMATCH_CIS_TYPE, INVALID_CRYPTO_TAIL, INVALID_CRYPTO_KEY, VERIFICATION_FAILED_IN_EMITTER_COUNTRY, UNSUPPORTED_AI_FOUND, CIS_NOT_FOUND_IN_GIS_MT, NOT_PLACED_ON_MARKET, NOT_PRINTED_ON_PACKAGE, EXPIRED_ITEM, SALE_BLOCKED_BY_OGB, ITEM_SOLD

UinStatusType

登录验证状态:

  • FAILED — 验证失败。

  • IN_PROGRESS — 在验证过程中。

  • NOT_ON_VALIDATION — 胜利尚未发送以进行验证,或者订单中的所有胜利并非已转移。

  • OK — 检查成功完成。

Type

Description

UinStatusType

Enum: OK, IN_PROGRESS, FAILED, NOT_ON_VALIDATION

UinSubstatusType

验证过程中的错误详细信息 УИНа.

  • UIN_MERCHANT_MISMATCH — УИН 不属于您的商店。

  • UIN_MERCHANT_UNREGISTERED — 商店未连接到系统 ГИИС ДМДК.

  • UIN_NO_DATA — УИН 未找到或阻止。

仅为状态返回 FAILED.

Type

Description

UinSubstatusType

Enum: UIN_MERCHANT_MISMATCH, UIN_MERCHANT_UNREGISTERED, UIN_NO_DATA

400 Bad Request

请求包含不正确的数据。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

ApiErrorDTO

一般错误格式。

Name

Description

code*

Type: string

的错误代码。

message

Type: string

错误的描述。

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

500 Internal Server Error

市场的内部错误。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

No longer supported, please use an alternative and newer version.

[*uin]:珠宝的唯一识别号码。

当制造商在贵金属和宝石周转控制系统中注册产品时,他会收到UIN—GIIS DMDK。

什么是GTIN?
[医]GTIN — 这是在单个国际数据库中分配给产品的唯一编号。 GS1. 此编号生成EAN、UPC或ISBN条形码。

如何确保产品在数据库中
你可以在 验证页面 在GS1协会的网站上。 如果未找到产品,请向供应商索取GTIN代码。

如何为您的产品获得GTIN
要接收GTIN代码,制造商需要加入GS1协会并注册产品。