Документация API

Налоговые декларации

Получение налоговых деклараций компании.

Возвращает постраничный список налоговых деклараций и начислений указанной компании.

Эндпоинт

GET /api/v1/companies/:company_id/tax_declarations

Параметры

ПараметрТипГдеОписание
company_idintegerpathУникальный идентификатор компании.
pageintegerqueryНомер страницы (по умолчанию: 1).
limitintegerqueryЗаписей на странице (по умолчанию: 100).

Примеры кода

Получение налоговых деклараций

import requests

url = 'https://statsnet.co/api/v1/companies/12345/tax_declarations'
headers = {
  'Authorization': 'Bearer sk_live_YOUR_KEY',
  'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers).json()
print(response)

Ответ

Успешный ответ

{
  "tax_regime": "Общеустановленный режим",
  "tax_declarations": [
    {
      "amount": 1250000.5,
      "doc_type": "Декларация по НДС",
      "doc_num": "TD-2024-Q1",
      "date": "2024-03-31"
    },
    {
      "amount": 980000,
      "doc_type": "Декларация по КПН",
      "doc_num": "TD-2023-Q4",
      "date": "2023-12-31"
    }
  ]
}

Обработка ошибок

Ответ с ошибкой

{
  "status": 403,
  "message": "access denied"
}

Это платный эндпоинт. Возможны также ответы 402 — {"status": 402, "message": "payment required"} — если подписка истекла, отменена или просрочена, и 429 — {"status": 429, "message": "quota exhausted"} — когда квота отчётов тарифа за текущий период исчерпана.