atol 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 739a43f61f1406eeeb5ef5233e3788c7609d9d480fbe1dfab694073b200e181e
-  data.tar.gz: f967cee6aeb248b5c00217d9548cbd671d771bfc94d4d1d1840b747b36dcb205
+  metadata.gz: 17a1f879f910bd053721385602bc4e3c158dc10625534db847d78bdb54ee75e4
+  data.tar.gz: 8408f2c974e2e49c3dd89745e942cc06375fbcbf050d843015fdd17d8839eae4
 SHA512:
-  metadata.gz: fc2d5a6482f6856b7700602148b29698b1b362e004255a28fa27a7cd6b903349ec2d7c33f10c38a31c3b6c98d4f3bed70537fdc2cb69d92edc4b19e78586f73a
-  data.tar.gz: 303cf4af75af283fc6b0917ce4a5f8c7d081c4f4e776b9f5120170e63ed8a6b78a0dddda4d7ab8c516f768c459048a82f2dba632eb4feee61f58e0ec80e1d83c
+  metadata.gz: 05c52df6c9b2bfcd04c47a09a2e71f1e1eec304809cba41c1e858431c6a141eeca774191ebd8488c88a97225dad0a3524af12d9bc018d0c66a29a0a279b81698
+  data.tar.gz: 5e034691a9b942dab227b3c2341b1379aebe787d6b71b9eee895387c8caee014e17da56a1588b2479d9852c21e5fe5646ef2ef7bcb15fc26141e4be7bdc90c37

data/.rubocop.yml

@@ -11,4 +11,6 @@ Metrics/LineLength:
 
 Metrics/ParameterLists:
   Exclude:
-    - lib/atol/request/post_document/item/body.rb
+    - lib/atol/request/post_document/item/body.rb
+    - lib/atol/request/post_document/sell/body.rb
+    - lib/atol/request/post_document/correction/v5/body.rb

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    atol (0.8.1)
+    atol (1.1.0)
       anyway_config (~> 1.0)
 
 GEM
@@ -9,7 +9,7 @@ GEM
   specs:
     addressable (2.5.2)
       public_suffix (>= 2.0.2, < 4.0)
-    anyway_config (1.1.3)
+    anyway_config (1.4.4)
     ast (2.4.1)
     coveralls (0.8.21)
       json (>= 1.8, < 3)
@@ -22,7 +22,7 @@ GEM
     diff-lcs (1.3)
     docile (1.1.5)
     hashdiff (0.3.7)
-    json (2.1.0)
+    json (2.18.1)
     parallel (1.19.2)
     parser (2.7.1.4)
       ast (~> 2.4.1)
@@ -77,7 +77,7 @@ PLATFORMS
 
 DEPENDENCIES
   atol!
-  bundler (~> 1.15)
+  bundler (~> 2.1.4)
   coveralls
   rake (~> 13.0)
   rspec (~> 3.0)

data/README.md

@@ -9,8 +9,7 @@
 
 ##### Совместимость
 
-Для корректной работы необходим интерпретатор Руби версии 2.5. Пакет работает с версией протокола v4.
-
+Для корректной работы необходим интерпретатор Руби версии ~> 3.0.0. Пакет работает с версиями протокола [v4](http://atol.online/api_v4) и [v5](http://atol.online/api_v5)  (см. настройку ATOL_API_URL).
 
 ## Использование
 
@@ -26,58 +25,10 @@ gem 'atol'
 ```
 $ bundle install
 ```
-### Конфигурация
-
-Для обращения к сервису необходимы данные учетной записи.
-
-При инициализации приложение попытается найти необходимые параметры в константе `ENV`.
-
-Для корректной работы потребуются следующие переменные окружения.
-
-**Все переменные являются обязательными**.
-
-```bash
-# .env
-ATOL_INN=123456789010
-ATOL_LOGIN=example-login
-ATOL_PASSWORD=example-password
-ATOL_PAYMENT_ADDRESS="г. Москва, ул. Ленина, д.1 к.2"
-ATOL_GROUP_CODE=example-group-code
-ATOL_DEFAULT_SNO=esn
-ATOL_DEFAULT_TAX=vat18
-ATOL_CALLBACK_URL=https://www.example.com/callback_path
-ATOL_COMPANY_EMAIL=example@email.com
-ATOL_DEFAULT_PAYMENT_TYPE=1
-```
-
-Значения `ATOL_INN`, `ATOL_LOGIN`, `ATOL_PASSWORD`, `ATOL_PAYMENT_ADDRESS` и `ATOL_GROUP_CODE` вы получаете при регистрации в сервисе.
-
-`ATOL_DEFAULT_SNO` - система налогообложения. Возможные значения:
-1) "osn" – общая СН;
-2) "usn_income" – упрощенная СН (доходы);
-3) "usn_income_outcome" – упрощенная СН (доходы минус расходы);
-4) "envd" – единый налог на вмененный доход;
-5) "esn" – единый сельскохозяйственный налог;
-6) "patent" – патентная СН.
-
-`ATOL_DEFAULT_TAX` - номер налога в ККТ. Возможные значения:
-1) "none" – без НДС;
-2) "vat0" – НДС по ставке 0%;
-3) "vat10" – НДС чека по ставке 10%;
-4) "vat18" – НДС чека по ставке 18%;
-5) "vat110" – НДС чека по расчетной ставке 10/110;
-6) "vat118" – НДС чека по расчетной ставке 18/118.
-
-`ATOL_CALLBACK_URL` - адрес, по которому сервис будет отправлять информацию после создания чека.
-
-`ATOL_DEFAULT_PAYMENT_TYPE` - вид оплаты. Возможные значения:
-1) "1" – электронный;
-2) "2" – "9" – расширенные типы оплаты. Для каждого фискального типа оплаты можно указать расширенный тип оплаты.
-
-`ATOL_COMPANY_EMAIL` - адрес электронной почты вашей компании.
-
 ### Конфигурация в инициализаторе
 
+Для обращения к сервису необходимы данные учетной записи. `login`, `password` и `group_code`
+
 Для Rails-приложений так же можно создать файл инициализации и задать параметры непосредственно в коде:
 
 ```ruby
@@ -88,13 +39,15 @@ Rails.application.config.after_initialize do
     config.inn                  = '123456789010'
     config.login                = 'example-login'
     config.password             = 'example-password'
-    config.payment_address      = 'г. Москва, ул. Ленина, д.1 к.2'
+    config.payment_address      = 'г. Москва, ул. Ленина, д.1 к.2' # тэг 1187
     config.group_code           = 'example-group-code'
-    config.default_sno          = 'esn'
+    config.default_sno          = 'esn' # тэг 1055
     config.default_tax          = 'vat18'
     config.callback_url         = 'https://www.example.com/callback_path'
     config.company_email        = 'example@email.com'
-    config.default_payment_type = '1'
+    config.default_payment_type = '1' # тэг 1031
+    config.api_url              = 'https://online.atol.ru/possystem/v5' # по умолчанию 'https://online.atol.ru/possystem/v4' ФФД 1.05
+    config.internet             = true # тэг 1125, по умолчанию false
   end
 end
 ```
@@ -151,8 +104,7 @@ body = Atol::Request::PostDocument::Sell::Body.new(
   email: 'example@example.com',
   items: [
     ...
-  ],
-  agent_info_type: 'bank_paying_agent'
+  ]
 ).to_json
 ```
 
@@ -160,6 +112,8 @@ body = Atol::Request::PostDocument::Sell::Body.new(
 
 Массив `items` должен включать в себя объекты, которые так же соответствуют схеме.
 
+#### Items для версии V4
+
 Для создания `items` можно использовать класс `Atol::Request::PostDocument::Item::Body`.
 
 Его конструктор принимает обязательные аргументы `name`, `price`, `payment_method`, `payment_object` и опциональные `quantity` (по умолчанию 1), `supplier_info_inn`, `supplier_info_name`, `agent_info_type` (тег ФФД - 1222).
@@ -197,7 +151,7 @@ item = Atol::Request::PostDocument::Item::Body.new(
 Тогда создание всего тела запроса будет выглядеть так:
 
 ```ruby
-body = Atol::Request::PostDocument::Sell::Body.new(
+Atol::Request::PostDocument::Sell::Body.new(
   external_id: 123,
   email: 'example@example.com',
   items: [
@@ -271,8 +225,76 @@ body = Atol::Request::PostDocument::Sell::Body.new(
   "timestamp":"06.02.2018 12:35:00",
   "external_id":123
 }
+```
+
+#### Items для версии V5
+
+Создается как в v4 только
+
+- Добавлено обязательное поле `measure`
+- Добавлено обязательное поле `vat`
+- Изменен тип поля `payment_object` на int
+
+Доступные значения для `measure`
 
 ```
+0, 10, 11, 12, 20, 21, 22, 30, 31, 32, 40, 41, 42, 50, 51, 70, 71, 72, 73, 80, 81, 82, 83, 255
+```
+
+`vat` имеет вид объекта, пример
+
+```
+{ type: 'none' }
+```
+Доступные type для vat
+`none vat0 vat5 vat7 vat10 vat22 vat105 vat107 vat110 vat20 vat120 vat122`
+
+Доступные значения для `payment_object`
+
+```
+1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23
+```
+
+#### Кастомные payments
+
+По умолчанию `Sell::Body` формирует один платёж с типом из конфигурации (`default_payment_type`) и суммой, равной итогу позиций. Если нужны другие виды оплаты (например, зачёт аванса — тег 1215, тип `2`), можно передать массив объектов `Atol::Request::PostDocument::Payment` явно. Сумма платежей должна совпадать с итогом позиций, иначе конструктор бросит `Atol::PaymentsTotalMismatchError`.
+
+```ruby
+payments = [
+  Atol::Request::PostDocument::Payment.new(
+    type: Atol::Request::PostDocument::Payment::PREPAID_TYPE,
+    sum: 200.0
+  )
+]
+Atol::Request::PostDocument::Sell::Body.new(
+  external_id: 123,
+  email: 'example@example.com',
+  items: [item],
+  payments: payments
+).to_json
+```
+
+Виды оплаты (`type`) — константы класса `Atol::Request::PostDocument::Payment`: `CASH_TYPE` наличные (1031), `CASHLESS_TYPE` безналичный (1081), `PREPAID_TYPE` предоплата/зачёт аванса (1215), `POSTPAID_TYPE` постоплата/кредит (1216), `COUNTER_PROVISION_TYPE` встречное предоставление (1217), `EXTENDED_5_TYPE`–`EXTENDED_9_TYPE` расширенные.
+
+#### Чек коррекции для версии V5
+
+Для тела чека коррекции используется класс `Atol::Request::PostDocument::Correction::Body` — он выбирает реализацию по `config.api_url`, как и `Item::Body`. Реализован только ФФД 1.2 (`Correction::V5::Body`, операции `sell_refund_correction`, `sell_correction` и т.п.); для v4-эндпоинта (ФФД 1.05) тело коррекции не реализовано и конструктор бросит `Atol::Request::PostDocument::Correction::Body::BadApiUrlError`.
+
+Обязательные аргументы: `external_id`, `items`, `correction_type` (`self` или `instruction`) и `base_date` (дата корректируемого расчёта в формате `dd.mm.yyyy`, тег 1178), а также хотя бы один контакт клиента — `phone` или `email`. Необязательные: `base_number` — номер документа-основания (тег 1179, не более 32 байт); `additional_check_props` — дополнительный реквизит чека/БСО (тег 1192, не более 16 байт); и `payments` (как и в `Sell::Body`, при отсутствии формируется один платёж из `default_payment_type` с суммой, равной итогу позиций; переданная сумма платежей должна совпадать с итогом позиций).
+
+```ruby
+body = Atol::Request::PostDocument::Correction::Body.new(
+  external_id: 123,
+  email: 'example@example.com',
+  items: [...],
+  correction_type: 'self',
+  base_date: '01.01.2026',
+  base_number: '12345'
+).to_json
+
+Atol::Transaction::PostDocument.new(operation: :sell_refund_correction, token: token, body: body).call
+```
+
 #### Отправка документа
 
 Когда токен и тело запроса составлены, остается только сделать post-запрос.

data/atol-rb.gemspec

@@ -25,7 +25,7 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'anyway_config', '~> 1.0'
 
-  spec.add_development_dependency 'bundler', '~> 1.15'
+  spec.add_development_dependency 'bundler', '~> 2.1.4'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
   spec.add_development_dependency 'rubocop', '~> 0.90'

data/lib/atol/config.rb

@@ -15,9 +15,10 @@ module Atol
                 :default_tax,
                 :callback_url,
                 :company_email,
+                internet: false,
                 req_tries_number: 3,
                 default_payment_type: 1,
                 http_client: Net::HTTP,
-                api_url: "https://online.atol.ru/possystem/#{Atol::Version::API}"
+                api_url: Atol::Version::V4
   end
 end

data/lib/atol/errors.rb

@@ -18,6 +18,9 @@ module Atol
   class StateMissingUuidError < StandardError; end
   class StateNotFoundError < StandardError; end
   class ZeroItemQuantityError < StandardError; end
+  class BadPaymentError < StandardError; end
+  class EmptyPaymentsError < StandardError; end
+  class PaymentsTotalMismatchError < StandardError; end
 
   ERRORS = Hash[
       0 => BadJSONError,

data/lib/atol/request/post_document/correction/body.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Atol
+  module Request
+    class PostDocument
+      module Correction
+        class Body
+          BadApiUrlError = Class.new(StandardError)
+
+          attr_reader :instance
+
+          def initialize(**kwargs)
+            config = kwargs[:config] || Atol.config
+            @instance = case config.api_url
+                        when Atol::Version::V5, Atol::Version::V5_TEST
+                          Atol::Request::PostDocument::Correction::V5::Body.new(**kwargs)
+                        when Atol::Version::V4, Atol::Version::V4_TEST
+                          raise BadApiUrlError, 'correction body for the v4 api is not implemented'
+                        else
+                          raise BadApiUrlError
+                        end
+          end
+
+          def to_h
+            instance.to_h
+          end
+
+          def to_json(*args)
+            instance.to_json(*args)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/atol/request/post_document/correction/v5/body.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+require 'atol/errors'
+require 'atol/request/post_document/payment'
+
+module Atol
+  module Request
+    class PostDocument
+      module Correction
+        module V5
+          class Body
+            class BadCorrectionTypeError < StandardError; end
+            class BadCorrectionBaseDateError < StandardError; end
+            class BadCorrectionBaseNumberError < StandardError; end
+            class BadAdditionalCheckPropsError < StandardError; end
+
+            CORRECTION_TYPES = %w[self instruction].freeze
+            BASE_DATE_FORMAT = /\A\d{2}\.\d{2}\.\d{4}\z/
+            BASE_NUMBER_MAX_BYTESIZE = 32
+            ADDITIONAL_CHECK_PROPS_MAX_BYTESIZE = 16
+
+            def initialize(external_id:, items:, correction_type:, base_date:, phone: '', email: '',
+                           payments: nil, base_number: nil, additional_check_props: nil, config: nil, **options)
+              raise(Atol::EmptyClientContactError) if phone.empty? && email.empty?
+              raise(Atol::EmptySellItemsError) if items.empty?
+              raise(BadCorrectionTypeError) unless CORRECTION_TYPES.include?(correction_type)
+              raise(BadCorrectionBaseDateError) unless base_date.to_s.match?(BASE_DATE_FORMAT)
+              raise(BadCorrectionBaseNumberError) if base_number && base_number.to_s.bytesize > BASE_NUMBER_MAX_BYTESIZE
+              if additional_check_props && additional_check_props.to_s.bytesize > ADDITIONAL_CHECK_PROPS_MAX_BYTESIZE
+                raise(BadAdditionalCheckPropsError)
+              end
+
+              total = items.sum { |item| item[:sum] }
+              validate_payments!(payments, total)
+
+              @config = config || Atol.config
+              @external_id = external_id
+              @phone = phone
+              @email = email
+              @items = items
+              @correction_type = correction_type
+              @base_date = base_date
+              @base_number = base_number
+              @additional_check_props = additional_check_props
+              @total = total
+              @payments = payments
+            end
+
+            def to_h
+              build_body.clone
+            end
+
+            def to_json(*_args)
+              build_body.to_json
+            end
+
+            private
+
+            attr_reader :config, :external_id, :phone, :email, :items, :payments,
+                        :correction_type, :base_date, :base_number, :additional_check_props, :total
+
+            def validate_payments!(payments, total)
+              return if payments.nil?
+
+              raise(Atol::EmptyPaymentsError) if payments.empty?
+              raise(Atol::BadPaymentError) if payments.any? { |payment| !payment.is_a?(Payment) }
+              raise(Atol::PaymentsTotalMismatchError) unless payments.sum(&:sum).round(2) == total.round(2)
+            end
+
+            def build_body
+              {
+                external_id: external_id,
+                correction: correction,
+                service: service,
+                timestamp: Time.now.strftime(Atol::TIMESTAMP_FORMAT)
+              }
+            end
+
+            def correction
+              result = {
+                client: client,
+                company: company,
+                correction_info: correction_info,
+                items: items,
+                payments: build_payments,
+                total: total,
+                internet: config.internet
+              }
+              result[:additional_check_props] = additional_check_props if additional_check_props
+
+              result
+            end
+
+            def client
+              result = {}
+              result[:email] = email unless email.empty?
+              result[:phone] = phone unless phone.empty?
+
+              result
+            end
+
+            def company
+              {
+                inn: config.inn.to_s,
+                sno: config.default_sno,
+                payment_address: config.payment_address,
+                email: config.company_email
+              }
+            end
+
+            def build_payments
+              (payments || [Payment.new(type: config.default_payment_type, sum: total)]).map(&:to_h)
+            end
+
+            def service
+              config.callback_url ? { callback_url: config.callback_url } : {}
+            end
+
+            def correction_info
+              info = { type: correction_type, base_date: base_date }
+              info[:base_number] = base_number if base_number
+
+              info
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/atol/request/post_document/item/body.rb

@@ -1,86 +1,28 @@
 # frozen_string_literal: true
 
-require 'atol/errors'
-
 module Atol
   module Request
     class PostDocument
       module Item
         class Body
-          BadPaymentMethodError = Class.new(StandardError)
-          BadPaymentObjectError = Class.new(StandardError)
-
-          PAYMENT_METHODS = [
-            'full_prepayment', 'prepayment', 'advance', 'full_payment',
-            'partial_payment', 'credit', 'credit_payment'
-          ]
-
-          PAYMENT_OBJECTS = [
-            'commodity', 'excise', 'job', 'service', 'gambling_bet', 'gambling_prize',
-            'lottery', 'lottery_prize', 'intellectual_activity', 'payment', 'agent_commission',
-            'composite', 'another'
-          ]
+          BadApiUrlError = Class.new(StandardError)
 
-          attr_accessor :config, :name, :price, :quantity, :payment_method, :payment_object,
-                        :agent_info_type, :supplier_info_inn, :supplier_info_name
+          attr_reader :instance
 
-          def initialize(config: nil, name:, price:, quantity: 1, payment_method:, payment_object:, **options)
-            setup_attributes(config, name, price, quantity, payment_method, payment_object, options)
-            validate_attributes
+          def initialize(**kwargs)
+            config = kwargs[:config] || Atol.config
+            @instance = case config.api_url
+                        when Atol::Version::V4, Atol::Version::V4_TEST
+                          Atol::Request::PostDocument::Item::V4::Body.new(**kwargs)
+                        when Atol::Version::V5, Atol::Version::V5_TEST
+                          Atol::Request::PostDocument::Item::V5::Body.new(**kwargs)
+                        else
+                          raise BadApiUrlError
+                        end
           end
 
           def to_h
-            body.clone
-          end
-
-          def to_json(*_args)
-            body.to_json
-          end
-
-          private
-
-          def setup_attributes(config, name, price, quantity, payment_method, payment_object, options)
-            self.config = config || Atol.config
-            self.name = name
-            self.price = price.to_f
-            self.quantity = quantity.to_f
-            self.payment_method = payment_method.to_s
-            self.payment_object = payment_object.to_s
-            self.agent_info_type = options[:agent_info_type].to_s
-            self.supplier_info_inn = options[:supplier_info_inn].to_s
-            self.supplier_info_name = options[:supplier_info_name].to_s
-          end
-
-          def validate_attributes
-            raise Atol::ZeroItemQuantityError if quantity.to_f.zero?
-            raise BadPaymentMethodError unless PAYMENT_METHODS.include?(payment_method)
-            raise BadPaymentObjectError unless PAYMENT_OBJECTS.include?(payment_object)
-          end
-
-          def agent_info
-            return if agent_info_type.nil? || agent_info_type.empty?
-
-            { agent_info: { type: agent_info_type } }
-          end
-
-          def supplier_info
-            return if supplier_info_inn.nil? || supplier_info_inn.empty? || agent_info.nil?
-
-            info = { inn: supplier_info_inn, name: supplier_info_name }
-            filtered_info = info.reject { |_key, value| value&.empty? }
-            { supplier_info: filtered_info } unless filtered_info.empty?
-          end
-
-          def body
-            @body ||= {
-              name: name,
-              price: price,
-              quantity: quantity,
-              sum: (price * quantity).round(2),
-              tax: config.default_tax,
-              payment_method: payment_method,
-              payment_object: payment_object
-            }.merge(supplier_info.to_h, agent_info.to_h)
+            instance.to_h
           end
         end
       end

data/lib/atol/request/post_document/item/v4/body.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require 'atol/errors'
+
+module Atol
+  module Request
+    class PostDocument
+      module Item
+        module V4
+          class Body
+            BadPaymentMethodError = Class.new(StandardError)
+            BadPaymentObjectError = Class.new(StandardError)
+
+            PAYMENT_METHODS = %w[
+              full_prepayment prepayment advance full_payment
+              partial_payment credit credit_payment
+            ].freeze
+
+            PAYMENT_OBJECTS = %w[
+              commodity excise job service gambling_bet gambling_prize
+              lottery lottery_prize intellectual_activity payment agent_commission
+              composite another
+            ].freeze
+
+            attr_accessor :config,
+                          :name,
+                          :price,
+                          :quantity,
+                          :payment_method,
+                          :payment_object,
+                          :agent_info_type,
+                          :supplier_info_inn,
+                          :supplier_info_name
+
+            def initialize(config: nil, name:, price:, quantity: 1, payment_method:, payment_object:, **options)
+              setup_attributes(config, name, price, quantity, payment_method, payment_object, options)
+              validate_attributes
+            end
+
+            def to_h
+              body.clone
+            end
+
+            def to_json(*_args)
+              body.to_json
+            end
+
+            private
+
+            def setup_attributes(config, name, price, quantity, payment_method, payment_object, options)
+              self.config = config || Atol.config
+              self.name = name
+              self.price = price.to_f
+              self.quantity = quantity.to_f
+              self.payment_method = payment_method.to_s
+              self.payment_object = payment_object.to_s
+              self.agent_info_type = options[:agent_info_type].to_s
+              self.supplier_info_inn = options[:supplier_info_inn].to_s
+              self.supplier_info_name = options[:supplier_info_name].to_s
+            end
+
+            def validate_attributes
+              raise Atol::ZeroItemQuantityError if quantity.to_f.zero?
+              raise BadPaymentMethodError unless PAYMENT_METHODS.include?(payment_method)
+              raise BadPaymentObjectError unless PAYMENT_OBJECTS.include?(payment_object)
+            end
+
+            def agent_info
+              return if agent_info_type.nil? || agent_info_type.empty?
+
+              { agent_info: { type: agent_info_type } }
+            end
+
+            def supplier_info
+              return if supplier_info_inn.nil? || supplier_info_inn.empty? || agent_info.nil?
+
+              info = { inn: supplier_info_inn, name: supplier_info_name }
+              filtered_info = info.reject { |_key, value| value&.empty? }
+              { supplier_info: filtered_info } unless filtered_info.empty?
+            end
+
+            def body
+              @body ||= {
+                name: name,
+                price: price,
+                quantity: quantity,
+                sum: (price * quantity).round(2),
+                tax: config.default_tax,
+                payment_method: payment_method,
+                payment_object: payment_object
+              }.merge(supplier_info.to_h, agent_info.to_h)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/atol/request/post_document/item/v5/body.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require 'atol/errors'
+
+module Atol
+  module Request
+    class PostDocument
+      module Item
+        module V5
+          class Body
+            BadPaymentMethodError = Class.new(StandardError)
+            BadPaymentObjectError = Class.new(StandardError)
+            BadMeasureError = Class.new(StandardError)
+            BadVatTypeError = Class.new(StandardError)
+
+            # https://atol-kassa.ru/wp-content/nfiles/files/ATOL/kassa/АТОЛ%20Онлайн%20-%20Описание%20протокола%20v5%20(ФФД%201.2).pdf
+
+            PAYMENT_METHODS = %w[full_prepayment prepayment advance full_payment partial_payment credit credit_payment].freeze
+            PAYMENT_OBJECTS = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23].freeze
+            MEASURE = [0, 10, 11, 12, 20, 21, 22, 30, 31, 32, 40, 41, 42, 50, 51, 70, 71, 72, 73, 80, 81, 82, 83, 255].freeze
+            VAT_TYPES = %w[none vat0 vat5 vat7 vat10 vat22 vat105 vat107 vat110 vat20 vat120 vat122].freeze
+
+            attr_accessor :name,
+                          :price,
+                          :quantity,
+                          :payment_method,
+                          :payment_object,
+                          :agent_info_type,
+                          :supplier_info_inn,
+                          :supplier_info_name,
+                          :measure,
+                          :vat
+
+            def initialize(name:, price:, quantity: 1, payment_method:, payment_object:, measure:, vat:, **options)
+              setup_attributes(name, price, quantity, payment_method, payment_object, measure, vat, options)
+              validate_attributes
+            end
+
+            def to_h
+              body.clone
+            end
+
+            def to_json(*_args)
+              body.to_json
+            end
+
+            private
+
+            def setup_attributes(name, price, quantity, payment_method, payment_object, measure, vat, options)
+              self.name = name
+              self.price = price.to_f
+              self.quantity = quantity.to_f
+              self.payment_method = payment_method.to_s
+              self.payment_object = payment_object
+              self.agent_info_type = options[:agent_info_type].to_s
+              self.supplier_info_inn = options[:supplier_info_inn].to_s
+              self.supplier_info_name = options[:supplier_info_name].to_s
+              self.measure = measure
+              self.vat = vat
+            end
+
+            def validate_attributes
+              raise Atol::ZeroItemQuantityError if quantity.to_f.zero?
+              raise BadPaymentMethodError unless PAYMENT_METHODS.include?(payment_method)
+              raise BadPaymentObjectError unless PAYMENT_OBJECTS.include?(payment_object)
+              raise BadMeasureError unless MEASURE.include?(measure)
+              raise BadVatTypeError unless VAT_TYPES.include?(vat&.[](:type))
+            end
+
+            def agent_info
+              return if agent_info_type.nil? || agent_info_type.empty?
+
+              { agent_info: { type: agent_info_type } }
+            end
+
+            def supplier_info
+              return if supplier_info_inn.nil? || supplier_info_inn.empty? || agent_info.nil?
+
+              info = { inn: supplier_info_inn, name: supplier_info_name }
+              filtered_info = info.reject { |_key, value| value&.empty? }
+              { supplier_info: filtered_info } unless filtered_info.empty?
+            end
+
+            def body
+              @body ||= {
+                name: name,
+                price: price,
+                quantity: quantity,
+                sum: (price * quantity).round(2),
+                payment_method: payment_method,
+                payment_object: payment_object,
+                measure: measure,
+                vat: vat
+              }.merge(supplier_info.to_h, agent_info.to_h)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/atol/request/post_document/payment.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'atol/errors'
+
+module Atol
+  module Request
+    class PostDocument
+      class Payment
+        CASH_TYPE = 0                   # наличные
+        CASHLESS_TYPE = 1               # безналичный
+        PREPAID_TYPE = 2                # предоплата/зачёт аванса (тег 1215)
+        POSTPAID_TYPE = 3               # постоплата/кредит
+        COUNTER_PROVISION_TYPE = 4      # встречное предоставление
+        EXTENDED_5_TYPE = 5             # расширенный тип оплаты 5
+        EXTENDED_6_TYPE = 6             # расширенный тип оплаты 6
+        EXTENDED_7_TYPE = 7             # расширенный тип оплаты 7
+        EXTENDED_8_TYPE = 8             # расширенный тип оплаты 8
+        EXTENDED_9_TYPE = 9             # расширенный тип оплаты 9
+
+        TYPES = [
+          CASH_TYPE, CASHLESS_TYPE, PREPAID_TYPE, POSTPAID_TYPE, COUNTER_PROVISION_TYPE,
+          EXTENDED_5_TYPE, EXTENDED_6_TYPE, EXTENDED_7_TYPE, EXTENDED_8_TYPE, EXTENDED_9_TYPE
+        ].freeze
+
+        attr_reader :type, :sum
+
+        def initialize(type:, sum:)
+          raise(Atol::BadPaymentError, 'not allowed type') unless TYPES.include?(type)
+          raise(Atol::BadPaymentError, 'sum must be zero or a positive number') unless sum.is_a?(Numeric) && sum >= 0
+
+          @type = type
+          @sum = sum
+        end
+
+        def to_h
+          { sum: sum, type: type }
+        end
+      end
+    end
+  end
+end

data/lib/atol/request/post_document/sell/body.rb

@@ -1,89 +1,88 @@
 # frozen_string_literal: true
 
 require 'atol/errors'
+require 'atol/request/post_document/payment'
 
 module Atol
   module Request
     class PostDocument
       module Sell
         class Body
-          def initialize(external_id:, phone: '', email: '', items:, config: nil, **options)
+          def initialize(external_id:, phone: '', email: '', items:, payments: nil, config: nil, **options)
             raise(Atol::EmptyClientContactError) if phone.empty? && email.empty?
             raise(Atol::EmptySellItemsError) if items.empty?
 
+            total = items.sum { |item| item[:sum] }
+            validate_payments!(payments, total)
+
             @config = config || Atol.config
             @external_id = external_id
             @phone = phone
             @email = email
             @items = items
-            @agent_info_type = options[:agent_info_type]
+            @total = total
+            @payments = payments
           end
 
           def to_h
-            body.clone
+            build_body.clone
           end
 
           def to_json(*_args)
-            body.to_json
+            build_body.to_json
           end
 
           private
 
-          def body
-            body_template.tap do |result|
-              receipt = result[:receipt]
-              client = receipt[:client]
+          attr_reader :config, :external_id, :phone, :email, :items, :payments, :total
 
-              result[:external_id] = @external_id
-              result[:service][:callback_url] = @config.callback_url if @config.callback_url
+          def validate_payments!(payments, total)
+            return if payments.nil?
 
-              add_client_data(client)
-              add_receipt_data(receipt)
-            end
+            raise(Atol::EmptyPaymentsError) if payments.empty?
+            raise(Atol::BadPaymentError) if payments.any? { |payment| !payment.is_a?(Payment) }
+            raise(Atol::PaymentsTotalMismatchError) unless payments.sum(&:sum).round(2) == total.round(2)
           end
 
-          def body_template
+          def build_body
             {
+              external_id: external_id,
               receipt: {
-                client: {},
-                company: {
-                  inn: @config.inn.to_s,
-                  sno: @config.default_sno,
-                  payment_address: @config.payment_address,
-                  email: @config.company_email
-                },
-                items: [],
-                payments: [
-                  {
-                    sum: 0,
-                    type: @config.default_payment_type
-                  }
-                ]
+                client: client,
+                company: company,
+                items: items,
+                payments: build_payments,
+                total: total,
+                internet: config.internet
               },
-              service: {},
+              service: service,
               timestamp: Time.now.strftime(Atol::TIMESTAMP_FORMAT)
             }
           end
 
-          def add_client_data(client)
-            client[:email] = @email unless @email.empty?
-            client[:phone] = @phone unless @phone.empty?
-          end
+          def client
+            result = {}
+            result[:email] = email unless email.empty?
+            result[:phone] = phone unless phone.empty?
 
-          def add_receipt_data(receipt)
-            receipt[:total] = receipt[:payments][0][:sum] = total
-            receipt[:items] = @items
-            add_agent_and_supplier_info(receipt)
+            result
           end
 
-          def add_agent_and_supplier_info(receipt)
-            return if @agent_info_type.nil? || @agent_info_type.empty?
+          def company
+            {
+              inn: config.inn.to_s,
+              sno: config.default_sno,
+              payment_address: config.payment_address,
+              email: config.company_email
+            }
+          end
 
-            receipt[:agent_info] = { type: @agent_info_type }
+          def build_payments
+            (payments || [Payment.new(type: config.default_payment_type, sum: total)]).map(&:to_h)
           end
 
-          def total
-            @total ||= @items.inject(0) { |sum, item| sum += item[:sum] }
+          def service
+            config.callback_url ? { callback_url: config.callback_url } : {}
           end
         end
       end

data/lib/atol/request/post_document.rb

@@ -3,12 +3,16 @@
 require 'atol'
 require 'atol/errors'
 require 'atol/request/post_document/item/body'
+require 'atol/request/post_document/item/v4/body'
+require 'atol/request/post_document/item/v5/body'
 require 'atol/request/post_document/sell/body'
+require 'atol/request/post_document/correction/body'
+require 'atol/request/post_document/correction/v5/body'
 
 module Atol
   module Request
     class PostDocument
-      OPERATIONS = %i[sell sell_refund sell_correction buy buy_refund buy_correction].freeze
+      OPERATIONS = %i[sell sell_refund sell_correction sell_refund_correction buy buy_refund buy_correction buy_refund_correction].freeze
       HEADERS = { 'Content-Type' => 'application/json; charset=utf-8' }.freeze
 
       def initialize(operation:, token:, body:, config: nil, req_logger: nil, res_logger: nil)

data/lib/atol/version.rb

@@ -2,7 +2,12 @@
 
 module Atol
   module Version
-    API = 'v4'
-    LIB = '1.0.0'
+    V4 = 'https://online.atol.ru/possystem/v4'
+    V5 = 'https://online.atol.ru/possystem/v5'
+
+    V4_TEST = 'https://testonline.atol.ru/possystem/v4'
+    V5_TEST = 'https://testonline.atol.ru/possystem/v5'
+
+    LIB = '1.2.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atol
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0
 platform: ruby
 authors:
 - GeorgeGorbanev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-04-14 00:00:00.000000000 Z
+date: 2026-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anyway_config
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: 2.1.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: 2.1.4
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -119,7 +119,12 @@ files:
 - lib/atol/request/get_document_state.rb
 - lib/atol/request/get_token.rb
 - lib/atol/request/post_document.rb
+- lib/atol/request/post_document/correction/body.rb
+- lib/atol/request/post_document/correction/v5/body.rb
 - lib/atol/request/post_document/item/body.rb
+- lib/atol/request/post_document/item/v4/body.rb
+- lib/atol/request/post_document/item/v5/body.rb
+- lib/atol/request/post_document/payment.rb
 - lib/atol/request/post_document/sell/body.rb
 - lib/atol/transaction.rb
 - lib/atol/transaction/get_document_state.rb