Посчитать форму

Форма по данным 1С с ячейками и сверкой с той же формой в 1С. Сдаёт отчётность человек. Неизвестная форма или период, который ещё не начался, — 400 с текстом для человека.

Доступ: company.read.

Доступно по ключу API.

GET /v1/companies/{co}/forms/build

Посчитать форму

cURL

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

200

{
  "form": "300.00",
  "title": "<string>",
  "period": {
    "code": "2026-Q2",
    "title": "2 кв 2026",
    "from": "2026-06-30",
    "to": "2026-06-30",
    "kind": "month"
  },
  "coverage": "full",
  "next": "<string>",
  "reference": {
    "found": true,
    "date": "<string>",
    "edition": "<string>",
    "note": "<string>"
  },
  "totals": {
    "match": 123,
    "mismatch": 123,
    "no_reference": 123,
    "not_computed": 123
  },
  "cells": [
    {
      "line": "300.00.015 A",
      "cell": "s_300_00_015_a",
      "title": "<string>",
      "type": "money",
      "ours": "<string>",
      "one_c": "<string>",
      "ours_value": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "one_c_value": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "status": "match",
      "causes": [
        {
          "kind": "<string>",
          "date": "<string>",
          "number": "<string>",
          "source": "РегистрНакопления.НДС",
          "what": "<string>",
          "amount": {
            "amount": 1234.5,
            "amount_tiyn": 123450,
            "formatted": "1 234,50 ₸"
          },
          "records": 123
        }
      ],
      "diff": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "note": "<string>"
    }
  ],
  "missing": [
    {
      "what": "<string>",
      "why": "<string>",
      "cells": [
        "<string>"
      ],
      "action": "fill_in_1c",
      "where": "<string>",
      "objects": [
        {
          "name": "<string>",
          "ref": "<string>"
        }
      ]
    }
  ],
  "uncovered": {
    "total": 123,
    "cells": [
      {
        "name": "<string>",
        "value": "<string>"
      }
    ]
  },
  "warnings": [
    "<string>"
  ],
  "ready_to_file": true,
  "isna": true,
  "submission": "<string>",
  "not_ready_because": [
    "<string>"
  ]
}

Авторизации

sessionapiKeybearerKey

tungo.session_token · string · cookie · обязательно

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

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

co · 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"

Ответ

200

application/json

Форма

Форма по данным 1С с ячейками и сверкой с той же формой в 1С

form · string · обязательно

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

Пример:

"300.00"

title · string · обязательно

Название формы

period · object · обязательно

Налоговый период формы

Show child attributes

coverage · enum<string> · обязательно

full — наш расчёт считает весь бланк; partial — не все строки: сдавать по нашему расчёту нельзя

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

next · string · обязательно

Как сдать — текст для человека: сдаёт человек своей ЭЦП, не ИИ

reference · object · обязательно

Та же форма в 1С, если есть — для сверки

Show child attributes

totals · object · обязательно

Сколько ячеек в каждом статусе сверки

Show child attributes

cells · object[] · обязательно

Ячейки формы по порядку бланка

Show child attributes

missing · object[] · обязательно

Чего не хватает для расчёта

Show child attributes

uncovered · object · обязательно

Непокрытая часть формы: в 1С заполнено, а наш расчёт эти ячейки не считает

Show child attributes

warnings · string[] · обязательно

Предупреждения расчёта (например, период ещё не закончился)

ready_to_file · boolean · обязательно

Готова ли форма к сдаче по нашему расчёту; расхождение с 1С не мешает (ошибаться может и 1С)

isna · boolean · обязательно

Можно ли собрать файл для КНП ИСНА — показать кнопку «Файл для ИСНА» (GET …/forms/isna)

submission · string

Кто и куда сдаёт, если не налоговая в КНП ИСНА (статистика, финотчётность)

not_ready_because · string[]

Почему сдавать рано — при ready_to_file = false