smartbill-sdk 1.0.0

data/lib/smartbill/sdk/contracts/invoice_payment_contract.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Contracts
+      # Validation contract for {Models::InvoicePayment} (payment at
+      # issuance, embedded in an {Models::Invoice}).
+      class InvoicePaymentContract < Base
+        params do
+          required(:value).filled(:float, gt?: 0)
+          optional(:payment_series).maybe(:string)
+          required(:type).filled(:string)
+          optional(:is_cash).maybe(:bool)
+        end
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/contracts/invoice_ref_contract.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Contracts
+      # Validation contract for {Models::InvoiceRef}.
+      #
+      # Ensures the document reference has non-blank +series_name+ and
+      # +number+ (the struct already enforces presence; this adds the
+      # "filled" semantic check).
+      class InvoiceRefContract < Base
+        params do
+          required(:series_name).filled(:string)
+          required(:number).filled(:string)
+        end
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/contracts/payment_contract.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Contracts
+      # Validation contract for {Models::Payment}.
+      #
+      # Validates +type+ against the SmartBill payment-type set, +value+
+      # (positive when present), date format, and +precision+.
+      class PaymentContract < Base
+        # Allowed +type+ values (mirrors {Models::PaymentType}).
+        PAYMENT_TYPES = [
+          "Chitanta",
+          "Bon",
+          "Card",
+          "Card online",
+          "CEC",
+          "Bilet ordin",
+          "Ordin plata",
+          "Mandat postal",
+          "Extras de cont",
+          "Ramburs",
+          "Alta incasare"
+        ].freeze
+
+        params do
+          required(:company_vat_code).filled(:string)
+          optional(:issue_date).maybe(:string, format?: DATE_REGEX)
+          optional(:value).maybe(:float, gt?: 0)
+          optional(:type).maybe(:string, included_in?: PAYMENT_TYPES)
+          optional(:precision).maybe(:integer, gteq?: 0)
+          optional(:exchange_rate).maybe(:float, gt?: 0)
+        end
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/contracts/storno_contract.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Contracts
+      # Validation contract for {Models::StornoRequest} (+POST /invoice/reverse+).
+      class StornoContract < Base
+        params do
+          required(:company_vat_code).filled(:string)
+          required(:series_name).filled(:string)
+          required(:number).filled(:string)
+          optional(:issue_date).maybe(:string, format?: DATE_REGEX)
+        end
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/contracts.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "dry-validation"
+
+module Smartbill
+  module Sdk
+    # dry-validation contracts for SmartBill request models.
+    #
+    # Each request model has a {Models::Struct} (shape + coercion + required
+    # presence) and a {Contracts::Contract} (semantic rules: date formats,
+    # enum membership, numeric ranges). Services validate a struct against
+    # its contract before sending and raise {ValidationError} on failure.
+    #
+    # Each contract lives in its own file (e.g. `contracts/invoice_contract.rb`
+    # defines `InvoiceContract`) and is autoloaded by Zeitwerk.
+    module Contracts
+    end
+  end
+end

data/lib/smartbill/sdk/error.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    # Base class for all errors raised by the SDK.
+    class Error < StandardError; end
+  end
+end

data/lib/smartbill/sdk/models/base_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Common envelope: +errorText+/+message+/+number+/+series+/+url+.
+      class BaseResponse < Struct
+        attribute :error_text, Types::Strict::String.optional.default(nil)
+        attribute :message, Types::Strict::String.optional.default(nil)
+        attribute :number, Types::Strict::String.optional.default(nil)
+        attribute :series, Types::Strict::String.optional.default(nil)
+        attribute :url, Types::Strict::String.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/client.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Client data (+client+ / +clientMin+).
+      class Client < Struct
+        attribute :name, Types::Strict::String
+        attribute :vat_code, Types::Strict::String.optional.default(nil)
+        attribute :code, Types::Strict::String.optional.default(nil)
+        attribute :address, Types::Strict::String.optional.default(nil)
+        attribute :reg_com, Types::Strict::String.optional.default(nil)
+        attribute :is_tax_payer, Types::Strict::Bool.optional.default(nil)
+        attribute :contact, Types::Strict::String.optional.default(nil)
+        attribute :phone, Types::Strict::String.optional.default(nil)
+        attribute :city, Types::Strict::String.optional.default(nil)
+        attribute :county, Types::Strict::String.optional.default(nil)
+        attribute :country, Types::Strict::String.optional.default(nil)
+        attribute :email, Types::Strict::String.optional.default(nil)
+        attribute :bank, Types::Strict::String.optional.default(nil)
+        attribute :iban, Types::Strict::String.optional.default(nil)
+        attribute :save_to_db, Types::Strict::Bool.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/discount_type.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Discount type: 1 = valoric, 2 = procentual.
+      module DiscountType
+        VALORIC = 1
+        PROCENTUAL = 2
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/document_type.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Document type for the e-mail endpoint.
+      module DocumentType
+        INVOICE = "factura"
+        PROFORMA = "proforma"
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/email_document.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Request body for +POST /document/send+.
+      #
+      # +subject+ and +body_text+ should be Base64-encoded by the caller
+      # (as required by the SmartBill API).
+      class EmailDocument < Struct
+        attribute :company_vat_code, Types::Strict::String
+        attribute :series_name, Types::Strict::String
+        attribute :number, Types::Strict::String
+        attribute :type, Types::Strict::String.optional.default(nil)
+        attribute :subject, Types::Strict::String.optional.default(nil)
+        attribute :to, Types::Strict::String.optional.default(nil)
+        attribute :cc, Types::Strict::String.optional.default(nil)
+        attribute :bcc, Types::Strict::String.optional.default(nil)
+        attribute :body_text, Types::Strict::String.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/email_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Response for +POST /document/send+ (+Response.status+).
+      class EmailResponse < Struct
+        attribute :status, EmailStatus.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/email_status.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # The +status+ block of an {EmailResponse}.
+      class EmailStatus < Struct
+        attribute :code, Types::StrOrInt.optional.default(nil)
+        attribute :message, Types::Strict::String.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/estimate.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Request body for +POST /estimate+ (emitere proforma).
+      class Estimate < Struct
+        attribute :company_vat_code, Types::Strict::String
+        attribute :client, Client.optional.default(nil)
+        attribute :is_draft, Types::Strict::Bool.optional.default(nil)
+        attribute :issue_date, Types::Strict::String.optional.default(nil)
+        attribute :series_name, Types::Strict::String.optional.default(nil)
+        attribute :currency, Types::Strict::String.optional.default(nil)
+        attribute :exchange_rate, Types::Coercible::Float.optional.default(nil)
+        attribute :language, Types::Strict::String.optional.default(nil)
+        attribute :precision, Types::Coercible::Integer.optional.default(nil)
+        attribute :issuer_cnp, Types::Strict::String.optional.default(nil)
+        attribute :issuer_name, Types::Strict::String.optional.default(nil)
+        attribute :aviz, Types::Strict::String.optional.default(nil)
+        attribute :due_date, Types::Strict::String.optional.default(nil)
+        attribute :mentions, Types::Strict::String.optional.default(nil)
+        attribute :observations, Types::Strict::String.optional.default(nil)
+        attribute :delegate_name, Types::Strict::String.optional.default(nil)
+        attribute :delegate_identity_card, Types::Strict::String.optional.default(nil)
+        attribute :delegate_auto, Types::Strict::String.optional.default(nil)
+        attribute :payment_url, Types::Strict::String.optional.default(nil)
+        attribute :use_stock, Types::Strict::Bool.optional.default(nil)
+        attribute :products, Types::Array.of(Product).default([].freeze)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/fiscal_receipt_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Response for bon-fiscal endpoints.
+      #
+      # Used by +POST /payment+ when +type='Bon'+ (the response includes the
+      # generated receipt id) and by +GET /payment/text+ (which returns the
+      # base64-encoded fiscal-printer text in +message+).
+      class FiscalReceiptResponse < BaseResponse
+        attribute :id, Types::StrOrInt.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/invoice.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Request body for +POST /invoice+ (emitere factura).
+      #
+      # The JSON is sent as a bare object (the SmartBill +invoice+ envelope
+      # key is handled by the API itself for this endpoint).
+      class Invoice < Struct
+        attribute :company_vat_code, Types::Strict::String
+        attribute :client, Client.optional.default(nil)
+        attribute :is_draft, Types::Strict::Bool.optional.default(nil)
+        attribute :issue_date, Types::Strict::String.optional.default(nil)
+        attribute :series_name, Types::Strict::String.optional.default(nil)
+        attribute :currency, Types::Strict::String.optional.default(nil)
+        attribute :exchange_rate, Types::Coercible::Float.optional.default(nil)
+        attribute :language, Types::Strict::String.optional.default(nil)
+        attribute :precision, Types::Coercible::Integer.optional.default(nil)
+        attribute :issuer_cnp, Types::Strict::String.optional.default(nil)
+        attribute :issuer_name, Types::Strict::String.optional.default(nil)
+        attribute :aviz, Types::Strict::String.optional.default(nil)
+        attribute :due_date, Types::Strict::String.optional.default(nil)
+        attribute :mentions, Types::Strict::String.optional.default(nil)
+        attribute :observations, Types::Strict::String.optional.default(nil)
+        attribute :delegate_auto, Types::Strict::String.optional.default(nil)
+        attribute :delegate_identity_card, Types::Strict::String.optional.default(nil)
+        attribute :delegate_name, Types::Strict::String.optional.default(nil)
+        attribute :delivery_date, Types::Strict::String.optional.default(nil)
+        attribute :payment_date, Types::Strict::String.optional.default(nil)
+        attribute :use_stock, Types::Strict::Bool.optional.default(nil)
+        attribute :use_estimate_details, Types::Strict::Bool.optional.default(nil)
+        attribute :use_payment_tax, Types::Strict::Bool.optional.default(nil)
+        attribute :payment_base, Types::Coercible::Float.optional.default(nil)
+        attribute :colected_tax, Types::Coercible::Float.optional.default(nil)
+        attribute :payment_total, Types::Coercible::Float.optional.default(nil)
+        attribute :payment_url, Types::Strict::String.optional.default(nil)
+        attribute :estimate, InvoiceRef.optional.default(nil)
+        attribute :products, Types::Array.of(Product).default([].freeze)
+        attribute :payment, InvoicePayment.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/invoice_create_response.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Response for invoice / proforma creation.
+      class InvoiceCreateResponse < BaseResponse; end
+    end
+  end
+end

data/lib/smartbill/sdk/models/invoice_payment.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Payment-at-issuance block embedded in an {Invoice}.
+      class InvoicePayment < Struct
+        attribute :value, Types::Coercible::Float
+        attribute :payment_series, Types::Strict::String.optional.default(nil)
+        attribute :type, Types::Strict::String
+        attribute :is_cash, Types::Strict::Bool.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/invoice_ref.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Reference to an existing document (series + number).
+      #
+      # Requests use +seriesName+, but the +GET /estimate/invoices+
+      # response returns +series+. Both names are accepted on input;
+      # serialization always emits +seriesName+.
+      class InvoiceRef < Struct
+        # Map the API's bare "series" response key onto +series_name+
+        # in addition to the inherited snake_case/camelCase transform.
+        transform_keys do |key|
+          name = INFLECTOR.underscore(key.to_s).to_sym
+          name == :series ? :series_name : name
+        end
+
+        attribute :series_name, Types::Strict::String
+        attribute :number, Types::Strict::String
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/payment.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Request body for +POST /payment+.
+      #
+      # Covers general incasari, chitanta, and bon fiscal. Fields unused for
+      # a given +type+ are simply left as nil. Bon-fiscal +received_*+ fields
+      # are all optional and default to 0 on the server side.
+      class Payment < Struct
+        attribute :company_vat_code, Types::Strict::String
+        attribute :client, Client.optional.default(nil)
+        attribute :issue_date, Types::Strict::String.optional.default(nil)
+        attribute :currency, Types::Strict::String.optional.default(nil)
+        attribute :language, Types::Strict::String.optional.default(nil)
+        attribute :exchange_rate, Types::Coercible::Float.optional.default(nil)
+        attribute :precision, Types::Coercible::Integer.optional.default(nil)
+        attribute :issuer_cnp, Types::Strict::String.optional.default(nil)
+        attribute :series_name, Types::Strict::String.optional.default(nil)
+        attribute :number, Types::Strict::String.optional.default(nil)
+        attribute :value, Types::Coercible::Float.optional.default(nil)
+        attribute :text, Types::Strict::String.optional.default(nil)
+        attribute :translated_text, Types::Strict::String.optional.default(nil)
+        attribute :is_draft, Types::Strict::Bool.optional.default(nil)
+        attribute :type, Types::Strict::String.optional.default(nil)
+        attribute :is_cash, Types::Strict::Bool.optional.default(nil)
+        attribute :observation, Types::Strict::String.optional.default(nil)
+        attribute :use_invoice_details, Types::Strict::Bool.optional.default(nil)
+        attribute :invoices_list, Types::Array.of(InvoiceRef).optional.default(nil)
+        # Bon fiscal
+        attribute :return_fiscal_printer_text, Types::Strict::Bool.optional.default(nil)
+        attribute :use_stock, Types::Strict::Bool.optional.default(nil)
+        attribute :products, Types::Array.of(Product).optional.default(nil)
+        attribute :received_cash, Types::Coercible::Float.optional.default(nil)
+        attribute :received_card, Types::Coercible::Float.optional.default(nil)
+        attribute :received_tichete_masa, Types::Coercible::Float.optional.default(nil)
+        attribute :received_tichete_cadou, Types::Coercible::Float.optional.default(nil)
+        attribute :received_ordin_de_plata, Types::Coercible::Float.optional.default(nil)
+        attribute :received_cec, Types::Coercible::Float.optional.default(nil)
+        attribute :received_credit, Types::Coercible::Float.optional.default(nil)
+        attribute :received_cupon, Types::Coercible::Float.optional.default(nil)
+        attribute :received_puncte_de_fidelitate, Types::Coercible::Float.optional.default(nil)
+        attribute :received_bonuri_valoare_fixa, Types::Coercible::Float.optional.default(nil)
+        attribute :received_moneda_alternativa, Types::Coercible::Float.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/payment_status_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Response for +GET /invoice/paymentstatus+.
+      class PaymentStatusResponse < Struct
+        attribute :error_text, Types::Strict::String.optional.default(nil)
+        attribute :message, Types::Strict::String.optional.default(nil)
+        attribute :number, Types::Strict::String.optional.default(nil)
+        attribute :series, Types::Strict::String.optional.default(nil)
+        attribute :invoice_total_amount, Types::Coercible::Float.optional.default(nil)
+        attribute :paid_amount, Types::Coercible::Float.optional.default(nil)
+        attribute :unpaid_amount, Types::Coercible::Float.optional.default(nil)
+        attribute :paid, Types::Strict::Bool.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/payment_type.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Possible values for +type+ on payments / incasari.
+      module PaymentType
+        CHITANTA = "Chitanta"
+        BON = "Bon"
+        CARD = "Card"
+        CARD_ONLINE = "Card online"
+        CEC = "CEC"
+        BILET_ORDIN = "Bilet ordin"
+        ORDIN_PLATA = "Ordin plata"
+        MANDAT_POSTAL = "Mandat postal"
+        EXTRAS_DE_CONT = "Extras de cont"
+        RAMBURS = "Ramburs"
+        ALTA_INCASARE = "Alta incasare"
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/product.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # A product or discount line on an invoice / proforma / bon fiscal.
+      #
+      # Discount-specific fields (+number_of_items+, +discount_type+,
+      # +discount_percentage+, +discount_value+, +discount_tax_value+) are
+      # only relevant when +is_discount+ is true.
+      class Product < Struct
+        attribute :name, Types::Strict::String
+        attribute :code, Types::Strict::String.optional.default(nil)
+        attribute :product_description, Types::Strict::String.optional.default(nil)
+        attribute :translated_name, Types::Strict::String.optional.default(nil)
+        attribute :translated_measuring_unit, Types::Strict::String.optional.default(nil)
+        attribute :is_discount, Types::Strict::Bool.optional.default(nil)
+        attribute :number_of_items, Types::Coercible::Integer.optional.default(nil)
+        attribute :measuring_unit_name, Types::Strict::String.optional.default(nil)
+        attribute :currency, Types::Strict::String.optional.default(nil)
+        attribute :quantity, Types::Coercible::Float.optional.default(nil)
+        attribute :price, Types::Coercible::Float.optional.default(nil)
+        attribute :is_tax_included, Types::Strict::Bool.optional.default(nil)
+        attribute :tax_name, Types::Strict::String.optional.default(nil)
+        attribute :tax_percentage, Types::Coercible::Float.optional.default(nil)
+        attribute :exchange_rate, Types::Coercible::Float.optional.default(nil)
+        attribute :save_to_db, Types::Strict::Bool.optional.default(nil)
+        attribute :warehouse_name, Types::Strict::String.optional.default(nil)
+        attribute :is_service, Types::Strict::Bool.optional.default(nil)
+        # Discount fields
+        attribute :discount_type, Types::Coercible::Integer.optional.default(nil)
+        attribute :discount_percentage, Types::Coercible::Float.optional.default(nil)
+        attribute :discount_value, Types::Coercible::Float.optional.default(nil)
+        attribute :discount_tax_value, Types::Coercible::Float.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/proforma_invoices_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Response for +GET /estimate/invoices+.
+      class ProformaInvoicesResponse < BaseResponse
+        attribute :are_invoices_created, Types::Strict::Bool.optional.default(nil)
+        attribute :invoices, Types::Array.of(InvoiceRef).default([].freeze)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/series.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # A document series entry from +GET /series+.
+      class Series < Struct
+        attribute :name, Types::Strict::String.optional.default(nil)
+        attribute :next_number, Types::StrOrInt.optional.default(nil)
+        attribute :type, Types::Strict::String.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/series_list_response.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Parsed response of +GET /series+.
+      class SeriesListResponse < Struct
+        attribute :error_text, Types::Strict::String.optional.default(nil)
+        attribute :message, Types::Strict::String.optional.default(nil)
+        attribute :list, Types::Array.of(Series).default([].freeze)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/stock_list.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # A +list+ entry under the stocks response — products + warehouse.
+      class StockList < Struct
+        attribute :products, Types::Array.of(StockProduct).default([].freeze)
+        attribute :warehouse, StockWarehouse.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/stock_product.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # A product entry within a stock list.
+      class StockProduct < Struct
+        attribute :measuring_unit, Types::Strict::String.optional.default(nil)
+        attribute :product_code, Types::Strict::String.optional.default(nil)
+        attribute :product_name, Types::Strict::String.optional.default(nil)
+        attribute :quantity, Types::Coercible::Float.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/stock_warehouse.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Warehouse details attached to a stock list entry.
+      class StockWarehouse < Struct
+        attribute :warehouse_name, Types::Strict::String.optional.default(nil)
+        attribute :warehouse_type, Types::Strict::String.optional.default(nil)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/stocks_response.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Parsed response of +GET /stocks+.
+      class StocksResponse < Struct
+        attribute :error_text, Types::Strict::String.optional.default(nil)
+        attribute :message, Types::Strict::String.optional.default(nil)
+        attribute :list, Types::Array.of(StockList).default([].freeze)
+      end
+    end
+  end
+end

data/lib/smartbill/sdk/models/storno_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Smartbill
+  module Sdk
+    module Models
+      # Request body for +POST /invoice/reverse+ (stornare factura).
+      #
+      # Sent as a bare object (no envelope).
+      class StornoRequest < Struct
+        attribute :company_vat_code, Types::Strict::String
+        attribute :series_name, Types::Strict::String
+        attribute :number, Types::Strict::String
+        attribute :issue_date, Types::Strict::String.optional.default(nil)
+      end
+    end
+  end
+end