e-invoice-api 0.25.0 → 0.26.1

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,24 +45,33 @@ module EInvoiceAPI
       optional :search, String, nil?: true
 
       # @!attribute sender
-      #   Filter by sender ID
+      #   (Deprecated) Filter by sender ID
       #
       #   @return [String, nil]
       optional :sender, String, nil?: true
 
-      # @!attribute state
-      #   Filter by document state
+      # @!attribute sort_by
+      #   Field to sort by
       #
-      #   @return [Symbol, EInvoiceAPI::Models::DocumentState, nil]
-      optional :state, enum: -> { EInvoiceAPI::DocumentState }, nil?: true
+      #   @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 type
-      #   Filter by document type
+      #   Filter by document type. If not provided, returns all types.
       #
       #   @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, 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 +80,46 @@ 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 state [Symbol, EInvoiceAPI::Models::DocumentState, nil] Filter by document state
+      #   @param sort_by [Symbol, EInvoiceAPI::Models::OutboxListReceivedDocumentsParams::SortBy] Field to sort by
       #
-      #   @param type [Symbol, EInvoiceAPI::Models::DocumentType, nil] Filter by document type
+      #   @param sort_order [Symbol, EInvoiceAPI::Models::OutboxListReceivedDocumentsParams::SortOrder] Sort direction (asc/desc)
+      #
+      #   @param type [Symbol, EInvoiceAPI::Models::DocumentType, nil] Filter by document type. If not provided, returns all types.
       #
       #   @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

@@ -14,103 +14,107 @@ module EInvoiceAPI
       #
       # Create a new invoice or credit note
       #
-      # @overload create(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, previous_unpaid_balance: 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, request_options: {})
+      # @overload create(construct_pdf: nil, 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_peppol_id: 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, previous_unpaid_balance: 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, request_options: {})
       #
-      # @param allowances [Array<EInvoiceAPI::Models::DocumentCreate::Allowance>, nil]
+      # @param construct_pdf [Boolean] Query param: If true, generate a constructed PDF from the document and include i
       #
-      # @param amount_due [Float, String, nil] The amount due for payment. Must be positive and rounded to maximum 2 decimals
+      # @param allowances [Array<EInvoiceAPI::Models::DocumentCreate::Allowance>, nil] Body param
       #
-      # @param attachments [Array<EInvoiceAPI::Models::DocumentAttachmentCreate>, nil]
+      # @param amount_due [Float, String, nil] Body param: The amount due for payment. Must be positive and rounded to maximum
       #
-      # @param billing_address [String, nil] The billing address (if different from customer address)
+      # @param attachments [Array<EInvoiceAPI::Models::DocumentAttachmentCreate>, nil] Body param
       #
-      # @param billing_address_recipient [String, nil] The recipient name at the billing address
+      # @param billing_address [String, nil] Body param: The billing address (if different from customer address)
       #
-      # @param charges [Array<EInvoiceAPI::Models::DocumentCreate::Charge>, nil]
+      # @param billing_address_recipient [String, nil] Body param: The recipient name at the billing address
       #
-      # @param currency [Symbol, EInvoiceAPI::Models::CurrencyCode] Currency of the invoice (ISO 4217 currency code)
+      # @param charges [Array<EInvoiceAPI::Models::DocumentCreate::Charge>, nil] Body param
       #
-      # @param customer_address [String, nil] The address of the customer/buyer
+      # @param currency [Symbol, EInvoiceAPI::Models::CurrencyCode] Body param: Currency of the invoice (ISO 4217 currency code)
       #
-      # @param customer_address_recipient [String, nil] The recipient name at the customer address
+      # @param customer_address [String, nil] Body param: The address of the customer/buyer
       #
-      # @param customer_company_id [String, nil] Customer company ID. For Belgium this is the CBE number or their EUID (European
+      # @param customer_address_recipient [String, nil] Body param: The recipient name at the customer address
       #
-      # @param customer_email [String, nil] The email address of the customer
+      # @param customer_company_id [String, nil] Body param: Customer company ID. For Belgium this is the CBE number or their EUI
       #
-      # @param customer_id [String, nil] The unique identifier for the customer in your system
+      # @param customer_email [String, nil] Body param: The email address of the customer
       #
-      # @param customer_name [String, nil] The company name of the customer/buyer
+      # @param customer_id [String, nil] Body param: The unique identifier for the customer in your system
       #
-      # @param customer_tax_id [String, nil] Customer tax ID. For Belgium this is the VAT number. Must include the country pr
+      # @param customer_name [String, nil] Body param: The company name of the customer/buyer
       #
-      # @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection] The direction of the document: INBOUND (purchases) or OUTBOUND (sales)
+      # @param customer_peppol_id [String, nil] Body param: Customer Peppol ID
       #
-      # @param document_type [Symbol, EInvoiceAPI::Models::DocumentType] The type of document: INVOICE, CREDIT_NOTE, or DEBIT_NOTE
+      # @param customer_tax_id [String, nil] Body param: Customer tax ID. For Belgium this is the VAT number. Must include th
       #
-      # @param due_date [Date, nil] The date when payment is due
+      # @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection] Body param: The direction of the document: INBOUND (purchases) or OUTBOUND (sale
       #
-      # @param invoice_date [Date, nil] The date when the invoice was issued
+      # @param document_type [Symbol, EInvoiceAPI::Models::DocumentType] Body param: The type of document: INVOICE, CREDIT_NOTE, or DEBIT_NOTE
       #
-      # @param invoice_id [String, nil] The unique invoice identifier/number
+      # @param due_date [Date, nil] Body param: The date when payment is due
       #
-      # @param invoice_total [Float, String, nil] The total amount of the invoice including tax (invoice*total = subtotal + total*
+      # @param invoice_date [Date, nil] Body param: The date when the invoice was issued
       #
-      # @param items [Array<EInvoiceAPI::Models::DocumentCreate::Item>] At least one line item is required
+      # @param invoice_id [String, nil] Body param: The unique invoice identifier/number
       #
-      # @param note [String, nil] Additional notes or comments for the invoice
+      # @param invoice_total [Float, String, nil] Body param: The total amount of the invoice including tax (invoice_total = subto
       #
-      # @param payment_details [Array<EInvoiceAPI::Models::PaymentDetailCreate>, nil]
+      # @param items [Array<EInvoiceAPI::Models::DocumentCreate::Item>] Body param: At least one line item is required
       #
-      # @param payment_term [String, nil] The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')
+      # @param note [String, nil] Body param: Additional notes or comments for the invoice
       #
-      # @param previous_unpaid_balance [Float, String, nil] The previous unpaid balance from prior invoices, if any. Must be positive and ro
+      # @param payment_details [Array<EInvoiceAPI::Models::PaymentDetailCreate>, nil] Body param
       #
-      # @param purchase_order [String, nil] The purchase order reference number
+      # @param payment_term [String, nil] Body param: The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')
       #
-      # @param remittance_address [String, nil] The address where payment should be sent or remitted to
+      # @param previous_unpaid_balance [Float, String, nil] Body param: The previous unpaid balance from prior invoices, if any. Must be pos
       #
-      # @param remittance_address_recipient [String, nil] The recipient name at the remittance address
+      # @param purchase_order [String, nil] Body param: The purchase order reference number
       #
-      # @param service_address [String, nil] The address where services were performed or goods were delivered
+      # @param remittance_address [String, nil] Body param: The address where payment should be sent or remitted to
       #
-      # @param service_address_recipient [String, nil] The recipient name at the service address
+      # @param remittance_address_recipient [String, nil] Body param: The recipient name at the remittance address
       #
-      # @param service_end_date [Date, nil] The end date of the service period or delivery period
+      # @param service_address [String, nil] Body param: The address where services were performed or goods were delivered
       #
-      # @param service_start_date [Date, nil] The start date of the service period or delivery period
+      # @param service_address_recipient [String, nil] Body param: The recipient name at the service address
       #
-      # @param shipping_address [String, nil] The shipping/delivery address
+      # @param service_end_date [Date, nil] Body param: The end date of the service period or delivery period
       #
-      # @param shipping_address_recipient [String, nil] The recipient name at the shipping address
+      # @param service_start_date [Date, nil] Body param: The start date of the service period or delivery period
       #
-      # @param state [Symbol, EInvoiceAPI::Models::DocumentState] The current state of the document: DRAFT, TRANSIT, FAILED, SENT, or RECEIVED
+      # @param shipping_address [String, nil] Body param: The shipping/delivery address
       #
-      # @param subtotal [Float, String, nil] The taxable base of the invoice. Should be the sum of all line items - allowance
+      # @param shipping_address_recipient [String, nil] Body param: The recipient name at the shipping address
       #
-      # @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::TaxCode] Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E
+      # @param state [Symbol, EInvoiceAPI::Models::DocumentState] Body param: The current state of the document: DRAFT, TRANSIT, FAILED, SENT, or
       #
-      # @param tax_details [Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>, nil]
+      # @param subtotal [Float, String, nil] Body param: The taxable base of the invoice. Should be the sum of all line items
       #
-      # @param total_discount [Float, String, nil] The net financial discount/charge of the invoice (non-VAT charges minus non-VAT
+      # @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::TaxCode] Body param: Tax category code of the invoice (e.g., S for standard rate, Z for z
       #
-      # @param total_tax [Float, String, nil] The total tax amount of the invoice. Must be positive and rounded to maximum 2 d
+      # @param tax_details [Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>, nil] Body param
       #
-      # @param vatex [Symbol, EInvoiceAPI::Models::DocumentCreate::Vatex, nil] VATEX code list for VAT exemption reasons
+      # @param total_discount [Float, String, nil] Body param: The net financial discount/charge of the invoice (non-VAT charges mi
       #
-      # @param vatex_note [String, nil] Textual explanation for VAT exemption
+      # @param total_tax [Float, String, nil] Body param: The total tax amount of the invoice. Must be positive and rounded to
       #
-      # @param vendor_address [String, nil] The address of the vendor/seller
+      # @param vatex [Symbol, EInvoiceAPI::Models::DocumentCreate::Vatex, nil] Body param: VATEX code list for VAT exemption reasons
       #
-      # @param vendor_address_recipient [String, nil] The recipient name at the vendor address
+      # @param vatex_note [String, nil] Body param: Textual explanation for VAT exemption
       #
-      # @param vendor_company_id [String, nil] Vendor company ID. For Belgium this is the CBE number or their EUID (European Un
+      # @param vendor_address [String, nil] Body param: The address of the vendor/seller
       #
-      # @param vendor_email [String, nil] The email address of the vendor
+      # @param vendor_address_recipient [String, nil] Body param: The recipient name at the vendor address
       #
-      # @param vendor_name [String, nil] The name of the vendor/seller/supplier
+      # @param vendor_company_id [String, nil] Body param: Vendor company ID. For Belgium this is the CBE number or their EUID
       #
-      # @param vendor_tax_id [String, nil] Vendor tax ID. For Belgium this is the VAT number. Must include the country pref
+      # @param vendor_email [String, nil] Body param: The email address of the vendor
+      #
+      # @param vendor_name [String, nil] Body param: The name of the vendor/seller/supplier
+      #
+      # @param vendor_tax_id [String, nil] Body param: Vendor tax ID. For Belgium this is the VAT number. Must include the
       #
       # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -118,11 +122,14 @@ module EInvoiceAPI
       #
       # @see EInvoiceAPI::Models::DocumentCreateParams
       def create(params = {})
+        query_params = [:construct_pdf]
         parsed, options = EInvoiceAPI::DocumentCreateParams.dump_request(params)
+        query = EInvoiceAPI::Internal::Util.encode_query_params(parsed.slice(*query_params))
         @client.request(
           method: :post,
           path: "api/documents/",
-          body: parsed,
+          query: query,
+          body: parsed.except(*query_params),
           model: EInvoiceAPI::DocumentResponse,
           options: options
         )
@@ -200,7 +207,12 @@ module EInvoiceAPI
         )
       end
 
-      # Send an invoice or credit note via Peppol
+      # Send an invoice or credit note via Peppol. By default, the sender and receiver
+      # Peppol IDs are derived from the company (tax) IDs in the document, regardless of
+      # whether the document was created from a UBL with a different endpoint ID. To
+      # explicitly set the sender or receiver Peppol ID, provide them via the query
+      # parameters (sender_peppol_scheme, sender_peppol_id, receiver_peppol_scheme,
+      # receiver_peppol_id).
       #
       # @overload send_(document_id, email: nil, receiver_peppol_id: nil, receiver_peppol_scheme: nil, sender_peppol_id: nil, sender_peppol_scheme: nil, request_options: {})
       #

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, type: nil, request_options: {})
       #
       # @param date_from [Time, nil] Filter by issue date (from)
       #
@@ -18,11 +18,13 @@ 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 state [Symbol, EInvoiceAPI::Models::DocumentState, nil] Filter by document state
+      # @param sort_by [Symbol, EInvoiceAPI::Models::InboxListParams::SortBy] Field to sort by
       #
-      # @param type [Symbol, EInvoiceAPI::Models::DocumentType, nil] Filter by document type
+      # @param sort_order [Symbol, EInvoiceAPI::Models::InboxListParams::SortOrder] Sort direction (asc/desc)
+      #
+      # @param type [Symbol, EInvoiceAPI::Models::DocumentType, nil] Filter by document type. If not provided, returns all types.
       #
       # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -44,12 +46,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>]
@@ -70,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>]

data/lib/e_invoice_api/resources/outbox.rb

@@ -3,14 +3,27 @@
 module EInvoiceAPI
   module Resources
     class Outbox
-      # Retrieve a paginated list of draft documents with filtering options.
+      # @deprecated
       #
-      # @overload list_draft_documents(page: nil, page_size: nil, request_options: {})
+      # Retrieve a paginated list of draft documents with filtering options including
+      # state and text search.
+      #
+      # @overload list_draft_documents(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}, nil]
       #
       # @return [EInvoiceAPI::Internal::DocumentsNumberPage<EInvoiceAPI::Models::DocumentResponse>]
@@ -29,10 +42,13 @@ module EInvoiceAPI
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {EInvoiceAPI::Models::OutboxListReceivedDocumentsParams} for more details.
+      #
       # Retrieve a paginated list of sent documents with filtering options including
       # state, type, sender, date range, and text search.
       #
-      # @overload list_received_documents(date_from: nil, date_to: nil, page: nil, page_size: nil, search: nil, sender: nil, state: nil, type: nil, request_options: {})
+      # @overload list_received_documents(date_from: nil, date_to: nil, page: nil, page_size: nil, receiver: nil, search: nil, sender: nil, sort_by: nil, sort_order: nil, type: nil, request_options: {})
       #
       # @param date_from [Time, nil] Filter by issue date (from)
       #
@@ -42,13 +58,17 @@ 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 state [Symbol, EInvoiceAPI::Models::DocumentState, nil] Filter by document state
+      # @param sort_by [Symbol, EInvoiceAPI::Models::OutboxListReceivedDocumentsParams::SortBy] Field to sort by
       #
-      # @param type [Symbol, EInvoiceAPI::Models::DocumentType, nil] Filter by document type
+      # @param sort_order [Symbol, EInvoiceAPI::Models::OutboxListReceivedDocumentsParams::SortOrder] Sort direction (asc/desc)
+      #
+      # @param type [Symbol, EInvoiceAPI::Models::DocumentType, nil] Filter by document type. If not provided, returns all types.
       #
       # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/e_invoice_api/resources/validate.rb

@@ -8,7 +8,7 @@ module EInvoiceAPI
       #
       # Validate if the JSON document can be converted to a valid UBL document
       #
-      # @overload validate_json(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, previous_unpaid_balance: 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, request_options: {})
+      # @overload validate_json(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_peppol_id: 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, previous_unpaid_balance: 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, request_options: {})
       #
       # @param allowances [Array<EInvoiceAPI::Models::DocumentCreate::Allowance>, nil]
       #
@@ -36,6 +36,8 @@ module EInvoiceAPI
       #
       # @param customer_name [String, nil] The company name of the customer/buyer
       #
+      # @param customer_peppol_id [String, nil] Customer Peppol ID
+      #
       # @param customer_tax_id [String, nil] Customer tax ID. For Belgium this is the VAT number. Must include the country pr
       #
       # @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection] The direction of the document: INBOUND (purchases) or OUTBOUND (sales)

data/lib/e_invoice_api/version.rb

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

data/rbi/e_invoice_api/models/document_create.rbi

@@ -67,6 +67,10 @@ module EInvoiceAPI
       sig { returns(T.nilable(String)) }
       attr_accessor :customer_name
 
+      # Customer Peppol ID
+      sig { returns(T.nilable(String)) }
+      attr_accessor :customer_peppol_id
+
       # Customer tax ID. For Belgium this is the VAT number. Must include the country
       # prefix
       sig { returns(T.nilable(String)) }
@@ -272,6 +276,7 @@ module EInvoiceAPI
           customer_email: T.nilable(String),
           customer_id: T.nilable(String),
           customer_name: T.nilable(String),
+          customer_peppol_id: T.nilable(String),
           customer_tax_id: T.nilable(String),
           direction: EInvoiceAPI::DocumentDirection::OrSymbol,
           document_type: EInvoiceAPI::DocumentType::OrSymbol,
@@ -341,6 +346,8 @@ module EInvoiceAPI
         customer_id: nil,
         # The company name of the customer/buyer
         customer_name: nil,
+        # Customer Peppol ID
+        customer_peppol_id: nil,
         # Customer tax ID. For Belgium this is the VAT number. Must include the country
         # prefix
         customer_tax_id: nil,
@@ -444,6 +451,7 @@ module EInvoiceAPI
             customer_email: T.nilable(String),
             customer_id: T.nilable(String),
             customer_name: T.nilable(String),
+            customer_peppol_id: T.nilable(String),
             customer_tax_id: T.nilable(String),
             direction: EInvoiceAPI::DocumentDirection::OrSymbol,
             document_type: EInvoiceAPI::DocumentType::OrSymbol,

data/rbi/e_invoice_api/models/document_create_from_pdf_response.rbi

@@ -66,6 +66,10 @@ module EInvoiceAPI
       sig { returns(T.nilable(String)) }
       attr_accessor :customer_name
 
+      # Customer Peppol ID
+      sig { returns(T.nilable(String)) }
+      attr_accessor :customer_peppol_id
+
       # Customer tax ID. For Belgium this is the VAT number. Must include the country
       # prefix
       sig { returns(T.nilable(String)) }
@@ -292,6 +296,7 @@ module EInvoiceAPI
           customer_email: T.nilable(String),
           customer_id: T.nilable(String),
           customer_name: T.nilable(String),
+          customer_peppol_id: T.nilable(String),
           customer_tax_id: T.nilable(String),
           direction: EInvoiceAPI::DocumentDirection::OrSymbol,
           document_type: EInvoiceAPI::DocumentType::OrSymbol,
@@ -368,6 +373,8 @@ module EInvoiceAPI
         customer_id: nil,
         # The company name of the customer/buyer
         customer_name: nil,
+        # Customer Peppol ID
+        customer_peppol_id: nil,
         # Customer tax ID. For Belgium this is the VAT number. Must include the country
         # prefix
         customer_tax_id: nil,
@@ -470,6 +477,7 @@ module EInvoiceAPI
             customer_email: T.nilable(String),
             customer_id: T.nilable(String),
             customer_name: T.nilable(String),
+            customer_peppol_id: T.nilable(String),
             customer_tax_id: T.nilable(String),
             direction: EInvoiceAPI::DocumentDirection::TaggedSymbol,
             document_type: EInvoiceAPI::DocumentType::TaggedSymbol,

data/rbi/e_invoice_api/models/document_create_params.rbi

@@ -14,15 +14,36 @@ module EInvoiceAPI
           )
         end
 
+      # If true, generate a constructed PDF from the document and include it both as
+      # document attachment and embedded in the UBL.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :construct_pdf
+
+      sig { params(construct_pdf: T::Boolean).void }
+      attr_writer :construct_pdf
+
       sig do
-        params(request_options: EInvoiceAPI::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          construct_pdf: T::Boolean,
+          request_options: EInvoiceAPI::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(
+        # If true, generate a constructed PDF from the document and include it both as
+        # document attachment and embedded in the UBL.
+        construct_pdf: nil,
+        request_options: {}
+      )
       end
 
-      sig { override.returns({ request_options: EInvoiceAPI::RequestOptions }) }
+      sig do
+        override.returns(
+          {
+            construct_pdf: T::Boolean,
+            request_options: EInvoiceAPI::RequestOptions
+          }
+        )
+      end
       def to_hash
       end
     end