tungo-sdk 0.2.0

data/lib/tungo/models/proposal_card.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Полная карточка предложения: шапка, строки, проводки, блокеры, кнопки и история
+    class ProposalCard < Tungo::Model
+      # @!attribute [r] actions
+      #   Кнопки карточки в нужном порядке: approve, approve_draft, reject
+      #   @return [Array<Tungo::Models::ProposalAction>]
+      required :actions, array_of(:ProposalAction)
+
+      # @!attribute [r] advance_offset
+      #   @return [Tungo::Models::ProposalAdvanceOffset, nil]
+      optional :advance_offset, :ProposalAdvanceOffset
+
+      # @!attribute [r] approval
+      #   @return [Tungo::Models::ProposalApproval]
+      required :approval, :ProposalApproval
+
+      # @!attribute [r] blocker_count
+      #   Сколько блокеров: больше 0 — одобрить нельзя, нужен ответ человека в чате
+      #   @return [Integer]
+      required :blocker_count, :integer
+
+      # @!attribute [r] blockers
+      #   Блокеры — показать красным: пока они есть, одобрить нельзя. Снимает их ответ человека в чате
+      #   (ИИ пересоберёт предложение)
+      #   @return [Array<String>]
+      required :blockers, array_of(:string)
+
+      # @!attribute [r] counterparty
+      #   @return [Tungo::Models::ProposalParty, nil]
+      optional :counterparty, :ProposalParty
+
+      # @!attribute [r] created_at
+      #   Когда ИИ подготовил предложение, ISO 8601 UTC
+      #   @return [String]
+      required :created_at, :string
+
+      # @!attribute [r] dialog_id
+      #   Разговор чата, в котором ИИ подготовил предложение: «Открыть разговор» — GET
+      #   …/chat/{dialog_id} (если он ваш). null — не из чата (пачка, автоматизация, MCP)
+      #   @return [String, nil]
+      required :dialog_id, :string, nullable: true
+
+      # @!attribute [r] document_number
+      #   Номер документа в 1С — есть, когда документ уже записан
+      #   @return [String, nil]
+      optional :document_number, :string
+
+      # @!attribute [r] header
+      #   @return [Tungo::Models::ProposalHeader]
+      required :header, :ProposalHeader
+
+      # @!attribute [r] history
+      #   История статусов, от старых к новым
+      #   @return [Array<Tungo::Models::ProposalHistoryEvent>]
+      required :history, array_of(:ProposalHistoryEvent)
+
+      # @!attribute [r] href
+      #   Адрес карточки в API: GET по нему отдаёт ProposalCard
+      #   @return [String]
+      required :href, :string
+
+      # @!attribute [r] id
+      #   Номер предложения внутри компании (P-000123): по нему открывают карточку GET …/proposals/{id}
+      #   и одобряют POST …/proposals/{id}/approve
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] intent
+      #   Намерение ИИ в предметных терминах (ключи snake_case) — для аудита и отладки; интерфейсу
+      #   показывать не нужно
+      #   @return [Hash{String=>Object}]
+      required :intent, map_of(:any)
+
+      # @!attribute [r] kind
+      #   @return [String]
+      required :kind, :ProposalKind
+
+      # @!attribute [r] kind_title
+      #   Вид документа по-русски для показа
+      #   @return [String]
+      required :kind_title, :string
+
+      # @!attribute [r] level
+      #   @return [String]
+      required :level, :AutonomyLevel
+
+      # @!attribute [r] level_title
+      #   Уровень самостоятельности по-русски для показа
+      #   @return [String]
+      required :level_title, :string
+
+      # @!attribute [r] line_count
+      #   Сколько строк товаров и услуг в документе; 0 у платёжек и справочников
+      #   @return [Integer]
+      required :line_count, :integer
+
+      # @!attribute [r] lines
+      #   Строки товаров и услуг; пусто у платёжек, кассовых ордеров и справочников
+      #   @return [Array<Tungo::Models::ProposalLine>]
+      required :lines, array_of(:ProposalLine)
+
+      # @!attribute [r] postings
+      #   Ожидаемые проводки — что получится в учёте после проведения
+      #   @return [Array<Tungo::Models::ProposalPosting>]
+      required :postings, array_of(:ProposalPosting)
+
+      # @!attribute [r] result
+      #   @return [Tungo::Models::ProposalResult, nil]
+      optional :result, :ProposalResult
+
+      # @!attribute [r] source
+      #   @return [Tungo::Models::ProposalSource]
+      required :source, :ProposalSource
+
+      # @!attribute [r] status
+      #   @return [String]
+      required :status, :ProposalStatus
+
+      # @!attribute [r] status_title
+      #   Статус по-русски для показа (бейдж)
+      #   @return [String]
+      required :status_title, :string
+
+      # @!attribute [r] summary
+      #   Текстовое превью документа (для чата и логов). Интерфейс рисует карточку по полям выше
+      #   @return [String]
+      required :summary, :string
+
+      # @!attribute [r] title
+      #   Заголовок строки очереди: вид документа, дата и контрагент
+      #   @return [String]
+      required :title, :string
+
+      # @!attribute [r] total
+      #   @return [Tungo::Models::Money]
+      required :total, :Money
+
+      # @!attribute [r] vat
+      #   @return [Tungo::Models::Money]
+      required :vat, :Money
+
+      # @!attribute [r] warning_count
+      #   Сколько предупреждений: показать жёлтый значок, одобрению не мешают
+      #   @return [Integer]
+      required :warning_count, :integer
+
+      # @!attribute [r] warnings
+      #   Предупреждения — показать жёлтым; одобрению не мешают
+      #   @return [Array<String>]
+      required :warnings, array_of(:string)
+    end
+  end
+end

data/lib/tungo/models/proposal_contract.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Договор контрагента, по которому идёт документ
+    class ProposalContract < Tungo::Model
+      # @!attribute [r] date
+      #   Дата договора как записана в 1С (обычно ГГГГ-ММ-ДД)
+      #   @return [String, nil]
+      optional :date, :string
+
+      # @!attribute [r] kind
+      #   Вид договора из 1С: СПокупателем, СПоставщиком, Прочее…
+      #   @return [String, nil]
+      optional :kind, :string
+
+      # @!attribute [r] name
+      #   Название договора; не нашёлся в 1С — «Договор не найден в 1С»
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] number
+      #   Номер договора, если заполнен в 1С
+      #   @return [String, nil]
+      optional :number, :string
+
+      # @!attribute [r] ref
+      #   Ref_Key договора в 1С (GUID). Показывать не нужно — это ссылка для перехода в 1С и для отладки
+      #   @return [String]
+      required :ref, :string
+    end
+  end
+end

data/lib/tungo/models/proposal_decision.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Итог одобрения или отклонения
+    class ProposalDecision < Tungo::Model
+      # @!attribute [r] document
+      #   @return [Tungo::Models::ProposalDocument, nil]
+      optional :document, :ProposalDocument
+
+      # @!attribute [r] message
+      #   Итог для человека — показать как есть («Документ № … проведён, проводки совпали»)
+      #   @return [String]
+      required :message, :string
+
+      # @!attribute [r] mismatches
+      #   Только у одобрения: расхождения фактических проводок с ожидаемыми; пусто — совпали
+      #   @return [Array<String>, nil]
+      optional :mismatches, array_of(:string)
+
+      # @!attribute [r] ok
+      #   Всегда true: отказ приходит ошибкой ApproveError
+      #   @return [Boolean]
+      required :ok, :boolean
+
+      # @!attribute [r] postings
+      #   Только у одобрения: фактические проводки 1С
+      #   @return [Array<Tungo::Models::ProposalPosting>, nil]
+      optional :postings, array_of(:ProposalPosting)
+
+      # @!attribute [r] proposal
+      #   @return [Tungo::Models::ProposalCard, nil]
+      optional :proposal, :ProposalCard
+
+      # @!attribute [r] repeated
+      #   true — решение уже было принято раньше, повтор ничего не изменил (второй документ не создан)
+      #   @return [Boolean]
+      required :repeated, :boolean
+    end
+  end
+end

data/lib/tungo/models/proposal_document.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # При сбое записи, если документ уже создан: «записан черновиком, но не проведён» видно без карточки;
+    # повтор «Записать» проведёт тот же документ
+    class ProposalDocument < Tungo::Model
+      # @!attribute [r] number
+      #   Номер документа в 1С
+      #   @return [String, nil]
+      optional :number, :string
+
+      # @!attribute [r] posted
+      #   Проведён ли документ; нет поля — повтор уже записанного (смотрите статус в proposal)
+      #   @return [Boolean, nil]
+      optional :posted, :boolean
+
+      # @!attribute [r] ref
+      #   Ref_Key документа в 1С
+      #   @return [String, nil]
+      optional :ref, :string
+    end
+  end
+end

data/lib/tungo/models/proposal_header.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Шапка документа: дата, стороны, итоги, счета
+    class ProposalHeader < Tungo::Model
+      # @!attribute [r] accounts
+      #   Счета из шапки документа: расчёты с контрагентом, авансы, банковский счёт
+      #   @return [Array<Tungo::Models::ProposalAccount>]
+      required :accounts, array_of(:ProposalAccount)
+
+      # @!attribute [r] comment
+      #   Комментарий документа в 1С (там же метка [AI P-…], по которой документ находится в 1С)
+      #   @return [String, nil]
+      optional :comment, :string
+
+      # @!attribute [r] contract
+      #   @return [Tungo::Models::ProposalContract, nil]
+      optional :contract, :ProposalContract
+
+      # @!attribute [r] counterparty
+      #   @return [Tungo::Models::ProposalParty, nil]
+      optional :counterparty, :ProposalParty
+
+      # @!attribute [r] date
+      #   Дата документа ГГГГ-ММ-ДД — календарная дата, без часового пояса: показывать как есть, не
+      #   переводить
+      #   @return [String]
+      required :date, :string
+
+      # @!attribute [r] document_title
+      #   Вид документа по-русски (заголовок карточки)
+      #   @return [String]
+      required :document_title, :string
+
+      # @!attribute [r] entity_set
+      #   Набор OData 1С, куда ляжет запись (Document_… — документ, Catalog_… — справочник); для отладки
+      #   @return [String]
+      required :entity_set, :string
+
+      # @!attribute [r] net
+      #   @return [Tungo::Models::Money]
+      required :net, :Money
+
+      # @!attribute [r] organization
+      #   @return [Tungo::Models::ProposalParty, nil]
+      optional :organization, :ProposalParty
+
+      # @!attribute [r] payment_purpose
+      #   Назначение платежа — у банковских документов
+      #   @return [String, nil]
+      optional :payment_purpose, :string
+
+      # @!attribute [r] prices_include_vat
+      #   Включают ли суммы строк НДС (реквизит СуммаВключаетНДС); нет — у документа такого реквизита
+      #   нет
+      #   @return [Boolean, nil]
+      optional :prices_include_vat, :boolean
+
+      # @!attribute [r] total
+      #   @return [Tungo::Models::Money]
+      required :total, :Money
+
+      # @!attribute [r] vat
+      #   @return [Tungo::Models::Money]
+      required :vat, :Money
+    end
+  end
+end

data/lib/tungo/models/proposal_history_event.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Шаг истории предложения
+    class ProposalHistoryEvent < Tungo::Model
+      # @!attribute [r] actor
+      #   Кто: usr_… — человек, key_… — ключ API, ai — ИИ, automation:… — автоматизация, system — сам
+      #   сервис
+      #   @return [String]
+      required :actor, :string
+
+      # @!attribute [r] at
+      #   Когда, ISO 8601 UTC
+      #   @return [String]
+      required :at, :string
+
+      # @!attribute [r] note
+      #   Пояснение: причина отклонения, комментарий к одобрению, текст ошибки записи
+      #   @return [String, nil]
+      optional :note, :string
+
+      # @!attribute [r] status
+      #   @return [String]
+      required :status, :ProposalStatus
+
+      # @!attribute [r] status_title
+      #   Статус по-русски
+      #   @return [String]
+      required :status_title, :string
+    end
+  end
+end

data/lib/tungo/models/proposal_kind.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Что ИИ предлагает записать в 1С (подпись по-русски — в kind_title): - sale — реализация товаров и
+    # услуг (продажа покупателю); - purchase — поступление товаров и услуг (покупка у поставщика); -
+    # bank_receipt — входящее пла…
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ProposalKind
+      extend Tungo::Internal::Enum
+
+      SALE = "sale"
+      PURCHASE = "purchase"
+      BANK_RECEIPT = "bank_receipt"
+      BANK_PAYMENT = "bank_payment"
+      COUNTERPARTY = "counterparty"
+      CONTRACT = "contract"
+      REVERT = "revert"
+      INVENTORY_WRITEOFF = "inventory_writeoff"
+      CASH_ORDER_IN = "cash_order_in"
+      CASH_ORDER_OUT = "cash_order_out"
+      ADVANCE_REPORT = "advance_report"
+    end
+  end
+end

data/lib/tungo/models/proposal_line.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
+    # Строка товара или услуги в документе
+    class ProposalLine < Tungo::Model
+      # @!attribute [r] accounts
+      #   Счета строки: учёт, доходы, себестоимость, НДС
+      #   @return [Array<Tungo::Models::ProposalAccount>]
+      required :accounts, array_of(:ProposalAccount)
+
+      # @!attribute [r] description
+      #   Содержание услуги своими словами, если отличается от названия номенклатуры
+      #   @return [String, nil]
+      optional :description, :string
+
+      # @!attribute [r] item
+      #   Номенклатура строки (товар или услуга из справочника 1С)
+      #   @return [Tungo::Models::ProposalLineItem]
+      required :item, :ProposalLineItem
+
+      # @!attribute [r] no
+      #   Номер строки в карточке, с 1 (товары, затем услуги)
+      #   @return [Integer]
+      required :no, :integer
+
+      # @!attribute [r] price
+      #   @return [Tungo::Models::Money]
+      required :price, :Money
+
+      # @!attribute [r] quantity
+      #   Количество (может быть дробным)
+      #   @return [Integer, BigDecimal]
+      required :quantity, :number
+
+      # @!attribute [r] section
+      #   goods — табличная часть «Товары»; services — «Услуги»
+      #   @return [String]
+      required :section, :ProposalLineSection
+
+      # @!attribute [r] sum
+      #   @return [Tungo::Models::Money]
+      required :sum, :Money
+
+      # @!attribute [r] total
+      #   @return [Tungo::Models::Money]
+      required :total, :Money
+
+      # @!attribute [r] vat
+      #   @return [Tungo::Models::Money]
+      required :vat, :Money
+
+      # @!attribute [r] vat_rate
+      #   Ставка НДС в процентах (12, 0); нет — ставка не определена
+      #   @return [Integer, BigDecimal, nil]
+      optional :vat_rate, :number
+
+      # @!attribute [r] vat_rate_title
+      #   Ставка НДС для показа: «12%», «Без НДС», «Ставка не определена»
+      #   @return [String]
+      required :vat_rate_title, :string
+    end
+  end
+end

data/lib/tungo/models/proposal_line_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
+    # Номенклатура строки (товар или услуга из справочника 1С)
+    class ProposalLineItem < Tungo::Model
+      # @!attribute [r] name
+      #   Название товара или услуги; не нашлась в 1С — «Номенклатура не найдена в 1С»
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] ref
+      #   Ref_Key номенклатуры в 1С; пустая строка — номенклатура не указана
+      #   @return [String]
+      required :ref, :string
+    end
+  end
+end

data/lib/tungo/models/proposal_line_section.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
+    # goods — табличная часть «Товары»; services — «Услуги»
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ProposalLineSection
+      extend Tungo::Internal::Enum
+
+      GOODS = "goods"
+      SERVICES = "services"
+    end
+  end
+end

data/lib/tungo/models/proposal_list_item.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Короткая карточка для очереди — без строк и проводок (за ними — GET …/proposals/{id})
+    class ProposalListItem < Tungo::Model
+      # @!attribute [r] approval
+      #   @return [Tungo::Models::ProposalApproval]
+      required :approval, :ProposalApproval
+
+      # @!attribute [r] blocker_count
+      #   Сколько блокеров: больше 0 — одобрить нельзя, нужен ответ человека в чате
+      #   @return [Integer]
+      required :blocker_count, :integer
+
+      # @!attribute [r] counterparty
+      #   @return [Tungo::Models::ProposalParty, nil]
+      optional :counterparty, :ProposalParty
+
+      # @!attribute [r] created_at
+      #   Когда ИИ подготовил предложение, ISO 8601 UTC
+      #   @return [String]
+      required :created_at, :string
+
+      # @!attribute [r] dialog_id
+      #   Разговор чата, в котором ИИ подготовил предложение: «Открыть разговор» — GET
+      #   …/chat/{dialog_id} (если он ваш). null — не из чата (пачка, автоматизация, MCP)
+      #   @return [String, nil]
+      required :dialog_id, :string, nullable: true
+
+      # @!attribute [r] document_number
+      #   Номер документа в 1С — есть, когда документ уже записан
+      #   @return [String, nil]
+      optional :document_number, :string
+
+      # @!attribute [r] href
+      #   Адрес карточки в API: GET по нему отдаёт ProposalCard
+      #   @return [String]
+      required :href, :string
+
+      # @!attribute [r] id
+      #   Номер предложения внутри компании (P-000123): по нему открывают карточку GET …/proposals/{id}
+      #   и одобряют POST …/proposals/{id}/approve
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] kind
+      #   @return [String]
+      required :kind, :ProposalKind
+
+      # @!attribute [r] kind_title
+      #   Вид документа по-русски для показа
+      #   @return [String]
+      required :kind_title, :string
+
+      # @!attribute [r] level
+      #   @return [String]
+      required :level, :AutonomyLevel
+
+      # @!attribute [r] level_title
+      #   Уровень самостоятельности по-русски для показа
+      #   @return [String]
+      required :level_title, :string
+
+      # @!attribute [r] line_count
+      #   Сколько строк товаров и услуг в документе; 0 у платёжек и справочников
+      #   @return [Integer]
+      required :line_count, :integer
+
+      # @!attribute [r] status
+      #   @return [String]
+      required :status, :ProposalStatus
+
+      # @!attribute [r] status_title
+      #   Статус по-русски для показа (бейдж)
+      #   @return [String]
+      required :status_title, :string
+
+      # @!attribute [r] title
+      #   Заголовок строки очереди: вид документа, дата и контрагент
+      #   @return [String]
+      required :title, :string
+
+      # @!attribute [r] total
+      #   @return [Tungo::Models::Money]
+      required :total, :Money
+
+      # @!attribute [r] vat
+      #   @return [Tungo::Models::Money]
+      required :vat, :Money
+
+      # @!attribute [r] warning_count
+      #   Сколько предупреждений: показать жёлтый значок, одобрению не мешают
+      #   @return [Integer]
+      required :warning_count, :integer
+    end
+  end
+end

data/lib/tungo/models/proposal_page.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 Models
+    # Страница очереди предложений, свежие сверху
+    class ProposalPage < Tungo::Model
+      # @!attribute [r] counts
+      #   Сколько предложений в каждом статусе (ключ — ProposalStatus), без учёта фильтра — для бейджей
+      #   вкладок; статусов без предложений нет
+      #   @return [Hash{String=>Integer, BigDecimal}]
+      required :counts, map_of(:number)
+
+      # @!attribute [r] data
+      #   Предложения страницы, свежие сверху
+      #   @return [Array<Tungo::Models::ProposalListItem>]
+      required :data, array_of(:ProposalListItem)
+
+      # @!attribute [r] next_cursor
+      #   Курсор следующей страницы. Чтобы получить её — тот же запрос (с теми же фильтрами) и
+      #   `?cursor=<это значение>`. null — страниц больше нет (кнопку «Ещё» спрятать). Курсор
+      #   непрозрачный: не разбирать и не собирать самому, хр…
+      #   @return [String, nil]
+      required :next_cursor, :string, nullable: true
+
+      # @!attribute [r] total
+      #   Сколько предложений подходит под все фильтры (на всех страницах)
+      #   @return [Integer, BigDecimal]
+      required :total, :number
+    end
+  end
+end

data/lib/tungo/models/proposal_party.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Контрагент документа; нет — у документа его нет (например, кассовый ордер без контрагента)
+    class ProposalParty < Tungo::Model
+      # @!attribute [r] bin
+      #   БИН/ИИН — 12 цифр (БИН у юрлица, ИИН у ИП и физлица). Нет — в 1С не заполнен
+      #   @return [String, nil]
+      optional :bin, :string
+
+      # @!attribute [r] name
+      #   Название для показа. Не нашёлся в 1С — «Контрагент не найден в 1С»
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] ref
+      #   Ref_Key контрагента или организации в 1С (GUID). Показывать не нужно — это ссылка для перехода
+      #   в 1С и для отладки
+      #   @return [String]
+      required :ref, :string
+    end
+  end
+end