@pimia/sdk 0.11.0 → 0.13.0

package/dist/api.d.ts

@@ -192,6 +192,22 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/contracts/{contract}/activate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["contract.activateContract"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/app/version": {
         parameters: {
             query?: never;
@@ -454,6 +470,22 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/contracts/{contract}/cancel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["contract.cancelContract"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/estimates/{estimate}/status": {
         parameters: {
             query?: never;
@@ -808,6 +840,79 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/contracts/{contract}/document": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["contractDocument.upload"];
+        delete: operations["contractDocument.destroy"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/contracts/delete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Borrado en lote (`POST /contracts/delete`). Fail-loud: un id no
+         *     borrable aborta el lote entero antes de borrar nada
+         */
+        post: operations["contracts.delete"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/contracts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["contracts.index"];
+        put?: never;
+        post: operations["contracts.store"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/contracts/{contract}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["contracts.show"];
+        put: operations["contracts.update"];
+        post?: never;
+        /**
+         * Borra UN contrato, el de la ruta. Solo en borrador: lo activo se
+         *     cancela, no se borra (decisión 8) — y eso es un 422 con el porqué, no
+         *     un 500 ni un borrado a medias
+         */
+        delete: operations["contracts.destroy"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/estimates/{estimate}/convert-to-invoice": {
         parameters: {
             query?: never;
@@ -2676,7 +2781,12 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Retrieve a list of existing Items */
+        /**
+         * Retrieve a list of existing Items
+         * @description El `@return` de JsonResponse se retira como en el índice de facturas:
+         *     nunca fue el tipo real y, con dos returns, dejaba la respuesta sin forma
+         *     en el spec.
+         */
         get: operations["items.index"];
         put?: never;
         /** Create Item */
@@ -3641,6 +3751,37 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/received-invoices/{id}/mark-goods-received": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Marca la mercancía de la factura recibida como RECIBIDA y suma sus líneas
+         *     al almacén — el espejo exacto del `mark-delivered` del albarán de venta
+         *     (estudio de stock, decisión S3)
+         * @description Es una acción explícita y no el alta de la factura a propósito: el OCR
+         *     crea borradores que se corrigen, y un borrador no es mercancía en la
+         *     estantería. El candado es `stock_added_at` —un instante, como el
+         *     `stock_deducted_at` del albarán (#473)— y hace la acción idempotente:
+         *     la segunda llamada es un 422, no una segunda suma.
+         *
+         *     Reglas espejo del albarán, también a propósito: solo mueven almacén las
+         *     líneas con `item_id`, y un artículo con `opening_stock` NULL («nunca ha
+         *     llevado stock») no se estrena por una compra — se estrena en su ficha o
+         *     con un ajuste, que son los gestos que significan «declaro existencias».
+         */
+        post: operations["receivedInvoices.markGoodsReceived"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/banking/transactions": {
         parameters: {
             query?: never;
@@ -3940,6 +4081,22 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/contracts/{contract}/renew": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["contract.renewContract"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/roles/{role}/abilities": {
         parameters: {
             query?: never;
@@ -4277,6 +4434,54 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/invoices/{invoice}/shared-link": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["invoice.sharedLink"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/contracts/{contract}/shared-link": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["contract.sharedLink"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/estimates/{estimate}/shared-link": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["estimate.sharedLink"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/expenses/{expense}/show/receipt": {
         parameters: {
             query?: never;
@@ -4392,6 +4597,60 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/items/{item}/stock-adjustments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Ajusta las existencias de un artículo y devuelve el asiento */
+        post: operations["item.stockAdjustments"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/stock-movements": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Los movimientos de stock de la empresa, del más nuevo al más viejo */
+        get: operations["stockMovements.index"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/items/{item}/stock-movements": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Los movimientos de stock de UN artículo — la pestaña «Movimientos» de su
+         *     ficha, la que responde «¿por qué tengo 47?»
+         */
+        get: operations["stockMovements.forItem"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/store/modules": {
         parameters: {
             query?: never;
@@ -5482,6 +5741,79 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/warehouses/{warehouse}/stock": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Las existencias de UN almacén, artículo a artículo
+         * @description La pregunta que la dimensión vino a contestar: «¿cuántos me quedan en la
+         *     tienda?». Sale de `item_warehouse_stock`, que es el reparto del contador
+         *     global y no una segunda cuenta: la suma por artículo de todos los
+         *     almacenes es exactamente `items.opening_stock`.
+         */
+        get: operations["warehouses.stock"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/warehouses": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Los almacenes de la empresa */
+        get: operations["warehouses.index"];
+        put?: never;
+        /** Da de alta un almacén */
+        post: operations["warehouses.store"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/warehouses/{warehouse}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["warehouses.show"];
+        /**
+         * Edita un almacén
+         * @description ⚠️ El por defecto no se puede APAGAR desde aquí: se cambia encendiendo
+         *     otro, que apaga este en la misma transacción. Un `is_default: false`
+         *     sobre el único que lo tiene dejaría a la empresa sin sitio donde anotar
+         *     lo que no elige, y el 422 lo dice en vez de aceptarlo y romperse luego.
+         */
+        put: operations["warehouses.update"];
+        post?: never;
+        /**
+         * Borra un almacén VACÍO y sin historia
+         * @description Tres negativas, y las tres con su código: el por defecto no se borra
+         *     (`default_warehouse_required`), uno con asientos tampoco
+         *     (`stock_movements_attached` — el asiento lo nombra, y la historia del
+         *     almacén es lo que hace de fiar el saldo), y uno con existencias, menos
+         *     (`stock_attached`: borrarlo evaporaría un saldo que sí está en el
+         *     contador global). Para el que ya no se usa está `is_active: false`.
+         */
+        delete: operations["warehouses.destroy"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/settings/webhooks": {
         parameters: {
             query?: never;
@@ -5710,6 +6042,23 @@ export interface components {
                 name: string;
             } | null;
         };
+        /**
+         * ActivateContractRequest
+         * @description Activación de un contrato (`POST /contracts/{contract}/activate`).
+         *
+         *     Sin cuerpo, el contrato CREA su recurrente gobernada; con
+         *     `recurring_invoice_id`, ADOPTA esa — heredándole los límites del periodo
+         *     pero sin pisar su frecuencia, sus líneas ni sus impuestos, que son
+         *     configuración humana (Contract::activate()).
+         *
+         *     El `exists` va acotado por empresa por la misma lección de siempre (#395):
+         *     dentro de una instancia conviven varias empresas, y el id a secas casaría
+         *     la recurrente de otra. El modelo lo re-comprueba (empresa Y cliente), pero
+         *     el 422 de aquí llega antes y dice qué falla.
+         */
+        ActivateContractRequest: {
+            recurring_invoice_id?: number | null;
+        };
         /** AddressResource */
         AddressResource: {
             id: number;
@@ -5956,9 +6305,105 @@ export interface components {
             updated_at: string | null;
         };
         /**
-         * ConvertEstimateRequest
-         * @description Cuerpo —opcional— de la conversión de un presupuesto en factura.
-         */
+         * ContractRequest
+         * @description Alta y edición de un contrato (`POST /contracts`, `PUT /contracts/{id}`).
+         *
+         *     Dos decisiones que no son costumbre sino contrato (#583):
+         *
+         *      - **`status` NO se acepta aquí.** El ciclo de vida va por sus acciones
+         *        (`activate`/`cancel`/`renew`), que son las que gobiernan las recurrentes;
+         *        aceptar `status` en el PUT sería un contrato ACTIVE sin recurrente o
+         *        CANCELLED sin pausar nada — el estado mentiría. La lista blanca del
+         *        payload son estas reglas (ContractFields), así que no declararlo ya es
+         *        excluirlo.
+         *      - **Los cerrados llevan `Rule::in`**, y no solo por validar: el generador
+         *        del spec deduce el enum de la regla, y el estudio dejó medido lo que pasa
+         *        cuando no se hace — `frequency`/`status`/`limit_by` de la recurrente son
+         *        `string` sin enum en el contrato público y el SDK hereda esa opacidad.
+         */
+        ContractRequest: {
+            title: string;
+            description?: string | null;
+            contract_number?: string | null;
+            customer_id: number;
+            /** Format: date-time */
+            starts_at: string;
+            /**
+             * Format: date-time
+             * @description Nullable = contrato indefinido: la recurrente gobernada hereda
+             *     `limit_by = NONE`.
+             */
+            ends_at?: string | null;
+            /**
+             * @description Céntimos, enteros — la convención monetaria de la casa. El tope
+             *     es el mismo que el de `total` en documentos.
+             */
+            amount: number;
+            currency_id?: number | null;
+            /** @enum {string} */
+            billing_every: "MONTHLY" | "QUARTERLY" | "SEMIANNUAL" | "ANNUAL";
+            /**
+             * @description 1..31 y no 1..28: el 29-31 es entrada legítima («factúrame a fin
+             *     de mes») que la compilación fija al 28 — rechazarla aquí obligaría
+             *     al cliente a conocer una limitación de cron que es nuestra.
+             */
+            billing_anchor_day?: number | null;
+            /** @enum {string|null} */
+            renewal_mode?: "NONE" | "MANUAL" | "TACIT" | null;
+            /**
+             * @description Nullable = «usa el default del catálogo regional» (#584). El tope
+             *     corta los disparates sin opinar sobre ninguna legislación.
+             */
+            notice_days?: number | null;
+            /**
+             * @description El presupuesto de origen, acotado por empresa — la lección del
+             *     `item_id` de las recurrentes (#395): sin el `where`, un contrato
+             *     podía quedar apuntando al presupuesto de OTRA empresa del tenant.
+             */
+            estimate_id?: number | null;
+        };
+        /** ContractResource */
+        ContractResource: {
+            id: number;
+            title: string;
+            description: string | null;
+            contract_number: string | null;
+            customer_id: number | null;
+            company_id: number | null;
+            creator_id: number | null;
+            currency_id: number | null;
+            status: string;
+            ha_vencido: boolean;
+            starts_at: string | null;
+            ends_at: string | null;
+            amount: number | null;
+            billing_every: string;
+            billing_anchor_day: number | null;
+            renewal_mode: string;
+            notice_days: number | null;
+            /**
+             * @description El efectivo: el del contrato o el default del catálogo regional
+             *     (config/contracts.php). La pantalla enseña este, no el crudo.
+             */
+            notice_days_effective: number;
+            /**
+             * @description ¿Hay firmado adjunto? El fichero se sube por su POST multiparte
+             *     dedicado (#584) y se pisa al resubir.
+             */
+            has_document: boolean;
+            estimate_id: number | null;
+            /** Format: date-time */
+            cancelled_at: string | null;
+            fields?: components["schemas"]["CustomFieldValueResource"][];
+            customer?: components["schemas"]["CustomerResource"] | null;
+            estimate?: components["schemas"]["EstimateResource"] | null;
+            recurring_invoices?: components["schemas"]["RecurringInvoiceResource"][];
+            invoices?: components["schemas"]["InvoiceResource"][];
+        };
+        /**
+         * 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
@@ -6297,6 +6742,19 @@ export interface components {
              */
             external_ref: string | null;
         };
+        /**
+         * DeleteContractsRequest
+         * @description Borrado múltiple de contratos (`POST /contracts/delete`). Mismo patrón que
+         *     DeleteRecurringInvoicesRequest: el `exists` convierte el id inexistente en
+         *     un 422 que dice cuál falla, en vez del 500 de iterar sobre un `find()` nulo.
+         *
+         *     Lo que NO valida esto: que cada contrato esté en borrador. Esa es la regla
+         *     de negocio (decisión 8: lo activo se cancela, no se borra) y vive en
+         *     `Contract::deleteContracts()`, que aborta el lote entero en voz alta.
+         */
+        DeleteContractsRequest: {
+            ids: number[];
+        };
         /** DeleteCustomersRequest */
         DeleteCustomersRequest: {
             ids: number[];
@@ -6379,6 +6837,16 @@ export interface components {
             delivery_note_number: string | null;
             delivery_note_date: string;
             status: string;
+            /**
+             * Format: date-time
+             * @description Cuándo movió el almacén este albarán (NULL = aún no). El #473 lo
+             *     creó sin publicarlo y los clientes lo INFERÍAN del estado — que
+             *     es justo lo que `convertToInvoice` rompe al pisar `DELIVERED`
+             *     con `INVOICED`. Con el libro (estudio de stock, S1) deja de ser
+             *     contabilidad interna: es lo que la pantalla del albarán necesita
+             *     para contar lo que hizo.
+             */
+            stock_deducted_at: string | null;
             sub_total: number;
             total: number;
             tax: number;
@@ -7082,6 +7550,7 @@ export interface components {
             sent_at: string | null;
             /** Format: date-time */
             viewed_at: string | null;
+            contract_id: number | null;
         };
         /** InvoiceItem */
         InvoiceItem: {
@@ -7594,6 +8063,12 @@ export interface components {
             notes: string | null;
             price: number;
             purchase_price: number | null;
+            /**
+             * @description Coste medio ponderado en céntimos (S8, informativo): lo
+             *     recalcula cada compra recibida; NULL = aún no hay entradas con
+             *     coste anotadas.
+             */
+            average_cost_cents: number | null;
             default_discount: number;
             unit_id: number | null;
             company_id: number | null;
@@ -7620,6 +8095,62 @@ export interface components {
             taxes?: components["schemas"]["TaxResource"][];
             currency?: components["schemas"]["CurrencyResource"] | null;
         };
+        /** ItemSummaryResource */
+        ItemSummaryResource: {
+            id: number;
+            name: string;
+            item_type: string;
+            sku: string | null;
+            supplier_reference: string | null;
+            description: string | null;
+            price: number;
+            purchase_price: number | null;
+            average_cost_cents: number | null;
+            default_discount: number;
+            category_id: number | null;
+            category?: {
+                id: number;
+                name: string;
+            };
+            unit_id: number | null;
+            /**
+             * @description Del `leftJoin` del índice, no de la relación: es el único dato de
+             *     la unidad que los listados pintan.
+             */
+            unit_name: string | null;
+            company_id: number | null;
+            currency_id: number | null;
+            tax_per_item: string;
+            purchase_tax_type_id: number | null;
+            is_active: boolean;
+            is_time_trackable: boolean;
+            opening_stock: number;
+            stock_alert_qty: number | null;
+            allow_sale_without_stock: boolean;
+            /** Format: date-time */
+            created_at: string | null;
+            /** Format: date-time */
+            updated_at: string | null;
+            taxes?: {
+                id: number;
+                tax_type_id: number | null;
+                item_id: number | null;
+                company_id: number | null;
+                name: string;
+                amount: number;
+                percent: number;
+                base_amount: number;
+                currency_id: number | null;
+                type: string | null;
+            }[];
+        };
+        /** ItemWarehouseStockResource */
+        ItemWarehouseStockResource: {
+            item_id: number;
+            item_name: string;
+            warehouse_id: number;
+            quantity: number;
+        };
         /** ItemsRequest */
         ItemsRequest: {
             name: string;
@@ -7642,11 +8173,19 @@ export interface components {
             description?: string | null;
             notes?: string | null;
             is_active?: boolean | null;
+            /**
+             * @description Saldo de existencias del artículo. Pese al nombre NO es el
+             *     inicial: es el contador vivo que mueven albaranes, facturas,
+             *     compras y ajustes (el detalle, en `GET /items/{item}/stock-movements`).
+             *     En el alta se guarda 0 si no llega; en la actualización se
+             *     conserva el que había. Escribirlo aquí pisa el saldo (queda
+             *     anotado como `manual_edit`); para corregir con motivo está
+             *     `POST /items/{item}/stock-adjustments`.
+             */
+            opening_stock?: number | null;
             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: {
@@ -8128,6 +8667,14 @@ export interface components {
             received_invoice_number: string | null;
             reference_number: string | null;
             status: string;
+            /**
+             * Format: date-time
+             * @description Cuándo se sumó la mercancía al almacén (mark-goods-received);
+             *     NULL si aún no. Se publica —al contrario que en su día el
+             *     `stock_deducted_at` del albarán— porque es lo que permite a un
+             *     cliente pintar el botón «Mercancía recibida» solo cuando toca.
+             */
+            stock_added_at: string | null;
             paid_status: string;
             tax_per_item: string | null;
             discount_per_item: string | null;
@@ -8350,6 +8897,18 @@ export interface components {
             creator?: components["schemas"]["UserResource"] | null;
             currency?: components["schemas"]["CurrencyResource"] | null;
         };
+        /**
+         * RenewContractRequest
+         * @description Renovación manual de un contrato (`POST /contracts/{contract}/renew`).
+         *
+         *     Solo la fecha nueva: que sea POSTERIOR al fin actual —renovar es extender—
+         *     lo comprueba `Contract::renew()`, porque depende del estado del contrato y
+         *     no del cuerpo. La renovación tácita no pasa por aquí: es el job de fase 2.
+         */
+        RenewContractRequest: {
+            /** Format: date-time */
+            ends_at: string;
+        };
         /** Role */
         Role: {
             id: number;
@@ -8390,7 +8949,7 @@ export interface components {
              *     ningún permiso es una operación legítima, y `required` la
              *     prohibiría (un array vacío no pasa `required`).
              */
-            abilities: ("dashboard" | "view-customer" | "create-customer" | "edit-customer" | "delete-customer" | "view-estimate" | "create-estimate" | "edit-estimate" | "delete-estimate" | "send-estimate" | "view-invoice" | "create-invoice" | "edit-invoice" | "delete-invoice" | "send-invoice" | "view-recurring-invoice" | "create-recurring-invoice" | "edit-recurring-invoice" | "delete-recurring-invoice" | "view-payment" | "create-payment" | "edit-payment" | "delete-payment" | "send-payment" | "view-expense" | "create-expense" | "edit-expense" | "delete-expense" | "view-delivery-note" | "create-delivery-note" | "edit-delivery-note" | "delete-delivery-note" | "view-item" | "create-item" | "edit-item" | "delete-item" | "view-lead" | "create-lead" | "edit-lead" | "delete-lead" | "convert-lead" | "view-contact" | "create-contact" | "edit-contact" | "delete-contact" | "view-project" | "create-project" | "edit-project" | "delete-project" | "view-task" | "create-task" | "edit-task" | "delete-task" | "view-own-task" | "edit-own-task" | "view-time-entry" | "create-time-entry" | "edit-time-entry" | "delete-time-entry" | "view-own-time-entry" | "create-own-time-entry" | "edit-own-time-entry" | "delete-own-time-entry" | "view-tax-type" | "create-tax-type" | "edit-tax-type" | "delete-tax-type" | "view-custom-field" | "create-custom-field" | "edit-custom-field" | "delete-custom-field" | "view-role" | "create-role" | "edit-role" | "delete-role" | "view-financial-reports" | "view-all-notes" | "manage-all-notes" | "time_clock.punch" | "time_clock.view_own" | "time_clock.view_team" | "time_clock.correct" | "absence.request" | "absence.approve" | "report.download_legal" | "view-employee" | "create-employee" | "edit-employee" | "delete-employee" | "view-work-schedule" | "manage-work-schedule" | "view-work-calendar" | "manage-work-calendar" | "pos.operate" | "pos.supervise" | "pos.void" | "pos.discount_high" | "pos.cash_movement" | "pos.return" | "pos.admin" | "pos.report" | "view-appointment" | "create-appointment" | "edit-appointment" | "delete-appointment")[];
+            abilities: ("dashboard" | "view-customer" | "create-customer" | "edit-customer" | "delete-customer" | "view-estimate" | "create-estimate" | "edit-estimate" | "delete-estimate" | "send-estimate" | "view-invoice" | "create-invoice" | "edit-invoice" | "delete-invoice" | "send-invoice" | "view-recurring-invoice" | "create-recurring-invoice" | "edit-recurring-invoice" | "delete-recurring-invoice" | "view-payment" | "create-payment" | "edit-payment" | "delete-payment" | "send-payment" | "view-expense" | "create-expense" | "edit-expense" | "delete-expense" | "view-delivery-note" | "create-delivery-note" | "edit-delivery-note" | "delete-delivery-note" | "view-item" | "create-item" | "edit-item" | "delete-item" | "view-lead" | "create-lead" | "edit-lead" | "delete-lead" | "convert-lead" | "view-contact" | "create-contact" | "edit-contact" | "delete-contact" | "view-project" | "create-project" | "edit-project" | "delete-project" | "view-task" | "create-task" | "edit-task" | "delete-task" | "view-own-task" | "edit-own-task" | "view-time-entry" | "create-time-entry" | "edit-time-entry" | "delete-time-entry" | "view-own-time-entry" | "create-own-time-entry" | "edit-own-time-entry" | "delete-own-time-entry" | "view-tax-type" | "create-tax-type" | "edit-tax-type" | "delete-tax-type" | "view-custom-field" | "create-custom-field" | "edit-custom-field" | "delete-custom-field" | "view-role" | "create-role" | "edit-role" | "delete-role" | "view-financial-reports" | "view-all-notes" | "manage-all-notes" | "time_clock.punch" | "time_clock.view_own" | "time_clock.view_team" | "time_clock.correct" | "absence.request" | "absence.approve" | "report.download_legal" | "view-employee" | "create-employee" | "edit-employee" | "delete-employee" | "view-work-schedule" | "manage-work-schedule" | "view-work-calendar" | "manage-work-calendar" | "pos.operate" | "pos.supervise" | "pos.void" | "pos.discount_high" | "pos.cash_movement" | "pos.return" | "pos.admin" | "pos.report" | "view-appointment" | "create-appointment" | "edit-appointment" | "delete-appointment" | "view-contract" | "create-contract" | "edit-contract" | "delete-contract" | "view-warehouse" | "create-warehouse" | "edit-warehouse" | "delete-warehouse")[];
         };
         /**
          * RoleRequest
@@ -8415,7 +8974,7 @@ export interface components {
             name: string;
             abilities?: {
                 /** @enum {string} */
-                ability: "dashboard" | "view-customer" | "create-customer" | "edit-customer" | "delete-customer" | "view-estimate" | "create-estimate" | "edit-estimate" | "delete-estimate" | "send-estimate" | "view-invoice" | "create-invoice" | "edit-invoice" | "delete-invoice" | "send-invoice" | "view-recurring-invoice" | "create-recurring-invoice" | "edit-recurring-invoice" | "delete-recurring-invoice" | "view-payment" | "create-payment" | "edit-payment" | "delete-payment" | "send-payment" | "view-expense" | "create-expense" | "edit-expense" | "delete-expense" | "view-delivery-note" | "create-delivery-note" | "edit-delivery-note" | "delete-delivery-note" | "view-item" | "create-item" | "edit-item" | "delete-item" | "view-lead" | "create-lead" | "edit-lead" | "delete-lead" | "convert-lead" | "view-contact" | "create-contact" | "edit-contact" | "delete-contact" | "view-project" | "create-project" | "edit-project" | "delete-project" | "view-task" | "create-task" | "edit-task" | "delete-task" | "view-own-task" | "edit-own-task" | "view-time-entry" | "create-time-entry" | "edit-time-entry" | "delete-time-entry" | "view-own-time-entry" | "create-own-time-entry" | "edit-own-time-entry" | "delete-own-time-entry" | "view-tax-type" | "create-tax-type" | "edit-tax-type" | "delete-tax-type" | "view-custom-field" | "create-custom-field" | "edit-custom-field" | "delete-custom-field" | "view-role" | "create-role" | "edit-role" | "delete-role" | "view-financial-reports" | "view-all-notes" | "manage-all-notes" | "time_clock.punch" | "time_clock.view_own" | "time_clock.view_team" | "time_clock.correct" | "absence.request" | "absence.approve" | "report.download_legal" | "view-employee" | "create-employee" | "edit-employee" | "delete-employee" | "view-work-schedule" | "manage-work-schedule" | "view-work-calendar" | "manage-work-calendar" | "pos.operate" | "pos.supervise" | "pos.void" | "pos.discount_high" | "pos.cash_movement" | "pos.return" | "pos.admin" | "pos.report" | "view-appointment" | "create-appointment" | "edit-appointment" | "delete-appointment";
+                ability: "dashboard" | "view-customer" | "create-customer" | "edit-customer" | "delete-customer" | "view-estimate" | "create-estimate" | "edit-estimate" | "delete-estimate" | "send-estimate" | "view-invoice" | "create-invoice" | "edit-invoice" | "delete-invoice" | "send-invoice" | "view-recurring-invoice" | "create-recurring-invoice" | "edit-recurring-invoice" | "delete-recurring-invoice" | "view-payment" | "create-payment" | "edit-payment" | "delete-payment" | "send-payment" | "view-expense" | "create-expense" | "edit-expense" | "delete-expense" | "view-delivery-note" | "create-delivery-note" | "edit-delivery-note" | "delete-delivery-note" | "view-item" | "create-item" | "edit-item" | "delete-item" | "view-lead" | "create-lead" | "edit-lead" | "delete-lead" | "convert-lead" | "view-contact" | "create-contact" | "edit-contact" | "delete-contact" | "view-project" | "create-project" | "edit-project" | "delete-project" | "view-task" | "create-task" | "edit-task" | "delete-task" | "view-own-task" | "edit-own-task" | "view-time-entry" | "create-time-entry" | "edit-time-entry" | "delete-time-entry" | "view-own-time-entry" | "create-own-time-entry" | "edit-own-time-entry" | "delete-own-time-entry" | "view-tax-type" | "create-tax-type" | "edit-tax-type" | "delete-tax-type" | "view-custom-field" | "create-custom-field" | "edit-custom-field" | "delete-custom-field" | "view-role" | "create-role" | "edit-role" | "delete-role" | "view-financial-reports" | "view-all-notes" | "manage-all-notes" | "time_clock.punch" | "time_clock.view_own" | "time_clock.view_team" | "time_clock.correct" | "absence.request" | "absence.approve" | "report.download_legal" | "view-employee" | "create-employee" | "edit-employee" | "delete-employee" | "view-work-schedule" | "manage-work-schedule" | "view-work-calendar" | "manage-work-calendar" | "pos.operate" | "pos.supervise" | "pos.void" | "pos.discount_high" | "pos.cash_movement" | "pos.return" | "pos.admin" | "pos.report" | "view-appointment" | "create-appointment" | "edit-appointment" | "delete-appointment" | "view-contract" | "create-contract" | "edit-contract" | "delete-contract" | "view-warehouse" | "create-warehouse" | "edit-warehouse" | "delete-warehouse";
             }[] | null;
         };
         /** RoleResource */
@@ -8494,6 +9053,62 @@ export interface components {
         SettingRequest: {
             settings: string;
         };
+        /** StockAdjustmentRequest */
+        StockAdjustmentRequest: {
+            /**
+             * @description Cantidad FIRMADA que se aplica al contador: positiva repone,
+             *     negativa retira. Decimal a propósito (litros, kg); el contador
+             *     redondea y el asiento guarda la cantidad exacta.
+             */
+            quantity: number;
+            /**
+             * @description El motivo es obligatorio: un ajuste sin porqué es el contador
+             *     pisado de siempre, que es justo lo que el libro viene a retirar.
+             */
+            note: string;
+        };
+        /** StockMovementResource */
+        StockMovementResource: {
+            id: number;
+            item_id: number | null;
+            /**
+             * @description El nombre del artículo, para que el índice GLOBAL del libro sea
+             *     legible sin cruzarlo con el catálogo en el cliente. NULL cuando
+             *     el artículo ya no existe (`item_id` es nullOnDelete: el asiento
+             *     sobrevive al artículo y su nombre no — el cliente lo enseña como
+             *     «artículo borrado», que es la verdad). Los dos índices lo cargan
+             *     con `with('item:id,name')`: sin eso sería un N+1 por fila.
+             */
+            item_name: string | null;
+            /**
+             * @description DÓNDE pasó (N2). Los asientos anteriores a la dimensión están
+             *     todos en el «Principal» que estrenó la migración: es la única
+             *     respuesta verdadera, porque nadie declaró jamás dónde estaban.
+             *     NULL solo si el almacén desapareció (`nullOnDelete`), igual que
+             *     `item_name` — y con el mismo eager load, `warehouse:id,name`.
+             */
+            warehouse_id: number | null;
+            warehouse_name: string | null;
+            /**
+             * @description Cantidad FIRMADA que trajo la causa (decimal: hay artículos en
+             *     litros y kg). El contador redondea; la diferencia se ve en la
+             *     cadena de `balance_after`.
+             */
+            quantity: number;
+            balance_after: number;
+            /**
+             * @description El coste unitario de una ENTRADA, en céntimos (S8). NULL en las
+             *     salidas y en las entradas sin coste conocido.
+             */
+            unit_cost_cents: number | null;
+            reason: string;
+            document_type: string | null;
+            document_id: number | null;
+            note: string | null;
+            creator_id: number | null;
+            /** Format: date-time */
+            created_at: string;
+        };
         /**
          * StoreApprovalRequest
          * @description POST /api/v1/approvals (paso 2, plataforma de integradores) — una app de
@@ -9031,6 +9646,37 @@ export interface components {
                 role: string | null;
             }[];
         };
+        /** WarehouseRequest */
+        WarehouseRequest: {
+            name: string;
+            code?: string | null;
+            address?: string | null;
+            is_default?: boolean | null;
+            is_active?: boolean | null;
+        };
+        /** WarehouseResource */
+        WarehouseResource: {
+            id: number;
+            name: string;
+            code: string | null;
+            address: string | null;
+            /**
+             * @description Exactamente uno por empresa lo lleva puesto: es el que hereda
+             *     todo movimiento que no elige almacén, que hoy son casi todos
+             *     (solo albarán y recepción preguntan).
+             */
+            is_default: boolean;
+            /**
+             * @description Un almacén con historia no se borra —el asiento lo nombra—: se
+             *     desactiva. Desactivado no se ofrece para movimientos nuevos y
+             *     sigue explicando los viejos.
+             */
+            is_active: boolean;
+            /** Format: date-time */
+            created_at: string | null;
+            /** Format: date-time */
+            updated_at: string | null;
+        };
         /** WorkCalendarRequest */
         WorkCalendarRequest: {
             name: string;
@@ -9475,6 +10121,38 @@ export interface operations {
             422: components["responses"]["ValidationException"];
         };
     };
+    "contract.activateContract": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The contract ID */
+                contract: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["ActivateContractRequest"];
+            };
+        };
+        responses: {
+            /** @description `ContractResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ContractResource"];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
     appVersion: {
         parameters: {
             query?: never;
@@ -10123,6 +10801,44 @@ export interface operations {
             422: components["responses"]["ValidationException"];
         };
     };
+    "contract.cancelContract": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The contract ID */
+                contract: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description `ContractResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ContractResource"];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        success: boolean;
+                        message: string;
+                    };
+                };
+            };
+        };
+    };
     "estimate.changeEstimateStatus": {
         parameters: {
             query?: never;
@@ -10454,80 +11170,310 @@ export interface operations {
             };
         };
     };
-    "connectedApps.index": {
+    "connectedApps.index": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            id: number;
+                            name: string;
+                            confidential: boolean;
+                            scopes: string[];
+                            permissions: {
+                                text: string;
+                                write: boolean;
+                            }[];
+                            summary: string;
+                            connected_at: string | null;
+                            last_used_at: string | null;
+                            active_tokens: number;
+                            credentials: {
+                                id: number;
+                                connected_at: string | null;
+                                last_used_at: string | null;
+                                expires_at: string | null;
+                            }[];
+                        }[];
+                    };
+                };
+            };
+        };
+    };
+    "connectedApps.destroyCredential": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                credentialId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        message: string;
+                        revoked_tokens: number;
+                    };
+                };
+            };
+        };
+    };
+    "connectedApps.destroy": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                authorizationId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        message: string;
+                        revoked_tokens: number;
+                    };
+                };
+            };
+        };
+    };
+    "contact.index": {
+        parameters: {
+            query: {
+                customer_id: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Array of `ContactResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ContactResource"][];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
+    "contact.store": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ContactRequest"];
+            };
+        };
+        responses: {
+            /** @description `ContactResource` */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ContactResource"];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
+    "contact.show": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The contact ID */
+                contact: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @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"];
+        };
+    };
+    "contractDocument.upload": {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description The contract ID */
+                contract: number;
+            };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "multipart/form-data": {
+                    /**
+                     * Format: binary
+                     * @description Maximum file size: 10240 kilobytes.
+                     */
+                    document: Blob;
+                };
+            };
+        };
         responses: {
+            /** @description `ContractResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        data: {
-                            id: number;
-                            name: string;
-                            confidential: boolean;
-                            scopes: string[];
-                            permissions: {
-                                text: string;
-                                write: boolean;
-                            }[];
-                            summary: string;
-                            connected_at: string | null;
-                            last_used_at: string | null;
-                            active_tokens: number;
-                            credentials: {
-                                id: number;
-                                connected_at: string | null;
-                                last_used_at: string | null;
-                                expires_at: string | null;
-                            }[];
-                        }[];
+                        data: components["schemas"]["ContractResource"];
                     };
                 };
             };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
         };
     };
-    "connectedApps.destroyCredential": {
+    "contractDocument.destroy": {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                credentialId: number;
+                /** @description The contract ID */
+                contract: number;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
+            /** @description `ContractResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        message: string;
-                        revoked_tokens: number;
+                        data: components["schemas"]["ContractResource"];
                     };
                 };
             };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
         };
     };
-    "connectedApps.destroy": {
+    "contracts.delete": {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                authorizationId: number;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeleteContractsRequest"];
+            };
+        };
         responses: {
             200: {
                 headers: {
@@ -10535,40 +11481,41 @@ export interface operations {
                 };
                 content: {
                     "application/json": {
-                        message: string;
-                        revoked_tokens: number;
+                        success: boolean;
                     };
                 };
             };
+            403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
         };
     };
-    "contact.index": {
+    "contracts.index": {
         parameters: {
-            query: {
-                customer_id: number;
-            };
+            query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Array of `ContactResource` */
+            /** @description Array of `ContractResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        data: components["schemas"]["ContactResource"][];
+                        data: components["schemas"]["ContractResource"][];
+                        meta: {
+                            contract_total_count: number;
+                        };
                     };
                 };
             };
             403: components["responses"]["AuthorizationException"];
-            422: components["responses"]["ValidationException"];
         };
     };
-    "contact.store": {
+    "contracts.store": {
         parameters: {
             query?: never;
             header?: never;
@@ -10577,18 +11524,18 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["ContactRequest"];
+                "application/json": components["schemas"]["ContractRequest"];
             };
         };
         responses: {
-            /** @description `ContactResource` */
+            /** @description `ContractResource` */
             201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        data: components["schemas"]["ContactResource"];
+                        data: components["schemas"]["ContractResource"];
                     };
                 };
             };
@@ -10596,26 +11543,26 @@ export interface operations {
             422: components["responses"]["ValidationException"];
         };
     };
-    "contact.show": {
+    "contracts.show": {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description The contact ID */
-                contact: number;
+                /** @description The contract ID */
+                contract: number;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description `ContactResource` */
+            /** @description `ContractResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        data: components["schemas"]["ContactResource"];
+                        data: components["schemas"]["ContractResource"];
                     };
                 };
             };
@@ -10623,30 +11570,30 @@ export interface operations {
             404: components["responses"]["ModelNotFoundException"];
         };
     };
-    "contact.update": {
+    "contracts.update": {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description The contact ID */
-                contact: number;
+                /** @description The contract ID */
+                contract: number;
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["ContactRequest"];
+                "application/json": components["schemas"]["ContractRequest"];
             };
         };
         responses: {
-            /** @description `ContactResource` */
+            /** @description `ContractResource` */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        data: components["schemas"]["ContactResource"];
+                        data: components["schemas"]["ContractResource"];
                     };
                 };
             };
@@ -10655,13 +11602,13 @@ export interface operations {
             422: components["responses"]["ValidationException"];
         };
     };
-    "contact.destroy": {
+    "contracts.destroy": {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description The contact ID */
-                contact: number;
+                /** @description The contract ID */
+                contract: number;
             };
             cookie?: never;
         };
@@ -10679,6 +11626,17 @@ export interface operations {
             };
             403: components["responses"]["AuthorizationException"];
             404: components["responses"]["ModelNotFoundException"];
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        success: boolean;
+                        message: string;
+                    };
+                };
+            };
         };
     };
     "estimate.convertEstimate": {
@@ -14843,14 +15801,21 @@ export interface operations {
     };
     "items.index": {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Con `summary`, cada fila trae solo lo que los listados leen: identidad, precios y banderas, la categoría reducida a `{id, name}`, el nombre de la unidad y los impuestos del artículo (enteros, con la misma forma que la vista completa). Sin empresa, sin moneda y sin la unidad como objeto — el recurso completo arrastra la empresa entera por fila, roles incluidos, y contra un catálogo de 200 artículos eso son ~4 s y ~900 KB de los que el 86 % es ese lastre. El artículo completo sigue en el detalle y en el índice sin este parámetro. */
+                view?: "summary";
+            };
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Array of `ItemResource` */
+            /**
+             * @description Array of `ItemResource`
+             *
+             *     Array of `ItemSummaryResource`
+             */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -14862,6 +15827,12 @@ export interface operations {
                             tax_types: components["schemas"]["TaxType"][];
                             item_total_count: number;
                         };
+                    } | {
+                        data: (components["schemas"]["ItemSummaryResource"] & Record<string, never>)[];
+                        meta: {
+                            tax_types: components["schemas"]["TaxType"][];
+                            item_total_count: number;
+                        };
                     };
                 };
             };
@@ -16972,6 +17943,43 @@ export interface operations {
             };
         };
     };
+    "receivedInvoices.markGoodsReceived": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description `ReceivedInvoiceResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ReceivedInvoiceResource"];
+                    };
+                };
+            };
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        error: "goods_already_received";
+                        /** @constant */
+                        message: "La mercancía de esta factura recibida ya se sumó al almacén.";
+                    };
+                };
+            };
+        };
+    };
     "reconciliation.transactions": {
         parameters: {
             query?: {
@@ -17475,6 +18483,38 @@ export interface operations {
             422: components["responses"]["ValidationException"];
         };
     };
+    "contract.renewContract": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The contract ID */
+                contract: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RenewContractRequest"];
+            };
+        };
+        responses: {
+            /** @description `ContractResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ContractResource"];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
     "roles.getAbilities": {
         parameters: {
             query?: never;
@@ -18058,19 +19098,106 @@ export interface operations {
                 content: {
                     "application/json": {
                         /** @constant */
-                        error: "xml_generation_error";
-                        message: string;
+                        error: "xml_generation_error";
+                        message: string;
+                    };
+                };
+            };
+        };
+    };
+    "sepa-remittances.show": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                sepa_remittance: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["SepaRemittance"];
+                    };
+                };
+            };
+        };
+    };
+    "sepa-remittances.destroy": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                sepa_remittance: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        success: boolean;
+                    };
+                };
+            };
+        };
+    };
+    "invoice.sharedLink": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The invoice ID */
+                invoice: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            url: string;
+                            expires_at: string;
+                        };
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        message: "Un borrador no tiene enlace: publica la factura primero.";
                     };
                 };
             };
         };
     };
-    "sepa-remittances.show": {
+    "contract.sharedLink": {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                sepa_remittance: string;
+                /** @description The contract ID */
+                contract: number;
             };
             cookie?: never;
         };
@@ -18082,18 +19209,35 @@ export interface operations {
                 };
                 content: {
                     "application/json": {
-                        data: components["schemas"]["SepaRemittance"];
+                        data: {
+                            url: string;
+                            expires_at: string;
+                        };
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        message: "Un contrato sin activar no tiene enlace todavía.";
                     };
                 };
             };
         };
     };
-    "sepa-remittances.destroy": {
+    "estimate.sharedLink": {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                sepa_remittance: string;
+                /** @description The estimate ID */
+                estimate: number;
             };
             cookie?: never;
         };
@@ -18105,7 +19249,23 @@ export interface operations {
                 };
                 content: {
                     "application/json": {
-                        success: boolean;
+                        data: {
+                            url: string;
+                            expires_at: string;
+                        };
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        message: "Un presupuesto sin número no tiene enlace todavía.";
                     };
                 };
             };
@@ -18337,6 +19497,123 @@ export interface operations {
             };
         };
     };
+    "item.stockAdjustments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                item: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["StockAdjustmentRequest"];
+            };
+        };
+        responses: {
+            /** @description `StockMovementResource` */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["StockMovementResource"];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
+    "stockMovements.index": {
+        parameters: {
+            query?: {
+                /** @description Solo los asientos de este artículo. */
+                item_id?: number;
+                /** @description Solo los asientos con este motivo (`initial`, `import`, `manual_edit`, `manual_adjustment`, `purchase`, `sale_invoice`, `delivery_note`, `pos_sale`, `pos_return`). */
+                reason?: string;
+                /** @description Solo los asientos de este almacén. */
+                warehouse_id?: number;
+                /** @description Desde esta fecha (YYYY-MM-DD). */
+                from_date?: string;
+                /** @description Hasta esta fecha (YYYY-MM-DD). */
+                to_date?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Array of `StockMovementResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["StockMovementResource"][];
+                        meta: {
+                            stock_movement_total_count: number;
+                            /**
+                             * @description S8, informativo: lo que vale el almacén hoy, en céntimos —
+                             *     existencias × coste medio aprendido, con el precio de compra
+                             *     de la ficha como respaldo cuando aún no hay medio. Los
+                             *     artículos sin ninguno de los dos cuentan 0: la cifra no se
+                             *     inventa costes, y por eso puede quedarse corta — nunca
+                             *     larga. NO es un asiento contable ni una valoración de
+                             *     cierre (estudio de stock §6).
+                             */
+                            stock_value_cents: number;
+                        };
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+        };
+    };
+    "stockMovements.forItem": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                item: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Array of `StockMovementResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["StockMovementResource"][];
+                        meta: {
+                            opening_stock: number | null;
+                            /**
+                             * @description El reparto del saldo por almacén (N2). Su suma es
+                             *     exactamente `opening_stock` de arriba — es el mismo número
+                             *     contado por sitios, no una segunda cuenta. Se sirve entero
+                             *     (una pyme tiene almacenes de contar con los dedos) y sin
+                             *     paginar: es cabecera de la pestaña, no listado.
+                             */
+                            warehouse_stock: {
+                                warehouse_id: number;
+                                warehouse_name: string;
+                                quantity: number;
+                            }[];
+                        };
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+        };
+    };
     "storeModules.index": {
         parameters: {
             query?: never;
@@ -23392,6 +24669,180 @@ export interface operations {
             422: components["responses"]["ValidationException"];
         };
     };
+    "warehouses.stock": {
+        parameters: {
+            query?: {
+                /** @description Filtra por nombre del artículo. */
+                search?: string;
+                /** @description Solo los artículos con saldo distinto de cero (`1`). */
+                only_with_stock?: boolean;
+            };
+            header?: never;
+            path: {
+                /** @description The warehouse ID */
+                warehouse: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Array of `ItemWarehouseStockResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ItemWarehouseStockResource"][];
+                        meta: {
+                            warehouse: components["schemas"]["WarehouseResource"];
+                        };
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+        };
+    };
+    "warehouses.index": {
+        parameters: {
+            query?: {
+                /** @description Filtra por nombre o código. */
+                search?: string;
+                /** @description Solo los activos (`1`) o solo los desactivados (`0`). */
+                is_active?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Array of `WarehouseResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["WarehouseResource"][];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+        };
+    };
+    "warehouses.store": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WarehouseRequest"];
+            };
+        };
+        responses: {
+            /** @description El recurso recién creado. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": 201;
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
+    "warehouses.show": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The warehouse ID */
+                warehouse: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description `WarehouseResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["WarehouseResource"];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+        };
+    };
+    "warehouses.update": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The warehouse ID */
+                warehouse: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WarehouseRequest"];
+            };
+        };
+        responses: {
+            /** @description `WarehouseResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["WarehouseResource"];
+                    } | string;
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
+    "warehouses.destroy": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The warehouse ID */
+                warehouse: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        success: string;
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+        };
+    };
     "webhookEndpoints.index": {
         parameters: {
             query?: never;