.. _Integration_IntegrationApi_StatusesHistory_ProcessingRnptStatuses:

Обработка статусов РНПТ
#######################

Продукт позволяет проверять регистрационные номера партий товаров в сервисе проверки РНПТ и загружать результаты проверки.

Передача документов в сервис проверки РНПТ работает для входящих документов, содержащих товары с признаком прослеживаемости.

| См. также:
| :ref:`Setup_Integration_AdvancedSetup_Rnpt`

Порядок обработки документа в сервисе проверки РНПТ
***************************************************

При получении документа, содержащего товары с признаком прослеживаемости, выполняется запрос к сервису проверки РНПТ.

После получения ответа от сервиса в истории статусов появится статус документа "Результаты проверки РНПТ" (код статуса ``RN``).
Вложение статуса будет содержать ссылку на файл с результатами проверки.

Формат вложения
***************

Файл с результатами проверки РНПТ - это XML-документ.
Формат файла приведен ниже.

.. list-table:: Документ (Document)
    :widths: 3 2 1 1 3
    :header-rows: 0

    * - **Наименование**
      - **Элемент**
      - **Тип**
      - **Обязательность**
      - **Дополнительная информация**
      
    * - Продукт
      - Product
      - С
      - НМ
      - Состав элемента см. :numref:`rnpt-product`.

.. list-table:: Продукт (Product)
    :widths: 15 10 5 5 5 15
    :name: rnpt-product

    * - **Наименование**
      - **Элемент**
      - **Тип**
      - **Формат**
      - **Обязательность**
      - **Дополнительная информация**

    * - РНПТ
      - Rnpt
      - П
      - Т(27)
      - О
      - 

    * - Результат проверки
      - CheckResult
      - С
      -
      - О
      - Состав элемента см. :numref:`rnpt-check-result`.

.. list-table:: Результат проверки (CheckResult)
    :widths: 15 10 5 5 5 15
    :name: rnpt-check-result

    * - **Наименование**
      - **Элемент**
      - **Тип**
      - **Формат**
      - **Обязательность**
      - **Дополнительная информация**
    * - Код статуса
      - STATUS_CODE
      - П
      - N(1-3)
      - О
      - 
    * - Информация об ошибке
      - FAULT
      - С
      - 
      - Н
      - Обязателен, если код статуса равен 1. Состав элемента см. :numref:`rnpt-check-result-fault`.
    * - Результат проверки
      - RESULT
      - С
      - 
      - Н
      - Обязателен, если код статуса равен 2. Состав элемента см. :numref:`rnpt-check-result-succeded`.

.. list-table:: Информация об ошибке (FAULT)
    :widths: 15 10 5 5 5
    :name: rnpt-check-result-fault

    * - **Наименование**
      - **Элемент**
      - **Тип**
      - **Формат**
      - **Обязательность**
    * - Код ошибки
      - ERR_CODE
      - П
      - N(1-3)
      - О
    * - Наименование ошибки
      - ERR_NAME
      - П
      - Т(1-1000)
      - О

.. list-table:: Результат проверки (RESULT)
    :widths: 15 10 5 5 5
    :name: rnpt-check-result-succeded

    * - **Наименование**
      - **Элемент**
      - **Тип**
      - **Формат**
      - **Обязательность**
    * - Код ТН ВЭД ЕАЭС
      - CODE_TNVED
      - П
      - Т(6-10)
      - О
    * - Наименование товара
      - NAME_GOODS
      - П
      - Т(0-1000)
      - О
    * - Код страны происхождения по ОКСМ
      - CODE_CO_PROD
      - П
      - Т(=3)
      - Н
    * - Страна происхождения товара
      - NAME_CO_PROD
      - П
      - Т(500)
      - Н
    * - Дата выпуска/регистрации товара
      - DATE_PROD
      - П
      - 
      - О
    * - Код единицы измерения по ОКЕИ
      - UNIT_CODE
      - П
      - T(3-4)
      - О
    * - Наименование единицы измерения
      - NAME_UNIT_CODE
      - П
      - T(0-100)
      - О
    * - Количество ввезенного товара
      - QUANT_INPUT_GOODS
      - П
      - N(26.11)
      - О
    * - Количество выбывшего товара
      - QUANT_OUTPUT_GOODS
      - П
      - N(26.11)
      - О
    * - Количество товара в обороте
      - QUANT_CIRCUL_GOODS
      - П
      - N(26.11)
      - О

.. note::
    Подробную информацию о данных, получаемых в ходе проверки РНПТ, можно получить в описании типа ``CheckTRCRNPT_Response`` 
    в инструкции подключения к API сервиса проверки РНПТ на `сайте ФНС <https://www.nalog.gov.ru/rn77/related_activities/spt/>`_.

Используемые сокращения
=======================

**Тип**. Может принимать следующие значения: 

  - "С" - сложный элемент логической модели (содержит вложенные элементы); 
  - "П" - простой элемент логической модели, реализованный в виде элемента XML файла; 
  - "А" - простой элемент логической модели, реализованный в виде атрибута элемента XML файла; простой элемент логической модели не содержит вложенные элементы.

**Формат**. Формат элемента представляется следующими условными обозначениями: 

  - T - символьная строка; 
  - N - числовое значение (целое или дробное).

Формат символьной строки указывается в виде T(n-k) или T(=k), где: 

  - n - минимальное количество знаков; 
  - k - максимальное количество знаков; 
  - символ "-" - разделитель; 
  - символ "=" означает фиксированное количество знаков в строке. 

В случае, если минимальное количество знаков равно 0, формат имеет вид T(0-k). 
В случае, если максимальное количество знаков не ограничено, формат имеет вид T(n-).

Формат числового значения указывается в виде N(m.k), где: 

  - m - максимальное количество знаков в числе, включая знак (для отрицательного числа), целую и дробную часть числа без разделяющей десятичной точки; 
  - k - максимальное число знаков дробной части числа. 
  
Если число знаков дробной части числа равно 0 (то есть число целое), то формат числового значения имеет вид N(m).

Для простых элементов, являющихся базовыми в XML, например, элемент с типом "date", поле "Формат элемента" не заполняется.

**Обязательность** элемента определяет обязательность наличия элемента (совокупности наименования элемента и его значения) в файле. 

Признак обязательности элемента может принимать следующие значения: 

  - "О" - наличие элемента в файле обмена обязательно; 
  - "Н" - присутствие элемента в файле обмена необязательно, то есть элемент может отсутствовать. 
  
Если элемент принимает ограниченный перечень значений (по классификатору, кодовому словарю и тому подобное), то признак обязательности элемента дополняется символом "К". Например, "ОК". 
В случае, если количество реализаций элемента может быть более одной, то признак обязательности элемента дополняется символом "М". Например, "НМ" или "ОКМ".