Входящие ЭСФ и поступления в 1С

Последние входящие ЭСФ: найдено ли поступление в 1С и что делать. Без since — 90 дней до until (или сегодня); окно — не больше 366 дней.

Доступ: company.read.

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

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

Входящие ЭСФ и поступления в 1С

cURL

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

200

{
  "as_of": "2023-12-25",
  "since": "2023-12-25",
  "until": "2023-12-25",
  "data": [
    {
      "esf": "<string>",
      "number": "<string>",
      "date": "2023-12-25",
      "turnover_date": "2023-12-25",
      "supplier": "<string>",
      "supplier_bin": "000000000000",
      "total": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "vat": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "status": "<string>",
      "action": "document_found",
      "action_title": "Документ найден",
      "match": {
        "status": "matched",
        "document": {
          "kind": "<string>",
          "number": "<string>",
          "date": "2023-12-25",
          "amount": {
            "amount": 1234.5,
            "amount_tiyn": 123450,
            "formatted": "1 234,50 ₸"
          }
        },
        "linked": true,
        "candidates": 123
      },
      "warnings": [
        "<string>"
      ],
      "blockers": [
        "<string>"
      ]
    }
  ],
  "total": 123,
  "next_cursor": "<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"

until · string<date>

По какую дату включительно — ГГГГ-ММ-ДД, календарная дата без часового пояса

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

Пример:

"2026-07-01"

action · string

Только ЭСФ с этим action: один код или несколько через запятую (document_found, propose_purchase, counterparty_needed, ask_human, skip). Неизвестный код — 400

limit · integer

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

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

cursor · string

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

Ответ

200

application/json

Входящие ЭСФ

Входящие ЭСФ и поступления в 1С под них

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

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

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

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

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

Конец окна включительно — ГГГГ-ММ-ДД, календарная дата без часового пояса: показывать как есть

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

Входящие ЭСФ за окно, новые первыми — эта страница (не больше limit)

Show child attributes

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

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

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

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