e-invoice-api 0.32.0 → 0.34.0

data/lib/e_invoice_api/resources/mailbox.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Resources
+    class Mailbox
+      # Some parameter documentations has been truncated, see
+      # {EInvoiceAPI::Models::MailboxListParams} for more details.
+      #
+      # Retrieve a paginated list of received inbound emails with filtering, search, and
+      # sorting options.
+      #
+      # @overload list(page: nil, page_size: nil, processed: nil, received_from: nil, received_to: nil, search: nil, sort_by: nil, sort_order: nil, status: nil, request_options: {})
+      #
+      # @param page [Integer] Page number
+      #
+      # @param page_size [Integer] Number of items per page
+      #
+      # @param processed [Boolean, nil] Filter by processing status. If not provided, returns all. Ignored when `status`
+      #
+      # @param received_from [Time, nil] Inclusive lower bound on received date (falls back to created_at when received_a
+      #
+      # @param received_to [Time, nil] Inclusive upper bound on received date (falls back to created_at when received_a
+      #
+      # @param search [String, nil] Case-insensitive search across sender email, subject, message ID, and attachment
+      #
+      # @param sort_by [Symbol, EInvoiceAPI::Models::MailboxListParams::SortBy] Field to sort by
+      #
+      # @param sort_order [Symbol, EInvoiceAPI::Models::MailboxListParams::SortOrder] Sort direction (asc/desc)
+      #
+      # @param status [Symbol, EInvoiceAPI::Models::MailboxListParams::Status, nil] Filter by status: pending, success, or failed. Takes precedence over `processed`
+      #
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [EInvoiceAPI::Internal::DocumentsNumberPage<EInvoiceAPI::Models::InboundEmailResponse>]
+      #
+      # @see EInvoiceAPI::Models::MailboxListParams
+      def list(params = {})
+        parsed, options = EInvoiceAPI::MailboxListParams.dump_request(params)
+        query = EInvoiceAPI::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "api/mailbox/",
+          query: query,
+          page: EInvoiceAPI::Internal::DocumentsNumberPage,
+          model: EInvoiceAPI::InboundEmailResponse,
+          options: options
+        )
+      end
+
+      # Retrieve a single inbound email by ID, scoped to the caller's tenant.
+      #
+      # @overload retrieve(inbound_email_id, request_options: {})
+      #
+      # @param inbound_email_id [String]
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [EInvoiceAPI::Models::InboundEmailResponse]
+      #
+      # @see EInvoiceAPI::Models::MailboxRetrieveParams
+      def retrieve(inbound_email_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["api/mailbox/%1$s", inbound_email_id],
+          model: EInvoiceAPI::InboundEmailResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Download a specific attachment from an inbound email by filename. Returns the
+      # binary content with the correct Content-Type.
+      #
+      # @overload download_attachment(filename, inbound_email_id:, request_options: {})
+      #
+      # @param filename [String]
+      # @param inbound_email_id [String]
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Object]
+      #
+      # @see EInvoiceAPI::Models::MailboxDownloadAttachmentParams
+      def download_attachment(filename, params)
+        parsed, options = EInvoiceAPI::MailboxDownloadAttachmentParams.dump_request(params)
+        inbound_email_id =
+          parsed.delete(:inbound_email_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :get,
+          path: ["api/mailbox/%1$s/attachments/%2$s", inbound_email_id, filename],
+          model: EInvoiceAPI::Internal::Type::Unknown,
+          options: options
+        )
+      end
+
+      # Retry processing of a previously failed inbound email by replaying the original
+      # Postmark payload.
+      #
+      # @overload reprocess(inbound_email_id, request_options: {})
+      #
+      # @param inbound_email_id [String]
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [EInvoiceAPI::Models::InboundEmailResponse]
+      #
+      # @see EInvoiceAPI::Models::MailboxReprocessParams
+      def reprocess(inbound_email_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["api/mailbox/%1$s/reprocess", inbound_email_id],
+          model: EInvoiceAPI::InboundEmailResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [EInvoiceAPI::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/e_invoice_api/resources/stats.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Resources
+    class Stats
+      # Some parameter documentations has been truncated, see
+      # {EInvoiceAPI::Models::StatsRetrieveParams} for more details.
+      #
+      # Retrieve usage statistics for billing purposes. Returns statistics for document
+      # sent and document received actions, grouped by aggregation period
+      # (day/week/month). If no date parameters are provided, returns daily stats for
+      # all available data.
+      #
+      # @overload retrieve(aggregation: nil, end_date: nil, start_date: nil, request_options: {})
+      #
+      # @param aggregation [Symbol, EInvoiceAPI::Models::StatsRetrieveParams::Aggregation, nil] Aggregation type: DAY, WEEK, or MONTH. Defaults to DAY.
+      #
+      # @param end_date [Date, nil] End date in yyyy-mm-dd format. If not provided, queries to latest available data
+      #
+      # @param start_date [Date, nil] Start date in yyyy-mm-dd format. If not provided, queries from earliest availabl
+      #
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [EInvoiceAPI::Models::StatsRetrieveResponse]
+      #
+      # @see EInvoiceAPI::Models::StatsRetrieveParams
+      def retrieve(params = {})
+        parsed, options = EInvoiceAPI::StatsRetrieveParams.dump_request(params)
+        query = EInvoiceAPI::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "api/stats",
+          query: query,
+          model: EInvoiceAPI::Models::StatsRetrieveResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [EInvoiceAPI::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/e_invoice_api/resources/validate.rb

@@ -6,9 +6,11 @@ module EInvoiceAPI
       # Some parameter documentations has been truncated, see
       # {EInvoiceAPI::Models::ValidateValidateJsonParams} for more details.
       #
-      # Validate if the JSON document can be converted to a valid UBL document
+      # Validate if the JSON document can be converted to a valid UBL document. The
+      # generated UBL is returned in ubl_document also when is_valid is false, so you
+      # can inspect it.
       #
-      # @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: {})
+      # @overload validate_json(allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, buyer_reference: 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_phone: 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, preceding_invoice_date: nil, preceding_invoice_id: nil, previous_unpaid_balance: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, rounding_amount: nil, sales_order: 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_currency: nil, tax_details: nil, total_discount: nil, total_tax: nil, total_tax_in_tax_currency: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_company_id: nil, vendor_email: nil, vendor_name: nil, vendor_phone: nil, vendor_tax_id: nil, request_options: {})
       #
       # @param allowances [Array<EInvoiceAPI::Models::DocumentCreate::Allowance>, nil]
       #
@@ -20,6 +22,8 @@ module EInvoiceAPI
       #
       # @param billing_address_recipient [String, nil] The recipient name at the billing address
       #
+      # @param buyer_reference [String, nil] The buyer reference (BT-10), e.g. a cost centre or accounting reference requeste
+      #
       # @param charges [Array<EInvoiceAPI::Models::DocumentCreate::Charge>, nil]
       #
       # @param currency [Symbol, EInvoiceAPI::Models::CurrencyCode] Currency of the invoice (ISO 4217 currency code)
@@ -38,6 +42,8 @@ module EInvoiceAPI
       #
       # @param customer_peppol_id [String, nil] Customer Peppol ID
       #
+      # @param customer_phone [String, nil] The telephone number of the customer contact (BT-57)
+      #
       # @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)
@@ -60,6 +66,10 @@ module EInvoiceAPI
       #
       # @param payment_term [String, nil] The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')
       #
+      # @param preceding_invoice_date [Date, nil] The preceding invoice issue date (BT-26)
+      #
+      # @param preceding_invoice_id [String, nil] The preceding invoice reference (BT-25): the number of the invoice this document
+      #
       # @param previous_unpaid_balance [Float, String, nil] The previous unpaid balance from prior invoices, if any. Must be positive and ro
       #
       # @param purchase_order [String, nil] The purchase order reference number
@@ -68,6 +78,10 @@ module EInvoiceAPI
       #
       # @param remittance_address_recipient [String, nil] The recipient name at the remittance address
       #
+      # @param rounding_amount [Float, String, nil] The amount added to the invoice total to round the amount for payment (BT-114),
+      #
+      # @param sales_order [String, nil] The sales order reference (BT-14) assigned by the seller
+      #
       # @param service_address [String, nil] The address where services were performed or goods were delivered
       #
       # @param service_address_recipient [String, nil] The recipient name at the service address
@@ -86,12 +100,16 @@ module EInvoiceAPI
       #
       # @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 tax_currency [String, nil] The VAT accounting currency (BT-6, ISO 4217 currency code), when VAT is accounte
+      #
       # @param tax_details [Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>, nil]
       #
       # @param total_discount [Float, String, nil] The net financial discount/charge of the invoice (non-VAT charges minus non-VAT
       #
       # @param total_tax [Float, String, nil] The total tax amount of the invoice. Must be positive and rounded to maximum 2 d
       #
+      # @param total_tax_in_tax_currency [Float, String, nil] The total VAT amount in the VAT accounting currency tax_currency (BT-111). Does
+      #
       # @param vatex [Symbol, EInvoiceAPI::Models::DocumentCreate::Vatex, nil] VATEX code list for VAT exemption reasons
       #
       # @param vatex_note [String, nil] Textual explanation for VAT exemption
@@ -106,6 +124,8 @@ module EInvoiceAPI
       #
       # @param vendor_name [String, nil] The name of the vendor/seller/supplier
       #
+      # @param vendor_phone [String, nil] The telephone number of the vendor contact (BT-42). Required when vendor and cus
+      #
       # @param vendor_tax_id [String, nil] Vendor tax ID. For Belgium this is the VAT number. Must include the country pref
       #
       # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/e_invoice_api/resources/webhooks.rb

@@ -106,6 +106,51 @@ module EInvoiceAPI
         )
       end
 
+      # Get the history of a webhook
+      #
+      # @overload history(webhook_id, request_options: {})
+      #
+      # @param webhook_id [String]
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [EInvoiceAPI::Models::WebhookHistoryResponse]
+      #
+      # @see EInvoiceAPI::Models::WebhookHistoryParams
+      def history(webhook_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["api/webhooks/%1$s/history", webhook_id],
+          model: EInvoiceAPI::Models::WebhookHistoryResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Send a test event to a webhook for testing and debugging purposes
+      #
+      # @overload test_(webhook_id, data:, event_type:, request_options: {})
+      #
+      # @param webhook_id [String]
+      #
+      # @param data [Hash{Symbol=>Object}] Custom event data payload
+      #
+      # @param event_type [String] Must be valid WebhookEventType
+      #
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [EInvoiceAPI::Models::WebhookTestResponse]
+      #
+      # @see EInvoiceAPI::Models::WebhookTestParams
+      def test_(webhook_id, params)
+        parsed, options = EInvoiceAPI::WebhookTestParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["api/webhooks/%1$s/test", webhook_id],
+          body: parsed,
+          model: EInvoiceAPI::Models::WebhookTestResponse,
+          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.32.0"
+  VERSION = "0.34.0"
 end

data/lib/e_invoice_api.rb

@@ -57,6 +57,10 @@ require_relative "e_invoice_api/models/document_create"
 require_relative "e_invoice_api/models/allowance"
 require_relative "e_invoice_api/models/certificate"
 require_relative "e_invoice_api/models/charge"
+require_relative "e_invoice_api/models/conversion/document_create_from_pdf_task"
+require_relative "e_invoice_api/models/conversion/pdf_create_params"
+require_relative "e_invoice_api/models/conversion/pdf_result_params"
+require_relative "e_invoice_api/models/conversion/pdf_retrieve_params"
 require_relative "e_invoice_api/models/currency_code"
 require_relative "e_invoice_api/models/document_attachment_create"
 require_relative "e_invoice_api/models/document_create_from_pdf_params"
@@ -65,6 +69,8 @@ require_relative "e_invoice_api/models/document_create_params"
 require_relative "e_invoice_api/models/document_delete_params"
 require_relative "e_invoice_api/models/document_delete_response"
 require_relative "e_invoice_api/models/document_direction"
+require_relative "e_invoice_api/models/document_lifecycle_params"
+require_relative "e_invoice_api/models/document_lifecycle_response"
 require_relative "e_invoice_api/models/document_response"
 require_relative "e_invoice_api/models/document_retrieve_params"
 require_relative "e_invoice_api/models/documents/attachment_add_params"
@@ -79,8 +85,12 @@ require_relative "e_invoice_api/models/documents/ubl_get_params"
 require_relative "e_invoice_api/models/documents/ubl_get_response"
 require_relative "e_invoice_api/models/document_send_params"
 require_relative "e_invoice_api/models/document_state"
+require_relative "e_invoice_api/models/document_timeline_params"
+require_relative "e_invoice_api/models/document_timeline_response"
 require_relative "e_invoice_api/models/document_type"
 require_relative "e_invoice_api/models/document_validate_params"
+require_relative "e_invoice_api/models/draft_list_params"
+require_relative "e_invoice_api/models/inbound_email_response"
 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"
@@ -88,12 +98,18 @@ 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/mailbox_download_attachment_params"
+require_relative "e_invoice_api/models/mailbox_list_params"
+require_relative "e_invoice_api/models/mailbox_reprocess_params"
+require_relative "e_invoice_api/models/mailbox_retrieve_params"
 require_relative "e_invoice_api/models/me_retrieve_params"
 require_relative "e_invoice_api/models/me_retrieve_response"
 require_relative "e_invoice_api/models/outbox_list_draft_documents_params"
 require_relative "e_invoice_api/models/outbox_list_received_documents_params"
 require_relative "e_invoice_api/models/paginated_document_response"
 require_relative "e_invoice_api/models/payment_detail_create"
+require_relative "e_invoice_api/models/stats_retrieve_params"
+require_relative "e_invoice_api/models/stats_retrieve_response"
 require_relative "e_invoice_api/models/ubl_document_validation"
 require_relative "e_invoice_api/models/unit_of_measure_code"
 require_relative "e_invoice_api/models/validate_validate_json_params"
@@ -103,18 +119,27 @@ require_relative "e_invoice_api/models/validate_validate_ubl_params"
 require_relative "e_invoice_api/models/webhook_create_params"
 require_relative "e_invoice_api/models/webhook_delete_params"
 require_relative "e_invoice_api/models/webhook_delete_response"
+require_relative "e_invoice_api/models/webhook_history_params"
+require_relative "e_invoice_api/models/webhook_history_response"
 require_relative "e_invoice_api/models/webhook_list_params"
 require_relative "e_invoice_api/models/webhook_list_response"
 require_relative "e_invoice_api/models/webhook_response"
 require_relative "e_invoice_api/models/webhook_retrieve_params"
+require_relative "e_invoice_api/models/webhook_test_params"
+require_relative "e_invoice_api/models/webhook_test_response"
 require_relative "e_invoice_api/models/webhook_update_params"
 require_relative "e_invoice_api/models"
+require_relative "e_invoice_api/resources/conversion"
+require_relative "e_invoice_api/resources/conversion/pdf"
 require_relative "e_invoice_api/resources/documents"
 require_relative "e_invoice_api/resources/documents/attachments"
 require_relative "e_invoice_api/resources/documents/ubl"
+require_relative "e_invoice_api/resources/drafts"
 require_relative "e_invoice_api/resources/inbox"
 require_relative "e_invoice_api/resources/lookup"
+require_relative "e_invoice_api/resources/mailbox"
 require_relative "e_invoice_api/resources/me"
 require_relative "e_invoice_api/resources/outbox"
+require_relative "e_invoice_api/resources/stats"
 require_relative "e_invoice_api/resources/validate"
 require_relative "e_invoice_api/resources/webhooks"

data/rbi/e_invoice_api/client.rbi

@@ -34,6 +34,18 @@ module EInvoiceAPI
     sig { returns(EInvoiceAPI::Resources::Webhooks) }
     attr_reader :webhooks
 
+    sig { returns(EInvoiceAPI::Resources::Drafts) }
+    attr_reader :drafts
+
+    sig { returns(EInvoiceAPI::Resources::Conversion) }
+    attr_reader :conversion
+
+    sig { returns(EInvoiceAPI::Resources::Stats) }
+    attr_reader :stats
+
+    sig { returns(EInvoiceAPI::Resources::Mailbox) }
+    attr_reader :mailbox
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers

data/rbi/e_invoice_api/models/conversion/document_create_from_pdf_task.rbi

@@ -0,0 +1,108 @@
+# typed: strong
+
+module EInvoiceAPI
+  module Models
+    DocumentCreateFromPdfTask = Conversion::DocumentCreateFromPdfTask
+
+    module Conversion
+      class DocumentCreateFromPdfTask < EInvoiceAPI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              EInvoiceAPI::Conversion::DocumentCreateFromPdfTask,
+              EInvoiceAPI::Internal::AnyHash
+            )
+          end
+
+        # The ID of the task that will process the PDF
+        sig { returns(String) }
+        attr_accessor :task_id
+
+        # The status of the task
+        sig do
+          returns(
+            T.nilable(
+              EInvoiceAPI::Conversion::DocumentCreateFromPdfTask::Status::TaggedSymbol
+            )
+          )
+        end
+        attr_reader :status
+
+        sig do
+          params(
+            status:
+              EInvoiceAPI::Conversion::DocumentCreateFromPdfTask::Status::OrSymbol
+          ).void
+        end
+        attr_writer :status
+
+        sig do
+          params(
+            task_id: String,
+            status:
+              EInvoiceAPI::Conversion::DocumentCreateFromPdfTask::Status::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The ID of the task that will process the PDF
+          task_id:,
+          # The status of the task
+          status: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              task_id: String,
+              status:
+                EInvoiceAPI::Conversion::DocumentCreateFromPdfTask::Status::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The status of the task
+        module Status
+          extend EInvoiceAPI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                EInvoiceAPI::Conversion::DocumentCreateFromPdfTask::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          PENDING =
+            T.let(
+              :pending,
+              EInvoiceAPI::Conversion::DocumentCreateFromPdfTask::Status::TaggedSymbol
+            )
+          COMPLETED =
+            T.let(
+              :completed,
+              EInvoiceAPI::Conversion::DocumentCreateFromPdfTask::Status::TaggedSymbol
+            )
+          FAILED =
+            T.let(
+              :failed,
+              EInvoiceAPI::Conversion::DocumentCreateFromPdfTask::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                EInvoiceAPI::Conversion::DocumentCreateFromPdfTask::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/e_invoice_api/models/conversion/pdf_create_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module EInvoiceAPI
+  module Models
+    module Conversion
+      class PdfCreateParams < EInvoiceAPI::Internal::Type::BaseModel
+        extend EInvoiceAPI::Internal::Type::RequestParameters::Converter
+        include EInvoiceAPI::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              EInvoiceAPI::Conversion::PdfCreateParams,
+              EInvoiceAPI::Internal::AnyHash
+            )
+          end
+
+        sig { returns(EInvoiceAPI::Internal::FileInput) }
+        attr_accessor :file
+
+        sig do
+          params(
+            file: EInvoiceAPI::Internal::FileInput,
+            request_options: EInvoiceAPI::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(file:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            {
+              file: EInvoiceAPI::Internal::FileInput,
+              request_options: EInvoiceAPI::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/e_invoice_api/models/conversion/pdf_result_params.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module EInvoiceAPI
+  module Models
+    module Conversion
+      class PdfResultParams < EInvoiceAPI::Internal::Type::BaseModel
+        extend EInvoiceAPI::Internal::Type::RequestParameters::Converter
+        include EInvoiceAPI::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              EInvoiceAPI::Conversion::PdfResultParams,
+              EInvoiceAPI::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :task_id
+
+        sig do
+          params(
+            task_id: String,
+            request_options: EInvoiceAPI::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(task_id:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            { task_id: String, request_options: EInvoiceAPI::RequestOptions }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/e_invoice_api/models/conversion/pdf_retrieve_params.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module EInvoiceAPI
+  module Models
+    module Conversion
+      class PdfRetrieveParams < EInvoiceAPI::Internal::Type::BaseModel
+        extend EInvoiceAPI::Internal::Type::RequestParameters::Converter
+        include EInvoiceAPI::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              EInvoiceAPI::Conversion::PdfRetrieveParams,
+              EInvoiceAPI::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :task_id
+
+        sig do
+          params(
+            task_id: String,
+            request_options: EInvoiceAPI::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(task_id:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            { task_id: String, request_options: EInvoiceAPI::RequestOptions }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end