e-invoice-api 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23d7619e1e75dac6fe3bcd0c65fba1c78d0ac0cd60ab565d7af41e2e7f592d19
-  data.tar.gz: 99516c01830236792b2be4c5f0085db90f90ca2818dea594d1287933f0a40397
+  metadata.gz: 7abd4e9f882f09d5deaf9badc11b80bf1f72aaf0ddbeca15f40ec9a09f86c63a
+  data.tar.gz: 8f887eb64cc01afba738f5c4aa8e07c354b9d2be27d9a915289780642a7bbebf
 SHA512:
-  metadata.gz: f44e0c71e1f355db186a8592f4f685c0cfe9a4769fe4e1f0ad3e677b78758d87c10bc9f26ef0bd952ffd2c033074d0e309c2f46b9608f0cca95cb27b96d42412
-  data.tar.gz: 647008fd466a95ae345608585133e24f32cfac7270c888d80c0d97062be5746d90bdf0949611478b31ac7a333dbc01aa3d879f39fc02d2170ea0b304c98f4b2d
+  metadata.gz: 422476590fa4a603fd348bb917e7904ad11dce1854f752041283b51b65c9532b55147b4f63c2a0357957ea521b61e6f6635b328736a256978e269778d9f57689
+  data.tar.gz: 45ad05d2208b99a1ef74c8685fd44c05d67ecfff5af222a21918b49b94e70407bc0c83cb39a73a50b771d0cbc84483b6145af552a49dad3333046b70a516cf75

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.2.0 (2025-07-14)
+
+Full Changelog: [v0.1.3...v0.2.0](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.1.3...v0.2.0)
+
+### Features
+
+* **api:** manual updates ([54948dd](https://github.com/e-invoice-be/e-invoice-rb/commit/54948dddae65c22153c2543e9ce60736cec1fb3f))
+
+
+### Chores
+
+* **internal:** version bump ([65b76f9](https://github.com/e-invoice-be/e-invoice-rb/commit/65b76f9bc4d9f337b9ee3ae8e12c93ed876fdbf0))
+
+## 0.1.3 (2025-07-01)
+
+Full Changelog: [v0.1.2...v0.1.3](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.1.2...v0.1.3)
+
+### Chores
+
+* **ci:** only run for pushes and fork pull requests ([3426465](https://github.com/e-invoice-be/e-invoice-rb/commit/34264655c03d80926f589bd4de11df9b3679a05d))
+* **internal:** allow streams to also be unwrapped on a per-row basis ([af37243](https://github.com/e-invoice-be/e-invoice-rb/commit/af372437732d3edfb00e29bcca82b1b42ee70a94))
+* **internal:** codegen related update ([8e9ab58](https://github.com/e-invoice-be/e-invoice-rb/commit/8e9ab5889454ca9b7e39ab3cbb2febbca9b44b84))
+
 ## 0.1.2 (2025-06-27)
 
 Full Changelog: [v0.1.1...v0.1.2](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.1.1...v0.1.2)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "e-invoice-api", "~> 0.1.2"
+gem "e-invoice-api", "~> 0.2.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/e_invoice_api/internal/transport/base_client.rb

@@ -471,6 +471,7 @@ module EInvoiceAPI
           self.class.validate!(req)
           model = req.fetch(:model) { EInvoiceAPI::Internal::Type::Unknown }
           opts = req[:options].to_h
+          unwrap = req[:unwrap]
           EInvoiceAPI::RequestOptions.validate!(opts)
           request = build_request(req.except(:options), opts)
           url = request.fetch(:url)
@@ -487,11 +488,18 @@ module EInvoiceAPI
           decoded = EInvoiceAPI::Internal::Util.decode_content(response, stream: stream)
           case req
           in {stream: Class => st}
-            st.new(model: model, url: url, status: status, response: response, stream: decoded)
+            st.new(
+              model: model,
+              url: url,
+              status: status,
+              response: response,
+              unwrap: unwrap,
+              stream: decoded
+            )
           in {page: Class => page}
             page.new(client: self, req: req, headers: response, page_data: decoded)
           else
-            unwrapped = EInvoiceAPI::Internal::Util.dig(decoded, req[:unwrap])
+            unwrapped = EInvoiceAPI::Internal::Util.dig(decoded, unwrap)
             EInvoiceAPI::Internal::Type::Converter.coerce(model, unwrapped)
           end
         end

data/lib/e_invoice_api/models/lookup_retrieve_participants_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Models
+    # @see EInvoiceAPI::Resources::Lookup#retrieve_participants
+    class LookupRetrieveParticipantsParams < EInvoiceAPI::Internal::Type::BaseModel
+      extend EInvoiceAPI::Internal::Type::RequestParameters::Converter
+      include EInvoiceAPI::Internal::Type::RequestParameters
+
+      # @!attribute query
+      #   Query to lookup
+      #
+      #   @return [String]
+      required :query, String
+
+      # @!attribute country_code
+      #   Country code of the company to lookup. If not provided, the search will be
+      #   global.
+      #
+      #   @return [String, nil]
+      optional :country_code, String, nil?: true
+
+      # @!method initialize(query:, country_code: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {EInvoiceAPI::Models::LookupRetrieveParticipantsParams} for more details.
+      #
+      #   @param query [String] Query to lookup
+      #
+      #   @param country_code [String, nil] Country code of the company to lookup. If not provided, the search will be globa
+      #
+      #   @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/e_invoice_api/models/lookup_retrieve_participants_response.rb

@@ -0,0 +1,195 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Models
+    # @see EInvoiceAPI::Resources::Lookup#retrieve_participants
+    class LookupRetrieveParticipantsResponse < EInvoiceAPI::Internal::Type::BaseModel
+      # @!attribute query_terms
+      #   Query terms used for search
+      #
+      #   @return [String]
+      required :query_terms, String
+
+      # @!attribute search_date
+      #   Search date of the result
+      #
+      #   @return [String]
+      required :search_date, String
+
+      # @!attribute total_count
+      #   Total number of results
+      #
+      #   @return [Integer]
+      required :total_count, Integer
+
+      # @!attribute used_count
+      #   Number of results returned by the API
+      #
+      #   @return [Integer]
+      required :used_count, Integer
+
+      # @!attribute participants
+      #   List of participants
+      #
+      #   @return [Array<EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant>, nil]
+      optional :participants,
+               -> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant] }
+
+      # @!method initialize(query_terms:, search_date:, total_count:, used_count:, participants: nil)
+      #   Represents the result of a Peppol directory search
+      #
+      #   @param query_terms [String] Query terms used for search
+      #
+      #   @param search_date [String] Search date of the result
+      #
+      #   @param total_count [Integer] Total number of results
+      #
+      #   @param used_count [Integer] Number of results returned by the API
+      #
+      #   @param participants [Array<EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant>] List of participants
+
+      class Participant < EInvoiceAPI::Internal::Type::BaseModel
+        # @!attribute peppol_id
+        #   Peppol ID of the participant
+        #
+        #   @return [String]
+        required :peppol_id, String
+
+        # @!attribute peppol_scheme
+        #   Peppol scheme of the participant
+        #
+        #   @return [String]
+        required :peppol_scheme, String
+
+        # @!attribute document_types
+        #   List of supported document types
+        #
+        #   @return [Array<EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType>, nil]
+        optional :document_types,
+                 -> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType] }
+
+        # @!attribute entities
+        #   List of business entities
+        #
+        #   @return [Array<EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity>, nil]
+        optional :entities,
+                 -> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity] }
+
+        # @!method initialize(peppol_id:, peppol_scheme:, document_types: nil, entities: nil)
+        #   Represents a Peppol participant with their details
+        #
+        #   @param peppol_id [String] Peppol ID of the participant
+        #
+        #   @param peppol_scheme [String] Peppol scheme of the participant
+        #
+        #   @param document_types [Array<EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType>] List of supported document types
+        #
+        #   @param entities [Array<EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity>] List of business entities
+
+        class DocumentType < EInvoiceAPI::Internal::Type::BaseModel
+          # @!attribute scheme
+          #   Document type scheme
+          #
+          #   @return [String]
+          required :scheme, String
+
+          # @!attribute value
+          #   Document type value
+          #
+          #   @return [String]
+          required :value, String
+
+          # @!method initialize(scheme:, value:)
+          #   Represents a supported document type
+          #
+          #   @param scheme [String] Document type scheme
+          #
+          #   @param value [String] Document type value
+        end
+
+        class Entity < EInvoiceAPI::Internal::Type::BaseModel
+          # @!attribute additional_info
+          #   Additional information
+          #
+          #   @return [String, nil]
+          optional :additional_info, String, nil?: true
+
+          # @!attribute country_code
+          #   Country code
+          #
+          #   @return [String, nil]
+          optional :country_code, String, nil?: true
+
+          # @!attribute geo_info
+          #   Geographic information
+          #
+          #   @return [String, nil]
+          optional :geo_info, String, nil?: true
+
+          # @!attribute identifiers
+          #   List of business identifiers
+          #
+          #   @return [Array<EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier>, nil]
+          optional :identifiers,
+                   -> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier] }
+
+          # @!attribute name
+          #   Business entity name
+          #
+          #   @return [String, nil]
+          optional :name, String, nil?: true
+
+          # @!attribute registration_date
+          #   Registration date
+          #
+          #   @return [String, nil]
+          optional :registration_date, String, nil?: true
+
+          # @!attribute website
+          #   Website URL
+          #
+          #   @return [String, nil]
+          optional :website, String, nil?: true
+
+          # @!method initialize(additional_info: nil, country_code: nil, geo_info: nil, identifiers: nil, name: nil, registration_date: nil, website: nil)
+          #   Represents a business entity
+          #
+          #   @param additional_info [String, nil] Additional information
+          #
+          #   @param country_code [String, nil] Country code
+          #
+          #   @param geo_info [String, nil] Geographic information
+          #
+          #   @param identifiers [Array<EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier>] List of business identifiers
+          #
+          #   @param name [String, nil] Business entity name
+          #
+          #   @param registration_date [String, nil] Registration date
+          #
+          #   @param website [String, nil] Website URL
+
+          class Identifier < EInvoiceAPI::Internal::Type::BaseModel
+            # @!attribute scheme
+            #   Identifier scheme
+            #
+            #   @return [String]
+            required :scheme, String
+
+            # @!attribute value
+            #   Identifier value
+            #
+            #   @return [String]
+            required :value, String
+
+            # @!method initialize(scheme:, value:)
+            #   Represents a business identifier
+            #
+            #   @param scheme [String] Identifier scheme
+            #
+            #   @param value [String] Identifier value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/e_invoice_api/models.rb

@@ -73,6 +73,8 @@ module EInvoiceAPI
 
   LookupRetrieveParams = EInvoiceAPI::Models::LookupRetrieveParams
 
+  LookupRetrieveParticipantsParams = EInvoiceAPI::Models::LookupRetrieveParticipantsParams
+
   OutboxListDraftDocumentsParams = EInvoiceAPI::Models::OutboxListDraftDocumentsParams
 
   OutboxListReceivedDocumentsParams = EInvoiceAPI::Models::OutboxListReceivedDocumentsParams

data/lib/e_invoice_api/resources/lookup.rb

@@ -32,6 +32,34 @@ module EInvoiceAPI
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {EInvoiceAPI::Models::LookupRetrieveParticipantsParams} for more details.
+      #
+      # Lookup Peppol participants by name or other identifiers. You can limit the
+      # search to a specific country by providing the country code.
+      #
+      # @overload retrieve_participants(query:, country_code: nil, request_options: {})
+      #
+      # @param query [String] Query to lookup
+      #
+      # @param country_code [String, nil] Country code of the company to lookup. If not provided, the search will be globa
+      #
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [EInvoiceAPI::Models::LookupRetrieveParticipantsResponse]
+      #
+      # @see EInvoiceAPI::Models::LookupRetrieveParticipantsParams
+      def retrieve_participants(params)
+        parsed, options = EInvoiceAPI::LookupRetrieveParticipantsParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "api/lookup/participants",
+          query: parsed,
+          model: EInvoiceAPI::Models::LookupRetrieveParticipantsResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [EInvoiceAPI::Client]

data/lib/e_invoice_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EInvoiceAPI
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/lib/e_invoice_api.rb

@@ -77,6 +77,8 @@ require_relative "e_invoice_api/models/inbox_list_credit_notes_params"
 require_relative "e_invoice_api/models/inbox_list_invoices_params"
 require_relative "e_invoice_api/models/inbox_list_params"
 require_relative "e_invoice_api/models/lookup_retrieve_params"
+require_relative "e_invoice_api/models/lookup_retrieve_participants_params"
+require_relative "e_invoice_api/models/lookup_retrieve_participants_response"
 require_relative "e_invoice_api/models/lookup_retrieve_response"
 require_relative "e_invoice_api/models/outbox_list_draft_documents_params"
 require_relative "e_invoice_api/models/outbox_list_received_documents_params"

data/rbi/e_invoice_api/models/lookup_retrieve_participants_params.rbi

@@ -0,0 +1,56 @@
+# typed: strong
+
+module EInvoiceAPI
+  module Models
+    class LookupRetrieveParticipantsParams < EInvoiceAPI::Internal::Type::BaseModel
+      extend EInvoiceAPI::Internal::Type::RequestParameters::Converter
+      include EInvoiceAPI::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            EInvoiceAPI::LookupRetrieveParticipantsParams,
+            EInvoiceAPI::Internal::AnyHash
+          )
+        end
+
+      # Query to lookup
+      sig { returns(String) }
+      attr_accessor :query
+
+      # Country code of the company to lookup. If not provided, the search will be
+      # global.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :country_code
+
+      sig do
+        params(
+          query: String,
+          country_code: T.nilable(String),
+          request_options: EInvoiceAPI::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Query to lookup
+        query:,
+        # Country code of the company to lookup. If not provided, the search will be
+        # global.
+        country_code: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            query: String,
+            country_code: T.nilable(String),
+            request_options: EInvoiceAPI::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/e_invoice_api/models/lookup_retrieve_participants_response.rbi

@@ -0,0 +1,381 @@
+# typed: strong
+
+module EInvoiceAPI
+  module Models
+    class LookupRetrieveParticipantsResponse < EInvoiceAPI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            EInvoiceAPI::Models::LookupRetrieveParticipantsResponse,
+            EInvoiceAPI::Internal::AnyHash
+          )
+        end
+
+      # Query terms used for search
+      sig { returns(String) }
+      attr_accessor :query_terms
+
+      # Search date of the result
+      sig { returns(String) }
+      attr_accessor :search_date
+
+      # Total number of results
+      sig { returns(Integer) }
+      attr_accessor :total_count
+
+      # Number of results returned by the API
+      sig { returns(Integer) }
+      attr_accessor :used_count
+
+      # List of participants
+      sig do
+        returns(
+          T.nilable(
+            T::Array[
+              EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant
+            ]
+          )
+        )
+      end
+      attr_reader :participants
+
+      sig do
+        params(
+          participants:
+            T::Array[
+              EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::OrHash
+            ]
+        ).void
+      end
+      attr_writer :participants
+
+      # Represents the result of a Peppol directory search
+      sig do
+        params(
+          query_terms: String,
+          search_date: String,
+          total_count: Integer,
+          used_count: Integer,
+          participants:
+            T::Array[
+              EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::OrHash
+            ]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Query terms used for search
+        query_terms:,
+        # Search date of the result
+        search_date:,
+        # Total number of results
+        total_count:,
+        # Number of results returned by the API
+        used_count:,
+        # List of participants
+        participants: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            query_terms: String,
+            search_date: String,
+            total_count: Integer,
+            used_count: Integer,
+            participants:
+              T::Array[
+                EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant
+              ]
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Participant < EInvoiceAPI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant,
+              EInvoiceAPI::Internal::AnyHash
+            )
+          end
+
+        # Peppol ID of the participant
+        sig { returns(String) }
+        attr_accessor :peppol_id
+
+        # Peppol scheme of the participant
+        sig { returns(String) }
+        attr_accessor :peppol_scheme
+
+        # List of supported document types
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType
+              ]
+            )
+          )
+        end
+        attr_reader :document_types
+
+        sig do
+          params(
+            document_types:
+              T::Array[
+                EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType::OrHash
+              ]
+          ).void
+        end
+        attr_writer :document_types
+
+        # List of business entities
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity
+              ]
+            )
+          )
+        end
+        attr_reader :entities
+
+        sig do
+          params(
+            entities:
+              T::Array[
+                EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::OrHash
+              ]
+          ).void
+        end
+        attr_writer :entities
+
+        # Represents a Peppol participant with their details
+        sig do
+          params(
+            peppol_id: String,
+            peppol_scheme: String,
+            document_types:
+              T::Array[
+                EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType::OrHash
+              ],
+            entities:
+              T::Array[
+                EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::OrHash
+              ]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Peppol ID of the participant
+          peppol_id:,
+          # Peppol scheme of the participant
+          peppol_scheme:,
+          # List of supported document types
+          document_types: nil,
+          # List of business entities
+          entities: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              peppol_id: String,
+              peppol_scheme: String,
+              document_types:
+                T::Array[
+                  EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType
+                ],
+              entities:
+                T::Array[
+                  EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity
+                ]
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class DocumentType < EInvoiceAPI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType,
+                EInvoiceAPI::Internal::AnyHash
+              )
+            end
+
+          # Document type scheme
+          sig { returns(String) }
+          attr_accessor :scheme
+
+          # Document type value
+          sig { returns(String) }
+          attr_accessor :value
+
+          # Represents a supported document type
+          sig do
+            params(scheme: String, value: String).returns(T.attached_class)
+          end
+          def self.new(
+            # Document type scheme
+            scheme:,
+            # Document type value
+            value:
+          )
+          end
+
+          sig { override.returns({ scheme: String, value: String }) }
+          def to_hash
+          end
+        end
+
+        class Entity < EInvoiceAPI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity,
+                EInvoiceAPI::Internal::AnyHash
+              )
+            end
+
+          # Additional information
+          sig { returns(T.nilable(String)) }
+          attr_accessor :additional_info
+
+          # Country code
+          sig { returns(T.nilable(String)) }
+          attr_accessor :country_code
+
+          # Geographic information
+          sig { returns(T.nilable(String)) }
+          attr_accessor :geo_info
+
+          # List of business identifiers
+          sig do
+            returns(
+              T.nilable(
+                T::Array[
+                  EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier
+                ]
+              )
+            )
+          end
+          attr_reader :identifiers
+
+          sig do
+            params(
+              identifiers:
+                T::Array[
+                  EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier::OrHash
+                ]
+            ).void
+          end
+          attr_writer :identifiers
+
+          # Business entity name
+          sig { returns(T.nilable(String)) }
+          attr_accessor :name
+
+          # Registration date
+          sig { returns(T.nilable(String)) }
+          attr_accessor :registration_date
+
+          # Website URL
+          sig { returns(T.nilable(String)) }
+          attr_accessor :website
+
+          # Represents a business entity
+          sig do
+            params(
+              additional_info: T.nilable(String),
+              country_code: T.nilable(String),
+              geo_info: T.nilable(String),
+              identifiers:
+                T::Array[
+                  EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier::OrHash
+                ],
+              name: T.nilable(String),
+              registration_date: T.nilable(String),
+              website: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Additional information
+            additional_info: nil,
+            # Country code
+            country_code: nil,
+            # Geographic information
+            geo_info: nil,
+            # List of business identifiers
+            identifiers: nil,
+            # Business entity name
+            name: nil,
+            # Registration date
+            registration_date: nil,
+            # Website URL
+            website: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                additional_info: T.nilable(String),
+                country_code: T.nilable(String),
+                geo_info: T.nilable(String),
+                identifiers:
+                  T::Array[
+                    EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier
+                  ],
+                name: T.nilable(String),
+                registration_date: T.nilable(String),
+                website: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Identifier < EInvoiceAPI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier,
+                  EInvoiceAPI::Internal::AnyHash
+                )
+              end
+
+            # Identifier scheme
+            sig { returns(String) }
+            attr_accessor :scheme
+
+            # Identifier value
+            sig { returns(String) }
+            attr_accessor :value
+
+            # Represents a business identifier
+            sig do
+              params(scheme: String, value: String).returns(T.attached_class)
+            end
+            def self.new(
+              # Identifier scheme
+              scheme:,
+              # Identifier value
+              value:
+            )
+            end
+
+            sig { override.returns({ scheme: String, value: String }) }
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/e_invoice_api/models.rbi

@@ -35,6 +35,9 @@ module EInvoiceAPI
 
   LookupRetrieveParams = EInvoiceAPI::Models::LookupRetrieveParams
 
+  LookupRetrieveParticipantsParams =
+    EInvoiceAPI::Models::LookupRetrieveParticipantsParams
+
   OutboxListDraftDocumentsParams =
     EInvoiceAPI::Models::OutboxListDraftDocumentsParams
 

data/rbi/e_invoice_api/resources/lookup.rbi

@@ -22,6 +22,25 @@ module EInvoiceAPI
       )
       end
 
+      # Lookup Peppol participants by name or other identifiers. You can limit the
+      # search to a specific country by providing the country code.
+      sig do
+        params(
+          query: String,
+          country_code: T.nilable(String),
+          request_options: EInvoiceAPI::RequestOptions::OrHash
+        ).returns(EInvoiceAPI::Models::LookupRetrieveParticipantsResponse)
+      end
+      def retrieve_participants(
+        # Query to lookup
+        query:,
+        # Country code of the company to lookup. If not provided, the search will be
+        # global.
+        country_code: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: EInvoiceAPI::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/e_invoice_api/models/lookup_retrieve_participants_params.rbs

@@ -0,0 +1,28 @@
+module EInvoiceAPI
+  module Models
+    type lookup_retrieve_participants_params =
+      { query: String, country_code: String? }
+      & EInvoiceAPI::Internal::Type::request_parameters
+
+    class LookupRetrieveParticipantsParams < EInvoiceAPI::Internal::Type::BaseModel
+      extend EInvoiceAPI::Internal::Type::RequestParameters::Converter
+      include EInvoiceAPI::Internal::Type::RequestParameters
+
+      attr_accessor query: String
+
+      attr_accessor country_code: String?
+
+      def initialize: (
+        query: String,
+        ?country_code: String?,
+        ?request_options: EInvoiceAPI::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        query: String,
+        country_code: String?,
+        request_options: EInvoiceAPI::RequestOptions
+      }
+    end
+  end
+end

data/sig/e_invoice_api/models/lookup_retrieve_participants_response.rbs

@@ -0,0 +1,159 @@
+module EInvoiceAPI
+  module Models
+    type lookup_retrieve_participants_response =
+      {
+        query_terms: String,
+        search_date: String,
+        total_count: Integer,
+        used_count: Integer,
+        participants: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant]
+      }
+
+    class LookupRetrieveParticipantsResponse < EInvoiceAPI::Internal::Type::BaseModel
+      attr_accessor query_terms: String
+
+      attr_accessor search_date: String
+
+      attr_accessor total_count: Integer
+
+      attr_accessor used_count: Integer
+
+      attr_reader participants: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant]?
+
+      def participants=: (
+        ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant]
+      ) -> ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant]
+
+      def initialize: (
+        query_terms: String,
+        search_date: String,
+        total_count: Integer,
+        used_count: Integer,
+        ?participants: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant]
+      ) -> void
+
+      def to_hash: -> {
+        query_terms: String,
+        search_date: String,
+        total_count: Integer,
+        used_count: Integer,
+        participants: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant]
+      }
+
+      type participant =
+        {
+          peppol_id: String,
+          peppol_scheme: String,
+          document_types: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType],
+          entities: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity]
+        }
+
+      class Participant < EInvoiceAPI::Internal::Type::BaseModel
+        attr_accessor peppol_id: String
+
+        attr_accessor peppol_scheme: String
+
+        attr_reader document_types: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType]?
+
+        def document_types=: (
+          ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType]
+        ) -> ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType]
+
+        attr_reader entities: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity]?
+
+        def entities=: (
+          ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity]
+        ) -> ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity]
+
+        def initialize: (
+          peppol_id: String,
+          peppol_scheme: String,
+          ?document_types: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType],
+          ?entities: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity]
+        ) -> void
+
+        def to_hash: -> {
+          peppol_id: String,
+          peppol_scheme: String,
+          document_types: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::DocumentType],
+          entities: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity]
+        }
+
+        type document_type = { scheme: String, value: String }
+
+        class DocumentType < EInvoiceAPI::Internal::Type::BaseModel
+          attr_accessor scheme: String
+
+          attr_accessor value: String
+
+          def initialize: (scheme: String, value: String) -> void
+
+          def to_hash: -> { scheme: String, value: String }
+        end
+
+        type entity =
+          {
+            additional_info: String?,
+            country_code: String?,
+            geo_info: String?,
+            identifiers: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier],
+            name: String?,
+            registration_date: String?,
+            website: String?
+          }
+
+        class Entity < EInvoiceAPI::Internal::Type::BaseModel
+          attr_accessor additional_info: String?
+
+          attr_accessor country_code: String?
+
+          attr_accessor geo_info: String?
+
+          attr_reader identifiers: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier]?
+
+          def identifiers=: (
+            ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier]
+          ) -> ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier]
+
+          attr_accessor name: String?
+
+          attr_accessor registration_date: String?
+
+          attr_accessor website: String?
+
+          def initialize: (
+            ?additional_info: String?,
+            ?country_code: String?,
+            ?geo_info: String?,
+            ?identifiers: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier],
+            ?name: String?,
+            ?registration_date: String?,
+            ?website: String?
+          ) -> void
+
+          def to_hash: -> {
+            additional_info: String?,
+            country_code: String?,
+            geo_info: String?,
+            identifiers: ::Array[EInvoiceAPI::Models::LookupRetrieveParticipantsResponse::Participant::Entity::Identifier],
+            name: String?,
+            registration_date: String?,
+            website: String?
+          }
+
+          type identifier = { scheme: String, value: String }
+
+          class Identifier < EInvoiceAPI::Internal::Type::BaseModel
+            attr_accessor scheme: String
+
+            attr_accessor value: String
+
+            def initialize: (scheme: String, value: String) -> void
+
+            def to_hash: -> { scheme: String, value: String }
+          end
+        end
+      end
+    end
+  end
+end

data/sig/e_invoice_api/models.rbs

@@ -33,6 +33,8 @@ module EInvoiceAPI
 
   class LookupRetrieveParams = EInvoiceAPI::Models::LookupRetrieveParams
 
+  class LookupRetrieveParticipantsParams = EInvoiceAPI::Models::LookupRetrieveParticipantsParams
+
   class OutboxListDraftDocumentsParams = EInvoiceAPI::Models::OutboxListDraftDocumentsParams
 
   class OutboxListReceivedDocumentsParams = EInvoiceAPI::Models::OutboxListReceivedDocumentsParams

data/sig/e_invoice_api/resources/lookup.rbs

@@ -6,6 +6,12 @@ module EInvoiceAPI
         ?request_options: EInvoiceAPI::request_opts
       ) -> EInvoiceAPI::Models::LookupRetrieveResponse
 
+      def retrieve_participants: (
+        query: String,
+        ?country_code: String?,
+        ?request_options: EInvoiceAPI::request_opts
+      ) -> EInvoiceAPI::Models::LookupRetrieveParticipantsResponse
+
       def initialize: (client: EInvoiceAPI::Client) -> void
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: e-invoice-api
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - e-invoice
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-27 00:00:00.000000000 Z
+date: 2025-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -82,6 +82,8 @@ files:
 - lib/e_invoice_api/models/inbox_list_invoices_params.rb
 - lib/e_invoice_api/models/inbox_list_params.rb
 - lib/e_invoice_api/models/lookup_retrieve_params.rb
+- lib/e_invoice_api/models/lookup_retrieve_participants_params.rb
+- lib/e_invoice_api/models/lookup_retrieve_participants_response.rb
 - lib/e_invoice_api/models/lookup_retrieve_response.rb
 - lib/e_invoice_api/models/outbox_list_draft_documents_params.rb
 - lib/e_invoice_api/models/outbox_list_received_documents_params.rb
@@ -158,6 +160,8 @@ files:
 - rbi/e_invoice_api/models/inbox_list_invoices_params.rbi
 - rbi/e_invoice_api/models/inbox_list_params.rbi
 - rbi/e_invoice_api/models/lookup_retrieve_params.rbi
+- rbi/e_invoice_api/models/lookup_retrieve_participants_params.rbi
+- rbi/e_invoice_api/models/lookup_retrieve_participants_response.rbi
 - rbi/e_invoice_api/models/lookup_retrieve_response.rbi
 - rbi/e_invoice_api/models/outbox_list_draft_documents_params.rbi
 - rbi/e_invoice_api/models/outbox_list_received_documents_params.rbi
@@ -233,6 +237,8 @@ files:
 - sig/e_invoice_api/models/inbox_list_invoices_params.rbs
 - sig/e_invoice_api/models/inbox_list_params.rbs
 - sig/e_invoice_api/models/lookup_retrieve_params.rbs
+- sig/e_invoice_api/models/lookup_retrieve_participants_params.rbs
+- sig/e_invoice_api/models/lookup_retrieve_participants_response.rbs
 - sig/e_invoice_api/models/lookup_retrieve_response.rbs
 - sig/e_invoice_api/models/outbox_list_draft_documents_params.rbs
 - sig/e_invoice_api/models/outbox_list_received_documents_params.rbs