factpulse 3.0.9 → 3.0.13

data/docs/AFNORUpdatePatchDirectoryLineBody.md

@@ -0,0 +1,18 @@
+# FactPulse::AFNORUpdatePatchDirectoryLineBody
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **date_to** | **Date** | Effective end date of the directory line. | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::AFNORUpdatePatchDirectoryLineBody.new(
+  date_to: 2023-01-31
+)
+```
+

data/docs/AFNORUpdatePatchRoutingCodeBody.md

@@ -0,0 +1,24 @@
+# FactPulse::AFNORUpdatePatchRoutingCodeBody
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **routing_identifier_type** | **String** | Routing Identifier type. | [optional] |
+| **routing_code_name** | **String** | Name of the directory line routing code. This attribute is only returned if the directory line is defined at the SIREN / SIRET / Routing code mesh. | [optional] |
+| **administrative_status** | [**AFNORRoutingCodeAdministrativeStatus**](AFNORRoutingCodeAdministrativeStatus.md) |  | [optional] |
+| **address** | [**AFNORAddressPatch**](AFNORAddressPatch.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::AFNORUpdatePatchRoutingCodeBody.new(
+  routing_identifier_type: 0224,
+  routing_code_name: Libellé Code routage,
+  administrative_status: null,
+  address: null
+)
+```
+

data/docs/AFNORUpdatePutRoutingCodeBody.md

@@ -0,0 +1,24 @@
+# FactPulse::AFNORUpdatePutRoutingCodeBody
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **routing_identifier_type** | **String** | Routing Identifier type. |  |
+| **routing_code_name** | **String** | Name of the directory line routing code. This attribute is only returned if the directory line is defined at the SIREN / SIRET / Routing code mesh. |  |
+| **administrative_status** | [**AFNORRoutingCodeAdministrativeStatus**](AFNORRoutingCodeAdministrativeStatus.md) |  |  |
+| **address** | [**AFNORAddressPut**](AFNORAddressPut.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::AFNORUpdatePutRoutingCodeBody.new(
+  routing_identifier_type: 0224,
+  routing_code_name: Libellé Code routage,
+  administrative_status: null,
+  address: null
+)
+```
+

data/docs/AFNORWebhookCallbackContent.md

@@ -0,0 +1,18 @@
+# FactPulse::AFNORWebhookCallbackContent
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **flow_info** | [**AFNORFlow**](AFNORFlow.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::AFNORWebhookCallbackContent.new(
+  flow_info: null
+)
+```
+

data/docs/AcceptLanguage.md

@@ -0,0 +1,15 @@
+# FactPulse::AcceptLanguage
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::AcceptLanguage.new()
+```
+

data/docs/AggregatedPaymentInput.md

@@ -0,0 +1,22 @@
+# FactPulse::AggregatedPaymentInput
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **payment_date** | **Date** | Payment date |  |
+| **currency** | [**Currency**](Currency.md) |  | [optional] |
+| **amounts_by_rate** | [**Array<PaymentAmountByRate>**](PaymentAmountByRate.md) | Payment amounts by VAT rate |  |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::AggregatedPaymentInput.new(
+  payment_date: 2025-01-15,
+  currency: null,
+  amounts_by_rate: null
+)
+```
+

data/docs/AggregatedTransactionInput.md

@@ -0,0 +1,32 @@
+# FactPulse::AggregatedTransactionInput
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **date** | **Date** | Transaction date (TT-77) |  |
+| **category_code** | [**TransactionCategory**](TransactionCategory.md) | Transaction category code (TT-81). Use TLB1 for goods, TPS1 for services. |  |
+| **currency** | [**Currency**](Currency.md) |  | [optional] |
+| **tax_exclusive_amount** | [**Taxexclusiveamount**](Taxexclusiveamount.md) |  |  |
+| **tax_amount** | [**Taxamount**](Taxamount.md) |  |  |
+| **tax_breakdown** | [**Array<TaxBreakdownInput>**](TaxBreakdownInput.md) | VAT breakdown by rate |  |
+| **transaction_count** | **Integer** |  | [optional] |
+| **tax_due_type** | [**TaxDueDateType**](TaxDueDateType.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::AggregatedTransactionInput.new(
+  date: 2025-01-15,
+  category_code: null,
+  currency: null,
+  tax_exclusive_amount: null,
+  tax_amount: null,
+  tax_breakdown: null,
+  transaction_count: null,
+  tax_due_type: null
+)
+```
+

data/docs/AllowanceCharge.md

@@ -5,12 +5,12 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **is_charge** | **Boolean** | True for charge, False for allowance (ChargeIndicator). |  |
-| **amount** | [**Amount**](Amount.md) |  |  |
+| **amount** | [**Amount1**](Amount1.md) |  |  |
 | **base_amount** | [**BaseAmount**](BaseAmount.md) |  | [optional] |
 | **percentage** | [**Percentage**](Percentage.md) |  | [optional] |
 | **reason** | **String** |  | [optional] |
-| **reason_code** | **String** |  | [optional] |
-| **vat_category** | **String** |  | [optional] |
+| **reason_code** | [**AllowanceChargeReasonCode**](AllowanceChargeReasonCode.md) |  | [optional] |
+| **vat_category** | [**VATCategory**](VATCategory.md) |  | [optional] |
 | **vat_rate** | [**VatRate**](VatRate.md) |  | [optional] |
 
 ## Example

data/docs/AllowanceChargeReasonCode.md

@@ -0,0 +1,15 @@
+# FactPulse::AllowanceChargeReasonCode
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::AllowanceChargeReasonCode.new()
+```
+

data/docs/Amount1.md

@@ -0,0 +1,15 @@
+# FactPulse::Amount1
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::Amount1.new()
+```
+

data/docs/Buyercountry.md

@@ -0,0 +1,15 @@
+# FactPulse::Buyercountry
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::Buyercountry.new()
+```
+

data/docs/ChorusProApi.md

@@ -1,6 +1,6 @@
 # FactPulse::ChorusProApi
 
-All URIs are relative to *http://localhost*
+All URIs are relative to *https://factpulse.fr*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
@@ -318,7 +318,7 @@ FactPulse.configure do |config|
 end
 
 api_instance = FactPulse::ChorusProApi.new
-id_structure_cpp = 56 # Integer | 
+id_structure_cpp = 56 # Integer | Chorus Pro structure ID (idStructureCPP)
 
 begin
   # List structure services
@@ -351,7 +351,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **id_structure_cpp** | **Integer** |  |  |
+| **id_structure_cpp** | **Integer** | Chorus Pro structure ID (idStructureCPP) |  |
 
 ### Return type
 
@@ -925,6 +925,8 @@ end
 
 Consult an invoice (Validator)
 
+Retrieves detailed information about an invoice for validators.  **Use case**: Called by validators (public sector) to consult invoice details before approving or rejecting it.  **Required payload**: ```json {   \"idFacture\": 123456789 } ```  **Returns**: Complete invoice details including amounts, dates, attachments, and current status.
+
 ### Examples
 
 ```ruby

data/docs/{FactureElectroniqueRestApiSchemasChorusProChorusProCredentials.md → ChorusProCredentials.md}

@@ -1,4 +1,4 @@
-# FactPulse::FactureElectroniqueRestApiSchemasChorusProChorusProCredentials
+# FactPulse::ChorusProCredentials
 
 ## Properties
 
@@ -15,7 +15,7 @@
 ```ruby
 require 'factpulse'
 
-instance = FactPulse::FactureElectroniqueRestApiSchemasChorusProChorusProCredentials.new(
+instance = FactPulse::ChorusProCredentials.new(
   piste_client_id: null,
   piste_client_secret: null,
   chorus_pro_login: null,

data/docs/ConvertValidationFailedResponse.md

@@ -4,13 +4,13 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **status** | **String** |  | [optional][default to 'validation_failed'] |
-| **conversion_id** | **String** |  |  |
-| **message** | **String** |  | [optional][default to 'Donnees extraites avec erreurs de validation. Completez le formulaire et appelez /resume.'] |
-| **extraction** | [**ExtractionInfo**](ExtractionInfo.md) |  |  |
+| **status** | **String** | Statut de la conversion | [optional][default to 'validation_failed'] |
+| **conversion_id** | **String** | Identifiant unique de conversion |  |
+| **message** | **String** | Message explicatif | [optional][default to 'Donnees extraites avec erreurs de validation. Completez le formulaire et appelez /resume.'] |
+| **extraction** | [**ExtractionInfo**](ExtractionInfo.md) | Informations sur l'extraction OCR |  |
 | **extracted_data** | **Hash<String, Object>** | Donnees extraites par OCR au format FacturXInvoice (a completer/corriger) |  |
 | **missing_fields** | [**Array<MissingField>**](MissingField.md) | Champs manquants pour conformite Factur-X | [optional] |
-| **validation** | [**ValidationInfo**](ValidationInfo.md) |  |  |
+| **validation** | [**ValidationInfo**](ValidationInfo.md) | Resultat de la validation Factur-X |  |
 | **resume_url** | **String** | URL pour reprendre la conversion avec corrections |  |
 | **expires_at** | **Time** | Expiration de la conversion (1h) |  |
 

data/docs/CountryCode.md

@@ -0,0 +1,15 @@
+# FactPulse::CountryCode
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::CountryCode.new()
+```
+

data/docs/CreateAggregatedReportRequest.md

@@ -0,0 +1,34 @@
+# FactPulse::CreateAggregatedReportRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **report_id** | **String** | Report identifier (generated by caller) |  |
+| **report_name** | **String** |  | [optional] |
+| **transmission_type** | [**TransmissionTypeCode**](TransmissionTypeCode.md) | Transmission type: IN=Initial, RE=Rectificative (TT-4) | [optional] |
+| **sender** | [**ReportSender**](ReportSender.md) | Report sender/declarant |  |
+| **period** | [**ReportPeriod**](ReportPeriod.md) | Reporting period |  |
+| **invoices** | [**Array<InvoiceInput>**](InvoiceInput.md) |  | [optional] |
+| **transactions** | [**Array<AggregatedTransactionInput>**](AggregatedTransactionInput.md) |  | [optional] |
+| **invoice_payments** | [**Array<InvoicePaymentInput>**](InvoicePaymentInput.md) |  | [optional] |
+| **transaction_payments** | [**Array<AggregatedPaymentInput>**](AggregatedPaymentInput.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::CreateAggregatedReportRequest.new(
+  report_id: EREPORT-2025-001,
+  report_name: null,
+  transmission_type: null,
+  sender: null,
+  period: null,
+  invoices: null,
+  transactions: null,
+  invoice_payments: null,
+  transaction_payments: null
+)
+```
+

data/docs/CreateEReportingRequest.md

@@ -0,0 +1,36 @@
+# FactPulse::CreateEReportingRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **report_id** | **String** | Report identifier (generated by caller) |  |
+| **report_name** | **String** |  | [optional] |
+| **flow_type** | [**EReportingFlowType**](EReportingFlowType.md) | E-Reporting flux type (for internal routing) |  |
+| **transmission_type** | [**TransmissionTypeCode**](TransmissionTypeCode.md) | Transmission type (TT-4 TypeCode): IN=Initial, RE=Rectificative | [optional] |
+| **sender** | [**ReportSender**](ReportSender.md) | Report sender (declarant) |  |
+| **period** | [**ReportPeriod**](ReportPeriod.md) | Reporting period |  |
+| **invoices** | [**Array<InvoiceInput>**](InvoiceInput.md) |  | [optional] |
+| **transactions** | [**Array<AggregatedTransactionInput>**](AggregatedTransactionInput.md) |  | [optional] |
+| **invoice_payments** | [**Array<InvoicePaymentInput>**](InvoicePaymentInput.md) |  | [optional] |
+| **aggregated_payments** | [**Array<AggregatedPaymentInput>**](AggregatedPaymentInput.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::CreateEReportingRequest.new(
+  report_id: EREPORT-2025-001,
+  report_name: null,
+  flow_type: null,
+  transmission_type: null,
+  sender: null,
+  period: null,
+  invoices: null,
+  transactions: null,
+  invoice_payments: null,
+  aggregated_payments: null
+)
+```
+

data/docs/Currency.md

@@ -0,0 +1,15 @@
+# FactPulse::Currency
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::Currency.new()
+```
+

data/docs/CurrencyCode.md

@@ -0,0 +1,15 @@
+# FactPulse::CurrencyCode
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::CurrencyCode.new()
+```
+

data/docs/DirectoryLineInclude.md

@@ -0,0 +1,15 @@
+# FactPulse::DirectoryLineInclude
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::DirectoryLineInclude.new()
+```
+

data/docs/DocType.md

@@ -0,0 +1,15 @@
+# FactPulse::DocType
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'factpulse'
+
+instance = FactPulse::DocType.new()
+```
+

data/docs/DocumentConversionApi.md

@@ -1,91 +1,15 @@
 # FactPulse::DocumentConversionApi
 
-All URIs are relative to *http://localhost*
+All URIs are relative to *https://factpulse.fr*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**convert_document_api_v1_convert_post**](DocumentConversionApi.md#convert_document_api_v1_convert_post) | **POST** /api/v1/convert | Convertir un document en Factur-X |
 | [**convert_document_async_api_v1_convert_async_post**](DocumentConversionApi.md#convert_document_async_api_v1_convert_async_post) | **POST** /api/v1/convert/async | Convertir un document en Factur-X (mode asynchrone) |
 | [**download_file_api_v1_convert_conversion_id_download_filename_get**](DocumentConversionApi.md#download_file_api_v1_convert_conversion_id_download_filename_get) | **GET** /api/v1/convert/{conversion_id}/download/{filename} | Télécharger un fichier généré |
 | [**get_conversion_status_api_v1_convert_conversion_id_status_get**](DocumentConversionApi.md#get_conversion_status_api_v1_convert_conversion_id_status_get) | **GET** /api/v1/convert/{conversion_id}/status | Vérifier le statut d'une conversion |
 | [**resume_conversion_api_v1_convert_conversion_id_resume_post**](DocumentConversionApi.md#resume_conversion_api_v1_convert_conversion_id_resume_post) | **POST** /api/v1/convert/{conversion_id}/resume | Reprendre une conversion avec corrections |
 
 
-## convert_document_api_v1_convert_post
-
-> <ConvertSuccessResponse> convert_document_api_v1_convert_post(file, opts)
-
-Convertir un document en Factur-X
-
-Convertit un document (PDF, DOCX, XLSX, image) en Factur-X conforme.  ## Workflow  1. **Upload** : Le document est envoyé en multipart/form-data 2. **Extraction OCR + Classification** : Mistral OCR extrait les données et classifie le document en un seul appel 3. **Enrichissement** : Les données sont enrichies via SIRENE (SIRET → raison sociale) 4. **Validation** : Les règles Schematron sont appliquées 5. **Génération** : Le Factur-X PDF/A-3 est généré  ## Réponses possibles  - **200** : Conversion réussie, fichiers disponibles - **202** : Données manquantes, complétion requise - **422** : Validation échouée, corrections nécessaires - **400** : Fichier invalide - **429** : Quota dépassé
-
-### Examples
-
-```ruby
-require 'time'
-require 'factpulse'
-# setup authorization
-FactPulse.configure do |config|
-  # Configure Bearer authorization: HTTPBearer
-  config.access_token = 'YOUR_BEARER_TOKEN'
-end
-
-api_instance = FactPulse::DocumentConversionApi.new
-file = File.new('/path/to/some/file') # File | Document à convertir (PDF, DOCX, XLSX, JPG, PNG)
-opts = {
-  output: 'output_example', # String | Format de sortie: pdf, xml, both
-  callback_url: 'callback_url_example' # String | 
-}
-
-begin
-  # Convertir un document en Factur-X
-  result = api_instance.convert_document_api_v1_convert_post(file, opts)
-  p result
-rescue FactPulse::ApiError => e
-  puts "Error when calling DocumentConversionApi->convert_document_api_v1_convert_post: #{e}"
-end
-```
-
-#### Using the convert_document_api_v1_convert_post_with_http_info variant
-
-This returns an Array which contains the response data, status code and headers.
-
-> <Array(<ConvertSuccessResponse>, Integer, Hash)> convert_document_api_v1_convert_post_with_http_info(file, opts)
-
-```ruby
-begin
-  # Convertir un document en Factur-X
-  data, status_code, headers = api_instance.convert_document_api_v1_convert_post_with_http_info(file, opts)
-  p status_code # => 2xx
-  p headers # => { ... }
-  p data # => <ConvertSuccessResponse>
-rescue FactPulse::ApiError => e
-  puts "Error when calling DocumentConversionApi->convert_document_api_v1_convert_post_with_http_info: #{e}"
-end
-```
-
-### Parameters
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **file** | **File** | Document à convertir (PDF, DOCX, XLSX, JPG, PNG) |  |
-| **output** | **String** | Format de sortie: pdf, xml, both | [optional][default to &#39;pdf&#39;] |
-| **callback_url** | **String** |  | [optional] |
-
-### Return type
-
-[**ConvertSuccessResponse**](ConvertSuccessResponse.md)
-
-### Authorization
-
-[HTTPBearer](../README.md#HTTPBearer)
-
-### HTTP request headers
-
-- **Content-Type**: multipart/form-data
-- **Accept**: application/json
-
-
 ## convert_document_async_api_v1_convert_async_post
 
 > Object convert_document_async_api_v1_convert_async_post(file, opts)
@@ -109,7 +33,8 @@ api_instance = FactPulse::DocumentConversionApi.new
 file = File.new('/path/to/some/file') # File | Document à convertir (PDF, DOCX, XLSX, JPG, PNG)
 opts = {
   output: 'output_example', # String | Format de sortie: pdf, xml, both
-  callback_url: 'callback_url_example' # String | 
+  callback_url: 'callback_url_example', # String | 
+  webhook_mode: 'webhook_mode_example' # String | Mode de livraison du contenu: 'inline' (base64 dans webhook) ou 'download_url' (URL temporaire 1h)
 }
 
 begin
@@ -146,6 +71,7 @@ end
 | **file** | **File** | Document à convertir (PDF, DOCX, XLSX, JPG, PNG) |  |
 | **output** | **String** | Format de sortie: pdf, xml, both | [optional][default to &#39;pdf&#39;] |
 | **callback_url** | **String** |  | [optional] |
+| **webhook_mode** | **String** | Mode de livraison du contenu: &#39;inline&#39; (base64 dans webhook) ou &#39;download_url&#39; (URL temporaire 1h) | [optional][default to &#39;inline&#39;] |
 
 ### Return type
 
@@ -181,8 +107,8 @@ FactPulse.configure do |config|
 end
 
 api_instance = FactPulse::DocumentConversionApi.new
-conversion_id = 'conversion_id_example' # String | 
-filename = 'filename_example' # String | 
+conversion_id = 'conversion_id_example' # String | Conversion ID returned by POST /convert (UUID format)
+filename = 'filename_example' # String | File to download: 'facturx.pdf' or 'facturx.xml'
 
 begin
   # Télécharger un fichier généré
@@ -215,8 +141,8 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **conversion_id** | **String** |  |  |
-| **filename** | **String** |  |  |
+| **conversion_id** | **String** | Conversion ID returned by POST /convert (UUID format) |  |
+| **filename** | **String** | File to download: &#39;facturx.pdf&#39; or &#39;facturx.xml&#39; |  |
 
 ### Return type
 
@@ -252,7 +178,7 @@ FactPulse.configure do |config|
 end
 
 api_instance = FactPulse::DocumentConversionApi.new
-conversion_id = 'conversion_id_example' # String | 
+conversion_id = 'conversion_id_example' # String | Conversion ID returned by POST /convert (UUID format)
 
 begin
   # Vérifier le statut d'une conversion
@@ -285,7 +211,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **conversion_id** | **String** |  |  |
+| **conversion_id** | **String** | Conversion ID returned by POST /convert (UUID format) |  |
 
 ### Return type
 
@@ -321,7 +247,7 @@ FactPulse.configure do |config|
 end
 
 api_instance = FactPulse::DocumentConversionApi.new
-conversion_id = 'conversion_id_example' # String | 
+conversion_id = 'conversion_id_example' # String | Conversion ID returned by POST /convert (UUID format)
 convert_resume_request = FactPulse::ConvertResumeRequest.new # ConvertResumeRequest | 
 
 begin
@@ -355,7 +281,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **conversion_id** | **String** |  |  |
+| **conversion_id** | **String** | Conversion ID returned by POST /convert (UUID format) |  |
 | **convert_resume_request** | [**ConvertResumeRequest**](ConvertResumeRequest.md) |  |  |
 
 ### Return type