tungo-sdk 0.2.0

data/lib/tungo/models/batch_approve_job_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 BatchApproveJobKind
+      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/batch_approve_request.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Что одобрить: либо ids, либо batch_id — ровно одно из двух. Неизвестные поля — 400.
+    class BatchApproveRequest < Tungo::Model
+      # @!attribute [r] async
+      #   Одобрить заданием в фоне: ответ 202 с номером задания сразу, прогресс — …/batch/:id/events,
+      #   итог — …/batch/:id (report.approval). Пачка больше 50 предложений идёт заданием всегда.
+      #   @return [Boolean, nil]
+      optional :async, :boolean
+
+      # @!attribute [r] batch_id
+      #   Задание пачки (bat_… — id из ответа на загрузку выписки или ЭСФ): все предложения этого
+      #   задания
+      #   @return [String, nil]
+      optional :batch_id, :string
+
+      # @!attribute [r] exclude
+      #   Что снято галочками — эти предложения не одобряются (не больше 2000)
+      #   @return [Array<String>, nil]
+      optional :exclude, array_of(:string)
+
+      # @!attribute [r] idempotency_key
+      #   То же, что заголовок Idempotency-Key
+      #   @return [String, nil]
+      optional :idempotency_key, :string
+
+      # @!attribute [r] ids
+      #   Явный список предложений. Взаимоисключающе с batch_id.
+      #   @return [Array<String>, nil]
+      optional :ids, array_of(:string)
+
+      # @!attribute [r] note
+      #   Комментарий к решению: попадёт в журнал по каждому предложению
+      #   @return [String, nil]
+      optional :note, :string
+
+      # @!attribute [r] post
+      #   Проводить документы после записи (по умолчанию true)
+      #   @return [Boolean, nil]
+      optional :post, :boolean
+    end
+  end
+end

data/lib/tungo/models/batch_approve_response.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Итог одобрения пачкой — по каждому предложению
+    class BatchApproveResponse < Tungo::Model
+      # @!attribute [r] approved
+      #   Одобрено, включая уже записанные раньше
+      #   @return [Integer, BigDecimal]
+      required :approved, :number
+
+      # @!attribute [r] batch_id
+      #   Номер задания, если одобряли по batch_id
+      #   @return [String, nil]
+      optional :batch_id, :string
+
+      # @!attribute [r] counts
+      #   Сколько предложений с каждым исходом (ключ — outcome из results)
+      #   @return [Hash{String=>Integer, BigDecimal}]
+      required :counts, map_of(:number)
+
+      # @!attribute [r] excluded
+      #   Снято галочкой
+      #   @return [Integer, BigDecimal]
+      required :excluded, :number
+
+      # @!attribute [r] failed
+      #   Не одобрено по любой причине
+      #   @return [Integer, BigDecimal]
+      required :failed, :number
+
+      # @!attribute [r] limit
+      #   Предел пачки (2000)
+      #   @return [Integer, BigDecimal]
+      required :limit, :number
+
+      # @!attribute [r] message
+      #   Итог одной фразой для человека
+      #   @return [String]
+      required :message, :string
+
+      # @!attribute [r] ok
+      #   true — всё, что не снято галочкой, одобрено (или уже было записано); false — есть отказы,
+      #   смотрите results
+      #   @return [Boolean]
+      required :ok, :boolean
+
+      # @!attribute [r] requested
+      #   Сколько предложений в пачке (со снятыми галочкой)
+      #   @return [Integer, BigDecimal]
+      required :requested, :number
+
+      # @!attribute [r] results
+      #   Исход по каждому предложению, в порядке пачки
+      #   @return [Array<Tungo::Models::BatchApproveResult>]
+      required :results, array_of(:BatchApproveResult)
+
+      # @!attribute [r] stopped
+      #   Пачка остановлена раньше конца (1С трижды не ответила, база только для чтения, отозвали право,
+      #   нажали «Остановить»)
+      #   @return [Tungo::Models::BatchApproveResponseStopped, nil]
+      optional :stopped, :BatchApproveResponseStopped
+
+      # @!attribute [r] unknown_excluded
+      #   Номера из exclude, которых нет в пачке
+      #   @return [Array<String>, nil]
+      optional :unknown_excluded, array_of(:string)
+    end
+  end
+end

data/lib/tungo/models/batch_approve_response_stopped.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
+    # Пачка остановлена раньше конца (1С трижды не ответила, база только для чтения, отозвали право,
+    # нажали «Остановить»)
+    class BatchApproveResponseStopped < Tungo::Model
+      # @!attribute [r] reason
+      #   Почему остановлена — текст для человека
+      #   @return [String]
+      required :reason, :string
+
+      # @!attribute [r] remaining
+      #   Сколько предложений не тронуто и ждут решения
+      #   @return [Integer, BigDecimal]
+      required :remaining, :number
+    end
+  end
+end

data/lib/tungo/models/batch_approve_result.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Исход одного предложения пачки
+    class BatchApproveResult < Tungo::Model
+      # @!attribute [r] document_number
+      #   Номер документа в 1С, если записан
+      #   @return [String, nil]
+      optional :document_number, :string
+
+      # @!attribute [r] error
+      #   Код отказа (как error.code в ApproveError), если не удалось
+      #   @return [String, nil]
+      optional :error, :string
+
+      # @!attribute [r] id
+      #   Номер предложения внутри компании (P-000123): по нему открывают карточку GET …/proposals/{id}
+      #   и одобряют POST …/proposals/{id}/approve
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] message
+      #   Подробности для человека
+      #   @return [String]
+      required :message, :string
+
+      # @!attribute [r] mismatches
+      #   Расхождения проводок, если есть
+      #   @return [Array<String>, nil]
+      optional :mismatches, array_of(:string)
+
+      # @!attribute [r] outcome
+      #   Исход: approved — одобрено и записано; already_written — уже было записано (второй документ не
+      #   создан); excluded — снято галочкой; forbidden — нет права; policy_blocked — не пускает
+      #   политика; blocked — есть блокеры; not_…
+      #   @return [String]
+      required :outcome, :BatchApproveResultOutcome
+
+      # @!attribute [r] retry_after
+      #   При write_unknown сразу после обрыва: через сколько секунд повтор запишет заново, если
+      #   документа по метке так и не будет; в серию «1С не ответила» не считается
+      #   @return [Integer, nil]
+      optional :retry_after, :integer
+
+      # @!attribute [r] title
+      #   Исход по-русски для показа
+      #   @return [String]
+      required :title, :string
+    end
+  end
+end

data/lib/tungo/models/batch_approve_result_outcome.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
+    # Исход: approved — одобрено и записано; already_written — уже было записано (второй документ не
+    # создан); excluded — снято галочкой; forbidden — нет права; policy_blocked — не пускает политика;
+    # blocked — есть блокеры; not_…
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module BatchApproveResultOutcome
+      extend Tungo::Internal::Enum
+
+      APPROVED = "approved"
+      FORBIDDEN = "forbidden"
+      ALREADY_WRITTEN = "already_written"
+      NOT_FOUND = "not_found"
+      BLOCKED = "blocked"
+      WRONG_STATUS = "wrong_status"
+      READ_ONLY = "read_only"
+      UNAVAILABLE = "unavailable"
+      FAILED = "failed"
+      POLICY_BLOCKED = "policy_blocked"
+      JOB_RUNNING = "job_running"
+      EXCLUDED = "excluded"
+      NOT_ATTEMPTED = "not_attempted"
+    end
+  end
+end

data/lib/tungo/models/batch_job.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 BatchJob < Tungo::Model
+      # @!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, :BatchJobKind
+
+      # @!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] title
+      #   Название задания для списка
+      #   @return [String]
+      required :title, :string
+    end
+  end
+end

data/lib/tungo/models/batch_job_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 BatchJobKind
+      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/batch_job_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
+    # Задания без отчёта (report не отдаётся), страницами
+    class BatchJobList < Tungo::Model
+      # @!attribute [r] data
+      #   Задания этой страницы, свежие сверху
+      #   @return [Array<Tungo::Models::BatchJob>]
+      required :data, array_of(:BatchJob)
+
+      # @!attribute [r] next_cursor
+      #   Курсор следующей страницы. Чтобы получить её — тот же запрос (с теми же фильтрами) и
+      #   `?cursor=<это значение>`. null — страниц больше нет (кнопку «Ещё» спрятать). Курсор
+      #   непрозрачный: не разбирать и не собирать самому, хр…
+      #   @return [String, nil]
+      required :next_cursor, :string, nullable: true
+    end
+  end
+end

data/lib/tungo/models/batch_job_report.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Отчёт задания — когда оно закончилось (в списке GET …/batch не отдаётся)
+    class BatchJobReport < Tungo::Model
+      # @!attribute [r] approval
+      #   @return [Tungo::Models::BatchApproveResponse, nil]
+      optional :approval, :BatchApproveResponse
+
+      # @!attribute [r] created
+      #   Создано предложений
+      #   @return [Integer]
+      required :created, :integer
+
+      # @!attribute [r] duplicates
+      #   Повторы строки в одном источнике (тот же ключ, исход один). Одинаковые строки выписки без
+      #   номера документа — разные платежи: у второй и дальше свой ключ, сюда они не входят
+      #   @return [Integer]
+      required :duplicates, :integer
+
+      # @!attribute [r] failed
+      #   С ошибкой
+      #   @return [Integer]
+      required :failed, :integer
+
+      # @!attribute [r] gateway
+      #   Служебное: нагрузка на 1С
+      #   @return [Tungo::Models::BatchJobReportGateway, nil]
+      optional :gateway, :BatchJobReportGateway
+
+      # @!attribute [r] manual
+      #   Ждут решения человека
+      #   @return [Integer]
+      required :manual, :integer
+
+      # @!attribute [r] min_concurrency
+      #   Служебное: сколько сеансов 1С пачка держала
+      #   @return [Integer]
+      required :min_concurrency, :integer
+
+      # @!attribute [r] pending
+      #   Не взятые в работу после остановки; повторный запуск возьмёт их
+      #   @return [Integer]
+      required :pending, :integer
+
+      # @!attribute [r] rows
+      #   Исход по каждой строке
+      #   @return [Array<Tungo::Models::BatchJobRow>]
+      required :rows, array_of(:BatchJobRow)
+
+      # @!attribute [r] skipped
+      #   Пропущено (уже было)
+      #   @return [Integer]
+      required :skipped, :integer
+
+      # @!attribute [r] stopped
+      #   true — задание остановили до конца
+      #   @return [Boolean]
+      required :stopped, :boolean
+
+      # @!attribute [r] total
+      #   Строк в источнике
+      #   @return [Integer]
+      required :total, :integer
+
+      # @!attribute [r] unknown
+      #   С неизвестным исходом (1С не ответила)
+      #   @return [Integer]
+      required :unknown, :integer
+
+      # Properties beyond the declared ones are allowed; read them with #[].
+      additional_properties :any
+    end
+  end
+end

data/lib/tungo/models/batch_job_report_gateway.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 BatchJobReportGateway < Tungo::Model
+      # @!attribute [r] asked
+      #   Сколько обращений к 1С просили
+      #   @return [Integer]
+      required :asked, :integer
+
+      # @!attribute [r] passed
+      #   Сколько пропустил ограничитель
+      #   @return [Integer]
+      required :passed, :integer
+    end
+  end
+end

data/lib/tungo/models/batch_job_row.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 BatchJobRow < Tungo::Model
+      # @!attribute [r] blockers
+      #   Блокеры по строке
+      #   @return [Array<String>, nil]
+      optional :blockers, array_of(:string)
+
+      # @!attribute [r] document_ref
+      #   Ref_Key найденного или созданного документа 1С
+      #   @return [String, nil]
+      optional :document_ref, :string
+
+      # @!attribute [r] key
+      #   Ключ строки (он же метка документа): повтор задания эту строку второй раз не возьмёт
+      #   @return [String]
+      required :key, :string
+
+      # @!attribute [r] proposal_id
+      #   Номер предложения строки (P-…), если оно есть
+      #   @return [String, nil]
+      optional :proposal_id, :string
+
+      # @!attribute [r] question
+      #   @return [Tungo::Models::BatchRowQuestion, nil]
+      optional :question, :BatchRowQuestion
+
+      # @!attribute [r] reason
+      #   Почему manual, failed или unknown — текст для бухгалтера
+      #   @return [String, nil]
+      optional :reason, :string
+
+      # @!attribute [r] status
+      #   created — предложение создано; skipped — уже было (повтор строки или документ уже есть);
+      #   manual — строку решает человек (reason); failed — ошибка; unknown — исход неизвестен (1С не
+      #   ответила)
+      #   @return [String]
+      required :status, :BatchJobRowStatus
+
+      # @!attribute [r] title
+      #   Строка для человека: дата, контрагент, сумма
+      #   @return [String]
+      required :title, :string
+
+      # @!attribute [r] warnings
+      #   Предупреждения по строке
+      #   @return [Array<String>, nil]
+      optional :warnings, array_of(:string)
+    end
+  end
+end

data/lib/tungo/models/batch_job_row_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
+    # created — предложение создано; skipped — уже было (повтор строки или документ уже есть); manual —
+    # строку решает человек (reason); failed — ошибка; unknown — исход неизвестен (1С не ответила)
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module BatchJobRowStatus
+      extend Tungo::Internal::Enum
+
+      CREATED = "created"
+      SKIPPED = "skipped"
+      FAILED = "failed"
+      UNKNOWN = "unknown"
+      MANUAL = "manual"
+    end
+  end
+end

data/lib/tungo/models/batch_manual_row.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 BatchManualRow < Tungo::Model
+      # @!attribute [r] key
+      #   Ключ строки
+      #   @return [String]
+      required :key, :string
+
+      # @!attribute [r] question
+      #   Вопрос по строке (как BatchRowQuestion: id, text, options) — ответить в чате
+      #   @return [Object]
+      optional :question, :any
+
+      # @!attribute [r] reason
+      #   Почему её решает человек
+      #   @return [String]
+      required :reason, :string
+
+      # @!attribute [r] title
+      #   Строка для человека
+      #   @return [String]
+      required :title, :string
+    end
+  end
+end

data/lib/tungo/models/batch_row_question.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
+    # Вопрос по строке выписки: ответ в чате станет правилом, и следующий прогон разнесёт такую строку сам
+    class BatchRowQuestion < Tungo::Model
+      # @!attribute [r] id
+      #   id вопроса
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] options
+      #   Варианты ответа
+      #   @return [Array<Tungo::Models::BatchRowQuestionOptionItem>]
+      required :options, array_of(:BatchRowQuestionOptionItem)
+
+      # @!attribute [r] text
+      #   Вопрос бухгалтеру
+      #   @return [String]
+      required :text, :string
+    end
+  end
+end

data/lib/tungo/models/batch_row_question_option_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 +BatchRowQuestionOptionItem+ object of the API contract.
+    class BatchRowQuestionOptionItem < Tungo::Model
+      # @!attribute [r] description
+      #   Пояснение варианта
+      #   @return [String]
+      required :description, :string
+
+      # @!attribute [r] label
+      #   Вариант ответа
+      #   @return [String]
+      required :label, :string
+    end
+  end
+end

data/lib/tungo/models/batch_stop_result.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
+    # Итог «Остановить»
+    class BatchStopResult < Tungo::Model
+      # @!attribute [r] id
+      #   Номер задания
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] stopped
+      #   true — задание шло и остановлено; false — оно уже закончилось
+      #   @return [Boolean]
+      required :stopped, :boolean
+    end
+  end
+end