nfe-io 0.3.1 → 1.0.0

data/lib/nfe/errors.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module Nfe
+  # Base class for every error the SDK raises.
+  #
+  # All SDK errors derive from {Nfe::Error}, so consumer code can catch the
+  # whole family with a single +rescue Nfe::Error+. Errors derived from an HTTP
+  # response carry the response context (+status_code+, +request_id+,
+  # +error_code+, +response_body+, +response_headers+) for diagnostics.
+  #
+  # {#to_h} returns a logging-safe Hash that deliberately omits the raw
+  # response body and headers, which may carry secrets or PII.
+  class Error < StandardError
+    # @return [Integer, nil] HTTP status code, when derived from a response.
+    attr_reader :status_code
+    # @return [String, nil] server-supplied request/correlation id.
+    attr_reader :request_id
+    # @return [String, nil] machine-readable error code from the body.
+    attr_reader :error_code
+    # @return [String, nil] raw response body, for programmatic inspection.
+    attr_reader :response_body
+    # @return [Hash] response headers (lowercase keys).
+    attr_reader :response_headers
+
+    # @param message [String, nil] human-readable message.
+    # @param status_code [Integer, nil]
+    # @param request_id [String, nil]
+    # @param error_code [String, nil]
+    # @param response_body [String, nil]
+    # @param response_headers [Hash]
+    def initialize(message = nil, status_code: nil, request_id: nil,
+                   error_code: nil, response_body: nil, response_headers: {})
+      super(message)
+      @status_code = status_code
+      @request_id = request_id
+      @error_code = error_code
+      @response_body = response_body
+      @response_headers = response_headers || {}
+    end
+
+    # Logging-safe representation. Never includes raw headers or body, which
+    # could leak the API key, certificate password, or PII.
+    #
+    # @return [Hash]
+    def to_h
+      {
+        type: self.class.name,
+        message: message,
+        status_code: status_code,
+        request_id: request_id,
+        error_code: error_code
+      }
+    end
+  end
+
+  # HTTP 401 — the API key is missing or invalid.
+  class AuthenticationError < Error; end
+
+  # HTTP 403 — the API key is valid but not authorized for the resource.
+  class AuthorizationError < Error; end
+
+  # HTTP 400/422 — the request was malformed or failed validation.
+  class InvalidRequestError < Error; end
+
+  # HTTP 404 — the requested resource does not exist.
+  class NotFoundError < Error; end
+
+  # HTTP 409 — the request conflicts with the current resource state.
+  class ConflictError < Error; end
+
+  # HTTP 429 — too many requests. Carries the optional +retry_after+ hint.
+  class RateLimitError < Error
+    # @return [Integer, nil] seconds to wait before retrying, when advertised.
+    attr_reader :retry_after
+
+    # @param retry_after [Integer, nil] from the +Retry-After+ header.
+    def initialize(message = nil, retry_after: nil, **)
+      super(message, **)
+      @retry_after = retry_after
+    end
+  end
+
+  # HTTP 5xx — the API failed to process the request.
+  class ServerError < Error; end
+
+  # A network-level failure (DNS, connection refused, TLS, reset). Raised
+  # instead of returning a response, since no HTTP exchange completed.
+  class ApiConnectionError < Error; end
+
+  # A connection that timed out. A subclass of {ApiConnectionError} so a
+  # +rescue Nfe::ApiConnectionError+ also catches timeouts.
+  class TimeoutError < ApiConnectionError; end
+
+  # Raised when a webhook signature fails verification.
+  class SignatureVerificationError < Error; end
+
+  # Raised when the SDK is misconfigured: a required API key is missing for a
+  # family, or an invalid +environment+ was supplied. Raised client-side,
+  # before any HTTP request is issued.
+  class ConfigurationError < Error; end
+
+  # Raised when an asynchronous (202) invoice response violates the expected
+  # protocol — e.g., a 202 without a +Location+ header, or an +invoice_id+ that
+  # cannot be extracted from it.
+  class InvoiceProcessingError < Error; end
+end

data/lib/nfe/flow_status.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Nfe
+  # Lifecycle status of an asynchronously-processed fiscal document.
+  #
+  # Terminal states stop polling; non-terminal states mean processing is still
+  # in flight. The discriminated 202 Pending/Issued contract (modeled in the
+  # resource changes) uses {FlowStatus.terminal?} to decide when a document is
+  # settled.
+  module FlowStatus
+    # States in which processing has finished (success or failure).
+    TERMINAL = %w[Issued IssueFailed Cancelled CancelFailed].freeze
+
+    # States in which processing is still in progress.
+    NON_TERMINAL = %w[
+      PullFromCityHall
+      WaitingCalculateTaxes
+      WaitingDefineRpsNumber
+      WaitingSend
+      WaitingSendCancel
+      WaitingReturn
+      WaitingDownload
+    ].freeze
+
+    # Every known flow status.
+    ALL = (TERMINAL + NON_TERMINAL).freeze
+
+    module_function
+
+    # Returns +true+ when +status+ is a terminal flow state.
+    def terminal?(status)
+      TERMINAL.include?(status.to_s)
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/calculate_item_request.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      CalculateItemRequest = Data.define(:acquisition_purpose, :benefit, :cest, :discount_amount, :ex_tipi, :freight_amount, :gtin, :icms, :id, :ii, :insurance_amount, :issuer_tax_profile, :ncm, :operation_code, :origin, :others_amount, :quantity, :recipient_tax_profile, :sku, :unit_amount) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            acquisition_purpose: payload["acquisitionPurpose"],
+            benefit: payload["benefit"],
+            cest: payload["cest"],
+            discount_amount: payload["discountAmount"],
+            ex_tipi: payload["exTipi"],
+            freight_amount: payload["freightAmount"],
+            gtin: payload["gtin"],
+            icms: Icms.from_api(payload["icms"]),
+            id: payload["id"],
+            ii: Ii.from_api(payload["ii"]),
+            insurance_amount: payload["insuranceAmount"],
+            issuer_tax_profile: payload["issuerTaxProfile"],
+            ncm: payload["ncm"],
+            operation_code: payload["operationCode"],
+            origin: payload["origin"],
+            others_amount: payload["othersAmount"],
+            quantity: payload["quantity"],
+            recipient_tax_profile: payload["recipientTaxProfile"],
+            sku: payload["sku"],
+            unit_amount: payload["unitAmount"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/calculate_item_response.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      CalculateItemResponse = Data.define(:additional_information, :benefit, :cest, :cfop, :cofins, :icms, :icms_uf_dest, :id, :ii, :ipi, :last_modified, :pis, :product_id) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            additional_information: payload["additionalInformation"],
+            benefit: payload["benefit"],
+            cest: payload["cest"],
+            cfop: payload["cfop"],
+            cofins: Cofins.from_api(payload["cofins"]),
+            icms: Icms.from_api(payload["icms"]),
+            icms_uf_dest: IcmsUfDest.from_api(payload["icmsUfDest"]),
+            id: payload["id"],
+            ii: Ii.from_api(payload["ii"]),
+            ipi: Ipi.from_api(payload["ipi"]),
+            last_modified: payload["lastModified"],
+            pis: Pis.from_api(payload["pis"]),
+            product_id: payload["productId"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/calculate_request.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      CalculateRequest = Data.define(:collection_id, :is_product_registration, :issuer, :items, :operation_type, :recipient) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            collection_id: payload["collectionId"],
+            is_product_registration: payload["isProductRegistration"],
+            issuer: CalculateRequestIssuer.from_api(payload["issuer"]),
+            items: (payload["items"] || []).map { |e| CalculateItemRequest.from_api(e) },
+            operation_type: payload["operationType"],
+            recipient: CalculateRequestRecipient.from_api(payload["recipient"]),
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/calculate_request_issuer.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      CalculateRequestIssuer = Data.define(:state, :tax_profile, :tax_regime) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            state: payload["state"],
+            tax_profile: payload["taxProfile"],
+            tax_regime: payload["taxRegime"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/calculate_request_recipient.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      CalculateRequestRecipient = Data.define(:state, :tax_profile, :tax_regime) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            state: payload["state"],
+            tax_profile: payload["taxProfile"],
+            tax_regime: payload["taxRegime"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/calculate_response.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      CalculateResponse = Data.define(:items) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            items: (payload["items"] || []).map { |e| CalculateItemResponse.from_api(e) },
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/cofins.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      Cofins = Data.define(:cst, :p_cofins, :q_bcprod, :v_aliq_prod, :v_bc, :v_cofins) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            cst: payload["cst"],
+            p_cofins: payload["pCOFINS"],
+            q_bcprod: payload["qBCProd"],
+            v_aliq_prod: payload["vAliqProd"],
+            v_bc: payload["vBC"],
+            v_cofins: payload["vCOFINS"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/icms.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      Icms = Data.define(:c_benef_rbc, :csosn, :cst, :ind_deduz_deson, :mod_bc, :mod_bcst, :mot_des_icms, :mot_des_icmsst, :orig, :p_cred_sn, :p_dif, :p_fcp, :p_fcpdif, :p_fcpst, :p_fcpstret, :p_icms, :p_icmsefet, :p_icmsst, :p_mvast, :p_red_bc, :p_red_bcefet, :p_red_bcst, :p_st, :v_bc, :v_bcefet, :v_bcfcp, :v_bcfcpst, :v_bcfcpstret, :v_bcst, :v_bcstret, :v_cred_icmssn, :v_fcp, :v_fcpdif, :v_fcpefet, :v_fcpst, :v_fcpstret, :v_icms, :v_icmsdeson, :v_icmsdif, :v_icmsefet, :v_icmsop, :v_icmsst, :v_icmsstdeson, :v_icmsstret, :v_icmssubstituto) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            c_benef_rbc: payload["cBenefRBC"],
+            csosn: payload["csosn"],
+            cst: payload["cst"],
+            ind_deduz_deson: payload["indDeduzDeson"],
+            mod_bc: payload["modBC"],
+            mod_bcst: payload["modBCST"],
+            mot_des_icms: payload["motDesICMS"],
+            mot_des_icmsst: payload["motDesICMSST"],
+            orig: payload["orig"],
+            p_cred_sn: payload["pCredSN"],
+            p_dif: payload["pDif"],
+            p_fcp: payload["pFCP"],
+            p_fcpdif: payload["pFCPDif"],
+            p_fcpst: payload["pFCPST"],
+            p_fcpstret: payload["pFCPSTRet"],
+            p_icms: payload["pICMS"],
+            p_icmsefet: payload["pICMSEfet"],
+            p_icmsst: payload["pICMSST"],
+            p_mvast: payload["pMVAST"],
+            p_red_bc: payload["pRedBC"],
+            p_red_bcefet: payload["pRedBCEfet"],
+            p_red_bcst: payload["pRedBCST"],
+            p_st: payload["pST"],
+            v_bc: payload["vBC"],
+            v_bcefet: payload["vBCEfet"],
+            v_bcfcp: payload["vBCFCP"],
+            v_bcfcpst: payload["vBCFCPST"],
+            v_bcfcpstret: payload["vBCFCPSTRet"],
+            v_bcst: payload["vBCST"],
+            v_bcstret: payload["vBCSTRet"],
+            v_cred_icmssn: payload["vCredICMSSN"],
+            v_fcp: payload["vFCP"],
+            v_fcpdif: payload["vFCPDif"],
+            v_fcpefet: payload["vFCPEfet"],
+            v_fcpst: payload["vFCPST"],
+            v_fcpstret: payload["vFCPSTRet"],
+            v_icms: payload["vICMS"],
+            v_icmsdeson: payload["vICMSDeson"],
+            v_icmsdif: payload["vICMSDif"],
+            v_icmsefet: payload["vICMSEfet"],
+            v_icmsop: payload["vICMSOp"],
+            v_icmsst: payload["vICMSST"],
+            v_icmsstdeson: payload["vICMSSTDeson"],
+            v_icmsstret: payload["vICMSSTRet"],
+            v_icmssubstituto: payload["vICMSSubstituto"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/icms_uf_dest.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      IcmsUfDest = Data.define(:p_fcpufdest, :p_icmsinter, :p_icmsinter_part, :p_icmsufdest, :v_bcfcpufdest, :v_bcufdest, :v_fcpufdest, :v_icmsufdest, :v_icmsufremet) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            p_fcpufdest: payload["pFCPUFDest"],
+            p_icmsinter: payload["pICMSInter"],
+            p_icmsinter_part: payload["pICMSInterPart"],
+            p_icmsufdest: payload["pICMSUFDest"],
+            v_bcfcpufdest: payload["vBCFCPUFDest"],
+            v_bcufdest: payload["vBCUFDest"],
+            v_fcpufdest: payload["vFCPUFDest"],
+            v_icmsufdest: payload["vICMSUFDest"],
+            v_icmsufremet: payload["vICMSUFRemet"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/ii.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      Ii = Data.define(:inf_custo_aquis, :p_cred_sn, :v_bc, :v_cred_icmssn, :v_desp_adu, :v_enc_camb, :v_ii, :v_iof) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            inf_custo_aquis: payload["infCustoAquis"],
+            p_cred_sn: payload["pCredSN"],
+            v_bc: payload["vBC"],
+            v_cred_icmssn: payload["vCredICMSSN"],
+            v_desp_adu: payload["vDespAdu"],
+            v_enc_camb: payload["vEncCamb"],
+            v_ii: payload["vII"],
+            v_iof: payload["vIOF"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/ipi.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      Ipi = Data.define(:c_enq, :cst, :p_ipi, :q_unid, :v_bc, :v_ipi, :v_unid) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            c_enq: payload["cEnq"],
+            cst: payload["cst"],
+            p_ipi: payload["pIPI"],
+            q_unid: payload["qUnid"],
+            v_bc: payload["vBC"],
+            v_ipi: payload["vIPI"],
+            v_unid: payload["vUnid"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/operation_type.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      module OperationType
+        Outgoing = "Outgoing"
+        Incoming = "Incoming"
+        ALL = [Outgoing, Incoming].freeze
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/origin.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      module Origin
+        National = "National"
+        ForeignDirectImport = "ForeignDirectImport"
+        ForeignInternalMarket = "ForeignInternalMarket"
+        NationalWith40To70Import = "NationalWith40To70Import"
+        NationalPpb = "NationalPpb"
+        NationalWithLess40Import = "NationalWithLess40Import"
+        ForeignDirectImportWithoutNationalSimilar = "ForeignDirectImportWithoutNationalSimilar"
+        ForeignInternalMarketWithoutNationalSimilar = "ForeignInternalMarketWithoutNationalSimilar"
+        NationalWithGreater70Import = "NationalWithGreater70Import"
+        ALL = [National, ForeignDirectImport, ForeignInternalMarket, NationalWith40To70Import, NationalPpb, NationalWithLess40Import, ForeignDirectImportWithoutNationalSimilar, ForeignInternalMarketWithoutNationalSimilar, NationalWithGreater70Import].freeze
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/pis.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      Pis = Data.define(:cst, :p_pis, :q_bcprod, :v_aliq_prod, :v_bc, :v_pis) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            cst: payload["cst"],
+            p_pis: payload["pPIS"],
+            q_bcprod: payload["qBCProd"],
+            v_aliq_prod: payload["vAliqProd"],
+            v_bc: payload["vBC"],
+            v_pis: payload["vPIS"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/problem_details.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      ProblemDetails = Data.define(:detail, :instance, :status, :title, :type) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            detail: payload["detail"],
+            instance: payload["instance"],
+            status: payload["status"],
+            title: payload["title"],
+            type: payload["type"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/state.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      module State
+        AC = "AC"
+        AL = "AL"
+        AP = "AP"
+        AM = "AM"
+        BA = "BA"
+        CE = "CE"
+        DF = "DF"
+        ES = "ES"
+        GO = "GO"
+        MA = "MA"
+        MT = "MT"
+        MS = "MS"
+        MG = "MG"
+        PA = "PA"
+        PB = "PB"
+        PR = "PR"
+        PE = "PE"
+        PI = "PI"
+        RJ = "RJ"
+        RN = "RN"
+        RS = "RS"
+        RO = "RO"
+        RR = "RR"
+        SC = "SC"
+        SP = "SP"
+        SE = "SE"
+        TO = "TO"
+        EX = "EX"
+        ALL = [AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO, EX].freeze
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/tax_code.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      TaxCode = Data.define(:code, :description) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            code: payload["code"],
+            description: payload["description"],
+          )
+        end
+      end
+    end
+  end
+end

data/lib/nfe/generated/calculo_impostos_v1/tax_code_paginated_response.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+# AUTO-GENERATED — do not edit
+# Source: openapi/calculo-impostos-v1.yaml
+# Hash: sha256:39f6c3a1112ff3c98d842e172be5007eaa4d0c5f63d300ad263b96c9299ece99
+
+module Nfe
+  module Generated
+    module CalculoImpostosV1
+      TaxCodePaginatedResponse = Data.define(:current_page, :items, :total_count, :total_pages) do
+        def self.from_api(payload)
+          return nil if payload.nil?
+
+          new(
+            current_page: payload["currentPage"],
+            items: (payload["items"] || []).map { |e| TaxCode.from_api(e) },
+            total_count: payload["totalCount"],
+            total_pages: payload["totalPages"],
+          )
+        end
+      end
+    end
+  end
+end