Методы Сверки по НДС

В данном разделе описаны методы для получения статистики по счетам-фактурам организаций, которые добавлены в учетную запись сервиса НДС+, и их контрагентов.

Подробная спецификация методов показана в Swagger в разделе Сверка по НДС.

Предупреждение

В параметрах методов используется organizationId – идентификатор организации. Он относится к организациям, которые добавлены в учетную запись сервиса НДС+.

Поиск организаций

Метод: GET NdsOrganizations

Метод вернет список организаций, для которых доступна статистика по декларациям.

Параметры запроса

belongingType – признак принадлежности организации. При запросе организации можно отфильтровать по признаку:

  • my – значение по умолчанию, будут найдены все организации, которые добавлены в учетную запись сервиса НДС+;

  • contractorWithPermission – будут найдены все контрагенты, которые дали разрешение на просмотр данных деклараций по НДС.

Примечание

В ответах методов API могут встретиться еще два признака принадлежности:

  • contractor – контрагенты, которые встречаются в декларациях организации, но не дали разрешение на просмотр своих данных;

  • subcontractor – контрагенты, которые встречаются в декларациях контрагентов организации.

Отображение организаций с этими признаками принадлежности еще в разработке.

При вызове метода организации нельзя отфильтровать по признакам принадлежности contractor и subcontractor.

Получение организации по идентификатору

Метод: GET NdsOrganization

Метод вернет по идентификатору organizationId информацию об организации: ИНН, КПП, наименовании организации, признак принадлежности.

Получение списка деклараций

Метод: GET NdsDeclarations

Метод вернет список деклараций по идентификатору организации organizationId . В поле summary будет представлено количество счетов-фактур по каждому разделу декларации как общее, так и с расхождениями и разрывами.

Параметры запроса

year – фильтр по году подачи декларации. В данном параметре нужно передать год, в рамках которого необходимо получить список деклараций. Можно указать любой год с 2015, при условии что организации работали в сервисе НДС+ с этого периода. Год нужно указать в формате «yyyy».

quarter – фильтр по кварталу подачи декларации. В данном параметре нужно передать квартал, в рамках которого необходимо получить список деклараций. Квартал можно указать одной цифрой, допустимые значения: 1, 2, 3, 4. Если при запросе не будет указан квартал, то вернуться декларации за все кварталы указанного года в параметре year.

Если при запросе не будут указаны год и квартал, то вернеться список деклараций за все доступные периоды.

Получение декларации

Метод: GET NdsDeclaration

Метод вернет показатели декларации по ее идентификатору declarationId. Ответ метода содержит количество счетов-фактур по каждому разделу декларации как общее, так и с расхождениями и разрывами.

Получение списка контрагентов

Метод: GET NdsContractors

Метод вернет всех контрагентов организации по ее идентификатору organizationId. Список формируется по данным деклараций за период: году и кварталу подачи декларации.

В ответе метода в поле ContractorSummary для каждого контрагента будут указаны суммы НДС и количество счетов-фактур в декларации по разделам, а также сумма НДС и количество счетов-фактур с расхождениями и разрывами.

Параметры запроса

orderBy – фильтр по показателям декларации. Список контрагентов можно отсортировать по показателям:

  • invoicesTotal – количество счетов-фактур;

  • invoicesDifferent – количество счетов-фактур с разрывами и расхождениями;

  • ndsSumTotal – суммы НДС;

  • ndsSumDifferent – суммы НДС при расхождениях и разрывах.

year – фильтр по году подачи декларации. В данном параметре нужно передать год, в рамках которого необходимо получить список контрагентов. Можно указать год с 2015, при условии что организации работали в сервисе НДС+ с этого периода. Год нужно указать в формате «yyyy».

quarter – фильтр по кварталу подачи декларации. В данном параметре нужно передать квартал, в рамках которого необходимо получить список контрагентов. Квартал можно указать одной цифрой, допустимые значения: 1, 2, 3, 4.

Если при запросе не будут указаны год и квартал, то будет возвращен список контрагентов за все периоды.

Возможные коды ответов:

  • 400 BadRequest – указаны некорректные выходные данные или в запросе передан= год без квартала или квартал без года.

Получение контрагента по идентификатору

Метод: GET NdsContractor

Метод вернет результаты сверки с контрагентом за все периоды по идентификатору организации organizationId и идентификатору контрагента contractorId.

В ответе метода в поле summary по каждому разделу декларации будут указаны суммы НДС и количество счетов-фактур, а также сумма НДС и количество счетов-фактур с расхождениями и разрывами.

Суммарные показатели контрагента

Метод: GET NdsSummaries

Метод вернет показатели деклараций в разрезе одного контрагента по его идентификатору contractorId.

Параметры запроса

year – фильтр по году подачи декларации. В данном параметре нужно передать год, в рамках которого необходимо получить показатели. Можно указать год с 2015, при условии что организации работали в сервисе НДС+ с этого периода. Год нужно указать в формате «yyyy».

quarter – фильтр по кварталу подачи декларации. В данном параметре нужно передать квартал, в рамках которого необходимо получить показатели. Квартал можно указать одной цифрой, допустимые значения: 1, 2, 3, 4. Если при запросе не будет указан квартал, то будут возвращены декларации за все кварталы указанного года в параметре year.

Если при запросе не будут указаны год и квартал, то будут возвращены показатели за все периоды.