e-invoice-api 0.16.2 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b406f6e08449a83aa5dbd3ce27916d318ebfd258f5dd7d6c2108263f582d6d9
-  data.tar.gz: c18599bc9a690f2b88c341792026ae1ec76d85397f0ccf74b608672e1e7e62f4
+  metadata.gz: 8fb0bfb828758c8ddbf04bdc09f5bce1145a6ded3db11c23cc9944b3b9662c08
+  data.tar.gz: b0001510a23be50ad8a5ff691b5b7e069864ae4c3752da44362445c59e6a1e78
 SHA512:
-  metadata.gz: afd59dbb0ee0fac8fa5ba8db1f64ace3b4aec5b845c97ce10ddd8a7db76d942f95c6f128fda9f7395056e1561fb34ca1a86e34fb59d46d1500fb35d1c7bd6a99
-  data.tar.gz: 671edc1b1c9377a3aa30de0afc04a547c01672c645e54f06238692119c3dc5487691abcd2a920fde691ef44f88784252643fd65b5e2be94e66c7ed0d2bb4263f
+  metadata.gz: 88054607bad7af3d1e0c5e0e18242658a2d759cf7ba6719166700d24ec0a542bcf55e3fad7495da806ed965c566695930d4138dd2ff736977dde45df3bfa39d7
+  data.tar.gz: 1c3e1c2590702e931781bdb4fa3ed203c970a5b87412c598e03807cfa124b1c4e99675ff4552d02711f4bc04ced4ef60aca204afa7973763234b8d04a4301304

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 0.18.0 (2026-01-19)
+
+Full Changelog: [v0.17.0...v0.18.0](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.17.0...v0.18.0)
+
+### Features
+
+* **api:** api update ([6d3ef3b](https://github.com/e-invoice-be/e-invoice-rb/commit/6d3ef3b773cf13e36e20cef0008ad3dc75d36cfb))
+
+
+### Chores
+
+* **internal:** update `actions/checkout` version ([7bb6612](https://github.com/e-invoice-be/e-invoice-rb/commit/7bb661210fda31d5e2cc09db4d02a82c1b62a97c))
+
+## 0.17.0 (2026-01-15)
+
+Full Changelog: [v0.16.2...v0.17.0](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.16.2...v0.17.0)
+
+### Features
+
+* **api:** api update ([98fcc82](https://github.com/e-invoice-be/e-invoice-rb/commit/98fcc8246c3284db794e81609d5ba755f3c219b7))
+
+
+### Chores
+
+* fix typo in descriptions ([8fcc06b](https://github.com/e-invoice-be/e-invoice-rb/commit/8fcc06b2c2513b0bace66a8cc022ebfb714f2c6a))
+* **internal:** codegen related update ([54574e5](https://github.com/e-invoice-be/e-invoice-rb/commit/54574e575fdacf9430a8e1eaff3faced53cd4468))
+* move `cgi` into dependencies for ruby 4 ([cd5cd05](https://github.com/e-invoice-be/e-invoice-rb/commit/cd5cd055aa0c36ff19de62fd9f22680de2243bac))
+
+
+### Documentation
+
+* prominently feature MCP server setup in root SDK readmes ([d7f0db5](https://github.com/e-invoice-be/e-invoice-rb/commit/d7f0db5aa3c51da11a8be1c3551281b47acd5b49))
+
 ## 0.16.2 (2025-12-19)
 
 Full Changelog: [v0.16.1...v0.16.2](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.16.1...v0.16.2)

data/README.md

@@ -4,6 +4,15 @@ The e-invoice.be Peppol library provides convenient access to the e-invoice REST
 
 To get an API key, [make a free account](https://app.e-invoice.be/register?ref=ruby) and register your company.
 
+## MCP Server
+
+Use the E Invoice MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
+
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=e-invoice-api-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImUtaW52b2ljZS1hcGktbWNwIl19)
+[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22e-invoice-api-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22e-invoice-api-mcp%22%5D%7D)
+
+> Note: You may need to set environment variables in your MCP client.
+
 ## Documentation
 
 Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs.org/gems/e-invoice-api).
@@ -17,7 +26,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.16.2"
+gem "e-invoice-api", "~> 0.18.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/e_invoice_api/models/document_response.rb

@@ -9,6 +9,11 @@ module EInvoiceAPI
       #   @return [String]
       required :id, String
 
+      # @!attribute created_at
+      #
+      #   @return [Time]
+      required :created_at, Time
+
       # @!attribute allowances
       #
       #   @return [Array<EInvoiceAPI::Models::DocumentResponse::Allowance>, nil]
@@ -310,12 +315,14 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :vendor_tax_id, String, nil?: true
 
-      # @!method initialize(id:, allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, charges: nil, currency: nil, customer_address: nil, customer_address_recipient: nil, customer_company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, customer_tax_id: nil, direction: nil, document_type: nil, due_date: nil, invoice_date: nil, invoice_id: nil, invoice_total: nil, items: nil, note: nil, payment_details: nil, payment_term: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, service_address: nil, service_address_recipient: nil, service_end_date: nil, service_start_date: nil, shipping_address: nil, shipping_address_recipient: nil, state: nil, subtotal: nil, tax_code: nil, tax_details: nil, total_discount: nil, total_tax: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_company_id: nil, vendor_email: nil, vendor_name: nil, vendor_tax_id: nil)
+      # @!method initialize(id:, created_at:, allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, charges: nil, currency: nil, customer_address: nil, customer_address_recipient: nil, customer_company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, customer_tax_id: nil, direction: nil, document_type: nil, due_date: nil, invoice_date: nil, invoice_id: nil, invoice_total: nil, items: nil, note: nil, payment_details: nil, payment_term: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, service_address: nil, service_address_recipient: nil, service_end_date: nil, service_start_date: nil, shipping_address: nil, shipping_address_recipient: nil, state: nil, subtotal: nil, tax_code: nil, tax_details: nil, total_discount: nil, total_tax: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_company_id: nil, vendor_email: nil, vendor_name: nil, vendor_tax_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {EInvoiceAPI::Models::DocumentResponse} for more details.
       #
       #   @param id [String]
       #
+      #   @param created_at [Time]
+      #
       #   @param allowances [Array<EInvoiceAPI::Models::DocumentResponse::Allowance>, nil]
       #
       #   @param amount_due [String, nil] The amount due for payment. Must be positive and rounded to maximum 2 decimals

data/lib/e_invoice_api/models/document_type.rb

@@ -8,6 +8,8 @@ module EInvoiceAPI
       INVOICE = :INVOICE
       CREDIT_NOTE = :CREDIT_NOTE
       DEBIT_NOTE = :DEBIT_NOTE
+      SELFBILLING_INVOICE = :SELFBILLING_INVOICE
+      SELFBILLING_CREDIT_NOTE = :SELFBILLING_CREDIT_NOTE
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/e_invoice_api/models/inbox_list_credit_notes_params.rb

@@ -19,12 +19,55 @@ module EInvoiceAPI
       #   @return [Integer, nil]
       optional :page_size, Integer
 
-      # @!method initialize(page: nil, page_size: nil, request_options: {})
+      # @!attribute sort_by
+      #   Field to sort by
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::InboxListCreditNotesParams::SortBy, nil]
+      optional :sort_by, enum: -> { EInvoiceAPI::InboxListCreditNotesParams::SortBy }
+
+      # @!attribute sort_order
+      #   Sort direction (asc/desc)
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::InboxListCreditNotesParams::SortOrder, nil]
+      optional :sort_order, enum: -> { EInvoiceAPI::InboxListCreditNotesParams::SortOrder }
+
+      # @!method initialize(page: nil, page_size: nil, sort_by: nil, sort_order: nil, request_options: {})
       #   @param page [Integer] Page number
       #
       #   @param page_size [Integer] Number of items per page
       #
+      #   @param sort_by [Symbol, EInvoiceAPI::Models::InboxListCreditNotesParams::SortBy] Field to sort by
+      #
+      #   @param sort_order [Symbol, EInvoiceAPI::Models::InboxListCreditNotesParams::SortOrder] Sort direction (asc/desc)
+      #
       #   @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}]
+
+      # Field to sort by
+      module SortBy
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        CREATED_AT = :created_at
+        INVOICE_DATE = :invoice_date
+        DUE_DATE = :due_date
+        INVOICE_TOTAL = :invoice_total
+        CUSTOMER_NAME = :customer_name
+        VENDOR_NAME = :vendor_name
+        INVOICE_ID = :invoice_id
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Sort direction (asc/desc)
+      module SortOrder
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        ASC = :asc
+        DESC = :desc
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/e_invoice_api/models/inbox_list_invoices_params.rb

@@ -19,12 +19,55 @@ module EInvoiceAPI
       #   @return [Integer, nil]
       optional :page_size, Integer
 
-      # @!method initialize(page: nil, page_size: nil, request_options: {})
+      # @!attribute sort_by
+      #   Field to sort by
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::InboxListInvoicesParams::SortBy, nil]
+      optional :sort_by, enum: -> { EInvoiceAPI::InboxListInvoicesParams::SortBy }
+
+      # @!attribute sort_order
+      #   Sort direction (asc/desc)
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::InboxListInvoicesParams::SortOrder, nil]
+      optional :sort_order, enum: -> { EInvoiceAPI::InboxListInvoicesParams::SortOrder }
+
+      # @!method initialize(page: nil, page_size: nil, sort_by: nil, sort_order: nil, request_options: {})
       #   @param page [Integer] Page number
       #
       #   @param page_size [Integer] Number of items per page
       #
+      #   @param sort_by [Symbol, EInvoiceAPI::Models::InboxListInvoicesParams::SortBy] Field to sort by
+      #
+      #   @param sort_order [Symbol, EInvoiceAPI::Models::InboxListInvoicesParams::SortOrder] Sort direction (asc/desc)
+      #
       #   @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}]
+
+      # Field to sort by
+      module SortBy
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        CREATED_AT = :created_at
+        INVOICE_DATE = :invoice_date
+        DUE_DATE = :due_date
+        INVOICE_TOTAL = :invoice_total
+        CUSTOMER_NAME = :customer_name
+        VENDOR_NAME = :vendor_name
+        INVOICE_ID = :invoice_id
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Sort direction (asc/desc)
+      module SortOrder
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        ASC = :asc
+        DESC = :desc
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/e_invoice_api/models/inbox_list_params.rb

@@ -38,11 +38,23 @@ module EInvoiceAPI
       optional :search, String, nil?: true
 
       # @!attribute sender
-      #   Filter by sender ID
+      #   Filter by sender (vendor_name, vendor_email, vendor_tax_id, vendor_company_id)
       #
       #   @return [String, nil]
       optional :sender, String, nil?: true
 
+      # @!attribute sort_by
+      #   Field to sort by
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::InboxListParams::SortBy, nil]
+      optional :sort_by, enum: -> { EInvoiceAPI::InboxListParams::SortBy }
+
+      # @!attribute sort_order
+      #   Sort direction (asc/desc)
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::InboxListParams::SortOrder, nil]
+      optional :sort_order, enum: -> { EInvoiceAPI::InboxListParams::SortOrder }
+
       # @!attribute state
       #   Filter by document state
       #
@@ -55,7 +67,7 @@ module EInvoiceAPI
       #   @return [Symbol, EInvoiceAPI::Models::DocumentType, nil]
       optional :type, enum: -> { EInvoiceAPI::DocumentType }, nil?: true
 
-      # @!method initialize(date_from: nil, date_to: nil, page: nil, page_size: nil, search: nil, sender: nil, state: nil, type: nil, request_options: {})
+      # @!method initialize(date_from: nil, date_to: nil, page: nil, page_size: nil, search: nil, sender: nil, sort_by: nil, sort_order: nil, state: nil, type: nil, request_options: {})
       #   @param date_from [Time, nil] Filter by issue date (from)
       #
       #   @param date_to [Time, nil] Filter by issue date (to)
@@ -66,13 +78,44 @@ module EInvoiceAPI
       #
       #   @param search [String, nil] Search in invoice number, seller/buyer names
       #
-      #   @param sender [String, nil] Filter by sender ID
+      #   @param sender [String, nil] Filter by sender (vendor_name, vendor_email, vendor_tax_id, vendor_company_id)
+      #
+      #   @param sort_by [Symbol, EInvoiceAPI::Models::InboxListParams::SortBy] Field to sort by
+      #
+      #   @param sort_order [Symbol, EInvoiceAPI::Models::InboxListParams::SortOrder] Sort direction (asc/desc)
       #
       #   @param state [Symbol, EInvoiceAPI::Models::DocumentState, nil] Filter by document state
       #
       #   @param type [Symbol, EInvoiceAPI::Models::DocumentType, nil] Filter by document type
       #
       #   @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}]
+
+      # Field to sort by
+      module SortBy
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        CREATED_AT = :created_at
+        INVOICE_DATE = :invoice_date
+        DUE_DATE = :due_date
+        INVOICE_TOTAL = :invoice_total
+        CUSTOMER_NAME = :customer_name
+        VENDOR_NAME = :vendor_name
+        INVOICE_ID = :invoice_id
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Sort direction (asc/desc)
+      module SortOrder
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        ASC = :asc
+        DESC = :desc
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/e_invoice_api/models/lookup_retrieve_response.rb

@@ -192,7 +192,19 @@ module EInvoiceAPI
         #   @return [String, nil]
         optional :error, String, nil?: true
 
-        # @!method initialize(dns_records:, sml_hostname:, status:, error: nil)
+        # @!attribute lookup_method
+        #   DNS lookup method used: 'naptr' (new spec) or 'busdox' (legacy)
+        #
+        #   @return [String, nil]
+        optional :lookup_method, String, api_name: :lookupMethod, nil?: true
+
+        # @!attribute smp_hostname
+        #   Hostname of the SMP (Service Metadata Publisher) discovered via DNS
+        #
+        #   @return [String, nil]
+        optional :smp_hostname, String, api_name: :smpHostname, nil?: true
+
+        # @!method initialize(dns_records:, sml_hostname:, status:, error: nil, lookup_method: nil, smp_hostname: nil)
         #   Information about the DNS lookup performed
         #
         #   @param dns_records [Array<EInvoiceAPI::Models::LookupRetrieveResponse::DNSInfo::DNSRecord>] List of DNS records found for the Peppol participant
@@ -202,6 +214,10 @@ module EInvoiceAPI
         #   @param status [String] Status of the DNS lookup: 'success', 'error', or 'pending'
         #
         #   @param error [String, nil] Error message if the DNS lookup failed
+        #
+        #   @param lookup_method [String, nil] DNS lookup method used: 'naptr' (new spec) or 'busdox' (legacy)
+        #
+        #   @param smp_hostname [String, nil] Hostname of the SMP (Service Metadata Publisher) discovered via DNS
 
         class DNSRecord < EInvoiceAPI::Internal::Type::BaseModel
           # @!attribute ip

data/lib/e_invoice_api/models/outbox_list_draft_documents_params.rb

@@ -19,12 +19,79 @@ module EInvoiceAPI
       #   @return [Integer, nil]
       optional :page_size, Integer
 
-      # @!method initialize(page: nil, page_size: nil, request_options: {})
+      # @!attribute search
+      #   Search in invoice number, seller/buyer names
+      #
+      #   @return [String, nil]
+      optional :search, String, nil?: true
+
+      # @!attribute sort_by
+      #   Field to sort by
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::OutboxListDraftDocumentsParams::SortBy, nil]
+      optional :sort_by, enum: -> { EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy }
+
+      # @!attribute sort_order
+      #   Sort direction (asc/desc)
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::OutboxListDraftDocumentsParams::SortOrder, nil]
+      optional :sort_order, enum: -> { EInvoiceAPI::OutboxListDraftDocumentsParams::SortOrder }
+
+      # @!attribute state
+      #   Filter by document state
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::DocumentState, nil]
+      optional :state, enum: -> { EInvoiceAPI::DocumentState }, nil?: true
+
+      # @!attribute type
+      #   Filter by document type
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::DocumentType, nil]
+      optional :type, enum: -> { EInvoiceAPI::DocumentType }, nil?: true
+
+      # @!method initialize(page: nil, page_size: nil, search: nil, sort_by: nil, sort_order: nil, state: nil, type: nil, request_options: {})
       #   @param page [Integer] Page number
       #
       #   @param page_size [Integer] Number of items per page
       #
+      #   @param search [String, nil] Search in invoice number, seller/buyer names
+      #
+      #   @param sort_by [Symbol, EInvoiceAPI::Models::OutboxListDraftDocumentsParams::SortBy] Field to sort by
+      #
+      #   @param sort_order [Symbol, EInvoiceAPI::Models::OutboxListDraftDocumentsParams::SortOrder] Sort direction (asc/desc)
+      #
+      #   @param state [Symbol, EInvoiceAPI::Models::DocumentState, nil] Filter by document state
+      #
+      #   @param type [Symbol, EInvoiceAPI::Models::DocumentType, nil] Filter by document type
+      #
       #   @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}]
+
+      # Field to sort by
+      module SortBy
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        CREATED_AT = :created_at
+        INVOICE_DATE = :invoice_date
+        DUE_DATE = :due_date
+        INVOICE_TOTAL = :invoice_total
+        CUSTOMER_NAME = :customer_name
+        VENDOR_NAME = :vendor_name
+        INVOICE_ID = :invoice_id
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Sort direction (asc/desc)
+      module SortOrder
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        ASC = :asc
+        DESC = :desc
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/e_invoice_api/models/outbox_list_received_documents_params.rb

@@ -31,6 +31,13 @@ module EInvoiceAPI
       #   @return [Integer, nil]
       optional :page_size, Integer
 
+      # @!attribute receiver
+      #   Filter by receiver (customer_name, customer_email, customer_tax_id,
+      #   customer_company_id, customer_id)
+      #
+      #   @return [String, nil]
+      optional :receiver, String, nil?: true
+
       # @!attribute search
       #   Search in invoice number, seller/buyer names
       #
@@ -38,11 +45,25 @@ module EInvoiceAPI
       optional :search, String, nil?: true
 
       # @!attribute sender
-      #   Filter by sender ID
+      #   @deprecated
+      #
+      #   (Deprecated) Filter by sender ID
       #
       #   @return [String, nil]
       optional :sender, String, nil?: true
 
+      # @!attribute sort_by
+      #   Field to sort by
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::OutboxListReceivedDocumentsParams::SortBy, nil]
+      optional :sort_by, enum: -> { EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy }
+
+      # @!attribute sort_order
+      #   Sort direction (asc/desc)
+      #
+      #   @return [Symbol, EInvoiceAPI::Models::OutboxListReceivedDocumentsParams::SortOrder, nil]
+      optional :sort_order, enum: -> { EInvoiceAPI::OutboxListReceivedDocumentsParams::SortOrder }
+
       # @!attribute state
       #   Filter by document state
       #
@@ -55,7 +76,10 @@ module EInvoiceAPI
       #   @return [Symbol, EInvoiceAPI::Models::DocumentType, nil]
       optional :type, enum: -> { EInvoiceAPI::DocumentType }, nil?: true
 
-      # @!method initialize(date_from: nil, date_to: nil, page: nil, page_size: nil, search: nil, sender: nil, state: nil, type: nil, request_options: {})
+      # @!method initialize(date_from: nil, date_to: nil, page: nil, page_size: nil, receiver: nil, search: nil, sender: nil, sort_by: nil, sort_order: nil, state: nil, type: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {EInvoiceAPI::Models::OutboxListReceivedDocumentsParams} for more details.
+      #
       #   @param date_from [Time, nil] Filter by issue date (from)
       #
       #   @param date_to [Time, nil] Filter by issue date (to)
@@ -64,15 +88,48 @@ module EInvoiceAPI
       #
       #   @param page_size [Integer] Number of items per page
       #
+      #   @param receiver [String, nil] Filter by receiver (customer_name, customer_email, customer_tax_id, customer_com
+      #
       #   @param search [String, nil] Search in invoice number, seller/buyer names
       #
-      #   @param sender [String, nil] Filter by sender ID
+      #   @param sender [String, nil] (Deprecated) Filter by sender ID
+      #
+      #   @param sort_by [Symbol, EInvoiceAPI::Models::OutboxListReceivedDocumentsParams::SortBy] Field to sort by
+      #
+      #   @param sort_order [Symbol, EInvoiceAPI::Models::OutboxListReceivedDocumentsParams::SortOrder] Sort direction (asc/desc)
       #
       #   @param state [Symbol, EInvoiceAPI::Models::DocumentState, nil] Filter by document state
       #
       #   @param type [Symbol, EInvoiceAPI::Models::DocumentType, nil] Filter by document type
       #
       #   @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}]
+
+      # Field to sort by
+      module SortBy
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        CREATED_AT = :created_at
+        INVOICE_DATE = :invoice_date
+        DUE_DATE = :due_date
+        INVOICE_TOTAL = :invoice_total
+        CUSTOMER_NAME = :customer_name
+        VENDOR_NAME = :vendor_name
+        INVOICE_ID = :invoice_id
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Sort direction (asc/desc)
+      module SortOrder
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        ASC = :asc
+        DESC = :desc
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/e_invoice_api/models/paginated_document_response.rb

@@ -3,6 +3,11 @@
 module EInvoiceAPI
   module Models
     class PaginatedDocumentResponse < EInvoiceAPI::Internal::Type::BaseModel
+      # @!attribute has_next_page
+      #
+      #   @return [Boolean]
+      required :has_next_page, EInvoiceAPI::Internal::Type::Boolean
+
       # @!attribute items
       #
       #   @return [Array<EInvoiceAPI::Models::DocumentResponse>]
@@ -28,7 +33,8 @@ module EInvoiceAPI
       #   @return [Integer]
       required :total, Integer
 
-      # @!method initialize(items:, page:, page_size:, pages:, total:)
+      # @!method initialize(has_next_page:, items:, page:, page_size:, pages:, total:)
+      #   @param has_next_page [Boolean]
       #   @param items [Array<EInvoiceAPI::Models::DocumentResponse>]
       #   @param page [Integer]
       #   @param page_size [Integer]

data/lib/e_invoice_api/resources/documents/attachments.rb

@@ -76,8 +76,10 @@ module EInvoiceAPI
 
         # @deprecated
         #
-        # Add one or more attachments when creating a new invoice or credit note via POST
-        # /api/documents/
+        # Add one or more attachments to an invoice. Be careful: the attachments ARE NOT
+        # ADDED to the UBL! They are only stored in our database and can be downloaded
+        # later. To add attachments to the UBL, you need to add the attachment(s) via POST
+        # /api/documents
         #
         # @overload add(document_id, file:, request_options: {})
         #

data/lib/e_invoice_api/resources/documents.rb

@@ -174,11 +174,11 @@ module EInvoiceAPI
       #
       # @overload create_from_pdf(file:, customer_tax_id: nil, vendor_tax_id: nil, request_options: {})
       #
-      # @param file [Pathname, StringIO, IO, String, EInvoiceAPI::FilePart] Body param:
+      # @param file [Pathname, StringIO, IO, String, EInvoiceAPI::FilePart] Body param
       #
-      # @param customer_tax_id [String, nil] Query param:
+      # @param customer_tax_id [String, nil] Query param
       #
-      # @param vendor_tax_id [String, nil] Query param:
+      # @param vendor_tax_id [String, nil] Query param
       #
       # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/e_invoice_api/resources/inbox.rb

@@ -6,7 +6,7 @@ module EInvoiceAPI
       # Retrieve a paginated list of received documents with filtering options including
       # state, type, sender, date range, and text search.
       #
-      # @overload list(date_from: nil, date_to: nil, page: nil, page_size: nil, search: nil, sender: nil, state: nil, type: nil, request_options: {})
+      # @overload list(date_from: nil, date_to: nil, page: nil, page_size: nil, search: nil, sender: nil, sort_by: nil, sort_order: nil, state: nil, type: nil, request_options: {})
       #
       # @param date_from [Time, nil] Filter by issue date (from)
       #
@@ -18,7 +18,11 @@ module EInvoiceAPI
       #
       # @param search [String, nil] Search in invoice number, seller/buyer names
       #
-      # @param sender [String, nil] Filter by sender ID
+      # @param sender [String, nil] Filter by sender (vendor_name, vendor_email, vendor_tax_id, vendor_company_id)
+      #
+      # @param sort_by [Symbol, EInvoiceAPI::Models::InboxListParams::SortBy] Field to sort by
+      #
+      # @param sort_order [Symbol, EInvoiceAPI::Models::InboxListParams::SortOrder] Sort direction (asc/desc)
       #
       # @param state [Symbol, EInvoiceAPI::Models::DocumentState, nil] Filter by document state
       #
@@ -43,12 +47,16 @@ module EInvoiceAPI
 
       # Retrieve a paginated list of received credit notes with filtering options.
       #
-      # @overload list_credit_notes(page: nil, page_size: nil, request_options: {})
+      # @overload list_credit_notes(page: nil, page_size: nil, sort_by: nil, sort_order: nil, request_options: {})
       #
       # @param page [Integer] Page number
       #
       # @param page_size [Integer] Number of items per page
       #
+      # @param sort_by [Symbol, EInvoiceAPI::Models::InboxListCreditNotesParams::SortBy] Field to sort by
+      #
+      # @param sort_order [Symbol, EInvoiceAPI::Models::InboxListCreditNotesParams::SortOrder] Sort direction (asc/desc)
+      #
       # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [EInvoiceAPI::Internal::DocumentsNumberPage<EInvoiceAPI::Models::DocumentResponse>]
@@ -68,12 +76,16 @@ module EInvoiceAPI
 
       # Retrieve a paginated list of received invoices with filtering options.
       #
-      # @overload list_invoices(page: nil, page_size: nil, request_options: {})
+      # @overload list_invoices(page: nil, page_size: nil, sort_by: nil, sort_order: nil, request_options: {})
       #
       # @param page [Integer] Page number
       #
       # @param page_size [Integer] Number of items per page
       #
+      # @param sort_by [Symbol, EInvoiceAPI::Models::InboxListInvoicesParams::SortBy] Field to sort by
+      #
+      # @param sort_order [Symbol, EInvoiceAPI::Models::InboxListInvoicesParams::SortOrder] Sort direction (asc/desc)
+      #
       # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [EInvoiceAPI::Internal::DocumentsNumberPage<EInvoiceAPI::Models::DocumentResponse>]