Реализации без действующего ЭСФ

Что мешает выписать ЭСФ по каждой реализации. Только чтение: ЭСФ здесь не подписываются и не отправляются.

Доступ: company.read.

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

GET /v1/companies/{co}/esf/outgoing

Реализации без действующего ЭСФ

cURL

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

200

{
  "as_of": "2023-12-25",
  "data": [
    {
      "sale": {
        "kind": "РеализацияТоваровУслуг",
        "number": "<string>",
        "date": "2023-12-25",
        "amount": {
          "amount": 1234.5,
          "amount_tiyn": 123450,
          "formatted": "1 234,50 ₸"
        },
        "counterparty": "<string>",
        "bin": "000000000000",
        "posted": true
      },
      "verdict": "invoice_not_issued",
      "verdict_title": "ЭСФ не выписан",
      "problem": "<string>",
      "blockers": [
        "<string>"
      ],
      "warnings": [
        "<string>"
      ],
      "tax_invoice": {
        "number": "<string>",
        "date": "<string>",
        "way": "<string>"
      },
      "esf": {
        "number": "<string>",
        "date": "2023-12-25",
        "registration_number": "<string>",
        "state": "<string>",
        "status": "<string>"
      },
      "age_days": 123
    }
  ],
  "total": 123,
  "next_cursor": "<string>",
  "note": "<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

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

since · string<date>

С какой даты — ГГГГ-ММ-ДД, календарная дата без часового пояса

Pattern: ^\d{4}-\d{2}-\d{2}$

Пример:

"2026-07-01"

verdict · string

Только реализации с этим verdict: один код или несколько через запятую (invoice_not_issued, esf_not_issued, esf_invalid). Неизвестный код — 400

limit · integer

Сколько строк на странице (1–100, по умолчанию 50)

Требуемый диапазон: 1 <= x <= 100

cursor · string

next_cursor из ответа прошлой страницы; без него — первая (самая свежая) страница. Остальные фильтры — те же, что у первой страницы.

Ответ

200

application/json

Реализации

Исходящие ЭСФ: реализации, по которым ЭСФ не выписан или не действует

as_of · string<date> · обязательно

На какую дату данные 1С — ГГГГ-ММ-ДД, календарная дата без часового пояса: показывать как есть

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

Реализации без действующего ЭСФ — эта страница (не больше limit)

Show child attributes

total · integer · обязательно

Сколько строк всего под фильтр (на всех страницах) — для «показано N из M»

next_cursor · string | null · обязательно

Курсор следующей страницы: тот же запрос (с теми же фильтрами) и ?cursor=<это значение>. null — страниц больше нет. Непрозрачный — не разбирать

note · string

Оговорки разбора — текст для человека