Методы Сверки по НДС
В данном разделе описаны методы для получения статистики по счетам-фактурам организаций, которые добавлены в учетную запись сервиса НДС+, и их контрагентов.
Подробная спецификация методов показана в 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.
Если при запросе не будут указаны год и квартал, то будут возвращены показатели за все периоды.