tungo-sdk 0.2.0

data/lib/tungo/models/proposal_posting.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Проводка — запись «дебет счёта / кредит счёта на сумму» в бухгалтерском учёте. В карточке —
+    # ожидаемые проводки; в result и в ответе одобрения — фактические, прочитанные из 1С после проведения.
+    class ProposalPosting < Tungo::Model
+      # @!attribute [r] amount
+      #   Сумма проводки; null — сумму посчитает сама 1С при проведении (себестоимость), тогда
+      #   computed_by_1c = true: показать «считает 1С»
+      #   @return [Tungo::Models::Money, nil]
+      required :amount, :Money, nullable: true
+
+      # @!attribute [r] computed_by_1c
+      #   true — сумму считает 1С (amount = null)
+      #   @return [Boolean]
+      required :computed_by_1c, :boolean
+
+      # @!attribute [r] credit
+      #   Код счёта кредита
+      #   @return [String]
+      required :credit, :string
+
+      # @!attribute [r] debit
+      #   Код счёта дебета (план счетов 1С)
+      #   @return [String]
+      required :debit, :string
+
+      # @!attribute [r] label
+      #   Что это за проводка простыми словами («выручка», «НДС к начислению»); у фактических проводок —
+      #   «факт 1С»
+      #   @return [String]
+      required :label, :string
+    end
+  end
+end

data/lib/tungo/models/proposal_result.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 ProposalResult < Tungo::Model
+      # @!attribute [r] mismatches
+      #   Чем фактические проводки расходятся с ожидаемыми — по строке на расхождение; пусто — совпали
+      #   @return [Array<String>]
+      required :mismatches, array_of(:string)
+
+      # @!attribute [r] number
+      #   Номер документа (или код карточки справочника) в 1С
+      #   @return [String]
+      required :number, :string
+
+      # @!attribute [r] postings
+      #   Фактические проводки 1С после проведения; пусто у черновика и справочников
+      #   @return [Array<Tungo::Models::ProposalPosting>]
+      required :postings, array_of(:ProposalPosting)
+
+      # @!attribute [r] ref
+      #   Ref_Key записанного документа в 1С (GUID). Показывать не нужно — это ссылка для перехода в 1С
+      #   и для отладки
+      #   @return [String]
+      required :ref, :string
+    end
+  end
+end

data/lib/tungo/models/proposal_source.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 ProposalSource < Tungo::Model
+      # @!attribute [r] channel
+      #   Откуда пришло: web — чат в приложении; api — по ключу API; mcp — из ИИ-клиента через MCP;
+      #   pipeline — пачка (выписка, ЭСФ, автоматизация); cli — служебная командная строка
+      #   @return [String]
+      required :channel, :ProposalSourceChannel
+
+      # @!attribute [r] note
+      #   Уточнение источника; у пачек — метка «batch:<номер задания>»
+      #   @return [String, nil]
+      optional :note, :string
+    end
+  end
+end

data/lib/tungo/models/proposal_source_channel.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
+    # Откуда пришло: web — чат в приложении; api — по ключу API; mcp — из ИИ-клиента через MCP; pipeline —
+    # пачка (выписка, ЭСФ, автоматизация); cli — служебная командная строка
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ProposalSourceChannel
+      extend Tungo::Internal::Enum
+
+      MCP = "mcp"
+      PIPELINE = "pipeline"
+      CLI = "cli"
+      WEB = "web"
+      API = "api"
+    end
+  end
+end

data/lib/tungo/models/proposal_status.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Где предложение в жизненном цикле (подпись по-русски — в status_title рядом): - previewed — ждёт
+    # решения бухгалтера: показать кнопки «Записать» и «Отклонить»; - approved — одобрено, но запись в 1С
+    # не закончена (1С не отв…
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ProposalStatus
+      extend Tungo::Internal::Enum
+
+      PREVIEWED = "previewed"
+      APPROVED = "approved"
+      REJECTED = "rejected"
+      COMMITTED = "committed"
+      POSTED = "posted"
+      VERIFIED = "verified"
+      MISMATCH = "mismatch"
+      FAILED = "failed"
+    end
+  end
+end

data/lib/tungo/models/reject_request.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Тело отклонения
+    class RejectRequest < Tungo::Model
+      # @!attribute [r] confirm_unknown_write
+      #   Только человек в кабинете (по ключу API — 403 permission_error, code human_only). Отклонить
+      #   одобренное «не знаем, записан ли» (write_unknown) или отмену «не знаем, отменён ли»
+      #   (revert_unknown), пока подключён снимок базы…
+      #   @return [Boolean, nil]
+      optional :confirm_unknown_write, :boolean
+
+      # @!attribute [r] reason
+      #   Причина отклонения от человека, от 3 до 1000 знаков — в журнал аудита и в обучение ИИ на
+      #   правках
+      #   @return [String]
+      required :reason, :string
+    end
+  end
+end

data/lib/tungo/models/statement_day.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Выписка дня из DirectBank (без отчёта: он — по GET …/batch/{id})
+    class StatementDay < Tungo::Model
+      # @!attribute [r] counts
+      #   Итоги по строкам; нет — отчёта ещё нет
+      #   @return [Tungo::Models::StatementDayCounts, nil]
+      optional :counts, :StatementDayCounts
+
+      # @!attribute [r] error
+      #   Почему задание прервано — текст для человека; нет — без ошибки
+      #   @return [String, nil]
+      optional :error, :string
+
+      # @!attribute [r] events
+      #   Сколько событий прогресса уже накоплено
+      #   @return [Integer, BigDecimal]
+      required :events, :number
+
+      # @!attribute [r] finished_at
+      #   Когда закончилось, ISO 8601 UTC; нет — ещё идёт
+      #   @return [String, nil]
+      optional :finished_at, :string
+
+      # @!attribute [r] id
+      #   id задания (bat_…): по нему — GET …/batch/{id}, …/summary, …/events, POST …/stop
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] kind
+      #   Вид задания: bank_statement — разбор загруженной банковской выписки; esf_purchases —
+      #   поступления по входящим ЭСФ; approve_batch — одобрение пачкой в фоне; directbank — выписка
+      #   дня, пришедшая сама из банка (DirectBank)
+      #   @return [String]
+      required :kind, :StatementDayKind
+
+      # @!attribute [r] report
+      #   @return [Tungo::Models::BatchJobReport, nil]
+      optional :report, :BatchJobReport
+
+      # @!attribute [r] running
+      #   true — задание идёт: показать прогресс (…/events), кнопку «Остановить»
+      #   @return [Boolean]
+      required :running, :boolean
+
+      # @!attribute [r] started_at
+      #   Когда задание началось, ISO 8601 UTC
+      #   @return [String]
+      required :started_at, :string
+
+      # @!attribute [r] summary
+      #   Адрес сводки задания: GET по нему — BatchSummary
+      #   @return [String]
+      required :summary, :string
+
+      # @!attribute [r] title
+      #   Название задания для списка
+      #   @return [String]
+      required :title, :string
+    end
+  end
+end

data/lib/tungo/models/statement_day_counts.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Итоги по строкам; нет — отчёта ещё нет
+    class StatementDayCounts < Tungo::Model
+      # @!attribute [r] created
+      #   Создано предложений
+      #   @return [Integer, BigDecimal]
+      required :created, :number
+
+      # @!attribute [r] failed
+      #   С ошибкой
+      #   @return [Integer, BigDecimal]
+      required :failed, :number
+
+      # @!attribute [r] manual
+      #   Решает человек
+      #   @return [Integer, BigDecimal]
+      required :manual, :number
+
+      # @!attribute [r] skipped
+      #   Пропущено (уже было)
+      #   @return [Integer, BigDecimal]
+      required :skipped, :number
+
+      # @!attribute [r] total
+      #   Строк в выписке
+      #   @return [Integer, BigDecimal]
+      required :total, :number
+
+      # @!attribute [r] unknown
+      #   Исход неизвестен
+      #   @return [Integer, BigDecimal]
+      required :unknown, :number
+    end
+  end
+end

data/lib/tungo/models/statement_day_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
+    # Вид задания: bank_statement — разбор загруженной банковской выписки; esf_purchases — поступления по
+    # входящим ЭСФ; approve_batch — одобрение пачкой в фоне; directbank — выписка дня, пришедшая сама из
+    # банка (DirectBank)
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module StatementDayKind
+      extend Tungo::Internal::Enum
+
+      BANK_STATEMENT = "bank_statement"
+      ESF_PURCHASES = "esf_purchases"
+      APPROVE_BATCH = "approve_batch"
+      DIRECTBANK = "directbank"
+    end
+  end
+end

data/lib/tungo/models/statement_day_list.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Выписки дня, свежие сверху, страницами
+    class StatementDayList < Tungo::Model
+      # @!attribute [r] data
+      #   Выписки по дням этой страницы, свежие сверху
+      #   @return [Array<Tungo::Models::StatementDay>]
+      required :data, array_of(:StatementDay)
+
+      # @!attribute [r] next_cursor
+      #   Курсор следующей страницы. Чтобы получить её — тот же запрос (с теми же фильтрами) и
+      #   `?cursor=<это значение>`. null — страниц больше нет (кнопку «Ещё» спрятать). Курсор
+      #   непрозрачный: не разбирать и не собирать самому, хр…
+      #   @return [String, nil]
+      required :next_cursor, :string, nullable: true
+    end
+  end
+end

data/lib/tungo/models/tax_form_cell.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Ячейка формы: наш расчёт рядом со значением в 1С
+    class TaxFormCell < Tungo::Model
+      # @!attribute [r] causes
+      #   Откуда число: у расхождения — всё происхождение, у ячейки без эталона — итог и до 5
+      #   документов, у остальных — пусто
+      #   @return [Array<Tungo::Models::TaxFormCellCause>]
+      required :causes, array_of(:TaxFormCellCause)
+
+      # @!attribute [r] cell
+      #   Имя ячейки в 1С
+      #   @return [String]
+      required :cell, :string
+
+      # @!attribute [r] diff
+      #   Наш расчёт минус 1С — у числовых ячеек; при type = money — Money (может быть отрицательной)
+      #   @return [Object]
+      optional :diff, :TaxFormCellDiff
+
+      # @!attribute [r] line
+      #   Номер строки как в бланке
+      #   @return [String]
+      required :line, :string
+
+      # @!attribute [r] note
+      #   Пояснение к ячейке (почему не посчитано и т. п.)
+      #   @return [String, nil]
+      optional :note, :string
+
+      # @!attribute [r] one_c
+      #   Значение в отчёте 1С строкой для показа («—» — нет, «пусто» — пустая ячейка бланка)
+      #   @return [String]
+      required :one_c, :string
+
+      # @!attribute [r] one_c_value
+      #   Значение 1С: при type = money — Money, иначе как есть в единице type; null — в отчёте 1С нет;
+      #   пустая числовая ячейка — 0
+      #   @return [Object]
+      required :one_c_value, :TaxFormCellOneCValue, nullable: true
+
+      # @!attribute [r] ours
+      #   Наш расчёт строкой для показа («1 234 567,89»; «—» — не посчитано)
+      #   @return [String]
+      required :ours, :string
+
+      # @!attribute [r] ours_value
+      #   Наш расчёт: при type = money — Money (сумма бывает отрицательной — к возврату, уменьшение),
+      #   иначе число или строка в единице type; null — не посчитано
+      #   @return [Object]
+      required :ours_value, :TaxFormCellOursValue, nullable: true
+
+      # @!attribute [r] status
+      #   match — совпало с 1С; mismatch — расхождение (показать красным, причины в causes и note);
+      #   no_reference — в отчёте 1С этой ячейки нет; not_computed — не посчитано (заполнить вручную,
+      #   почему — в note)
+      #   @return [String]
+      required :status, :TaxFormCellStatus
+
+      # @!attribute [r] title
+      #   Название строки по правилам составления формы
+      #   @return [String]
+      required :title, :string
+
+      # @!attribute [r] type
+      #   Тип значения и его единица: money — деньги (ours_value, one_c_value, diff — Money); number —
+      #   количество, штуки или дни (число как есть); percent — проценты (12 = 12 %); text — текст; date
+      #   — дата ГГГГ-ММ-ДД
+      #   @return [String]
+      required :type, :TaxFormCellType
+    end
+  end
+end

data/lib/tungo/models/tax_form_cell_cause.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Откуда взялось число ячейки: документ 1С или источник (регистр, проводки, формула)
+    class TaxFormCellCause < Tungo::Model
+      # @!attribute [r] amount
+      #   @return [Tungo::Models::Money, nil]
+      optional :amount, :Money
+
+      # @!attribute [r] date
+      #   Дата документа
+      #   @return [String, nil]
+      optional :date, :string
+
+      # @!attribute [r] kind
+      #   Вид документа 1С по-русски — если причина документ
+      #   @return [String, nil]
+      optional :kind, :string
+
+      # @!attribute [r] number
+      #   Номер документа
+      #   @return [String, nil]
+      optional :number, :string
+
+      # @!attribute [r] records
+      #   Сколько записей источника сложено
+      #   @return [Integer, nil]
+      optional :records, :integer
+
+      # @!attribute [r] source
+      #   Источник числа в именах 1С (регистр, проводки, формула) — если причина не документ
+      #   @return [String, nil]
+      optional :source, :string
+
+      # @!attribute [r] what
+      #   Что взято из источника: «оборот по ставке 16 %, кроме импорта»
+      #   @return [String, nil]
+      optional :what, :string
+    end
+  end
+end

data/lib/tungo/models/tax_form_cell_diff.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С — у числовых ячеек; при type = money — Money (может быть отрицательной)
+    #
+    # An object is matched to the variant whose required properties it carries; one that matches
+    # none is returned as a {Tungo::UnknownVariant}. Other values are returned as they are.
+    module TaxFormCellDiff
+      extend Tungo::Internal::Union
+
+      variants(
+        :Money,
+        :number
+      )
+    end
+  end
+end

data/lib/tungo/models/tax_form_cell_one_c_value.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Значение 1С: при type = money — Money, иначе как есть в единице type; null — в отчёте 1С нет; пустая
+    # числовая ячейка — 0
+    #
+    # An object is matched to the variant whose required properties it carries; one that matches
+    # none is returned as a {Tungo::UnknownVariant}. Other values are returned as they are.
+    module TaxFormCellOneCValue
+      extend Tungo::Internal::Union
+
+      variants(
+        :Money,
+        :number,
+        :string
+      )
+    end
+  end
+end

data/lib/tungo/models/tax_form_cell_ours_value.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Наш расчёт: при type = money — Money (сумма бывает отрицательной — к возврату, уменьшение), иначе
+    # число или строка в единице type; null — не посчитано
+    #
+    # An object is matched to the variant whose required properties it carries; one that matches
+    # none is returned as a {Tungo::UnknownVariant}. Other values are returned as they are.
+    module TaxFormCellOursValue
+      extend Tungo::Internal::Union
+
+      variants(
+        :Money,
+        :number,
+        :string
+      )
+    end
+  end
+end

data/lib/tungo/models/tax_form_cell_status.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
+    # match — совпало с 1С; mismatch — расхождение (показать красным, причины в causes и note);
+    # no_reference — в отчёте 1С этой ячейки нет; not_computed — не посчитано (заполнить вручную, почему —
+    # в note)
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module TaxFormCellStatus
+      extend Tungo::Internal::Enum
+
+      MATCH = "match"
+      MISMATCH = "mismatch"
+      NO_REFERENCE = "no_reference"
+      NOT_COMPUTED = "not_computed"
+    end
+  end
+end

data/lib/tungo/models/tax_form_cell_type.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Тип значения и его единица: money — деньги (ours_value, one_c_value, diff — Money); number —
+    # количество, штуки или дни (число как есть); percent — проценты (12 = 12 %); text — текст; date —
+    # дата ГГГГ-ММ-ДД
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module TaxFormCellType
+      extend Tungo::Internal::Enum
+
+      MONEY = "money"
+      NUMBER = "number"
+      PERCENT = "percent"
+      TEXT = "text"
+      DATE = "date"
+    end
+  end
+end

data/lib/tungo/models/tax_form_due.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Период формы в году: срок сдачи и есть ли она уже в 1С
+    class TaxFormDue < Tungo::Model
+      # @!attribute [r] due
+      #   Срок сдачи ГГГГ-ММ-ДД (с переносом с выходного); нет — срок не посчитан (причина в due_error)
+      #   @return [String, nil]
+      optional :due, :string
+
+      # @!attribute [r] due_error
+      #   Почему срок не посчитан — текст для человека
+      #   @return [String, nil]
+      optional :due_error, :string
+
+      # @!attribute [r] from
+      #   Начало периода — ГГГГ-ММ-ДД, календарная дата без часового пояса: показывать как есть
+      #   @return [String]
+      required :from, :string
+
+      # @!attribute [r] in_one_c
+      #   Дата регламентированного отчёта за этот период в 1С (ГГГГ-ММ-ДД) — форма уже есть в 1С; null —
+      #   в 1С её нет
+      #   @return [String, nil]
+      required :in_one_c, :string, nullable: true
+
+      # @!attribute [r] moved
+      #   true — срок выпал на нерабочий день и перенесён на следующий рабочий
+      #   @return [Boolean, nil]
+      optional :moved, :boolean
+
+      # @!attribute [r] period
+      #   Код периода — его передавать в ?period=: 2026-Q2 — квартал, 2026-H1 — полугодие, 2026-06 —
+      #   месяц (у форм «с начала года» — январь–июнь), 2026 — год
+      #   @return [String]
+      required :period, :string
+
+      # @!attribute [r] period_title
+      #   Период по-русски для показа
+      #   @return [String]
+      required :period_title, :string
+
+      # @!attribute [r] started
+      #   Начался ли период: false — считать форму ещё рано
+      #   @return [Boolean]
+      required :started, :boolean
+
+      # @!attribute [r] to
+      #   Конец периода — ГГГГ-ММ-ДД, календарная дата без часового пояса: показывать как есть
+      #   @return [String]
+      required :to, :string
+    end
+  end
+end