tungo-sdk 0.2.0

data/lib/tungo/resources/esf.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Resources
+    # Входящие и исходящие электронные счета-фактуры (ИС ЭСФ)
+    class Esf
+      # @api private
+      def initialize(client)
+        @client = client
+        freeze
+      end
+
+      # Входящие ЭСФ и поступления в 1С
+      #
+      # +GET /v1/companies/{co}/esf/incoming+
+      #
+      # @param action [String] Только ЭСФ с этим action: один код или несколько через запятую
+      #   (document_found, propose_purchase, counterparty_needed, ask_human, skip). Неизвестный код — 400
+      # @param cursor [String] next_cursor из ответа прошлой страницы; без него — первая (самая свежая)
+      #   страница. Остальные фильтры — те же, что у первой страницы.
+      # @param limit [Integer] Сколько строк на странице (1–100, по умолчанию 50)
+      # @param since [String] С какой даты — ГГГГ-ММ-ДД, календарная дата без часового пояса
+      # @param until [String] По какую дату включительно — ГГГГ-ММ-ДД, календарная дата без часового пояса
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Page<Tungo::Models::EsfIncomingItem>]
+      def get_incoming(
+        action: OMIT,
+        cursor: OMIT,
+        limit: OMIT,
+        since: OMIT,
+        until: OMIT,
+        company_id: nil,
+        request_options: nil
+      )
+        @client.page(
+          method: :get,
+          path: "/v1/companies/{co}/esf/incoming",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          query: {
+            "action" => action,
+            "cursor" => cursor,
+            "limit" => limit,
+            "since" => since,
+            "until" => binding.local_variable_get(:until)
+          },
+          model: :EsfIncomingReport,
+          options: request_options
+        )
+      end
+
+      # Входящие ЭСФ и поступления в 1С. Iterates over every item of every page, fetching pages lazily.
+      #
+      # +GET /v1/companies/{co}/esf/incoming+
+      #
+      # @param action [String] Только ЭСФ с этим action: один код или несколько через запятую
+      #   (document_found, propose_purchase, counterparty_needed, ask_human, skip). Неизвестный код — 400
+      # @param cursor [String] next_cursor из ответа прошлой страницы; без него — первая (самая свежая)
+      #   страница. Остальные фильтры — те же, что у первой страницы.
+      # @param limit [Integer] Сколько строк на странице (1–100, по умолчанию 50)
+      # @param since [String] С какой даты — ГГГГ-ММ-ДД, календарная дата без часового пояса
+      # @param until [String] По какую дату включительно — ГГГГ-ММ-ДД, календарная дата без часового пояса
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Enumerator<Tungo::Models::EsfIncomingItem>]
+      def get_incoming_all(
+        action: OMIT,
+        cursor: OMIT,
+        limit: OMIT,
+        since: OMIT,
+        until: OMIT,
+        company_id: nil,
+        request_options: nil
+      )
+        Tungo::Page.auto_paging do
+          get_incoming(
+            action: action,
+            cursor: cursor,
+            limit: limit,
+            since: since,
+            until: binding.local_variable_get(:until),
+            company_id: company_id,
+            request_options: request_options
+          )
+        end
+      end
+
+      # Реализации без действующего ЭСФ
+      #
+      # +GET /v1/companies/{co}/esf/outgoing+
+      #
+      # @param cursor [String] next_cursor из ответа прошлой страницы; без него — первая (самая свежая)
+      #   страница. Остальные фильтры — те же, что у первой страницы.
+      # @param limit [Integer] Сколько строк на странице (1–100, по умолчанию 50)
+      # @param since [String] С какой даты — ГГГГ-ММ-ДД, календарная дата без часового пояса
+      # @param verdict [String] Только реализации с этим verdict: один код или несколько через запятую
+      #   (invoice_not_issued, esf_not_issued, esf_invalid). Неизвестный код — 400
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Page<Tungo::Models::EsfOutgoingItem>]
+      def get_outgoing(cursor: OMIT, limit: OMIT, since: OMIT, verdict: OMIT, company_id: nil, request_options: nil)
+        @client.page(
+          method: :get,
+          path: "/v1/companies/{co}/esf/outgoing",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          query: { "cursor" => cursor, "limit" => limit, "since" => since, "verdict" => verdict },
+          model: :EsfOutgoingReport,
+          options: request_options
+        )
+      end
+
+      # Реализации без действующего ЭСФ. Iterates over every item of every page, fetching pages lazily.
+      #
+      # +GET /v1/companies/{co}/esf/outgoing+
+      #
+      # @param cursor [String] next_cursor из ответа прошлой страницы; без него — первая (самая свежая)
+      #   страница. Остальные фильтры — те же, что у первой страницы.
+      # @param limit [Integer] Сколько строк на странице (1–100, по умолчанию 50)
+      # @param since [String] С какой даты — ГГГГ-ММ-ДД, календарная дата без часового пояса
+      # @param verdict [String] Только реализации с этим verdict: один код или несколько через запятую
+      #   (invoice_not_issued, esf_not_issued, esf_invalid). Неизвестный код — 400
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Enumerator<Tungo::Models::EsfOutgoingItem>]
+      def get_outgoing_all(
+        cursor: OMIT,
+        limit: OMIT,
+        since: OMIT,
+        verdict: OMIT,
+        company_id: nil,
+        request_options: nil
+      )
+        Tungo::Page.auto_paging do
+          get_outgoing(
+            cursor: cursor,
+            limit: limit,
+            since: since,
+            verdict: verdict,
+            company_id: company_id,
+            request_options: request_options
+          )
+        end
+      end
+    end
+  end
+end

data/lib/tungo/resources/feed.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Resources
+    # Лента событий и предложений компании (страницы и живой поток SSE)
+    class Feed
+      # @api private
+      def initialize(client)
+        @client = client
+        freeze
+      end
+
+      # Лента компании
+      #
+      # +GET /v1/companies/{co}/feed+
+      #
+      # @param cursor [String] next_cursor из ответа прошлой страницы; без него — первая (самая свежая)
+      #   страница. Остальные фильтры — те же, что у первой страницы.
+      # @param limit [Integer] Сколько на странице: 1–100, по умолчанию 20
+      # @param section [String] Только этот раздел; без него — все
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Page<Tungo::Models::FeedItem>]
+      def get(cursor: OMIT, limit: OMIT, section: OMIT, company_id: nil, request_options: nil)
+        @client.page(
+          method: :get,
+          path: "/v1/companies/{co}/feed",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          query: { "cursor" => cursor, "limit" => limit, "section" => section },
+          model: :FeedPage,
+          options: request_options
+        )
+      end
+
+      # Лента компании. Iterates over every item of every page, fetching pages lazily.
+      #
+      # +GET /v1/companies/{co}/feed+
+      #
+      # @param cursor [String] next_cursor из ответа прошлой страницы; без него — первая (самая свежая)
+      #   страница. Остальные фильтры — те же, что у первой страницы.
+      # @param limit [Integer] Сколько на странице: 1–100, по умолчанию 20
+      # @param section [String] Только этот раздел; без него — все
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Enumerator<Tungo::Models::FeedItem>]
+      def get_all(cursor: OMIT, limit: OMIT, section: OMIT, company_id: nil, request_options: nil)
+        Tungo::Page.auto_paging do
+          get(
+            cursor: cursor,
+            limit: limit,
+            section: section,
+            company_id: company_id,
+            request_options: request_options
+          )
+        end
+      end
+
+      # Новые события ленты потоком SSE
+      #
+      # +GET /v1/companies/{co}/feed/events+
+      #
+      # @param cursor [String] С какого события (cursor из FeedItem); заголовок Last-Event-ID важнее
+      # @param once [String] 1 — отдать накопившееся и закрыть поток (для опроса без постоянного соединения)
+      # @param section [String] Только этот раздел; без него — все
+      # @param last_event_id [String, nil] resume after this event id (Last-Event-ID header)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Stream]
+      def list_events(
+        cursor: OMIT,
+        once: OMIT,
+        section: OMIT,
+        last_event_id: nil,
+        company_id: nil,
+        request_options: nil
+      )
+        @client.stream(
+          method: :get,
+          path: "/v1/companies/{co}/feed/events",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          query: { "cursor" => cursor, "once" => once, "section" => section },
+          event: :FeedItem,
+          last_event_id: last_event_id,
+          options: request_options
+        )
+      end
+    end
+  end
+end

data/lib/tungo/resources/forms.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Resources
+    # Налоговые формы (ФНО 100.00 и др.): сборка, проверка ИСНА и разрывы данных
+    class Forms
+      # @api private
+      def initialize(client)
+        @client = client
+        freeze
+      end
+
+      # Налоговые формы года
+      #
+      # +GET /v1/companies/{co}/forms+
+      #
+      # @param year [Integer] Год, 2026–2100 (по умолчанию текущий)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::TaxFormsYear]
+      def list(year: OMIT, company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/forms",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          query: { "year" => year },
+          model: :TaxFormsYear,
+          options: request_options
+        )
+      end
+
+      # Посчитать форму
+      #
+      # +GET /v1/companies/{co}/forms/build+
+      #
+      # @param form [String] Код формы, например 300.00 (из GET …/forms)
+      # @param period [String] Код периода — его передавать в ?period=: 2026-Q2 — квартал, 2026-H1 —
+      #   полугодие, 2026-06 — месяц (у форм «с начала года» — январь–июнь), 2026 — год. Из списка форм —
+      #   periods[].period. Подписи по-русски («2 кв 2026») тоже…
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::TaxFormView]
+      def build(form:, period:, company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/forms/build",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          query: { "form" => form, "period" => period },
+          model: :TaxFormView,
+          options: request_options
+        )
+      end
+
+      # Чего не хватает в 1С
+      #
+      # +GET /v1/companies/{co}/forms/data-gaps+
+      #
+      # @param year [Integer] Год, 2026–2100 (по умолчанию текущий)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::DataGaps]
+      def list_data_gaps(year: OMIT, company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/forms/data-gaps",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          query: { "year" => year },
+          model: :DataGaps,
+          options: request_options
+        )
+      end
+
+      # Файл формы для КНП ИСНА
+      #
+      # +GET /v1/companies/{co}/forms/isna+
+      #
+      # @param form [String] Код формы, например 300.00 (из GET …/forms)
+      # @param period [String] Код периода — его передавать в ?period=: 2026-Q2 — квартал, 2026-H1 —
+      #   полугодие, 2026-06 — месяц (у форм «с начала года» — январь–июнь), 2026 — год. Из списка форм —
+      #   periods[].period. Подписи по-русски («2 кв 2026») тоже…
+      # @param summary [String] 1 — сводка IsnaSummary вместо файла
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Object]
+      def get_isna(form:, period:, summary: OMIT, company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/forms/isna",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          query: { "form" => form, "period" => period, "summary" => summary },
+          model: :IsnaResponse,
+          options: request_options
+        )
+      end
+
+      # Примечания к финотчётности
+      #
+      # +GET /v1/companies/{co}/forms/notes+
+      #
+      # @param period [String] Период отчётности: «2026» — год целиком или «2026-08» — с января по август
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::FinancialNotes]
+      def list_notes(period:, company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/forms/notes",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          query: { "period" => period },
+          model: :FinancialNotes,
+          options: request_options
+        )
+      end
+    end
+  end
+end

data/lib/tungo/resources/onec.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Resources
+    # Состояние подключения компании к базе 1С
+    class Onec
+      # @api private
+      def initialize(client)
+        @client = client
+        freeze
+      end
+
+      # Состояние подключения к 1С (без настроек и секретов)
+      #
+      # +GET /v1/companies/{co}/onec/status+
+      #
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::OneCStatus]
+      def get_status(company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/onec/status",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          model: :OneCStatus,
+          options: request_options
+        )
+      end
+    end
+  end
+end