Файл формы для КНП ИСНА

curl --request GET \
  --url https://api.tungo.kz/v1/companies/{co}/forms/isna \
  --cookie tungo.session_token=

const options = {method: 'GET', headers: {cookie: 'tungo.session_token='}};

fetch('https://api.tungo.kz/v1/companies/{co}/forms/isna', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "form": "300.00",
  "period": {
    "from": "2026-06-30",
    "to": "2026-06-30",
    "code": "2026-Q2",
    "title": "2 кв 2026"
  },
  "file_name": "<string>",
  "format": {
    "version": "<string>",
    "verified": true,
    "note": "<string>"
  },
  "available": true,
  "exported": 123,
  "not_in_calculation": 123,
  "header_from": {},
  "reconciliation": {
    "reference": "<string>",
    "totals": {
      "match": 123,
      "mismatch": 123,
      "no_reference": 123,
      "not_computed": 123
    }
  },
  "complete": true,
  "download": {
    "screen": "<string>",
    "button": "<string>"
  },
  "next": "<string>",
  "map_edition": "<string>",
  "unmapped": [
    "<string>"
  ],
  "for_human": [
    "<string>"
  ],
  "incomplete_because": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ]
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

GET

companies

{co}

forms

isna

Файл формы для КНП ИСНА

curl --request GET \
  --url https://api.tungo.kz/v1/companies/{co}/forms/isna \
  --cookie tungo.session_token=

const options = {method: 'GET', headers: {cookie: 'tungo.session_token='}};

fetch('https://api.tungo.kz/v1/companies/{co}/forms/isna', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "form": "300.00",
  "period": {
    "from": "2026-06-30",
    "to": "2026-06-30",
    "code": "2026-Q2",
    "title": "2 кв 2026"
  },
  "file_name": "<string>",
  "format": {
    "version": "<string>",
    "verified": true,
    "note": "<string>"
  },
  "available": true,
  "exported": 123,
  "not_in_calculation": 123,
  "header_from": {},
  "reconciliation": {
    "reference": "<string>",
    "totals": {
      "match": 123,
      "mismatch": 123,
      "no_reference": 123,
      "not_computed": 123
    }
  },
  "complete": true,
  "download": {
    "screen": "<string>",
    "button": "<string>"
  },
  "next": "<string>",
  "map_edition": "<string>",
  "unmapped": [
    "<string>"
  ],
  "for_human": [
    "<string>"
  ],
  "incomplete_because": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ]
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

Авторизации

tungo.session_token

string

обязательно

Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.

Параметры пути

string

обязательно

id компании, co_… — из GET /v1/companies

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

form

string

обязательно

Код формы, например 300.00 (из GET …/forms)

Пример:

"300.00"

period

string

обязательно

Код периода — его передавать в ?period=: 2026-Q2 — квартал, 2026-H1 — полугодие, 2026-06 — месяц (у форм «с начала года» — январь–июнь), 2026 — год. Из списка форм — periods[].period. Подписи по-русски («2 кв 2026») тоже принимаются

Пример:

"2026-Q2"

summary

enum<string>

1 — сводка IsnaSummary вместо файла

Доступные опции:

1

Ответ

Файл ИСНА (или сводка при summary=1)

Option 1
Option 2

IsnaSummary при summary=1, иначе сам файл IsnaFile

form

string

обязательно

Код формы (бланка), например 300.00 — декларация по НДС

Пример:

"300.00"

period

object

обязательно

Период формы

Show child attributes

file_name

string

обязательно

Имя файла JSON для КНП ИСНА

format

object

обязательно

Формат файла

Show child attributes

available

boolean

обязательно

Можно ли скачать файл (GET …/forms/isna без summary)

exported

integer

обязательно

Сколько ячеек расчёта легло в файл

not_in_calculation

integer

обязательно

Сколько ячеек бланка наш расчёт не считает: в КНП останутся пустыми, если их не заполнить

header_from

object

обязательно

Откуда взято каждое значение шапки: реквизит → источник

Show child attributes

reconciliation

object

обязательно

Итог сверки с отчётом 1С

Show child attributes

complete

boolean

обязательно

Можно ли загружать как есть (кроме ручной шапки): форма полная, всё посчитано и легло в файл

download

object

обязательно

Где скачать файл в приложении

Show child attributes

string

обязательно

Что делать человеку с файлом в КНП ИСНА — по шагам

map_edition

string

Редакция бланка 1С, по чьей карте собран файл

unmapped

string[]

Ячейки расчёта, которых нет в карте: в файл не попали, перенести руками

for_human

string[]

Реквизиты шапки, которые человек заполняет в КНП сам

incomplete_because

string[]

Почему файл неполный

warnings

string[]

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