@pimia/sdk 0.2.0 → 0.4.0

package/dist/api.d.ts

@@ -121,54 +121,6 @@ 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": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post: operations["auth.logout"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/auth/check": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get: operations["auth.check"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/bank-accounts": {
         parameters: {
             query?: never;
@@ -278,7 +230,25 @@ 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.
+         *
+         *     Asistente de arranque: fija el tipo de cambio de cada moneda en uso y
+         *     RECALCULA con él los importes base de todas las facturas, presupuestos y
+         *     pagos de esa moneda — documentos ya emitidos incluidos. Corre una sola vez
+         *     por empresa (mientras `bulk_exchange_rate_configured` sea 'NO').
+         *
+         *     Reescribir en masa los importes de documentos emitidos es configuración de
+         *     empresa, no una operación de uso diario: va con el mismo gate de owner que
+         *     el resto de lo que escribe en Settings. Hasta 2026-08-10 no tenía ninguno
+         *     —el FormRequest autoriza a todo el mundo— y para un token de API la única
+         *     barrera era que `settings:write` no esté en el catálogo OAuth.
+         *
+         *     OJO al frontend: el modal lo abre `LayoutBasic` en cuanto entra CUALQUIER
+         *     usuario con la marca a 'NO'. Sin la condición de owner que se añadió allí,
+         *     este gate deja a un empleado atrapado en un modal que no puede completar.
+         */
         post: operations["general.bulkExchangeRate"];
         delete?: never;
         options?: never;
@@ -429,7 +399,14 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Handle the incoming request */
+        /**
+         * Convertir un presupuesto en factura borrador
+         * @description Acepta `external_ref` para etiquetar la factura resultante **en el mismo
+         *     paso**. Etiquetarla después, con `PUT /invoices/{id}`, llega tarde:
+         *     `invoice.created` ya ha salido con la referencia nula, y entre las dos
+         *     llamadas hay una ventana en la que la factura existe y no la encuentras
+         *     por tu referencia.
+         */
         post: operations["estimate.convertEstimate"];
         delete?: never;
         options?: never;
@@ -498,7 +475,10 @@ export interface paths {
         /** Display a listing of the resource */
         get: operations["custom-fields.index"];
         put?: never;
-        /** Store a newly created resource in storage */
+        /**
+         * 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;
@@ -515,10 +495,16 @@ export interface paths {
         };
         /** Display the specified resource */
         get: operations["custom-fields.show"];
-        /** Update the specified resource in storage */
+        /**
+         * 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 */
+        /**
+         * 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;
@@ -906,23 +892,6 @@ export interface paths {
         trace?: never;
     };
     "/fiscal-quarters/toggle": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** Toggle lock state for a quarter */
-        post: operations["fiscalQuarter.toggle"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/auth/password/email": {
         parameters: {
             query?: never;
             header?: never;
@@ -932,14 +901,38 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Igual que el `sendResetLinkEmail()` del trait, pero con la validación en
-         *     un FormRequest en vez de en su `validateEmail()` privado: ahí dentro el
-         *     generador del OpenAPI no la ve y este endpoint se publicaba sin cuerpo.
-         *     Mismas reglas (`required|email`)
-         * @description La RESPUESTA, en cambio, ya no es la del trait: es SIEMPRE la misma,
-         *     exista el correo o no. Ver `respuestaNeutra()`.
+         * 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.
+         *
+         *     Cerrar un trimestre corta el alta y la edición de facturas emitidas y
+         *     recibidas con fecha en ese periodo ({@see FiscalQuarter::isLocked}); esta
+         *     misma acción lo REABRE. Es cierre contable, así que va con el gate de
+         *     owner que ya gobierna la configuración sensible del tenant.
+         *
+         *     Hasta 2026-08-10 no tenía ninguno: el `index` y el `toggle` colgaban de la
+         *     ability de LECTURA de informes que gatea la pantalla (VIEW_FINANCIAL_REPORT
+         *     en el router del panel), de modo que cualquiera que pudiera ver el informe
+         *     contable podía reabrir un ejercicio cerrado. Para un token de API la única
+         *     barrera era que `reports:write` no esté en el catálogo OAuth — una ausencia
+         *     que protegía por accidente y que este gate deja de necesitar.
+         *
+         *     El `index` sigue sin gate a propósito: leer qué trimestres están cerrados
+         *     es lo que pinta el panel y no cambia nada.
+         *
+         *     `locked` (opcional) es el ESTADO DESEADO, y es lo que deberían mandar los
+         *     clientes: con él la operación es idempotente y dice lo que quiere en vez
+         *     de depender de lo que había. Sin él se conserva el alternado histórico.
+         *
+         *     El alternado ciego tiene una carrera que no es teórica: el cliente decide
+         *     qué va a pasar leyendo un estado que ya puede haber cambiado. El panel
+         *     pinta «Cerrar T1» porque lo leyó abierto, otro usuario lo cierra, y el
+         *     clic acaba REABRIENDO el trimestre que su botón prometía cerrar. Por la
+         *     vía del MCP era peor: `toggle_fiscal_quarter_lock` declaraba este mismo
+         *     parámetro y el servidor lo ignoraba, así que un agente que pidiera cerrar
+         *     un trimestre ya cerrado lo abría — en una operación que el propio MCP
+         *     anuncia como PELIGROSA.
          */
-        post: operations["forgotPassword.sendResetLinkEmail"];
+        post: operations["fiscalQuarter.toggle"];
         delete?: never;
         options?: never;
         head?: never;
@@ -1597,7 +1590,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;
@@ -2195,23 +2212,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;
@@ -2538,7 +2538,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.
@@ -3024,6 +3026,22 @@ export interface components {
             created_at: string;
             updated_at: string;
         };
+        /**
+         * ConvertEstimateRequest
+         * @description Cuerpo —opcional— de la conversión de un presupuesto en factura.
+         */
+        ConvertEstimateRequest: {
+            /**
+             * @description Referencia externa: TU identificador para la factura que sale de
+             *     esta conversión (el id del pedido o de la venta cerrada en tu
+             *     sistema). Sin él la factura nace sin etiquetar y los webhooks
+             *     `invoice.created` e `invoice.paid` llegan con `external_ref`
+             *     nulo. El alcance es tu client OAuth, igual que en el alta
+             *     directa de facturas. Duplicada dentro de tu namespace → 422 con
+             *     `existing_id`, y la conversión entera se deshace.
+             */
+            external_ref?: string | null;
+        };
         /** CountryResource */
         CountryResource: {
             id: number;
@@ -3129,6 +3147,17 @@ export interface components {
             prefix?: string | null;
             tax_id?: string | null;
             notes?: string | null;
+            /**
+             * @description Referencia externa: TU identificador para este cliente (el id
+             *     del deal, del contacto o del pedido en tu sistema). El alcance
+             *     es tu client OAuth, así que dos integradores pueden usar la
+             *     misma cadena sin pisarse y ninguno ve la del otro. Se consulta
+             *     con `GET /customers?external_ref=…`, vuelve en el recurso y
+             *     viaja en los webhooks `customer.*`. Si ya la lleva otro cliente
+             *     tuyo, la respuesta es un 422 con `existing_id` — que es el
+             *     find-or-create sin mantener mapeo local. `null` la desvincula.
+             */
+            external_ref?: string | null;
             currency_id?: string | null;
             payment_method_id?: number | null;
             billing?: {
@@ -3153,6 +3182,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: {
@@ -3180,6 +3216,13 @@ export interface components {
             prefix: string;
             tax_id: string;
             notes: string;
+            /**
+             * @description Referencia externa DE QUIEN PREGUNTA: la resuelve el client OAuth
+             *     del token, así que dos integradores ven cada uno la suya y el
+             *     panel (sin client) ve la del namespace de la company. Siempre
+             *     presente aunque sea null, para que el tipo del SDK no alterne.
+             */
+            external_ref: string | null;
             iban: string;
             bic: string;
             sepa_mandate_id: string;
@@ -3321,6 +3364,12 @@ export interface components {
             template_name: string;
             customer_id: string;
             lead_id: string;
+            /**
+             * @description Referencia externa del client OAuth del token (null si no hay).
+             *     Es el asidero que `lead_id` no podía ser: aquel es un entero de
+             *     Pimia y no admite el cuid o el uuid de un CRM de fuera.
+             */
+            external_ref: string | null;
             exchange_rate: string;
             base_discount_val: string;
             base_sub_total: string;
@@ -3354,6 +3403,17 @@ export interface components {
             expiry_date?: string | null;
             customer_id?: number | null;
             lead_id?: number | null;
+            /**
+             * @description Referencia externa: TU identificador para este presupuesto (el
+             *     id de la oportunidad en tu CRM). Es el asidero que `lead_id` no
+             *     podía ser: aquel es un entero de Pimia y no admite un cuid ni un
+             *     uuid. El alcance es tu client OAuth. Se consulta con
+             *     `GET /estimates?external_ref=…` y viaja en el payload de
+             *     `estimate.accepted`, así que recuperas tu oportunidad en el
+             *     evento sin mantener ningún mapeo. Duplicada dentro de tu
+             *     namespace → 422 con `existing_id`. `null` la desvincula.
+             */
+            external_ref?: string | 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
@@ -3402,6 +3462,13 @@ export interface components {
                     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;
@@ -3415,6 +3482,13 @@ export interface components {
              */
             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: {
@@ -3448,6 +3522,10 @@ export interface components {
              * @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: {
@@ -3479,23 +3557,6 @@ export interface components {
             currency?: components["schemas"]["CurrencyResource"];
             payment_method?: components["schemas"]["PaymentMethodResource"];
         };
-        /**
-         * ForgotPasswordRequest
-         * @description Envío del enlace de restablecimiento (`POST /auth/password/email`).
-         *
-         *     Mismas reglas que el `validateEmail()` del trait
-         *     `Illuminate\Foundation\Auth\SendsPasswordResetEmails` (laravel/ui), palabra
-         *     por palabra. Estaban ahí dentro y por eso el OpenAPI publicaba este endpoint
-         *     sin cuerpo: el generador solo mira la acción del controlador, y la acción
-         *     venía entera del trait.
-         */
-        ForgotPasswordRequest: {
-            /**
-             * Format: email
-             * @description Correo de la cuenta. La respuesta no distingue si existe o no.
-             */
-            email: string;
-        };
         /** InvestmentAssetResource */
         InvestmentAssetResource: {
             id: string;
@@ -3573,6 +3634,11 @@ export interface components {
             template_name: string;
             invoice_series_id: string;
             customer_id: string;
+            /**
+             * @description Referencia externa del client OAuth del token (null si no hay):
+             *     cada integrador ve la suya y solo la suya.
+             */
+            external_ref: string | null;
             payment_method_id: string;
             recurring_invoice_id: string;
             sequence_number: string;
@@ -3724,6 +3790,15 @@ export interface components {
             due_date?: string | null;
             customer_id: number;
             invoice_number?: string | null;
+            /**
+             * @description Referencia externa: TU identificador para esta factura (el id
+             *     del pedido o de la suscripción en tu sistema). El alcance es tu
+             *     client OAuth. Se consulta con `GET /invoices?external_ref=…` y
+             *     viaja en los payloads de `invoice.created` e `invoice.paid`.
+             *     Duplicada dentro de tu namespace → 422 con `existing_id`.
+             *     `null` la desvincula.
+             */
+            external_ref?: string | null;
             exchange_rate?: string | null;
             /**
              * @description Descuento global: opcional en el contrato y rellenado a 0 en
@@ -3771,6 +3846,13 @@ export interface components {
                     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;
@@ -3784,6 +3866,13 @@ export interface components {
              */
             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[];
@@ -3841,6 +3930,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[];
@@ -3920,12 +4011,6 @@ export interface components {
                 name: string;
             } | null;
         };
-        /** LoginRequest */
-        LoginRequest: {
-            username: string;
-            password: string;
-            device_name: string;
-        };
         /** Note */
         Note: {
             id: number;
@@ -3958,10 +4043,27 @@ export interface components {
             customer_id: string;
             exchange_rate?: string | null;
             amount: number;
-            payment_number: string;
+            /**
+             * @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: {
@@ -4073,7 +4175,18 @@ export interface components {
             received_invoice_date: string;
             due_date?: string | null;
             supplier_id: string;
-            received_invoice_number: 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;
@@ -4216,6 +4329,13 @@ export interface components {
              */
             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: {
@@ -4409,6 +4529,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: {
@@ -4708,31 +4835,31 @@ export interface components {
         };
     };
     responses: {
-        /** @description Validation error */
-        ValidationException: {
+        /** @description Authorization error */
+        AuthorizationException: {
             headers: {
                 [name: string]: unknown;
             };
             content: {
                 "application/json": {
-                    /** @description Errors overview. */
+                    /** @description Error overview. */
                     message: string;
-                    /** @description A detailed description of each field that failed validation. */
-                    errors: {
-                        [key: string]: string[];
-                    };
                 };
             };
         };
-        /** @description Authorization error */
-        AuthorizationException: {
+        /** @description Validation error */
+        ValidationException: {
             headers: {
                 [name: string]: unknown;
             };
             content: {
                 "application/json": {
-                    /** @description Error overview. */
+                    /** @description Errors overview. */
                     message: string;
+                    /** @description A detailed description of each field that failed validation. */
+                    errors: {
+                        [key: string]: string[];
+                    };
                 };
             };
         };
@@ -5122,74 +5249,6 @@ export interface operations {
             };
         };
     };
-    "auth.login": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["LoginRequest"];
-            };
-        };
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        /** @constant */
-                        type: "Bearer";
-                        token: string;
-                    };
-                };
-            };
-            422: components["responses"]["ValidationException"];
-        };
-    };
-    "auth.logout": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        success: boolean;
-                    };
-                };
-            };
-        };
-    };
-    "auth.check": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": boolean;
-                };
-            };
-        };
-    };
     "bank-accounts.index": {
         parameters: {
             query?: never;
@@ -5492,6 +5551,7 @@ export interface operations {
                     "application/json": Record<string, never>;
                 };
             };
+            403: components["responses"]["AuthorizationException"];
             422: components["responses"]["ValidationException"];
         };
     };
@@ -5815,7 +5875,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["ConvertEstimateRequest"];
+            };
+        };
         responses: {
             200: {
                 headers: {
@@ -5827,6 +5891,7 @@ export interface operations {
             };
             403: components["responses"]["AuthorizationException"];
             404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
         };
     };
     "general.countries": {
@@ -6130,7 +6195,10 @@ export interface operations {
     };
     "customers.index": {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Devuelve solo el recurso que lleve esta referencia externa. El alcance es el client OAuth del token: cada integrador consulta las suyas y nunca ve las de otro. Combinado con la escritura de `external_ref`, es el find-or-create sin mantener ningún mapeo local. */
+                external_ref?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -6688,7 +6756,10 @@ export interface operations {
     };
     "estimates.index": {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Devuelve solo el recurso que lleve esta referencia externa. El alcance es el client OAuth del token: cada integrador consulta las suyas y nunca ve las de otro. Combinado con la escritura de `external_ref`, es el find-or-create sin mantener ningún mapeo local. */
+                external_ref?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -7150,6 +7221,7 @@ export interface operations {
                 "application/json": {
                     year: number;
                     quarter: number;
+                    locked?: boolean | null;
                 };
             };
         };
@@ -7171,35 +7243,7 @@ export interface operations {
                     };
                 };
             };
-            422: components["responses"]["ValidationException"];
-        };
-    };
-    "forgotPassword.sendResetLinkEmail": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["ForgotPasswordRequest"];
-            };
-        };
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        /** @constant */
-                        message: "Password reset email sent.";
-                        /** @constant */
-                        data: "passwords.sent";
-                    };
-                };
-            };
+            403: components["responses"]["AuthorizationException"];
             422: components["responses"]["ValidationException"];
         };
     };
@@ -8098,6 +8142,8 @@ export interface operations {
         parameters: {
             query?: {
                 limit?: string;
+                /** @description Devuelve solo el recurso que lleve esta referencia externa. El alcance es el client OAuth del token: cada integrador consulta las suyas y nunca ve las de otro. Combinado con la escritura de `external_ref`, es el find-or-create sin mantener ningún mapeo local. */
+                external_ref?: string;
             };
             header?: never;
             path?: never;
@@ -8934,9 +8980,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;
@@ -8944,12 +8998,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;
+                    };
                 };
             };
         };
@@ -10292,39 +10352,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;