e-invoice-api 0.16.2 → 0.18.0

data/rbi/e_invoice_api/models/outbox_list_draft_documents_params.rbi

@@ -28,10 +28,64 @@ module EInvoiceAPI
       sig { params(page_size: Integer).void }
       attr_writer :page_size
 
+      # Search in invoice number, seller/buyer names
+      sig { returns(T.nilable(String)) }
+      attr_accessor :search
+
+      # Field to sort by
+      sig do
+        returns(
+          T.nilable(
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::OrSymbol
+          )
+        )
+      end
+      attr_reader :sort_by
+
+      sig do
+        params(
+          sort_by: EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::OrSymbol
+        ).void
+      end
+      attr_writer :sort_by
+
+      # Sort direction (asc/desc)
+      sig do
+        returns(
+          T.nilable(
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortOrder::OrSymbol
+          )
+        )
+      end
+      attr_reader :sort_order
+
+      sig do
+        params(
+          sort_order:
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortOrder::OrSymbol
+        ).void
+      end
+      attr_writer :sort_order
+
+      # Filter by document state
+      sig { returns(T.nilable(EInvoiceAPI::DocumentState::OrSymbol)) }
+      attr_accessor :state
+
+      # Filter by document type
+      sig { returns(T.nilable(EInvoiceAPI::DocumentType::OrSymbol)) }
+      attr_accessor :type
+
       sig do
         params(
           page: Integer,
           page_size: Integer,
+          search: T.nilable(String),
+          sort_by:
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::OrSymbol,
+          sort_order:
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortOrder::OrSymbol,
+          state: T.nilable(EInvoiceAPI::DocumentState::OrSymbol),
+          type: T.nilable(EInvoiceAPI::DocumentType::OrSymbol),
           request_options: EInvoiceAPI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -40,6 +94,16 @@ module EInvoiceAPI
         page: nil,
         # Number of items per page
         page_size: nil,
+        # Search in invoice number, seller/buyer names
+        search: nil,
+        # Field to sort by
+        sort_by: nil,
+        # Sort direction (asc/desc)
+        sort_order: nil,
+        # Filter by document state
+        state: nil,
+        # Filter by document type
+        type: nil,
         request_options: {}
       )
       end
@@ -49,12 +113,111 @@ module EInvoiceAPI
           {
             page: Integer,
             page_size: Integer,
+            search: T.nilable(String),
+            sort_by:
+              EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::OrSymbol,
+            sort_order:
+              EInvoiceAPI::OutboxListDraftDocumentsParams::SortOrder::OrSymbol,
+            state: T.nilable(EInvoiceAPI::DocumentState::OrSymbol),
+            type: T.nilable(EInvoiceAPI::DocumentType::OrSymbol),
             request_options: EInvoiceAPI::RequestOptions
           }
         )
       end
       def to_hash
       end
+
+      # Field to sort by
+      module SortBy
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        CREATED_AT =
+          T.let(
+            :created_at,
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::TaggedSymbol
+          )
+        INVOICE_DATE =
+          T.let(
+            :invoice_date,
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::TaggedSymbol
+          )
+        DUE_DATE =
+          T.let(
+            :due_date,
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::TaggedSymbol
+          )
+        INVOICE_TOTAL =
+          T.let(
+            :invoice_total,
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::TaggedSymbol
+          )
+        CUSTOMER_NAME =
+          T.let(
+            :customer_name,
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::TaggedSymbol
+          )
+        VENDOR_NAME =
+          T.let(
+            :vendor_name,
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::TaggedSymbol
+          )
+        INVOICE_ID =
+          T.let(
+            :invoice_id,
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Sort direction (asc/desc)
+      module SortOrder
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              EInvoiceAPI::OutboxListDraftDocumentsParams::SortOrder
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ASC =
+          T.let(
+            :asc,
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortOrder::TaggedSymbol
+          )
+        DESC =
+          T.let(
+            :desc,
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortOrder::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              EInvoiceAPI::OutboxListDraftDocumentsParams::SortOrder::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/e_invoice_api/models/outbox_list_received_documents_params.rbi

@@ -36,14 +36,55 @@ module EInvoiceAPI
       sig { params(page_size: Integer).void }
       attr_writer :page_size
 
+      # Filter by receiver (customer_name, customer_email, customer_tax_id,
+      # customer_company_id, customer_id)
+      sig { returns(T.nilable(String)) }
+      attr_accessor :receiver
+
       # Search in invoice number, seller/buyer names
       sig { returns(T.nilable(String)) }
       attr_accessor :search
 
-      # Filter by sender ID
+      # (Deprecated) Filter by sender ID
       sig { returns(T.nilable(String)) }
       attr_accessor :sender
 
+      # Field to sort by
+      sig do
+        returns(
+          T.nilable(
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::OrSymbol
+          )
+        )
+      end
+      attr_reader :sort_by
+
+      sig do
+        params(
+          sort_by:
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::OrSymbol
+        ).void
+      end
+      attr_writer :sort_by
+
+      # Sort direction (asc/desc)
+      sig do
+        returns(
+          T.nilable(
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortOrder::OrSymbol
+          )
+        )
+      end
+      attr_reader :sort_order
+
+      sig do
+        params(
+          sort_order:
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortOrder::OrSymbol
+        ).void
+      end
+      attr_writer :sort_order
+
       # Filter by document state
       sig { returns(T.nilable(EInvoiceAPI::DocumentState::OrSymbol)) }
       attr_accessor :state
@@ -58,8 +99,13 @@ module EInvoiceAPI
           date_to: T.nilable(Time),
           page: Integer,
           page_size: Integer,
+          receiver: T.nilable(String),
           search: T.nilable(String),
           sender: T.nilable(String),
+          sort_by:
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::OrSymbol,
+          sort_order:
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortOrder::OrSymbol,
           state: T.nilable(EInvoiceAPI::DocumentState::OrSymbol),
           type: T.nilable(EInvoiceAPI::DocumentType::OrSymbol),
           request_options: EInvoiceAPI::RequestOptions::OrHash
@@ -74,10 +120,17 @@ module EInvoiceAPI
         page: nil,
         # Number of items per page
         page_size: nil,
+        # Filter by receiver (customer_name, customer_email, customer_tax_id,
+        # customer_company_id, customer_id)
+        receiver: nil,
         # Search in invoice number, seller/buyer names
         search: nil,
-        # Filter by sender ID
+        # (Deprecated) Filter by sender ID
         sender: nil,
+        # Field to sort by
+        sort_by: nil,
+        # Sort direction (asc/desc)
+        sort_order: nil,
         # Filter by document state
         state: nil,
         # Filter by document type
@@ -93,8 +146,13 @@ module EInvoiceAPI
             date_to: T.nilable(Time),
             page: Integer,
             page_size: Integer,
+            receiver: T.nilable(String),
             search: T.nilable(String),
             sender: T.nilable(String),
+            sort_by:
+              EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::OrSymbol,
+            sort_order:
+              EInvoiceAPI::OutboxListReceivedDocumentsParams::SortOrder::OrSymbol,
             state: T.nilable(EInvoiceAPI::DocumentState::OrSymbol),
             type: T.nilable(EInvoiceAPI::DocumentType::OrSymbol),
             request_options: EInvoiceAPI::RequestOptions
@@ -103,6 +161,101 @@ module EInvoiceAPI
       end
       def to_hash
       end
+
+      # Field to sort by
+      module SortBy
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        CREATED_AT =
+          T.let(
+            :created_at,
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::TaggedSymbol
+          )
+        INVOICE_DATE =
+          T.let(
+            :invoice_date,
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::TaggedSymbol
+          )
+        DUE_DATE =
+          T.let(
+            :due_date,
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::TaggedSymbol
+          )
+        INVOICE_TOTAL =
+          T.let(
+            :invoice_total,
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::TaggedSymbol
+          )
+        CUSTOMER_NAME =
+          T.let(
+            :customer_name,
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::TaggedSymbol
+          )
+        VENDOR_NAME =
+          T.let(
+            :vendor_name,
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::TaggedSymbol
+          )
+        INVOICE_ID =
+          T.let(
+            :invoice_id,
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Sort direction (asc/desc)
+      module SortOrder
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              EInvoiceAPI::OutboxListReceivedDocumentsParams::SortOrder
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ASC =
+          T.let(
+            :asc,
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortOrder::TaggedSymbol
+          )
+        DESC =
+          T.let(
+            :desc,
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortOrder::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              EInvoiceAPI::OutboxListReceivedDocumentsParams::SortOrder::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/e_invoice_api/models/paginated_document_response.rbi

@@ -11,6 +11,9 @@ module EInvoiceAPI
           )
         end
 
+      sig { returns(T::Boolean) }
+      attr_accessor :has_next_page
+
       sig { returns(T::Array[EInvoiceAPI::DocumentResponse]) }
       attr_accessor :items
 
@@ -28,6 +31,7 @@ module EInvoiceAPI
 
       sig do
         params(
+          has_next_page: T::Boolean,
           items: T::Array[EInvoiceAPI::DocumentResponse::OrHash],
           page: Integer,
           page_size: Integer,
@@ -35,12 +39,13 @@ module EInvoiceAPI
           total: Integer
         ).returns(T.attached_class)
       end
-      def self.new(items:, page:, page_size:, pages:, total:)
+      def self.new(has_next_page:, items:, page:, page_size:, pages:, total:)
       end
 
       sig do
         override.returns(
           {
+            has_next_page: T::Boolean,
             items: T::Array[EInvoiceAPI::DocumentResponse],
             page: Integer,
             page_size: Integer,

data/rbi/e_invoice_api/resources/documents/attachments.rbi

@@ -37,8 +37,10 @@ module EInvoiceAPI
         def delete(attachment_id, document_id:, request_options: {})
         end
 
-        # 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
         sig do
           params(
             document_id: String,

data/rbi/e_invoice_api/resources/documents.rbi

@@ -218,11 +218,11 @@ module EInvoiceAPI
         ).returns(EInvoiceAPI::Models::DocumentCreateFromPdfResponse)
       end
       def create_from_pdf(
-        # Body param:
+        # Body param
         file:,
-        # Query param:
+        # Query param
         customer_tax_id: nil,
-        # Query param:
+        # Query param
         vendor_tax_id: nil,
         request_options: {}
       )

data/rbi/e_invoice_api/resources/inbox.rbi

@@ -13,6 +13,8 @@ module EInvoiceAPI
           page_size: Integer,
           search: T.nilable(String),
           sender: T.nilable(String),
+          sort_by: EInvoiceAPI::InboxListParams::SortBy::OrSymbol,
+          sort_order: EInvoiceAPI::InboxListParams::SortOrder::OrSymbol,
           state: T.nilable(EInvoiceAPI::DocumentState::OrSymbol),
           type: T.nilable(EInvoiceAPI::DocumentType::OrSymbol),
           request_options: EInvoiceAPI::RequestOptions::OrHash
@@ -33,8 +35,12 @@ module EInvoiceAPI
         page_size: nil,
         # Search in invoice number, seller/buyer names
         search: nil,
-        # Filter by sender ID
+        # Filter by sender (vendor_name, vendor_email, vendor_tax_id, vendor_company_id)
         sender: nil,
+        # Field to sort by
+        sort_by: nil,
+        # Sort direction (asc/desc)
+        sort_order: nil,
         # Filter by document state
         state: nil,
         # Filter by document type
@@ -48,6 +54,9 @@ module EInvoiceAPI
         params(
           page: Integer,
           page_size: Integer,
+          sort_by: EInvoiceAPI::InboxListCreditNotesParams::SortBy::OrSymbol,
+          sort_order:
+            EInvoiceAPI::InboxListCreditNotesParams::SortOrder::OrSymbol,
           request_options: EInvoiceAPI::RequestOptions::OrHash
         ).returns(
           EInvoiceAPI::Internal::DocumentsNumberPage[
@@ -60,6 +69,10 @@ module EInvoiceAPI
         page: nil,
         # Number of items per page
         page_size: nil,
+        # Field to sort by
+        sort_by: nil,
+        # Sort direction (asc/desc)
+        sort_order: nil,
         request_options: {}
       )
       end
@@ -69,6 +82,8 @@ module EInvoiceAPI
         params(
           page: Integer,
           page_size: Integer,
+          sort_by: EInvoiceAPI::InboxListInvoicesParams::SortBy::OrSymbol,
+          sort_order: EInvoiceAPI::InboxListInvoicesParams::SortOrder::OrSymbol,
           request_options: EInvoiceAPI::RequestOptions::OrHash
         ).returns(
           EInvoiceAPI::Internal::DocumentsNumberPage[
@@ -81,6 +96,10 @@ module EInvoiceAPI
         page: nil,
         # Number of items per page
         page_size: nil,
+        # Field to sort by
+        sort_by: nil,
+        # Sort direction (asc/desc)
+        sort_order: nil,
         request_options: {}
       )
       end

data/rbi/e_invoice_api/resources/outbox.rbi

@@ -3,11 +3,19 @@
 module EInvoiceAPI
   module Resources
     class Outbox
-      # Retrieve a paginated list of draft documents with filtering options.
+      # Retrieve a paginated list of draft documents with filtering options including
+      # state and text search.
       sig do
         params(
           page: Integer,
           page_size: Integer,
+          search: T.nilable(String),
+          sort_by:
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortBy::OrSymbol,
+          sort_order:
+            EInvoiceAPI::OutboxListDraftDocumentsParams::SortOrder::OrSymbol,
+          state: T.nilable(EInvoiceAPI::DocumentState::OrSymbol),
+          type: T.nilable(EInvoiceAPI::DocumentType::OrSymbol),
           request_options: EInvoiceAPI::RequestOptions::OrHash
         ).returns(
           EInvoiceAPI::Internal::DocumentsNumberPage[
@@ -20,6 +28,16 @@ module EInvoiceAPI
         page: nil,
         # Number of items per page
         page_size: nil,
+        # Search in invoice number, seller/buyer names
+        search: nil,
+        # Field to sort by
+        sort_by: nil,
+        # Sort direction (asc/desc)
+        sort_order: nil,
+        # Filter by document state
+        state: nil,
+        # Filter by document type
+        type: nil,
         request_options: {}
       )
       end
@@ -32,8 +50,13 @@ module EInvoiceAPI
           date_to: T.nilable(Time),
           page: Integer,
           page_size: Integer,
+          receiver: T.nilable(String),
           search: T.nilable(String),
           sender: T.nilable(String),
+          sort_by:
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortBy::OrSymbol,
+          sort_order:
+            EInvoiceAPI::OutboxListReceivedDocumentsParams::SortOrder::OrSymbol,
           state: T.nilable(EInvoiceAPI::DocumentState::OrSymbol),
           type: T.nilable(EInvoiceAPI::DocumentType::OrSymbol),
           request_options: EInvoiceAPI::RequestOptions::OrHash
@@ -52,10 +75,17 @@ module EInvoiceAPI
         page: nil,
         # Number of items per page
         page_size: nil,
+        # Filter by receiver (customer_name, customer_email, customer_tax_id,
+        # customer_company_id, customer_id)
+        receiver: nil,
         # Search in invoice number, seller/buyer names
         search: nil,
-        # Filter by sender ID
+        # (Deprecated) Filter by sender ID
         sender: nil,
+        # Field to sort by
+        sort_by: nil,
+        # Sort direction (asc/desc)
+        sort_order: nil,
         # Filter by document state
         state: nil,
         # Filter by document type

data/sig/e_invoice_api/models/document_response.rbs

@@ -3,6 +3,7 @@ module EInvoiceAPI
     type document_response =
       {
         id: String,
+        created_at: Time,
         allowances: ::Array[EInvoiceAPI::DocumentResponse::Allowance]?,
         amount_due: String?,
         attachments: ::Array[EInvoiceAPI::Documents::DocumentAttachment]?,
@@ -55,6 +56,8 @@ module EInvoiceAPI
     class DocumentResponse < EInvoiceAPI::Internal::Type::BaseModel
       attr_accessor id: String
 
+      attr_accessor created_at: Time
+
       attr_accessor allowances: ::Array[EInvoiceAPI::DocumentResponse::Allowance]?
 
       attr_accessor amount_due: String?
@@ -171,6 +174,7 @@ module EInvoiceAPI
 
       def initialize: (
         id: String,
+        created_at: Time,
         ?allowances: ::Array[EInvoiceAPI::DocumentResponse::Allowance]?,
         ?amount_due: String?,
         ?attachments: ::Array[EInvoiceAPI::Documents::DocumentAttachment]?,
@@ -222,6 +226,7 @@ module EInvoiceAPI
 
       def to_hash: -> {
         id: String,
+        created_at: Time,
         allowances: ::Array[EInvoiceAPI::DocumentResponse::Allowance]?,
         amount_due: String?,
         attachments: ::Array[EInvoiceAPI::Documents::DocumentAttachment]?,

data/sig/e_invoice_api/models/document_type.rbs

@@ -1,6 +1,11 @@
 module EInvoiceAPI
   module Models
-    type document_type = :INVOICE | :CREDIT_NOTE | :DEBIT_NOTE
+    type document_type =
+      :INVOICE
+      | :CREDIT_NOTE
+      | :DEBIT_NOTE
+      | :SELFBILLING_INVOICE
+      | :SELFBILLING_CREDIT_NOTE
 
     module DocumentType
       extend EInvoiceAPI::Internal::Type::Enum
@@ -8,6 +13,8 @@ module EInvoiceAPI
       INVOICE: :INVOICE
       CREDIT_NOTE: :CREDIT_NOTE
       DEBIT_NOTE: :DEBIT_NOTE
+      SELFBILLING_INVOICE: :SELFBILLING_INVOICE
+      SELFBILLING_CREDIT_NOTE: :SELFBILLING_CREDIT_NOTE
 
       def self?.values: -> ::Array[EInvoiceAPI::Models::document_type]
     end