tungo-sdk 0.2.0

data/lib/tungo/models/tax_form_list_item.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Форма отчётности, которую умеет считать Tungo
+    class TaxFormListItem < Tungo::Model
+      # @!attribute [r] annual
+      #   Годовая форма (раз в год)
+      #   @return [Boolean]
+      required :annual, :boolean
+
+      # @!attribute [r] coverage
+      #   full — наш расчёт считает весь бланк; partial — не все строки: сдавать по нашему расчёту
+      #   нельзя
+      #   @return [String]
+      required :coverage, :TaxFormListItemCoverage
+
+      # @!attribute [r] form
+      #   Код формы (бланка), например 300.00 — декларация по НДС
+      #   @return [String]
+      required :form, :string
+
+      # @!attribute [r] group
+      #   Раздел отчётности: tax — налоговая (КНП ИСНА); financial — финансовая (МСФО для МСБ);
+      #   statistics — статистика (stat.gov.kz); certificate — справки работникам
+      #   @return [String]
+      required :group, :TaxFormListItemGroup
+
+      # @!attribute [r] isna
+      #   Умеем ли собрать файл JSON для загрузки в КНП ИСНА (GET …/forms/isna)
+      #   @return [Boolean]
+      required :isna, :boolean
+
+      # @!attribute [r] kind
+      #   @return [String]
+      required :kind, :TaxPeriodKind
+
+      # @!attribute [r] period_kind
+      #   Вид периода по-русски: месяц, квартал, полугодие, год, с начала года по месяц
+      #   @return [String]
+      required :period_kind, :string
+
+      # @!attribute [r] periods
+      #   Периоды года: сроки и что уже есть в 1С
+      #   @return [Array<Tungo::Models::TaxFormDue>]
+      required :periods, array_of(:TaxFormDue)
+
+      # @!attribute [r] required
+      #   Обязана ли компания сдавать форму по учётной политике 1С: true, false или unknown — не понять
+      #   из 1С
+      #   @return [Object]
+      required :required, :TaxFormListItemRequired
+
+      # @!attribute [r] title
+      #   Название формы
+      #   @return [String]
+      required :title, :string
+
+      # @!attribute [r] why
+      #   Почему обязана или нет — объяснение для человека
+      #   @return [String]
+      required :why, :string
+    end
+  end
+end

data/lib/tungo/models/tax_form_list_item_coverage.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # full — наш расчёт считает весь бланк; partial — не все строки: сдавать по нашему расчёту нельзя
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module TaxFormListItemCoverage
+      extend Tungo::Internal::Enum
+
+      FULL = "full"
+      PARTIAL = "partial"
+    end
+  end
+end

data/lib/tungo/models/tax_form_list_item_group.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Раздел отчётности: tax — налоговая (КНП ИСНА); financial — финансовая (МСФО для МСБ); statistics —
+    # статистика (stat.gov.kz); certificate — справки работникам
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module TaxFormListItemGroup
+      extend Tungo::Internal::Enum
+
+      TAX = "tax"
+      FINANCIAL = "financial"
+      STATISTICS = "statistics"
+      CERTIFICATE = "certificate"
+    end
+  end
+end

data/lib/tungo/models/tax_form_list_item_required.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Обязана ли компания сдавать форму по учётной политике 1С: true, false или unknown — не понять из 1С
+    #
+    # The value is returned as it is.
+    module TaxFormListItemRequired
+      extend Tungo::Internal::Union
+
+      variants(
+        :boolean,
+        :string
+      )
+    end
+  end
+end

data/lib/tungo/models/tax_form_only_in_one_c.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Форма, которую бухгалтер сдавал из 1С, а нашего расчёта для неё нет
+    class TaxFormOnlyInOneC < Tungo::Model
+      # @!attribute [r] form
+      #   Код формы из 1С
+      #   @return [String]
+      required :form, :string
+
+      # @!attribute [r] periods
+      #   Периоды отчётов в 1С, строками «ГГГГ-ММ-ДД..ГГГГ-ММ-ДД»
+      #   @return [Array<String>]
+      required :periods, array_of(:string)
+    end
+  end
+end

data/lib/tungo/models/tax_form_period.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Налоговый период формы
+    class TaxFormPeriod < Tungo::Model
+      # @!attribute [r] code
+      #   Код периода — его передавать в ?period=: 2026-Q2 — квартал, 2026-H1 — полугодие, 2026-06 —
+      #   месяц (у форм «с начала года» — январь–июнь), 2026 — год
+      #   @return [String]
+      required :code, :string
+
+      # @!attribute [r] from
+      #   Начало периода — ГГГГ-ММ-ДД, календарная дата без часового пояса: показывать как есть
+      #   @return [String]
+      required :from, :string
+
+      # @!attribute [r] kind
+      #   @return [String]
+      required :kind, :TaxPeriodKind
+
+      # @!attribute [r] title
+      #   Период по-русски для показа
+      #   @return [String]
+      required :title, :string
+
+      # @!attribute [r] to
+      #   Конец периода включительно — ГГГГ-ММ-ДД, календарная дата без часового пояса: показывать как
+      #   есть
+      #   @return [String]
+      required :to, :string
+    end
+  end
+end

data/lib/tungo/models/tax_form_reference.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Та же форма в 1С, если есть — для сверки
+    class TaxFormReference < Tungo::Model
+      # @!attribute [r] date
+      #   Дата отчёта в 1С
+      #   @return [String, nil]
+      optional :date, :string
+
+      # @!attribute [r] edition
+      #   Редакция бланка в 1С
+      #   @return [String, nil]
+      optional :edition, :string
+
+      # @!attribute [r] found
+      #   Есть ли та же форма за период в 1С (эталон для сверки)
+      #   @return [Boolean]
+      required :found, :boolean
+
+      # @!attribute [r] note
+      #   Почему эталона нет или почему он под вопросом
+      #   @return [String, nil]
+      optional :note, :string
+    end
+  end
+end

data/lib/tungo/models/tax_form_totals.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Сколько ячеек в каждом статусе сверки
+    class TaxFormTotals < Tungo::Model
+      # @!attribute [r] match
+      #   Совпало
+      #   @return [Integer]
+      required :match, :integer
+
+      # @!attribute [r] mismatch
+      #   Расхождений
+      #   @return [Integer]
+      required :mismatch, :integer
+
+      # @!attribute [r] no_reference
+      #   Нет в эталоне 1С
+      #   @return [Integer]
+      required :no_reference, :integer
+
+      # @!attribute [r] not_computed
+      #   Не посчитано
+      #   @return [Integer]
+      required :not_computed, :integer
+    end
+  end
+end

data/lib/tungo/models/tax_form_view.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Форма по данным 1С с ячейками и сверкой с той же формой в 1С
+    class TaxFormView < Tungo::Model
+      # @!attribute [r] cells
+      #   Ячейки формы по порядку бланка
+      #   @return [Array<Tungo::Models::TaxFormCell>]
+      required :cells, array_of(:TaxFormCell)
+
+      # @!attribute [r] coverage
+      #   full — наш расчёт считает весь бланк; partial — не все строки: сдавать по нашему расчёту
+      #   нельзя
+      #   @return [String]
+      required :coverage, :TaxFormViewCoverage
+
+      # @!attribute [r] form
+      #   Код формы (бланка), например 300.00 — декларация по НДС
+      #   @return [String]
+      required :form, :string
+
+      # @!attribute [r] isna
+      #   Можно ли собрать файл для КНП ИСНА — показать кнопку «Файл для ИСНА» (GET …/forms/isna)
+      #   @return [Boolean]
+      required :isna, :boolean
+
+      # @!attribute [r] missing
+      #   Чего не хватает для расчёта
+      #   @return [Array<Tungo::Models::FormMissingData>]
+      required :missing, array_of(:FormMissingData)
+
+      # @!attribute [r] next
+      #   Как сдать — текст для человека: сдаёт человек своей ЭЦП, не ИИ
+      #   @return [String]
+      required :next, :string
+
+      # @!attribute [r] not_ready_because
+      #   Почему сдавать рано — при ready_to_file = false
+      #   @return [Array<String>, nil]
+      optional :not_ready_because, array_of(:string)
+
+      # @!attribute [r] period
+      #   @return [Tungo::Models::TaxFormPeriod]
+      required :period, :TaxFormPeriod
+
+      # @!attribute [r] ready_to_file
+      #   Готова ли форма к сдаче по нашему расчёту; расхождение с 1С не мешает (ошибаться может и 1С)
+      #   @return [Boolean]
+      required :ready_to_file, :boolean
+
+      # @!attribute [r] reference
+      #   @return [Tungo::Models::TaxFormReference]
+      required :reference, :TaxFormReference
+
+      # @!attribute [r] submission
+      #   Кто и куда сдаёт, если не налоговая в КНП ИСНА (статистика, финотчётность)
+      #   @return [String, nil]
+      optional :submission, :string
+
+      # @!attribute [r] title
+      #   Название формы
+      #   @return [String]
+      required :title, :string
+
+      # @!attribute [r] totals
+      #   @return [Tungo::Models::TaxFormTotals]
+      required :totals, :TaxFormTotals
+
+      # @!attribute [r] uncovered
+      #   Непокрытая часть формы: в 1С заполнено, а наш расчёт эти ячейки не считает
+      #   @return [Tungo::Models::TaxFormViewUncovered]
+      required :uncovered, :TaxFormViewUncovered
+
+      # @!attribute [r] warnings
+      #   Предупреждения расчёта (например, период ещё не закончился)
+      #   @return [Array<String>]
+      required :warnings, array_of(:string)
+    end
+  end
+end

data/lib/tungo/models/tax_form_view_coverage.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # full — наш расчёт считает весь бланк; partial — не все строки: сдавать по нашему расчёту нельзя
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module TaxFormViewCoverage
+      extend Tungo::Internal::Enum
+
+      FULL = "full"
+      PARTIAL = "partial"
+    end
+  end
+end

data/lib/tungo/models/tax_form_view_uncovered.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Непокрытая часть формы: в 1С заполнено, а наш расчёт эти ячейки не считает
+    class TaxFormViewUncovered < Tungo::Model
+      # @!attribute [r] cells
+      #   Эти ячейки
+      #   @return [Array<Tungo::Models::TaxFormViewUncoveredCellItem>]
+      required :cells, array_of(:TaxFormViewUncoveredCellItem)
+
+      # @!attribute [r] total
+      #   Сколько ячеек заполнено в 1С, а нами не считается
+      #   @return [Integer]
+      required :total, :integer
+    end
+  end
+end

data/lib/tungo/models/tax_form_view_uncovered_cell_item.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # The +TaxFormViewUncoveredCellItem+ object of the API contract.
+    class TaxFormViewUncoveredCellItem < Tungo::Model
+      # @!attribute [r] name
+      #   Имя ячейки в 1С
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] value
+      #   Значение в 1С
+      #   @return [String]
+      required :value, :string
+    end
+  end
+end

data/lib/tungo/models/tax_forms_year.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Какие формы сдавать за год, сроки и что уже есть в 1С
+    class TaxFormsYear < Tungo::Model
+      # @!attribute [r] forms
+      #   Формы, которые умеет считать Tungo, со сроками и отметкой «уже в 1С»
+      #   @return [Array<Tungo::Models::TaxFormListItem>]
+      required :forms, array_of(:TaxFormListItem)
+
+      # @!attribute [r] in_one_c_without_calculation
+      #   Формы, сданные из 1С, которых Tungo пока не считает; нет поля — таких нет
+      #   @return [Array<Tungo::Models::TaxFormOnlyInOneC>, nil]
+      optional :in_one_c_without_calculation, array_of(:TaxFormOnlyInOneC)
+
+      # @!attribute [r] regime
+      #   Режим налогообложения по учётной политике 1С (например, общеустановленный или упрощённый); нет
+      #   — не прочитан
+      #   @return [String, nil]
+      optional :regime, :string
+
+      # @!attribute [r] year
+      #   Год
+      #   @return [Integer]
+      required :year, :integer
+    end
+  end
+end

data/lib/tungo/models/tax_period_kind.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Вид периода формы: month — месяц; quarter — квартал; half — полугодие; year — год; ytd — с начала
+    # года по конец месяца (финотчётность)
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module TaxPeriodKind
+      extend Tungo::Internal::Enum
+
+      MONTH = "month"
+      QUARTER = "quarter"
+      HALF = "half"
+      YEAR = "year"
+      YTD = "ytd"
+    end
+  end
+end

data/lib/tungo/models/tax_period_ref.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Период формы: код и подпись
+    class TaxPeriodRef < Tungo::Model
+      # @!attribute [r] code
+      #   Код периода — его передавать в ?period=: 2026-Q2 — квартал, 2026-H1 — полугодие, 2026-06 —
+      #   месяц (у форм «с начала года» — январь–июнь), 2026 — год
+      #   @return [String]
+      required :code, :string
+
+      # @!attribute [r] title
+      #   Период по-русски для показа
+      #   @return [String]
+      required :title, :string
+    end
+  end
+end

data/lib/tungo/models/usage_rate.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Цена модели ИИ, по которой считается расход.
+    class UsageRate < Tungo::Model
+      # @!attribute [r] cache_read_per_mtok_tiyn
+      #   Цена 1 млн токенов чтения из кэша модели в тиынах (1 ₸ = 100 тиын; показывать значение / 100
+      #   ₸)
+      #   @return [Integer]
+      required :cache_read_per_mtok_tiyn, :integer
+
+      # @!attribute [r] cache_write_per_mtok_tiyn
+      #   Цена 1 млн токенов записи в кэш модели в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸)
+      #   @return [Integer]
+      required :cache_write_per_mtok_tiyn, :integer
+
+      # @!attribute [r] effective_from
+      #   С какого момента действует цена, ISO 8601 UTC
+      #   @return [String]
+      required :effective_from, :string
+
+      # @!attribute [r] input_per_mtok_tiyn
+      #   Цена 1 млн входных токенов (вопрос и контекст; токен — кусочек текста) в тиынах (1 ₸ = 100
+      #   тиын; показывать значение / 100 ₸)
+      #   @return [Integer]
+      required :input_per_mtok_tiyn, :integer
+
+      # @!attribute [r] model
+      #   Модель ИИ (техническое имя)
+      #   @return [String]
+      required :model, :string
+
+      # @!attribute [r] output_per_mtok_tiyn
+      #   Цена 1 млн токенов ответа в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸)
+      #   @return [Integer]
+      required :output_per_mtok_tiyn, :integer
+    end
+  end
+end

data/lib/tungo/models/webhook_attempt.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Попытка доставить событие на адрес.
+    class WebhookAttempt < Tungo::Model
+      # @!attribute [r] created_at
+      #   Когда была попытка, ISO 8601 UTC
+      #   @return [String]
+      required :created_at, :string
+
+      # @!attribute [r] endpoint_id
+      #   Адрес, на который доставлялось (ep_…)
+      #   @return [String]
+      required :endpoint_id, :string
+
+      # @!attribute [r] id
+      #   id попытки доставки (atmpt_…)
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] message_id
+      #   Сообщение Svix, которое доставлялось (msg_…)
+      #   @return [String]
+      required :message_id, :string
+
+      # @!attribute [r] response_duration_ms
+      #   Сколько ждали ответа приёмника, миллисекунды
+      #   @return [Integer]
+      required :response_duration_ms, :integer
+
+      # @!attribute [r] response_status_code
+      #   Код ответа приёмника; null — ответа не было (нет соединения, предел времени)
+      #   @return [Integer, nil]
+      required :response_status_code, :integer, nullable: true
+
+      # @!attribute [r] status
+      #   Итог: `succeeded` — приёмник ответил 2xx; `pending` — ждёт отправки или повтора; `failed` — не
+      #   доставлено (ответ не 2xx или нет соединения); `sending` — отправляется сейчас
+      #   @return [String]
+      required :status, :WebhookAttemptStatus
+
+      # @!attribute [r] trigger
+      #   `scheduled` — обычная доставка и повторы по расписанию, `manual` — повтор по запросу (resend)
+      #   @return [String]
+      required :trigger, :WebhookAttemptTrigger
+
+      # @!attribute [r] url
+      #   URL, на который ушёл запрос (каким он был в момент попытки)
+      #   @return [String]
+      required :url, :string
+    end
+  end
+end

data/lib/tungo/models/webhook_attempt_status.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Итог: `succeeded` — приёмник ответил 2xx; `pending` — ждёт отправки или повтора; `failed` — не
+    # доставлено (ответ не 2xx или нет соединения); `sending` — отправляется сейчас
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module WebhookAttemptStatus
+      extend Tungo::Internal::Enum
+
+      SUCCEEDED = "succeeded"
+      PENDING = "pending"
+      FAILED = "failed"
+      SENDING = "sending"
+    end
+  end
+end

data/lib/tungo/models/webhook_attempt_trigger.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # `scheduled` — обычная доставка и повторы по расписанию, `manual` — повтор по запросу (resend)
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module WebhookAttemptTrigger
+      extend Tungo::Internal::Enum
+
+      SCHEDULED = "scheduled"
+      MANUAL = "manual"
+    end
+  end
+end

data/lib/tungo/models/webhook_endpoint.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Адрес вебхуков: сервер клиента, куда Tungo шлёт события организации.
+    class WebhookEndpoint < Tungo::Model
+      # @!attribute [r] channels
+      #   Каналы — id сценариев автоматизаций (scn_…): на адрес идут только события этих сценариев; null
+      #   — все события
+      #   @return [Array<String>, nil]
+      required :channels, array_of(:string), nullable: true
+
+      # @!attribute [r] created_at
+      #   Когда заведён, ISO 8601 UTC
+      #   @return [String]
+      required :created_at, :string
+
+      # @!attribute [r] description
+      #   Подпись адреса для людей; пустая строка — не задана
+      #   @return [String]
+      required :description, :string
+
+      # @!attribute [r] enabled
+      #   false — на адрес сейчас не шлётся ничего, пока не включат снова (PATCH enabled: true)
+      #   @return [Boolean]
+      required :enabled, :boolean
+
+      # @!attribute [r] event_types
+      #   Какие события слать (имена из …/webhooks/event-types); null — все
+      #   @return [Array<String>, nil]
+      required :event_types, array_of(:string), nullable: true
+
+      # @!attribute [r] id
+      #   id адреса (ep_…) — для адресов …/webhooks/endpoints/{id}
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] updated_at
+      #   Когда менялся последний раз, ISO 8601 UTC
+      #   @return [String]
+      required :updated_at, :string
+
+      # @!attribute [r] url
+      #   Куда слать события (https)
+      #   @return [String]
+      required :url, :string
+    end
+  end
+end