@pimia/sdk 0.1.0 → 0.3.0

package/dist/api.d.ts

@@ -10,7 +10,18 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get accounting summary by quarter for a fiscal year */
+        /**
+         * Accounting summary. Two modes:
+         * @description - `year` (solo): array de 4 trimestres con revenue/expenses/vat/irpf/result.
+         *       Lo consume AccountingSummaryReport.vue — su shape es contrato estable.
+         *     - `from_date`+`to_date` (o `quarter`+`year`): objeto agregado del rango con
+         *       total_sales, total_received, total_expenses, net_profit, vat_collected,
+         *       vat_paid, vat_balance, irpf, counts y tax_breakdown. Con
+         *       `group_by=customer` añade by_customer; con `group_by=category`, by_category.
+         *       Lo consumen las tools MCP de informes (invoice-shelf-mcp).
+         *
+         *     Importes en céntimos, como el resto de la API.
+         */
         get: operations["accountingSummary.index"];
         put?: never;
         post?: never;
@@ -69,23 +80,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/auth/login": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post: operations["auth.login"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/auth/logout": {
+    "/approvals": {
         parameters: {
             query?: never;
             header?: never;
@@ -94,21 +89,30 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        post: operations["auth.logout"];
+        /**
+         * POST /api/v1/approvals — el partner crea una propuesta (nace 'proposed'
+         *     en modo preview, pendiente de la decisión del owner)
+         */
+        post: operations["approvals.store"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/auth/check": {
+    "/approvals/{id}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get: operations["auth.check"];
+        /**
+         * GET /api/v1/approvals/{id} — estado de una propuesta DEL client del
+         *     token. Escopeado por origin_client_id + tenant: cualquier otra cosa es
+         *     404 (no se filtra ni la existencia)
+         */
+        get: operations["approvals.show"];
         put?: never;
         post?: never;
         delete?: never;
@@ -226,7 +230,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Handle the incoming request */
+        /**
+         * Handle the incoming request
+         * @description **No disponible para integradores.** Exige `settings:write`, que el Authorization Server de Pimia no emite: la acción la realiza el dueño desde su panel y un token de partner recibe `403`. Aparece en el contrato para que el hueco sea explícito, no para que se llame.
+         */
         post: operations["general.bulkExchangeRate"];
         delete?: never;
         options?: never;
@@ -436,6 +443,52 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/custom-fields": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Display a listing of the resource */
+        get: operations["custom-fields.index"];
+        put?: never;
+        /**
+         * Store a newly created resource in storage
+         * @description **No disponible para integradores.** Exige `settings:write`, que el Authorization Server de Pimia no emite: la acción la realiza el dueño desde su panel y un token de partner recibe `403`. Aparece en el contrato para que el hueco sea explícito, no para que se llame.
+         */
+        post: operations["custom-fields.store"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/custom-fields/{customField}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Display the specified resource */
+        get: operations["custom-fields.show"];
+        /**
+         * Update the specified resource in storage
+         * @description **No disponible para integradores.** Exige `settings:write`, que el Authorization Server de Pimia no emite: la acción la realiza el dueño desde su panel y un token de partner recibe `403`. Aparece en el contrato para que el hueco sea explícito, no para que se llame.
+         */
+        put: operations["custom-fields.update"];
+        post?: never;
+        /**
+         * Remove the specified resource from storage
+         * @description **No disponible para integradores.** Exige `settings:write`, que el Authorization Server de Pimia no emite: la acción la realiza el dueño desde su panel y un token de partner recibe `403`. Aparece en el contrato para que el hueco sea explícito, no para que se llame.
+         */
+        delete: operations["custom-fields.destroy"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/customers/{customer}/stats": {
         parameters: {
             query?: never;
@@ -825,7 +878,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Toggle lock state for a quarter */
+        /**
+         * Toggle lock state for a quarter
+         * @description **No disponible para integradores.** Exige `reports:write`, que el Authorization Server de Pimia no emite: la acción la realiza el dueño desde su panel y un token de partner recibe `403`. Aparece en el contrato para que el hueco sea explícito, no para que se llame.
+         */
         post: operations["fiscalQuarter.toggle"];
         delete?: never;
         options?: never;
@@ -833,23 +889,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/auth/password/email": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** Send a reset link to the given user */
-        post: operations["forgotPassword.sendResetLinkEmail"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/currencies/{currency}/active-provider": {
         parameters: {
             query?: never;
@@ -1501,7 +1540,31 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Handle the incoming request */
+        /**
+         * Siguiente número de documento (orientativo, NO lo reserva)
+         * @description Calcula al vuelo qué número le tocaría al próximo documento del tipo pedido, con el
+         *     formato de numeración configurado por la empresa. Es lo que el panel pinta en el
+         *     formulario antes de guardar.
+         *
+         *     **No reserva nada y no es determinista.** No consume secuencia: dos llamadas
+         *     seguidas —o dos integradores a la vez— reciben el MISMO número, y quien guarde
+         *     primero se lo queda; el segundo se estrella contra el `unique` con un `422`.
+         *     El valor caduca en cuanto alguien crea un documento de ese tipo.
+         *
+         *     **No lo necesitas para escribir, y usarlo para eso te perjudica.** Desde el
+         *     2026-08-10 ninguna alta exige que el número lo pongas tú: `invoice_number`,
+         *     `estimate_number`, `payment_number` y `received_invoice_number` son opcionales y,
+         *     si no llegan, los asigna el servidor con este mismo formateador ya dentro de la
+         *     transacción que escribe. Pedir el número aquí para reenviarlo en el cuerpo solo
+         *     añade una carrera que el servidor no tiene, y de paso rompe la reproducibilidad
+         *     del cuerpo entre reintentos con `Idempotency-Key` (guía del integrador §7).
+         *     Su uso legítimo es previsualizar en una interfaz el número que le tocaría al
+         *     documento — para eso lo llama el panel.
+         *
+         *     **Comprueba `success` antes de leer `nextNumber`.** Un fallo llega con `200` y el
+         *     sobre `{"success": false, "message": "..."}`; desestructurar `nextNumber` a ciegas
+         *     degrada en silencio a `null`.
+         */
         get: operations["general.nextNumber"];
         put?: never;
         post?: never;
@@ -2099,23 +2162,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/auth/reset/password": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** Reset the given user's password */
-        post: operations["resetPassword.reset"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/search": {
         parameters: {
             query?: never;
@@ -2242,7 +2288,15 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Handle the incoming request */
+        /**
+         * Handle the incoming request
+         * @description Recibía un `Request` pelado y **no validaba nada**, al revés que las
+         *     vistas previas de presupuesto y factura. La consecuencia no era un error
+         *     sino algo peor: sin `body` la previsualización se renderizaba igual, con
+         *     el cuerpo vacío, así que enseñaba un correo que no era el que se iba a
+         *     mandar — y el envío de después sí valida, con lo que la vista previa
+         *     mentía justo en el caso en que había algo que corregir.
+         */
         get: operations["payment.sendPaymentPreview"];
         put?: never;
         post?: never;
@@ -2434,7 +2488,9 @@ export interface paths {
         put?: never;
         /**
          * POST tasks/{task}/delegate — delega esta tarea CRM a su agente Pim
-         * @description Reusa el plano async `delegated_tasks` (el mismo que ya cierra el round-trip
+         * @description **No disponible para integradores.** Exige `delegation:write`, que el Authorization Server de Pimia no emite: la acción la realiza el dueño desde su panel y un token de partner recibe `403`. Aparece en el contrato para que el hueco sea explícito, no para que se llame.
+         *
+         *     Reusa el plano async `delegated_tasks` (el mismo que ya cierra el round-trip
          *     delegar→agente→callback→sello): compone un context rico desde la tarea (título,
          *     descripción y el lead/cliente/proyecto vinculado con sus datos), crea la
          *     delegación, la entrega al Kanban del Copilot y la enlaza con la tarea.
@@ -2757,6 +2813,26 @@ export interface components {
         };
         /** Appointment */
         Appointment: string[];
+        /**
+         * AppointmentRequest
+         * @description Cita de agenda. Reglas movidas literalmente desde el método privado
+         *     `AppointmentController::validated()`, que el generador del OpenAPI no podía
+         *     ver: solo recorre el AST de la propia acción, no los ayudantes a los que
+         *     llama. Ver docs/guia-integradores.md.
+         */
+        AppointmentRequest: {
+            customer_id?: number | null;
+            item_id?: number | null;
+            staff_user_id?: number | null;
+            /** Format: date-time */
+            starts_at: string;
+            /** Format: date-time */
+            ends_at?: string | null;
+            /** @enum {string|null} */
+            status?: "booked" | "confirmed" | "attended" | "no_show" | "cancelled" | null;
+            source?: string | null;
+            notes?: string | null;
+        };
         /** BankAccount */
         BankAccount: {
             id: number;
@@ -2822,18 +2898,51 @@ export interface components {
                 exchange_rate: string;
             }[];
         };
+        /**
+         * ChangeInvoiceStatusRequest
+         * @description Cambio de estado de una factura (`POST /invoices/{invoice}/status`).
+         *
+         *     El juego de valores es CERRADO y son exactamente las tres transiciones que
+         *     el controlador implementa. Antes se aceptaba cualquier string: `DRAFT`,
+         *     `VIEWED` y `OVERDUE` —que el servidor MCP llegó a anunciar— respondían
+         *     `200 {"success": true}` sin tocar la factura, así que ni el panel ni un
+         *     agente podían distinguir un cambio real de uno que no ocurrió. Mismo patrón
+         *     que ChangeEstimateStatusController, que ya validaba así.
+         *
+         *     Los tres que NO están, y por qué:
+         *      - `DRAFT`: volver a borrador no existe. Publicar asigna número oficial y
+         *        registra en VeriFactu; deshacerlo se hace con una rectificativa.
+         *      - `VIEWED`: lo pone el servidor cuando el cliente abre el PDF
+         *        (InvoicePdfController), no es una transición que se pida.
+         *      - `OVERDUE`: no es un estado almacenado sino un filtro derivado de
+         *        `due_date` + `paid_status` (ver el scope de Invoice).
+         */
+        ChangeInvoiceStatusRequest: {
+            /**
+             * @description PUBLISHED asigna el número oficial y lanza el registro en
+             *     VeriFactu; SENT publica antes si aún era borrador; COMPLETED
+             *     exige que ya esté publicada o enviada.
+             * @enum {string}
+             */
+            status: "PUBLISHED" | "SENT" | "COMPLETED";
+            /**
+             * @description Slug de la plantilla a fijar al publicar. Si no existe en la
+             *     compañía, se ignora en silencio y la factura conserva la suya.
+             */
+            template_name?: string | null;
+        };
         /** CompanyResource */
         CompanyResource: {
-            id: string;
+            id: number;
             name: string;
             trade_name: string;
-            vat_id: string;
+            vat_id: string | null;
             tax_id: string;
-            logo: string;
+            logo: string | null;
             logo_path: string;
-            unique_hash: string;
+            unique_hash: string | null;
             owner_id: string;
-            slug: string;
+            slug: string | null;
             address?: components["schemas"]["AddressResource"];
             roles: components["schemas"]["RoleResource"][];
         };
@@ -2869,35 +2978,60 @@ export interface components {
         };
         /** CountryResource */
         CountryResource: {
-            id: string;
+            id: number;
             code: string;
             name: string;
             phone_code: string;
         };
         /** Currency */
-        Currency: string[];
+        Currency: {
+            id: number;
+            name: string;
+            code: string;
+            symbol: string | null;
+            precision: number;
+            exchange_rate: string | null;
+            swap_currency_symbol: string;
+            thousand_separator: string;
+            decimal_separator: string;
+            /** Format: date-time */
+            created_at: string | null;
+            /** Format: date-time */
+            updated_at: string | null;
+        };
         /** CurrencyResource */
         CurrencyResource: {
-            id: string;
+            id: number;
             name: string;
             code: string;
-            symbol: string;
-            precision: string;
+            symbol: string | null;
+            precision: number;
             thousand_separator: string;
             decimal_separator: string;
             swap_currency_symbol: string;
-            exchange_rate: string;
+            exchange_rate: string | null;
+        };
+        /** CustomFieldRequest */
+        CustomFieldRequest: {
+            name: string;
+            label: string;
+            model_type: string;
+            order: string;
+            type: string;
+            is_required: boolean;
+            options?: string[];
+            placeholder?: string | null;
         };
         /** CustomFieldResource */
         CustomFieldResource: {
-            id: string;
+            id: number;
             name: string;
             slug: string;
             label: string;
             model_type: string;
             type: string;
-            placeholder: string;
-            options: string;
+            placeholder: string | null;
+            options: string | null;
             boolean_answer: string;
             date_answer: string;
             time_answer: string;
@@ -2906,29 +3040,29 @@ export interface components {
             date_time_answer: string;
             is_required: string;
             in_use: string;
-            order: string;
-            company_id: string;
+            order: number;
+            company_id: number | null;
             default_answer: string;
-            company?: components["schemas"]["CompanyResource"];
+            company?: components["schemas"]["CompanyResource"] | null;
         };
         /** CustomFieldValueResource */
         CustomFieldValueResource: {
-            id: string;
+            id: number;
             custom_field_valuable_type: string;
-            custom_field_valuable_id: string;
+            custom_field_valuable_id: number;
             type: string;
-            boolean_answer: string;
-            date_answer: string;
-            time_answer: string;
-            string_answer: string;
-            number_answer: string;
-            date_time_answer: string;
-            custom_field_id: string;
-            company_id: string;
+            boolean_answer: string | null;
+            date_answer: string | null;
+            time_answer: string | null;
+            string_answer: string | null;
+            number_answer: string | null;
+            date_time_answer: string | null;
+            custom_field_id: number;
+            company_id: number | null;
             default_answer: string;
             default_formatted_answer: string | null;
             custom_field?: components["schemas"]["CustomFieldResource"];
-            company?: components["schemas"]["CompanyResource"];
+            company?: components["schemas"]["CompanyResource"] | null;
         };
         /** Customer */
         Customer: {
@@ -2971,6 +3105,13 @@ export interface components {
                 phone?: string | null;
                 fax?: string | null;
             };
+            /** @description Valores de campo personalizado del recurso. `id` es el de la definición, que se descubre en `GET /custom-fields` (catálogo `meta`, legible con cualquier token); las definiciones las crea el dueño del tenant desde su panel. Se devuelven en la clave `fields` del recurso. */
+            customFields?: {
+                /** @description Id de la definición del campo personalizado. */
+                id: number;
+                /** @description Valor a guardar. */
+                value: string;
+            }[];
         };
         /** CustomerResource */
         CustomerResource: {
@@ -3037,6 +3178,20 @@ export interface components {
         DeleteReceivedInvoicesRequest: {
             ids: string;
         };
+        /**
+         * DeleteRecurringInvoicesRequest
+         * @description Borrado múltiple de facturas recurrentes (`POST /recurring-invoices/delete`).
+         *     Mismo patrón que DeleteEstimatesRequest / DeleteInvoiceRequest, que es como
+         *     se declara el resto de borrados múltiples del panel.
+         *
+         *     El endpoint leía `$request->ids` sin validar y
+         *     `RecurringInvoice::deleteRecurringInvoice()` itera sin comprobar el `find()`,
+         *     así que un id inexistente reventaba con un 500. Con el `exists` pasa a ser un
+         *     422 que dice cuál falla.
+         */
+        DeleteRecurringInvoicesRequest: {
+            ids: number[];
+        };
         /** DeleteSuppliersRequest */
         DeleteSuppliersRequest: {
             ids: number[];
@@ -3152,6 +3307,88 @@ export interface components {
             company?: components["schemas"]["CompanyResource"];
             currency?: components["schemas"]["CurrencyResource"];
         };
+        /** EstimatesRequest */
+        EstimatesRequest: {
+            estimate_date: string;
+            expiry_date?: string | null;
+            customer_id?: number | null;
+            lead_id?: number | null;
+            /**
+             * @description Opcional en el alta: si no llega, lo genera el servidor con el mismo
+             *     SerialNumberFormatter que alimenta a GET /next-number, que es de donde
+             *     lo saca el panel. Exigirlo obligaba a un cliente de la API a replicar el
+             *     formato de numeración de la empresa para poder crear un presupuesto.
+             *     En PUT sigue siendo obligatorio (más abajo): el documento ya tiene uno.
+             */
+            estimate_number?: string | null;
+            exchange_rate?: string | null;
+            /**
+             * @description Descuento global: opcional en el contrato y rellenado a 0 en
+             *     prepareForValidation (el panel lo manda siempre, un cliente de la API
+             *     no tiene por qué). Ver DocumentHeaderPayload.
+             */
+            discount?: number | null;
+            discount_val?: number | null;
+            /**
+             * @description Agregados: el servidor es su oráculo —DocumentTotals los recompone desde
+             *     las líneas y getEstimatePayload los sobrescribe—, así que exigirlos era
+             *     pedirle al cliente un cálculo que se iba a descartar. Si llegan, siguen
+             *     comprobándose contra las líneas (ValidatesDocumentTotals).
+             */
+            sub_total?: number | null;
+            total?: number | null;
+            tax?: string | null;
+            template_name?: string | null;
+            items: {
+                description?: string | null;
+                name: string;
+                quantity: number;
+                price: number;
+                /**
+                 * @description Derivables: opcionales en el contrato y rellenados en prepareForValidation
+                 *     (el panel los manda siempre; un cliente de la API no tiene por qué).
+                 */
+                discount_val?: number | null;
+                tax?: number | null;
+                total?: number | null;
+                /**
+                 * @description Impuestos. El importe es derivable a partir del porcentaje
+                 *     (DocumentTaxPayload), así que un cliente de la API puede declarar
+                 *     «IVA 21 %» sin calcular nada; el panel sigue mandándolo ya hecho.
+                 */
+                taxes?: {
+                    tax_type_id?: number | null;
+                    percent?: number | null;
+                    amount?: number | null;
+                }[] | null;
+                /** @description Valores de campo personalizado DE LA LÍNEA (definiciones con `model_type` `InvoiceItem` o `EstimateItem`). Se acepta también la clave `custom_fields`, la forma histórica del panel. */
+                customFields?: {
+                    /** @description Id de la definición del campo personalizado. */
+                    id: number;
+                    /** @description Valor a guardar. */
+                    value: string;
+                }[];
+            }[];
+            taxes?: {
+                tax_type_id?: number | null;
+                percent?: number | null;
+                amount?: number | null;
+            }[] | null;
+            /**
+             * @description Sin `in:YES,NO`: hay documentos antiguos persistidos con 'NO ' (el
+             *     espacio de más que arrastraba el payload de aquí), y el panel reenvía
+             *     al editar lo que leyó. Se normaliza al leerlo, no se rechaza.
+             */
+            tax_per_item?: string | null;
+            tax_included?: boolean | null;
+            /** @description Valores de campo personalizado del recurso. `id` es el de la definición, que se descubre en `GET /custom-fields` (catálogo `meta`, legible con cualquier token); las definiciones las crea el dueño del tenant desde su panel. Se devuelven en la clave `fields` del recurso. */
+            customFields?: {
+                /** @description Id de la definición del campo personalizado. */
+                id: number;
+                /** @description Valor a guardar. */
+                value: string;
+            }[];
+        };
         /** ExpenseCategoryRequest */
         ExpenseCategoryRequest: {
             name: string;
@@ -3167,6 +3404,28 @@ export interface components {
             formatted_created_at: string;
             company?: components["schemas"]["CompanyResource"];
         };
+        /** ExpenseRequest */
+        ExpenseRequest: {
+            expense_date: string;
+            expense_number?: string | null;
+            expense_category_id: string;
+            exchange_rate?: string | null;
+            payment_method_id?: string | null;
+            amount: string;
+            customer_id?: string | null;
+            supplier_id?: string | null;
+            notes?: string | null;
+            currency_id: string;
+            /**
+             * Format: binary
+             * @description Maximum file size: 20000 kilobytes.
+             */
+            attachment_receipt?: string | null;
+            /** @description Valores de campo personalizado del recurso. `id` es el de la definición, que se descubre en `GET /custom-fields` (catálogo `meta`, legible con cualquier token); las definiciones las crea el dueño del tenant desde su panel. Se devuelven en la clave `fields` del recurso. En `multipart/form-data` viaja como cadena JSON: `[{"id":3,"value":"REF-42"}]`. */
+            customFields?: string;
+            /** @description Borra el recibo adjunto del gasto. Solo surte efecto en la actualización; en `multipart/form-data` viaja como `1` o `0`. */
+            is_attachment_receipt_removed?: boolean | null;
+        };
         /** ExpenseResource */
         ExpenseResource: {
             id: string;
@@ -3331,6 +3590,22 @@ export interface components {
             company?: components["schemas"]["CompanyResource"];
             currency?: components["schemas"]["CurrencyResource"];
         };
+        /**
+         * InvoiceSeriesRequest
+         * @description Serie de numeración de facturas. Reglas movidas literalmente desde el método
+         *     privado `InvoiceSeriesController::validatedData()`, que el generador del
+         *     OpenAPI no podía ver: solo recorre el AST de la propia acción, no los
+         *     ayudantes a los que llama. Ver docs/guia-integradores.md.
+         */
+        InvoiceSeriesRequest: {
+            code: string;
+            name: string;
+            number_format?: string | null;
+            default_template_id?: number | null;
+            next_sequence?: number;
+            is_default?: boolean;
+            is_active?: boolean;
+        };
         /** InvoiceSeriesResource */
         InvoiceSeriesResource: {
             id: string;
@@ -3349,6 +3624,46 @@ export interface components {
             created_at: string;
             updated_at: string;
         };
+        /**
+         * InvoiceTemplatePreviewRequest
+         * @description Previsualización en PDF de una plantilla YA GUARDADA
+         *     (`POST /invoice-templates/{invoiceTemplate}/preview`).
+         *
+         *     Ojo, el cuerpo aquí NO es el del previsualizador genérico
+         *     `POST /templates/preview` (ese sí recibe `config` y `base_template` sueltos y
+         *     los valida en línea, así que el OpenAPI ya los publicaba). En esta ruta
+         *     `InvoiceTemplateController::preview()` hace `merge()` de `config`,
+         *     `base_template` y `template_id` **desde la plantilla de la ruta**, pisando lo
+         *     que mande el cliente. Lo único que el cliente controla de verdad es lo de
+         *     abajo, y eso es lo que el contrato debe decir.
+         */
+        InvoiceTemplatePreviewRequest: {
+            /**
+             * @description Factura de la que sacar los datos de muestra. Sin ella se coge
+             *     una cualquiera de la compañía que tenga líneas y cliente.
+             */
+            invoice_id?: number | null;
+            /**
+             * @description Membrete aún no guardado (editor): data-URI para verlo al
+             *     instante. 5 MB de imagen ≈ 7 M de caracteres en base64.
+             */
+            letterhead?: string | null;
+        };
+        /**
+         * InvoiceTemplateRequest
+         * @description Plantilla de factura. Reglas movidas literalmente desde el método privado
+         *     `InvoiceTemplateController::validatedData()`, que el generador del OpenAPI no
+         *     podía ver: solo recorre el AST de la propia acción, no los ayudantes a los
+         *     que llama. Ver docs/guia-integradores.md.
+         */
+        InvoiceTemplateRequest: {
+            name: string;
+            slug?: string;
+            /** @enum {string} */
+            base_template?: "invoice1" | "invoice2" | "invoice3" | "invoice4" | "invoice5" | "invoice6" | "invoice7" | "invoice8" | "invoice9";
+            config?: string[];
+            is_default?: boolean;
+        };
         /** InvoiceTemplateResource */
         InvoiceTemplateResource: {
             id: string;
@@ -3364,7 +3679,86 @@ export interface components {
             updated_at: string;
         };
         /** InvoicesRequest */
-        InvoicesRequest: Record<string, never>;
+        InvoicesRequest: {
+            invoice_date: string;
+            due_date?: string | null;
+            customer_id: number;
+            invoice_number?: string | null;
+            exchange_rate?: string | null;
+            /**
+             * @description Descuento global: opcional en el contrato y rellenado a 0 en
+             *     prepareForValidation (el panel lo manda siempre, un cliente de la API
+             *     no tiene por qué). Ver DocumentHeaderPayload.
+             */
+            discount?: number | null;
+            discount_val?: number | null;
+            /**
+             * @description Agregados: el servidor es su oráculo —DocumentTotals los recompone desde
+             *     las líneas y getInvoicePayload los sobrescribe—, así que exigirlos era
+             *     pedirle al cliente un cálculo que se iba a descartar. Si llegan, siguen
+             *     comprobándose contra las líneas (ValidatesDocumentTotals).
+             */
+            sub_total?: number | null;
+            total?: number | null;
+            tax?: string | null;
+            /**
+             * @description Opcional como en EstimatesRequest: getInvoicePayload cae a 'invoice1'.
+             *     Exigirlo obligaba a un cliente de la API a conocer el nombre interno de
+             *     una plantilla para poder emitir una factura.
+             */
+            template_name?: string | null;
+            invoice_series_id?: number | null;
+            payment_method_id?: number | null;
+            items: {
+                description?: string | null;
+                name: string;
+                quantity: number;
+                price: number;
+                /**
+                 * @description Derivables: opcionales en el contrato y rellenados en prepareForValidation
+                 *     (el panel los manda siempre; un cliente de la API no tiene por qué).
+                 */
+                discount_val?: number | null;
+                tax?: number | null;
+                total?: number | null;
+                /**
+                 * @description Impuestos. El importe es derivable a partir del porcentaje
+                 *     (DocumentTaxPayload), así que un cliente de la API puede declarar
+                 *     «IVA 21 %» sin calcular nada; el panel sigue mandándolo ya hecho.
+                 */
+                taxes?: {
+                    tax_type_id?: number | null;
+                    percent?: number | null;
+                    amount?: number | null;
+                }[] | null;
+                /** @description Valores de campo personalizado DE LA LÍNEA (definiciones con `model_type` `InvoiceItem` o `EstimateItem`). Se acepta también la clave `custom_fields`, la forma histórica del panel. */
+                customFields?: {
+                    /** @description Id de la definición del campo personalizado. */
+                    id: number;
+                    /** @description Valor a guardar. */
+                    value: string;
+                }[];
+            }[];
+            taxes?: {
+                tax_type_id?: number | null;
+                percent?: number | null;
+                amount?: number | null;
+            }[] | null;
+            /**
+             * @description Sin `in:YES,NO`: hay documentos antiguos persistidos con 'NO ' (el
+             *     espacio de más que arrastra EstimatesRequest), y el panel reenvía al
+             *     editar lo que leyó. Se normaliza al leerlo, no se rechaza.
+             */
+            tax_per_item?: string | null;
+            tax_included?: boolean | null;
+            /** @description Valores de campo personalizado del recurso. `id` es el de la definición, que se descubre en `GET /custom-fields` (catálogo `meta`, legible con cualquier token); las definiciones las crea el dueño del tenant desde su panel. Se devuelven en la clave `fields` del recurso. */
+            customFields?: {
+                /** @description Id de la definición del campo personalizado. */
+                id: number;
+                /** @description Valor a guardar. */
+                value: string;
+            }[];
+        };
         /** ItemCategory */
         ItemCategory: string[];
         /** ItemResource */
@@ -3421,6 +3815,8 @@ export interface components {
             stock_alert_qty?: number | null;
             allow_sale_without_stock?: boolean | null;
             purchase_tax_type_id?: number | null;
+            /** @description Existencias iniciales del artículo. En el alta se guarda 0 si no llega; en la actualización se conserva el valor que ya tenía. */
+            opening_stock?: number | null;
         };
         /** LeadActivity */
         LeadActivity: string[];
@@ -3500,14 +3896,20 @@ export interface components {
                 name: string;
             } | null;
         };
-        /** LoginRequest */
-        LoginRequest: {
-            username: string;
-            password: string;
-            device_name: string;
-        };
         /** Note */
-        Note: string[];
+        Note: {
+            id: number;
+            type: string;
+            name: string | null;
+            notes: string | null;
+            noteable_type: string;
+            noteable_id: number;
+            company_id: number | null;
+            /** Format: date-time */
+            created_at: string | null;
+            /** Format: date-time */
+            updated_at: string | null;
+        };
         /** PaymentMethodRequest */
         PaymentMethodRequest: {
             name: string;
@@ -3520,6 +3922,34 @@ export interface components {
             type: string;
             company?: components["schemas"]["CompanyResource"];
         };
+        /** PaymentRequest */
+        PaymentRequest: {
+            payment_date: string;
+            customer_id: string;
+            exchange_rate?: string | null;
+            amount: number;
+            /**
+             * @description Opcional en el alta: si no llega, lo genera el servidor con el mismo
+             *     SerialNumberFormatter que alimenta a GET /next-number?key=payment, que es
+             *     de donde lo saca el panel. Exigirlo obligaba a un cliente de la API a
+             *     replicar el formato de numeración de la empresa, y encima a congelar el
+             *     cuerpo entre reintentos: `next-number` no reserva nada, así que pedirlo
+             *     dos veces puede dar dos números distintos y el reintento con la misma
+             *     Idempotency-Key rebotaba con 422 por «cuerpo distinto».
+             *     En PUT sigue siendo obligatorio (más abajo): el pago ya tiene uno.
+             */
+            payment_number?: string | null;
+            invoice_id?: string | null;
+            payment_method_id?: string | null;
+            notes?: string | null;
+            /** @description Valores de campo personalizado del recurso. `id` es el de la definición, que se descubre en `GET /custom-fields` (catálogo `meta`, legible con cualquier token); las definiciones las crea el dueño del tenant desde su panel. Se devuelven en la clave `fields` del recurso. */
+            customFields?: {
+                /** @description Id de la definición del campo personalizado. */
+                id: number;
+                /** @description Valor a guardar. */
+                value: string;
+            }[];
+        };
         /** PaymentResource */
         PaymentResource: {
             id: string;
@@ -3625,14 +4055,51 @@ export interface components {
             base_total: string;
             taxes?: components["schemas"]["TaxResource"][];
         };
-        /** ReceivedInvoiceResource */
-        ReceivedInvoiceResource: {
-            id: string;
+        /** ReceivedInvoiceRequest */
+        ReceivedInvoiceRequest: {
             received_invoice_date: string;
-            due_date: string;
-            received_invoice_number: string;
-            reference_number: string;
-            status: string;
+            due_date?: string | null;
+            supplier_id: string;
+            /**
+             * @description Opcional en el alta: si no llega, lo genera el servidor con el mismo
+             *     SerialNumberFormatter que alimenta a GET /next-number?key=received_invoice,
+             *     que es de donde lo saca el panel. Es el número del LIBRO DE RECIBIDAS —el
+             *     del proveedor va en `reference_number`—, así que numerarlo es cosa nuestra,
+             *     no del cliente de la API: exigirlo le obligaba a replicar el formato de la
+             *     empresa y a congelar el cuerpo entre reintentos (`next-number` no reserva,
+             *     dos llamadas pueden dar números distintos y la misma Idempotency-Key
+             *     rebotaba con 422 por «cuerpo distinto»).
+             *     En PUT sigue siendo obligatorio (más abajo): la factura ya tiene uno.
+             */
+            received_invoice_number?: string | null;
+            exchange_rate?: string | null;
+            discount: number;
+            discount_val: number;
+            sub_total: number;
+            total: number;
+            tax: string;
+            items: {
+                name: string;
+                quantity: number;
+                price: number;
+                description?: string | null;
+                /**
+                 * @description Derivables: opcionales en el contrato y rellenados en prepareForValidation
+                 *     (el panel los manda siempre; un cliente de la API no tiene por qué).
+                 */
+                discount_val?: number | null;
+                tax?: number | null;
+                total?: number | null;
+            }[];
+        };
+        /** ReceivedInvoiceResource */
+        ReceivedInvoiceResource: {
+            id: string;
+            received_invoice_date: string;
+            due_date: string;
+            received_invoice_number: string;
+            reference_number: string;
+            status: string;
             paid_status: string;
             tax_per_item: string;
             discount_per_item: string;
@@ -3670,6 +4137,91 @@ export interface components {
             company?: components["schemas"]["CompanyResource"];
             currency?: components["schemas"]["CurrencyResource"];
         };
+        /** RecurringInvoiceRequest */
+        RecurringInvoiceRequest: {
+            starts_at: string;
+            /**
+             * @description Los tres de abajo el panel los manda siempre porque su formulario los
+             *     tiene a mano (stub/recurring-invoice.js: send_automatically true, status
+             *     ACTIVE, limit_by NONE). Exigirlos obligaba a un cliente de la API a
+             *     declarar decisiones que tienen un valor por defecto obvio; los pone
+             *     getRecurringInvoicePayload con ese mismo valor.
+             */
+            send_automatically?: boolean | null;
+            status?: string | null;
+            limit_by?: string | null;
+            customer_id: number;
+            exchange_rate?: string | null;
+            /**
+             * @description Descuento global: opcional en el contrato y rellenado a 0 en
+             *     prepareForValidation (el panel lo manda siempre, un cliente de la API
+             *     no tiene por qué). Ver DocumentHeaderPayload.
+             */
+            discount?: number | null;
+            discount_val?: number | null;
+            /**
+             * @description Agregados: desde este cambio el servidor es su oráculo también aquí
+             *     —DocumentTotals los recompone desde las líneas y
+             *     getRecurringInvoicePayload los sobrescribe—, así que exigirlos era
+             *     pedirle al cliente un cálculo que se va a descartar. Si llegan, se
+             *     comprueban contra las líneas (ValidatesDocumentTotals).
+             */
+            sub_total?: number | null;
+            total?: number | null;
+            tax?: string | null;
+            /**
+             * @description Igual que en facturas y presupuestos desde el #296: si no llega, la pone
+             *     el payload. Un cliente de la API no tiene por qué conocer el nombre
+             *     interno de una plantilla.
+             */
+            template_name?: string | null;
+            frequency: string;
+            limit_count?: string;
+            limit_date?: string;
+            items: {
+                name: string;
+                quantity: number;
+                price: number;
+                description?: string | null;
+                /**
+                 * @description Derivables: opcionales en el contrato y rellenados en prepareForValidation
+                 *     (el panel los manda siempre; un cliente de la API no tiene por qué).
+                 */
+                discount_val?: number | null;
+                tax?: number | null;
+                total?: number | null;
+                /**
+                 * @description Impuestos, por línea o de documento. El `amount` es opcional: si no
+                 *     llega, lo deriva el servidor del porcentaje (DocumentTaxPayload), así
+                 *     que un cliente de la API puede declarar «IVA 21 %» sin calcular nada;
+                 *     el panel sigue mandándolo ya hecho.
+                 */
+                taxes?: {
+                    tax_type_id?: number | null;
+                    percent?: number | null;
+                    amount?: number | null;
+                }[] | null;
+            }[];
+            taxes?: {
+                tax_type_id?: number | null;
+                percent?: number | null;
+                amount?: number | null;
+            }[] | null;
+            /**
+             * @description Sin `in:YES,NO`: hay documentos antiguos persistidos con 'NO ' (el
+             *     espacio de más que arrastraba este mismo request), y el panel reenvía
+             *     al editar lo que leyó. Se normaliza al leerlo, no se rechaza.
+             */
+            tax_per_item?: string | null;
+            tax_included?: boolean | null;
+            /** @description Valores de campo personalizado del recurso. `id` es el de la definición, que se descubre en `GET /custom-fields` (catálogo `meta`, legible con cualquier token); las definiciones las crea el dueño del tenant desde su panel. Se devuelven en la clave `fields` del recurso. */
+            customFields?: {
+                /** @description Id de la definición del campo personalizado. */
+                id: number;
+                /** @description Valor a guardar. */
+                value: string;
+            }[];
+        };
         /** RecurringInvoiceResource */
         RecurringInvoiceResource: {
             id: string;
@@ -3713,7 +4265,16 @@ export interface components {
             currency?: components["schemas"]["CurrencyResource"];
         };
         /** Role */
-        Role: string[];
+        Role: {
+            id: number;
+            name: string;
+            title: string | null;
+            scope: number | null;
+            /** Format: date-time */
+            created_at: string | null;
+            /** Format: date-time */
+            updated_at: string | null;
+        };
         /** RoleResource */
         RoleResource: {
             id: string;
@@ -3723,7 +4284,12 @@ export interface components {
             formatted_created_at: string | null;
             abilities: string | string[];
         };
-        /** SendEstimatesRequest */
+        /**
+         * SendEstimatesRequest
+         * @description Mandar un presupuesto por correo (`POST /estimates/{id}/send`) y su vista
+         *     previa. Todo el cuerpo —y el remitente que pone la instancia— está en
+         *     {@see SendDocumentMailRequest}.
+         */
         SendEstimatesRequest: {
             subject: string;
             body: string;
@@ -3732,16 +4298,26 @@ export interface components {
             cc?: string | null;
             bcc?: string | null;
         };
-        /** SendInvoiceRequest */
+        /**
+         * SendInvoiceRequest
+         * @description Mandar una factura por correo (`POST /invoices/{id}/send`) y su vista previa.
+         *     Todo el cuerpo —y el remitente que pone la instancia— está en
+         *     {@see SendDocumentMailRequest}.
+         */
         SendInvoiceRequest: {
-            body: string;
             subject: string;
+            body: string;
             from: string;
             to: string;
             cc?: string | null;
             bcc?: string | null;
         };
-        /** SendPaymentRequest */
+        /**
+         * SendPaymentRequest
+         * @description Mandar un recibo de pago por correo (`POST /payments/{id}/send`) y su vista
+         *     previa. Todo el cuerpo —y el remitente que pone la instancia— está en
+         *     {@see SendDocumentMailRequest}.
+         */
         SendPaymentRequest: {
             subject: string;
             body: string;
@@ -3756,6 +4332,54 @@ export interface components {
             formatted_execution_date: string;
             formatted_total: string;
         };
+        /**
+         * StoreApprovalRequest
+         * @description POST /api/v1/approvals (paso 2, plataforma de integradores) — una app de
+         *     partner propone un write-effect sobre el tenant. La forma de `proposal` es
+         *     EXACTAMENTE la del contrato estructurado del flujo de delegación
+         *     (summary + changes[] + evals[], ver
+         *     {@see \App\Http\Controllers\Api\TenantDelegationCallbackController::structuredResultRules}):
+         *     misma primitiva, mismo panel, misma decisión del owner.
+         *
+         *     La autorización NO va aquí: es scope (api.scopes, dominio `approvals`) +
+         *     credencial de partner (token OAuth con ability `approvals:write`), que el
+         *     controller comprueba explícitamente — el partner no es owner del tenant y no
+         *     pasa gate de Bouncer.
+         */
+        StoreApprovalRequest: {
+            title: string;
+            task_type?: string | null;
+            context?: string | null;
+            /** @description Propuesta estructurada — réplica del contrato del flujo actual. */
+            proposal: {
+                schema_version?: number | null;
+                /** @enum {string|null} */
+                mode?: "applied" | "preview" | null;
+                agent_trace_id?: string | null;
+                summary: string;
+                changes?: {
+                    label: string;
+                    type?: string | null;
+                    action?: string | null;
+                    link?: string | null;
+                    record_id?: string | null;
+                    apply?: string[] | null;
+                }[] | null;
+                evals?: {
+                    label: string;
+                    pass: boolean;
+                    detail?: string | null;
+                    nivel?: number | null;
+                    cuenta_para_sello?: boolean | null;
+                }[] | null;
+                verifiability?: {
+                    nivel?: number | null;
+                    cuenta_para_sello?: boolean | null;
+                    /** @enum {string|null} */
+                    sello?: "pass" | "fail" | "n/a" | null;
+                } | null;
+            };
+        };
         /** SupplierRequest */
         SupplierRequest: {
             name: string;
@@ -3790,6 +4414,13 @@ export interface components {
                 phone?: string | null;
                 fax?: string | null;
             };
+            /** @description Valores de campo personalizado del recurso. `id` es el de la definición, que se descubre en `GET /custom-fields` (catálogo `meta`, legible con cualquier token); las definiciones las crea el dueño del tenant desde su panel. Se devuelven en la clave `fields` del recurso. */
+            customFields?: {
+                /** @description Id de la definición del campo personalizado. */
+                id: number;
+                /** @description Valor a guardar. */
+                value: string;
+            }[];
         };
         /** SupplierResource */
         SupplierResource: {
@@ -3870,6 +4501,13 @@ export interface components {
                 agent_skill: string | null;
                 status: string;
                 hermes_kanban_id: string | null;
+                /**
+                 * @description Paso 2 (integradores): el panel pinta «propuesto por X» cuando la
+                 *     propuesta viene de una app de partner y no del agente Pim.
+                 */
+                plane: string;
+                origin_client_id: string | null;
+                origin_client_name: string | null;
                 /** @description Lazo de verificar (Fase 2): lo que el panel pinta del callback. */
                 result: string | null;
                 result_data: unknown[] | null;
@@ -4065,16 +4703,16 @@ export interface components {
             formatted_created_at: string;
             currency?: components["schemas"]["CurrencyResource"];
             companies?: {
-                id: string;
+                id: number;
                 name: string;
                 trade_name: string;
-                vat_id: string;
+                vat_id: string | null;
                 tax_id: string;
-                logo: string;
+                logo: string | null;
                 logo_path: string;
-                unique_hash: string;
+                unique_hash: string | null;
                 owner_id: string;
-                slug: string;
+                slug: string | null;
                 address?: components["schemas"]["AddressResource"];
                 roles: components["schemas"]["RoleResource"][];
                 role: string | null;
@@ -4133,7 +4771,11 @@ export interface operations {
     "accountingSummary.index": {
         parameters: {
             query?: {
-                year?: string;
+                from_date?: string | null;
+                to_date?: string | null;
+                quarter?: number | null;
+                year?: number | null;
+                group_by?: "customer" | "category" | null;
             };
             header?: never;
             path?: never;
@@ -4158,9 +4800,38 @@ export interface operations {
                             irpf: number;
                             result: string;
                         }[];
+                    } | {
+                        data: {
+                            from_date: unknown;
+                            to_date: unknown;
+                            total_sales: number;
+                            total_received: number;
+                            total_expenses: string;
+                            net_profit: string;
+                            vat_collected: number;
+                            vat_paid: number;
+                            vat_balance: string;
+                            irpf: number;
+                            invoices_count: number;
+                            received_invoices_count: number;
+                            expenses_count: number;
+                            tax_breakdown: {
+                                name: string;
+                                percent: number;
+                                base: number;
+                                tax_amount: number;
+                            }[];
+                            by_customer: {
+                                customer_name: string | "Sin cliente";
+                                total: number;
+                                count: number;
+                            }[];
+                            by_category: unknown[];
+                        };
                     };
                 };
             };
+            422: components["responses"]["ValidationException"];
         };
     };
     appVersion: {
@@ -4214,7 +4885,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AppointmentRequest"];
+            };
+        };
         responses: {
             200: {
                 headers: {
@@ -4237,6 +4912,7 @@ export interface operations {
                     };
                 };
             };
+            422: components["responses"]["ValidationException"];
         };
     };
     "appointment.show": {
@@ -4274,7 +4950,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AppointmentRequest"];
+            };
+        };
         responses: {
             200: {
                 headers: {
@@ -4287,6 +4967,7 @@ export interface operations {
                 };
             };
             404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
         };
     };
     "appointment.destroy": {
@@ -4314,7 +4995,7 @@ export interface operations {
             404: components["responses"]["ModelNotFoundException"];
         };
     };
-    "auth.login": {
+    "approvals.store": {
         parameters: {
             query?: never;
             header?: never;
@@ -4323,30 +5004,75 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["LoginRequest"];
+                "application/json": components["schemas"]["StoreApprovalRequest"];
             };
         };
         responses: {
-            200: {
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        approval: {
+                            id: number;
+                            plane: string;
+                            title: string;
+                            task_type: string | null;
+                            context: unknown[] | null;
+                            /**
+                             * @description pending|in_progress|completed|failed — para el partner:
+                             *     in_progress = pendiente de decisión; completed = aprobada;
+                             *     failed = rechazada.
+                             */
+                            status: string;
+                            proposal: unknown[] | null;
+                            /**
+                             * @description proposed|needs_changes|approved|rejected. `needs_changes` NO es
+                             *     terminal: el owner pidió una revisión — en v1 el partner remite
+                             *     una propuesta nueva (no hay PATCH) o espera la decisión.
+                             */
+                            proposal_status: string | null;
+                            result: string | null;
+                            proposed_at: string;
+                            created_at: string;
+                            updated_at: string;
+                        };
+                    };
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        message: "Este endpoint exige un token OAuth de app de partner con el scope approvals:write.";
+                    };
+                };
+            };
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
                         /** @constant */
-                        type: "Bearer";
-                        token: string;
+                        message: "No hay un tenant en contexto para esta propuesta.";
                     };
                 };
             };
             422: components["responses"]["ValidationException"];
         };
     };
-    "auth.logout": {
+    "approvals.show": {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                id: number;
+            };
             cookie?: never;
         };
         requestBody?: never;
@@ -4357,27 +5083,53 @@ export interface operations {
                 };
                 content: {
                     "application/json": {
-                        success: boolean;
+                        approval: {
+                            id: number;
+                            plane: string;
+                            title: string;
+                            task_type: string | null;
+                            context: unknown[] | null;
+                            /**
+                             * @description pending|in_progress|completed|failed — para el partner:
+                             *     in_progress = pendiente de decisión; completed = aprobada;
+                             *     failed = rechazada.
+                             */
+                            status: string;
+                            proposal: unknown[] | null;
+                            /**
+                             * @description proposed|needs_changes|approved|rejected. `needs_changes` NO es
+                             *     terminal: el owner pidió una revisión — en v1 el partner remite
+                             *     una propuesta nueva (no hay PATCH) o espera la decisión.
+                             */
+                            proposal_status: string | null;
+                            result: string | null;
+                            proposed_at: string;
+                            created_at: string;
+                            updated_at: string;
+                        };
                     };
                 };
             };
-        };
-    };
-    "auth.check": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": boolean;
+                    "application/json": {
+                        /** @constant */
+                        message: "Este endpoint exige un token OAuth de app de partner con el scope approvals:write.";
+                    };
+                };
+            };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        message: "No hay un tenant en contexto para esta propuesta.";
+                    };
                 };
             };
         };
@@ -4730,7 +5482,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ChangeInvoiceStatusRequest"];
+            };
+        };
         responses: {
             200: {
                 headers: {
@@ -4754,26 +5510,7 @@ export interface operations {
                 };
             };
             403: components["responses"]["AuthorizationException"];
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        success: boolean;
-                        /** @constant */
-                        message: "Solo se pueden completar facturas ya publicadas o enviadas.";
-                    } | {
-                        success: boolean;
-                        /** @constant */
-                        message: "Solo se pueden enviar facturas en estado borrador o publicada.";
-                    } | {
-                        success: boolean;
-                        /** @constant */
-                        message: "Solo se pueden publicar facturas en estado borrador.";
-                    };
-                };
-            };
+            422: components["responses"]["ValidationException"];
         };
     };
     "estimate.cloneEstimate": {
@@ -4939,167 +5676,303 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description `ContactResource` */
+            /** @description `ContactResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ContactResource"];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+        };
+    };
+    "contact.update": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The contact ID */
+                contact: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ContactRequest"];
+            };
+        };
+        responses: {
+            /** @description `ContactResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ContactResource"];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
+    "contact.destroy": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The contact ID */
+                contact: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        success: boolean;
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+        };
+    };
+    "estimate.convertEstimate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The estimate ID */
+                estimate: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+        };
+    };
+    "general.countries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Array of `CountryResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["CountryResource"][];
+                    };
+                };
+            };
+        };
+    };
+    "invoice.creditNote": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                invoice: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        data: components["schemas"]["ContactResource"];
-                    };
+                    "application/json": Record<string, never>;
                 };
             };
             403: components["responses"]["AuthorizationException"];
-            404: components["responses"]["ModelNotFoundException"];
         };
     };
-    "contact.update": {
+    "general.currencies": {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description The contact ID */
-                contact: number;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["ContactRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
-            /** @description `ContactResource` */
+            /** @description Array of `CurrencyResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        data: components["schemas"]["ContactResource"];
+                        data: components["schemas"]["CurrencyResource"][];
                     };
                 };
             };
-            403: components["responses"]["AuthorizationException"];
-            404: components["responses"]["ModelNotFoundException"];
-            422: components["responses"]["ValidationException"];
         };
     };
-    "contact.destroy": {
+    "custom-fields.index": {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description The contact ID */
-                contact: number;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
+            /** @description Array of `CustomFieldResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        success: boolean;
+                        data: components["schemas"]["CustomFieldResource"][];
                     };
                 };
             };
             403: components["responses"]["AuthorizationException"];
-            404: components["responses"]["ModelNotFoundException"];
         };
     };
-    "estimate.convertEstimate": {
+    "custom-fields.store": {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description The estimate ID */
-                estimate: number;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CustomFieldRequest"];
+            };
+        };
         responses: {
+            /** @description `CustomFieldResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": Record<string, never>;
+                    "application/json": {
+                        data: components["schemas"]["CustomFieldResource"];
+                    };
                 };
             };
             403: components["responses"]["AuthorizationException"];
-            404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
         };
     };
-    "general.countries": {
+    "custom-fields.show": {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description The custom field ID */
+                customField: number;
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Array of `CountryResource` */
+            /** @description `CustomFieldResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        data: components["schemas"]["CountryResource"][];
+                        data: components["schemas"]["CustomFieldResource"];
                     };
                 };
             };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
         };
     };
-    "invoice.creditNote": {
+    "custom-fields.update": {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                invoice: string;
+                /** @description The custom field ID */
+                customField: number;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CustomFieldRequest"];
+            };
+        };
         responses: {
+            /** @description `CustomFieldResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": Record<string, never>;
+                    "application/json": {
+                        data: components["schemas"]["CustomFieldResource"];
+                    };
                 };
             };
             403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
         };
     };
-    "general.currencies": {
+    "custom-fields.destroy": {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description The custom field ID */
+                customField: number;
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Array of `CurrencyResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        data: components["schemas"]["CurrencyResource"][];
+                        success: boolean;
                     };
                 };
             };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
         };
     };
     "customer.customerStats": {
@@ -5790,7 +6663,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EstimatesRequest"];
+            };
+        };
         responses: {
             /** @description `EstimateResource` */
             200: {
@@ -5844,7 +6721,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EstimatesRequest"];
+            };
+        };
         responses: {
             /** @description `EstimateResource` */
             200: {
@@ -6056,7 +6937,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "multipart/form-data": components["schemas"]["ExpenseRequest"];
+            };
+        };
         responses: {
             /** @description `ExpenseResource` */
             200: {
@@ -6110,7 +6995,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "multipart/form-data": components["schemas"]["ExpenseRequest"];
+            };
+        };
         responses: {
             /** @description `ExpenseResource` */
             200: {
@@ -6229,40 +7118,6 @@ export interface operations {
             422: components["responses"]["ValidationException"];
         };
     };
-    "forgotPassword.sendResetLinkEmail": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        /** @constant */
-                        message: "Password reset email sent.";
-                        data: string;
-                    };
-                };
-            };
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        /** @constant */
-                        error: "Email could not be sent to this email address.";
-                    };
-                };
-            };
-        };
-    };
     "exchangeRate.getActiveProvider": {
         parameters: {
             query?: never;
@@ -6651,7 +7506,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["InvoiceSeriesRequest"];
+            };
+        };
         responses: {
             /** @description `InvoiceSeriesResource` */
             200: {
@@ -6665,6 +7524,7 @@ export interface operations {
                 };
             };
             403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
         };
     };
     "invoice-series.show": {
@@ -6704,7 +7564,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["InvoiceSeriesRequest"];
+            };
+        };
         responses: {
             /** @description `InvoiceSeriesResource` */
             200: {
@@ -6719,6 +7583,7 @@ export interface operations {
             };
             403: components["responses"]["AuthorizationException"];
             404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
         };
     };
     "invoice-series.destroy": {
@@ -6804,7 +7669,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["InvoiceTemplatePreviewRequest"];
+            };
+        };
         responses: {
             200: {
                 headers: {
@@ -6816,6 +7685,7 @@ export interface operations {
             };
             403: components["responses"]["AuthorizationException"];
             404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
         };
     };
     "invoiceTemplate.showLetterhead": {
@@ -6936,7 +7806,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["InvoiceTemplateRequest"];
+            };
+        };
         responses: {
             /** @description `InvoiceTemplateResource` */
             200: {
@@ -6950,6 +7824,7 @@ export interface operations {
                 };
             };
             403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
         };
     };
     "invoice-templates.show": {
@@ -6989,7 +7864,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["InvoiceTemplateRequest"];
+            };
+        };
         responses: {
             /** @description `InvoiceTemplateResource` */
             200: {
@@ -7004,17 +7883,7 @@ export interface operations {
             };
             403: components["responses"]["AuthorizationException"];
             404: components["responses"]["ModelNotFoundException"];
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        /** @constant */
-                        message: "Las plantillas del sistema no se pueden modificar. Crea una copia para personalizarla.";
-                    };
-                };
-            };
+            422: components["responses"]["ValidationException"];
         };
     };
     "invoice-templates.destroy": {
@@ -7175,11 +8044,9 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: {
+        requestBody: {
             content: {
-                "application/json": components["schemas"]["InvoicesRequest"] & {
-                    items?: string;
-                };
+                "application/json": components["schemas"]["InvoicesRequest"];
             };
         };
         responses: {
@@ -7232,11 +8099,9 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: {
+        requestBody: {
             content: {
-                "application/json": components["schemas"]["InvoicesRequest"] & {
-                    items?: string;
-                };
+                "application/json": components["schemas"]["InvoicesRequest"];
             };
         };
         responses: {
@@ -7984,9 +8849,17 @@ export interface operations {
     };
     "general.nextNumber": {
         parameters: {
-            query?: {
-                invoice_series_id?: string;
-                series_id?: string;
+            query: {
+                /** @description Tipo de documento cuyo número se calcula. Obligatorio: un valor fuera de la lista devuelve `success: false`. */
+                key: "invoice" | "credit_note" | "estimate" | "payment" | "delivery_note" | "received_invoice";
+                /** @description Serie de facturación a usar (solo `key=invoice`). Sin ella manda la serie por defecto de la empresa. `invoice_series_id` es su alias histórico y solo se mira si `series_id` no viene. */
+                series_id?: number;
+                /** @description Alias histórico de `series_id`. En clientes nuevos usa `series_id`. */
+                invoice_series_id?: number;
+                /** @description Id del documento que se está EDITANDO. Con él el cálculo reutiliza la secuencia que ese documento ya tiene en vez de proponer la siguiente; sin él siempre propone la siguiente. */
+                model_id?: number;
+                /** @description Id del cliente, para los formatos de numeración que llevan su serie o su contador (`{{CUSTOMER_SERIES}}`, `{{CUSTOMER_SEQUENCE}}`). Irrelevante en el resto de formatos. */
+                userId?: number;
             };
             header?: never;
             path?: never;
@@ -7994,12 +8867,18 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
+            /** @description Siempre `200`, también cuando falla: el discriminante es `success`. `nextNumber` es el número propuesto (`null` si `success` es `false`) e `isUsed` dice si la empresa ya tiene algún documento de ese tipo — el panel lo usa para saber si el formato de numeración todavía se puede cambiar. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": Record<string, never>;
+                    "application/json": {
+                        success: boolean;
+                        nextNumber: string | null;
+                        isUsed: boolean;
+                        message?: string;
+                    };
                 };
             };
         };
@@ -8317,7 +9196,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PaymentRequest"];
+            };
+        };
         responses: {
             /** @description `PaymentResource` */
             200: {
@@ -8371,7 +9254,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PaymentRequest"];
+            };
+        };
         responses: {
             /** @description `PaymentResource` */
             200: {
@@ -8829,7 +9716,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ReceivedInvoiceRequest"];
+            };
+        };
         responses: {
             /** @description `ReceivedInvoiceResource` */
             200: {
@@ -8881,7 +9772,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ReceivedInvoiceRequest"];
+            };
+        };
         responses: {
             /** @description `ReceivedInvoiceResource` */
             200: {
@@ -9171,7 +10066,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeleteRecurringInvoicesRequest"];
+            };
+        };
         responses: {
             200: {
                 headers: {
@@ -9184,6 +10083,7 @@ export interface operations {
                 };
             };
             403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
         };
     };
     "recurring-invoices.index": {
@@ -9219,7 +10119,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RecurringInvoiceRequest"];
+            };
+        };
         responses: {
             /** @description `RecurringInvoiceResource` */
             200: {
@@ -9273,7 +10177,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RecurringInvoiceRequest"];
+            };
+        };
         responses: {
             /** @description `RecurringInvoiceResource` */
             200: {
@@ -9313,39 +10221,6 @@ export interface operations {
             };
         };
     };
-    "resetPassword.reset": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": {
-                    token: string;
-                    /** Format: email */
-                    email: string;
-                    password: string;
-                    password_confirmation: string;
-                };
-            };
-        };
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        /** @constant */
-                        message: "Password reset successfully.";
-                    } | Record<string, never>;
-                };
-            };
-            422: components["responses"]["ValidationException"];
-        };
-    };
     "general.search": {
         parameters: {
             query?: never;
@@ -9535,8 +10410,8 @@ export interface operations {
     "invoice.sendInvoicePreview": {
         parameters: {
             query: {
-                body: string;
                 subject: string;
+                body: string;
                 from: string;
                 to: string;
                 cc?: string | null;
@@ -9597,7 +10472,14 @@ export interface operations {
     };
     "payment.sendPaymentPreview": {
         parameters: {
-            query?: never;
+            query: {
+                subject: string;
+                body: string;
+                from: string;
+                to: string;
+                cc?: string | null;
+                bcc?: string | null;
+            };
             header?: never;
             path: {
                 /** @description The payment ID */
@@ -9617,6 +10499,7 @@ export interface operations {
             };
             403: components["responses"]["AuthorizationException"];
             404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
         };
     };
     "sepaRemittance.eligibleInvoices": {
@@ -10018,6 +10901,13 @@ export interface operations {
                             agent_skill: string | null;
                             status: string;
                             hermes_kanban_id: string | null;
+                            /**
+                             * @description Paso 2 (integradores): el panel pinta «propuesto por X» cuando la
+                             *     propuesta viene de una app de partner y no del agente Pim.
+                             */
+                            plane: string;
+                            origin_client_id: string | null;
+                            origin_client_name: string | null;
                             /** @description Lazo de verificar (Fase 2): lo que el panel pinta del callback. */
                             result: string | null;
                             result_data: unknown[] | null;
@@ -10068,6 +10958,13 @@ export interface operations {
                             agent_skill: string | null;
                             status: string;
                             hermes_kanban_id: string | null;
+                            /**
+                             * @description Paso 2 (integradores): el panel pinta «propuesto por X» cuando la
+                             *     propuesta viene de una app de partner y no del agente Pim.
+                             */
+                            plane: string;
+                            origin_client_id: string | null;
+                            origin_client_name: string | null;
                             /** @description Lazo de verificar (Fase 2): lo que el panel pinta del callback. */
                             result: string | null;
                             result_data: unknown[] | null;
@@ -10100,6 +10997,13 @@ export interface operations {
                             agent_skill: string | null;
                             status: string;
                             hermes_kanban_id: string | null;
+                            /**
+                             * @description Paso 2 (integradores): el panel pinta «propuesto por X» cuando la
+                             *     propuesta viene de una app de partner y no del agente Pim.
+                             */
+                            plane: string;
+                            origin_client_id: string | null;
+                            origin_client_name: string | null;
                             /** @description Lazo de verificar (Fase 2): lo que el panel pinta del callback. */
                             result: string | null;
                             result_data: unknown[] | null;