标记代码验证状态

方法适用于模式：FBS 和 Express.

如果您使用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

广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。

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

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

⚠️ 不要把它与:

  • 商店的标识符，显示在商家的个人帐户中。
  • 广告活动。

Min value: 1

orderId

Type: integer

的订单ID。

Responses

200 OK

有关检查标记代码的信息。

Body

application/json
{
  "status": "OK",
  "result": {
    "items": [
      {
        "id": 0,
        "uin": [
          null
        ],
        "cis": [
          null
        ]
      }
    ]
  }
}

Type: object

All of 2 types
  • Type: object

    status

    Type: string

    响应的类型。 可能的值:

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

    Enum: OK, ERROR

    服务器响应的标准包装器。

    Example
    {
  "status": "OK"
}
  • Type: object

    result
    Type: object

    items
    Type: object[]

    id

    Type: integer

    订单中的产品ID。

    cis
    Type: object[]

    status

    Type: string

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

    • FAILED — 无法验证代码。

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

    • IN_PROGRESS — 在验证过程中。

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

    • OK — 检查成功完成。

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

    Enum: OK, FAILED, IN_PROGRESS, INVALID, NOT_ON_VALIDATION

    value

    Type: string

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

    Example: example

    substatus

    Type: string

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

    • 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

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

    Min items: 1

    Example
    [
  {
    "value": "example",
    "status": "OK",
    "substatus": "WRONG_OWNER_INN"
  }
]

    uin
    Type: object[]

    status

    Type: string

    登录验证状态:

    • FAILED — 验证失败。

    • IN_PROGRESS — 在验证过程中。

    • NOT_ON_VALIDATION — 胜利尚未发送以进行验证，或者订单中的所有胜利都未被转移。

    • OK — 检查成功完成。

    Enum: OK, IN_PROGRESS, FAILED, NOT_ON_VALIDATION

    value

    Type: string

    赢得产品。

    Example: example

    substatus

    Type: string

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

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

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

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

    仅为状态返回 FAILED.

    Enum: UIN_MERCHANT_MISMATCH, UIN_MERCHANT_UNREGISTERED, UIN_NO_DATA

    核实资料 УИНов.

    Min items: 1

    Example
    [
  {
    "value": "example",
    "status": "OK",
    "substatus": "UIN_MERCHANT_MISMATCH"
  }
]

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

    Example
    [
  {
    "id": 0,
    "uin": [
      {
        "value": "example",
        "status": "OK",
        "substatus": "UIN_MERCHANT_MISMATCH"
      }
    ],
    "cis": [
      {
        "value": "example",
        "status": "OK",
        "substatus": "WRONG_OWNER_INN"
      }
    ]
  }
]

    有关检查标记代码的信息。

    Example
    {
  "items": [
    {
      "id": 0,
      "uin": [
        {
          "value": "example",
          "status": "OK",
          "substatus": "UIN_MERCHANT_MISMATCH"
        }
      ],
      "cis": [
        {
          "value": "example",
          "status": "OK",
          "substatus": "WRONG_OWNER_INN"
        }
      ]
    }
  ]
}
    Example
    {
  "result": {
    "items": [
      {
        "id": 0,
        "uin": [
          {}
        ],
        "cis": [
          {}
        ]
      }
    ]
  }
}

400 Bad Request

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

Body

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

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

401 Unauthorized

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

Body

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

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

403 Forbidden

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

Body

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

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

404 Not Found

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

Body

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

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

420 Method Failure

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

Body

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

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

500 Internal Server Error

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

Body

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

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

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协会并注册产品。

上一篇
标记代码的传输
下一篇
发送确认代码