Выписки DirectBank по дням

DirectBank — обмен 1С с банком напрямую. Заход опроса (POST …/statements/directbank или сценарий автоматизации с action: directbank) пишет выписку дня — задание пачки вида directbank, по одной на день. Сам Tungo банк не опрашивает.

Доступ: company.read.

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

GET /v1/companies/{co}/statements

Выписки DirectBank по дням

cURL

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

200

{
  "data": [
    {
      "id": "bat_01h455vb4pex5vsknk084sn02q",
      "kind": "bank_statement",
      "title": "выписка statement.txt, строк 42",
      "started_at": "2023-11-07T05:31:56Z",
      "running": true,
      "events": 123,
      "summary": "<string>",
      "finished_at": "2023-11-07T05:31:56Z",
      "error": "<string>",
      "report": {
        "total": 123,
        "created": 123,
        "skipped": 123,
        "failed": 123,
        "unknown": 123,
        "manual": 123,
        "duplicates": 123,
        "pending": 123,
        "rows": [
          {
            "key": "<string>",
            "title": "10.07.2026 ТОО «Пример» 1 200 000 ₸",
            "status": "created",
            "proposal_id": "<string>",
            "document_ref": "<string>",
            "reason": "<string>",
            "warnings": [
              "<string>"
            ],
            "blockers": [
              "<string>"
            ],
            "question": {
              "id": "<string>",
              "text": "<string>",
              "options": [
                {
                  "label": "<string>",
                  "description": "<string>"
                }
              ]
            }
          }
        ],
        "min_concurrency": 123,
        "stopped": true,
        "gateway": {
          "asked": 123,
          "passed": 123
        },
        "approval": {
          "ok": true,
          "message": "Одобрено 12 из 14, исключено 1, с блокерами 1.",
          "requested": 123,
          "approved": 123,
          "excluded": 123,
          "failed": 123,
          "limit": 123,
          "counts": {
            "approved": 12,
            "excluded": 1,
            "blocked": 1
          },
          "results": [
            {
              "id": "P-000123",
              "outcome": "approved",
              "title": "Одобрено и записано",
              "message": "<string>",
              "error": "<string>",
              "retry_after": 123,
              "document_number": "<string>",
              "mismatches": [
                "<string>"
              ]
            }
          ],
          "batch_id": "<string>",
          "unknown_excluded": [
            "<string>"
          ],
          "stopped": {
            "reason": "<string>",
            "remaining": 123
          }
        }
      },
      "counts": {
        "total": 123,
        "created": 123,
        "skipped": 123,
        "manual": 123,
        "failed": 123,
        "unknown": 123
      }
    }
  ],
  "next_cursor": "aud_01jz8x3m4n5p6q7r8s9t0v1w2x"
}

Авторизации

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

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

cursor · string

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

limit · integer

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

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

Ответ

200

application/json

Выписки дня

Выписки дня, свежие сверху, страницами

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

Выписки по дням этой страницы, свежие сверху

Show child attributes

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

Курсор следующей страницы. Чтобы получить её — тот же запрос (с теми же фильтрами) и ?cursor=<это значение>. null — страниц больше нет (кнопку «Ещё» спрятать). Курсор непрозрачный: не разбирать и не собирать самому, хранить только до следующего запроса. Пустой data с не-null курсором не бывает.

Пример:

"aud_01jz8x3m4n5p6q7r8s9t0v1w2x"