@pimia/sdk 0.14.0 → 0.16.0

package/dist/api.d.ts

@@ -3774,6 +3774,13 @@ export interface paths {
          *     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».
+         *
+         *     ⚠️ **El almacén se puede declarar AQUÍ** (`warehouse_id`, opcional, N2) y
+         *     no solo en la factura: dónde se guarda la mercancía se sabe al recibirla
+         *     —descargando el camión—, no al teclear la factura que el OCR acaba de
+         *     crear. Lo que llegue aquí manda sobre lo que declarara el documento, y
+         *     se GUARDA en él: si el documento dijera una cosa y el almacén moviera
+         *     otra, la ficha estaría mintiendo sobre lo que hizo.
          */
         post: operations["receivedInvoices.markGoodsReceived"];
         delete?: never;
@@ -4614,6 +4621,113 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/stock-counts/{id}/confirm": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Confirma el recuento: emite los ajustes en bloque contra el libro
+         * @description Una línea por artículo contado y con diferencia, con motivo `count` y el
+         *     recuento como documento de origen. Lo que NO emite nada:
+         *
+         *      - las líneas **sin contar** (`counted_quantity` NULL) — nadie miró esa
+         *        estantería, y suponer que está vacía sería inventarse un dato;
+         *      - las que **cuadran** con el saldo del momento — el libro anota lo que
+         *        le pasó al contador, no lo que un documento quiso hacerle.
+         *
+         *     Todo va en UNA transacción: un recuento a medias dejaría el almacén en
+         *     un estado que ni la realidad ni el sistema han tenido nunca.
+         */
+        post: operations["stockCounts.confirm"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/stock-counts/{id}/cancel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Cancela un borrador: no emite nada y deja constancia de que se abrió y
+         *     no se cerró. Un recuento confirmado no se cancela — ya movió el almacén
+         */
+        post: operations["stockCounts.cancel"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/stock-counts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Los recuentos de la empresa, del más nuevo al más viejo */
+        get: operations["stock-counts.index"];
+        put?: never;
+        /**
+         * Abre un recuento
+         * @description Nace **sembrado** con lo que el almacén dice tener ahora (`seed`, por
+         *     defecto sí): contar es corregir una lista, no escribirla de cero. Se
+         *     siembran los artículos con saldo distinto de cero — una lista con las
+         *     doscientas referencias que el almacén NO tiene es una lista que nadie
+         *     lee. Lo que aparezca de más se añade contando (`PUT` con su `item_id`).
+         */
+        post: operations["stock-counts.store"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/stock-counts/{stock_count}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["stock-counts.show"];
+        /**
+         * Cuenta: escribe lo contado de cada línea
+         * @description Las líneas se UPSERTAN por artículo y no se borran y recrean, que es lo
+         *     que hacen los documentos de venta: aquí `expected_quantity` es la foto
+         *     de lo que el sistema creía cuando se dibujó la línea, y recrearla la
+         *     refrescaría en silencio — perdiendo justo el dato que permite avisar de
+         *     que algo se movió mientras se contaba. Un artículo que no venga en la
+         *     petición se queda como estaba.
+         *
+         *     Un recuento confirmado o cancelado no se edita: **422**.
+         */
+        put: operations["stock-counts.update"];
+        post?: never;
+        /**
+         * Borra un recuento que no ha movido nada
+         * @description Un confirmado no se borra: sus asientos explican saldos de hoy, y
+         *     borrarlo dejaría el libro nombrando un documento que no existe. Para el
+         *     que se abrió y no se cerró está `cancel`.
+         */
+        delete: operations["stock-counts.destroy"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/stock-movements": {
         parameters: {
             query?: never;
@@ -8088,6 +8202,15 @@ export interface components {
             is_active: boolean;
             is_time_trackable: boolean;
             opening_stock: number;
+            /**
+             * @description Lo COMPROMETIDO por documentos que aún no han movido el almacén
+             *     (N2 · pieza 3, cifra derivada — nadie la escribe). ⚠️ `null` NO
+             *     es cero: es «no se está calculando» (módulo `stock` sin
+             *     instalar, o el ciclo de inventario apagado). Pintar un 0 ahí
+             *     afirmaría «nada comprometido», que es lo que no se sabe.
+             *     El porqué entero, en {@see \App\Support\StockCommitments}.
+             */
+            committed_quantity: number | null;
             stock_alert_qty: number | null;
             allow_sale_without_stock: boolean;
             purchase_tax_type_id: number | null;
@@ -8131,6 +8254,13 @@ export interface components {
             is_active: boolean;
             is_time_trackable: boolean;
             opening_stock: number;
+            /**
+             * @description Igual que en el recurso completo: `null` es «no se está
+             *     calculando», no cero (N2 · pieza 3). La celda de stock del
+             *     listado del panel lo lee de aquí — el índice del catálogo va
+             *     por `?view=summary`.
+             */
+            committed_quantity: number | null;
             stock_alert_qty: number | null;
             allow_sale_without_stock: boolean;
             /** Format: date-time */
@@ -8156,6 +8286,15 @@ export interface components {
             item_name: string;
             warehouse_id: number;
             quantity: number;
+            /**
+             * @description Lo que el ARTÍCULO tiene comprometido — global, no de este
+             *     almacén (N2 · pieza 3). El nombre lleva el `item_` delante por
+             *     eso: en una fila que habla de una nave, «comprometido» a secas
+             *     se leería como «comprometido aquí», y de los dos documentos que
+             *     comprometen solo el albarán declara almacén. `null` = no se
+             *     está calculando; nunca es cero.
+             */
+            item_committed_quantity: number | null;
         };
         /** ItemsRequest */
         ItemsRequest: {
@@ -8967,7 +9106,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" | "view-contract" | "create-contract" | "edit-contract" | "delete-contract" | "view-warehouse" | "create-warehouse" | "edit-warehouse" | "delete-warehouse")[];
+            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" | "view-stock-count" | "create-stock-count" | "edit-stock-count" | "delete-stock-count")[];
         };
         /**
          * RoleRequest
@@ -8992,7 +9131,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" | "view-contract" | "create-contract" | "edit-contract" | "delete-contract" | "view-warehouse" | "create-warehouse" | "edit-warehouse" | "delete-warehouse";
+                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" | "view-stock-count" | "create-stock-count" | "edit-stock-count" | "delete-stock-count";
             }[] | null;
         };
         /** RoleResource */
@@ -9093,6 +9232,78 @@ export interface components {
              */
             warehouse_id?: number | null;
         };
+        /** StockCountLineResource */
+        StockCountLineResource: {
+            id: number;
+            item_id: number;
+            item_name: string;
+            /** @description Lo que el sistema creía CUANDO SE DIBUJÓ la línea. */
+            expected_quantity: number;
+            /**
+             * @description Lo contado. NULL = todavía no se ha contado, que NO es contar
+             *     cero: una estantería vacía es un dato y una que nadie ha mirado
+             *     no lo es. Las que llegan aquí en NULL no emiten nada al
+             *     confirmar.
+             */
+            counted_quantity: number | null;
+            /**
+             * @description La diferencia que se ENSEÑA mientras se cuenta. ⚠️ No es la que
+             *     se aplica al confirmar: esa se calcula contra el saldo de ese
+             *     momento, porque contar dice «aquí hay 12», no «quítale 3».
+             */
+            difference: number | null;
+            /**
+             * @description El asiento que esta línea emitió al confirmar, si emitió alguno
+             *     (una línea que cuadra no escribe nada en el libro).
+             */
+            stock_movement_id: number | null;
+        };
+        /** StockCountRequest */
+        StockCountRequest: {
+            /** Format: date-time */
+            count_date: string;
+            notes?: string | null;
+            warehouse_id?: number | null;
+            /**
+             * @description Sembrar el recuento con lo que el almacén tiene ahora. Solo se
+             *     mira en el alta.
+             */
+            seed?: boolean | null;
+            lines?: {
+                item_id: number;
+                counted_quantity: number | null;
+            }[] | null;
+        };
+        /** StockCountResource */
+        StockCountResource: {
+            id: number;
+            count_number: string;
+            sequence_number: number;
+            /**
+             * @description DRAFT | CONFIRMED | CANCELLED. Un confirmado es historia: ya
+             *     emitió sus asientos, y no se edita ni se borra.
+             */
+            status: string;
+            /** Format: date-time */
+            count_date: string;
+            /**
+             * @description De qué almacén se contó. NULL solo si el almacén se borró
+             *     después: el recuento sobrevive a lo que nombra.
+             */
+            warehouse_id: number | null;
+            warehouse_name: string | null;
+            notes: string | null;
+            /**
+             * Format: date-time
+             * @description Cuándo se confirmó, no solo si: dice además el instante, como
+             *     los dos candados del ciclo de stock.
+             */
+            confirmed_at: string | null;
+            creator_id: number | null;
+            /** Format: date-time */
+            created_at: string | null;
+            lines?: components["schemas"]["StockCountLineResource"][];
+        };
         /** StockMovementResource */
         StockMovementResource: {
             id: number;
@@ -17990,7 +18201,13 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody?: {
+            content: {
+                "application/json": {
+                    warehouse_id?: number | null;
+                };
+            };
+        };
         responses: {
             /** @description `ReceivedInvoiceResource` */
             200: {
@@ -18003,19 +18220,7 @@ export interface operations {
                     };
                 };
             };
-            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.";
-                    };
-                };
-            };
+            422: components["responses"]["ValidationException"];
         };
     };
     "reconciliation.transactions": {
@@ -19565,12 +19770,215 @@ export interface operations {
             422: components["responses"]["ValidationException"];
         };
     };
+    "stockCounts.confirm": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            id: number;
+                            status: string;
+                        };
+                        meta: {
+                            adjusted_lines: number;
+                            unchanged_lines: number;
+                            uncounted_lines: number;
+                            moved_while_counting: number;
+                        };
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+        };
+    };
+    "stockCounts.cancel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /**
+             * @description `StockCountResource`
+             *
+             *     Confirmar un recuento en el que nadie contó nada no es «cuadrar
+             *     el almacén»: es no haber contado. Decirlo es mejor que sellar un
+             *     documento vacío que después parecerá un inventario hecho.
+             */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["StockCountResource"];
+                    } | string;
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+        };
+    };
+    "stock-counts.index": {
+        parameters: {
+            query?: {
+                /** @description Solo los de este estado (`DRAFT`, `CONFIRMED`, `CANCELLED`). */
+                status?: string;
+                /** @description Solo los de este almacén. */
+                warehouse_id?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Array of `StockCountResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["StockCountResource"][];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+        };
+    };
+    "stock-counts.store": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["StockCountRequest"];
+            };
+        };
+        responses: {
+            /** @description El recurso recién creado. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": 201;
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
+    "stock-counts.show": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                stock_count: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description `StockCountResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["StockCountResource"] & Record<string, never>;
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+        };
+    };
+    "stock-counts.update": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                stock_count: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["StockCountRequest"];
+            };
+        };
+        responses: {
+            /**
+             * @description `StockCountResource`
+             *
+             *     Confirmar un recuento en el que nadie contó nada no es «cuadrar
+             *     el almacén»: es no haber contado. Decirlo es mejor que sellar un
+             *     documento vacío que después parecerá un inventario hecho.
+             */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["StockCountResource"] & Record<string, never>;
+                    } | string;
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
+    "stock-counts.destroy": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                stock_count: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        success: string;
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+        };
+    };
     "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`). */
+                /** @description Solo los asientos con este motivo (`initial`, `import`, `manual_edit`, `manual_adjustment`, `purchase`, `sale_invoice`, `delivery_note`, `pos_sale`, `pos_return`, `count`). */
                 reason?: string;
                 /** @description Solo los asientos de este almacén. */
                 warehouse_id?: number;
@@ -19645,6 +20053,46 @@ export interface operations {
                                 warehouse_name: string;
                                 quantity: number;
                             }[];
+                            /**
+                             * @description Lo COMPROMETIDO y lo DISPONIBLE (N2 · pieza 3). Cifra
+                             *     derivada: nadie la escribe, se calcula al preguntarla.
+                             *     `null` ENTERO = no se está calculando (módulo `stock` sin
+                             *     instalar o ciclo de inventario apagado); un cero ahí
+                             *     afirmaría «nada comprometido», que es lo que no se sabe. El desglose viaja entero y sin paginar, como
+                             *     `warehouse_stock`: es cabecera de pestaña, y son los
+                             *     borradores vivos de UN artículo, que en una pyme se cuentan
+                             *     con los dedos. Va aquí y no en un endpoint aparte porque la
+                             *     pregunta es la misma que abre el libro — «¿por qué tengo
+                             *     47?» y «¿por qué solo puedo vender 35?» se responden en la
+                             *     misma pantalla.
+                             */
+                            committed: {
+                                quantity: number;
+                                /**
+                                 * @description ⚠️ `null` cuando el artículo NUNCA ha llevado stock
+                                 *     (`opening_stock` NULL, la distinción que la migración se
+                                 *     esforzó en preservar): de ese no hay disponible que
+                                 *     calcular, y un «−4» ahí sería una alarma inventada.
+                                 */
+                                available: number | null;
+                                documents: ({
+                                    /** @constant */
+                                    document_type: "delivery_note";
+                                    document_id: number;
+                                    document_number: string;
+                                    customer_name: string;
+                                    date: string;
+                                    quantity: number;
+                                } | {
+                                    /** @constant */
+                                    document_type: "invoice";
+                                    document_id: number;
+                                    document_number: string;
+                                    customer_name: string;
+                                    date: string;
+                                    quantity: number;
+                                })[];
+                            } | null;
                         };
                     };
                 };

package/dist/client.d.ts

@@ -29,6 +29,8 @@ export type ContractResource = Schemas['ContractResource'];
 export type WarehouseResource = Schemas['WarehouseResource'];
 /** El saldo de un artículo EN un almacén. */
 export type ItemWarehouseStockResource = Schemas['ItemWarehouseStockResource'];
+/** Un recuento de inventario tal y como lo devuelve la API. */
+export type StockCountResource = Schemas['StockCountResource'];
 /** Cuerpo de alta/edición de cliente. Incluye `customFields`. */
 export type CustomerRequest = Schemas['CustomerRequest'];
 /** Cuerpo de alta/edición de factura. Incluye `customFields`. */
@@ -46,6 +48,12 @@ export type ContractRequest = Schemas['ContractRequest'];
  * misma transacción, porque la empresa necesita exactamente uno.
  */
 export type WarehouseRequest = Schemas['WarehouseRequest'];
+/**
+ * Cuerpo del alta y del conteo de un recuento. ⚠️ En `lines`,
+ * `counted_quantity: null` es «sin contar» y **no** es cero: las líneas en
+ * null no emiten nada al confirmar.
+ */
+export type StockCountRequest = Schemas['StockCountRequest'];
 /**
  * El sobre `{ data: … }` de Laravel para las escrituras que el spec **no
  * tipa**.
@@ -861,6 +869,185 @@ export declare class PimiaClient {
             };
         }>;
     };
+    /**
+     * Recuentos de inventario: contar un almacén y cuadrarlo de una vez. Exige
+     * `items:read` / `items:write` y el módulo `stock` (opt-in), como el resto.
+     *
+     * El ciclo es **contar → mirar diferencias → confirmar**, y los dos últimos
+     * pasos son llamadas distintas a propósito:
+     *
+     * - `update` escribe lo contado y **no mueve una sola existencia**;
+     * - `confirm` emite los ajustes en bloque, uno por línea con diferencia,
+     *   todos con motivo `count` y en la misma transacción.
+     *
+     * ⛔ **Dos cosas que hay que tener delante para no programar contra una
+     * aritmética que el servidor no garantiza:**
+     *
+     * 1. **La diferencia se calcula al CONFIRMAR**, contra el saldo de ese
+     *    momento: un recuento dice «aquí hay 12», no «quítale 3». Si algo se
+     *    movió entre contar y confirmar, el almacén queda igualmente en lo
+     *    contado, y el `meta.moved_while_counting` de la respuesta dice cuántas
+     *    líneas fueron.
+     * 2. **`counted_quantity: null` es «sin contar», y no es cero.** Las líneas
+     *    en null no emiten nada; mandar 0 es declarar que miraste y no había.
+     */
+    get stockCounts(): {
+        list: (query?: RequestOptions["query"], options?: ReadOptions) => Promise<{
+            data: components["schemas"]["StockCountResource"][];
+        }>;
+        get: (id: number | string, options?: ReadOptions) => Promise<{
+            data: components["schemas"]["StockCountResource"] & Record<string, never>;
+        }>;
+        /**
+         * Abre el recuento. Nace **sembrado** con lo que el almacén dice tener
+         * (`seed`, por defecto sí): contar es corregir una lista, no escribirla.
+         */
+        create: (body: StockCountRequest, options?: WriteOptions) => Promise<ResourceEnvelope<{
+            id: number;
+            count_number: string;
+            sequence_number: number;
+            status: string;
+            count_date: string;
+            warehouse_id: number | null;
+            warehouse_name: string | null;
+            notes: string | null;
+            confirmed_at: string | null;
+            creator_id: number | null;
+            created_at: string | null;
+            lines?: components["schemas"]["StockCountLineResource"][];
+        }>>;
+        /** Cuenta: escribe lo contado. No mueve el almacén. */
+        update: (id: number | string, body: StockCountRequest, options?: WriteOptions) => Promise<ResourceEnvelope<{
+            id: number;
+            count_number: string;
+            sequence_number: number;
+            status: string;
+            count_date: string;
+            warehouse_id: number | null;
+            warehouse_name: string | null;
+            notes: string | null;
+            confirmed_at: string | null;
+            creator_id: number | null;
+            created_at: string | null;
+            lines?: components["schemas"]["StockCountLineResource"][];
+        }>>;
+        /**
+         * Confirma: emite los ajustes en bloque. La respuesta trae el resumen en
+         * `meta` — cuántas líneas se ajustaron, cuántas cuadraban, cuántas
+         * quedaron sin contar y cuántas se movieron mientras se contaba.
+         */
+        confirm: (id: number | string, options?: WriteOptions) => Promise<{
+            data: {
+                id: number;
+                status: string;
+            };
+            meta: {
+                adjusted_lines: number;
+                unchanged_lines: number;
+                uncounted_lines: number;
+                moved_while_counting: number;
+            };
+        }>;
+        /** Cancela un borrador. Uno confirmado ya movió el almacén: 422. */
+        cancel: (id: number | string, options?: WriteOptions) => Promise<string | {
+            data: components["schemas"]["StockCountResource"];
+        }>;
+        /**
+         * Borra un recuento que no ha movido nada. Uno confirmado **no se
+         * borra**: sus asientos explican el saldo de hoy.
+         */
+        delete: (id: number | string, options?: ReadOptions) => Promise<{
+            success: string;
+        }>;
+    };
+    /**
+     * El libro del almacén: por qué un artículo tiene el saldo que tiene. Exige
+     * `items:read` — leer el libro es leer el catálogo que explica— y, a
+     * diferencia de almacenes y recuentos, **NO va tras el módulo `stock`**: el
+     * libro es N1 y N1 es de todos.
+     *
+     * ## El COMPROMETIDO, en la cabecera de `forItem`
+     *
+     * `meta.committed` responde la otra mitad de la pregunta: no «cuánto tengo»
+     * sino **«cuánto de lo que tengo puedo vender»**. Trae la cantidad, el
+     * disponible (saldo − comprometido) y el DESGLOSE de los documentos que lo
+     * comprometen.
+     *
+     * ⛔ **Tres cosas que hay que tener delante:**
+     *
+     * 1. **Es una cifra DERIVADA**: no hay columna que escribir, no existe un
+     *    `PUT` para reservar. Comprometen el albarán y la factura **en
+     *    borrador**, y dejan de hacerlo solos cuando mueven el almacén (al
+     *    entregar y al publicar). El presupuesto aceptado NO compromete: nada en
+     *    el núcleo dice cuándo se cumplió.
+     * 2. ⚠️ **`committed` a `null` NO es cero.** Es «no se está calculando» — la
+     *    empresa no tiene el módulo `stock`, o tiene el ciclo de inventario
+     *    apagado. Pintar un 0 ahí afirma «nada comprometido», que es justo lo
+     *    que no se sabe. Igual con `committed_quantity` en el artículo.
+     * 3. **Es GLOBAL por artículo, sin dimensión de almacén**: de los documentos
+     *    que comprometen solo el albarán declara almacén.
+     */
+    get stockMovements(): {
+        /**
+         * El libro entero de la empresa, filtrable por artículo, almacén, motivo
+         * y fechas. Su `meta` trae además el valor informativo del almacén
+         * (`stock_value_cents`), que NO es valoración contable.
+         */
+        list: (query?: RequestOptions["query"], options?: ReadOptions) => Promise<{
+            data: components["schemas"]["StockMovementResource"][];
+            meta: {
+                stock_movement_total_count: number;
+                stock_value_cents: number;
+            };
+        }>;
+        /**
+         * El libro de UN artículo, con la cabecera que lo explica: saldo
+         * (`meta.opening_stock`), reparto por almacén (`meta.warehouse_stock`) y
+         * comprometido (`meta.committed`).
+         */
+        forItem: (itemId: number | string, query?: RequestOptions["query"], options?: ReadOptions) => Promise<{
+            data: components["schemas"]["StockMovementResource"][];
+            meta: {
+                opening_stock: number | null;
+                warehouse_stock: {
+                    warehouse_id: number;
+                    warehouse_name: string;
+                    quantity: number;
+                }[];
+                committed: {
+                    quantity: number;
+                    available: number | null;
+                    documents: ({
+                        document_type: "delivery_note";
+                        document_id: number;
+                        document_number: string;
+                        customer_name: string;
+                        date: string;
+                        quantity: number;
+                    } | {
+                        document_type: "invoice";
+                        document_id: number;
+                        document_number: string;
+                        customer_name: string;
+                        date: string;
+                        quantity: number;
+                    })[];
+                } | null;
+            };
+        }>;
+        /**
+         * El ajuste manual con motivo: la corrección que deja rastro, frente al
+         * `PUT /items/{item}` que pisa el contador sin decir por qué. Cantidad
+         * FIRMADA (± decimal) y `note` obligatoria; `warehouse_id` opcional.
+         */
+        adjust: (itemId: number | string, body: {
+            quantity: number;
+            note: string;
+            warehouse_id?: number;
+        }, options?: WriteOptions) => Promise<{
+            data: components["schemas"]["StockMovementResource"];
+        }>;
+    };
     get<T = unknown>(path: string, query?: RequestOptions['query'], options?: ReadOptions): Promise<T>;
     post<T = unknown>(path: string, body?: unknown, options?: WriteOptions): Promise<T>;
     put<T = unknown>(path: string, body?: unknown, options?: WriteOptions): Promise<T>;

package/dist/client.js

@@ -197,6 +197,103 @@ export class PimiaClient {
             stock: (id, query, options) => this.get(`/warehouses/${id}/stock`, query, options),
         };
     }
+    /**
+     * Recuentos de inventario: contar un almacén y cuadrarlo de una vez. Exige
+     * `items:read` / `items:write` y el módulo `stock` (opt-in), como el resto.
+     *
+     * El ciclo es **contar → mirar diferencias → confirmar**, y los dos últimos
+     * pasos son llamadas distintas a propósito:
+     *
+     * - `update` escribe lo contado y **no mueve una sola existencia**;
+     * - `confirm` emite los ajustes en bloque, uno por línea con diferencia,
+     *   todos con motivo `count` y en la misma transacción.
+     *
+     * ⛔ **Dos cosas que hay que tener delante para no programar contra una
+     * aritmética que el servidor no garantiza:**
+     *
+     * 1. **La diferencia se calcula al CONFIRMAR**, contra el saldo de ese
+     *    momento: un recuento dice «aquí hay 12», no «quítale 3». Si algo se
+     *    movió entre contar y confirmar, el almacén queda igualmente en lo
+     *    contado, y el `meta.moved_while_counting` de la respuesta dice cuántas
+     *    líneas fueron.
+     * 2. **`counted_quantity: null` es «sin contar», y no es cero.** Las líneas
+     *    en null no emiten nada; mandar 0 es declarar que miraste y no había.
+     */
+    get stockCounts() {
+        return {
+            list: (query, options) => this.get('/stock-counts', query, options),
+            get: (id, options) => this.get(`/stock-counts/${id}`, undefined, options),
+            /**
+             * Abre el recuento. Nace **sembrado** con lo que el almacén dice tener
+             * (`seed`, por defecto sí): contar es corregir una lista, no escribirla.
+             */
+            create: (body, options) => this.post('/stock-counts', body, options),
+            /** Cuenta: escribe lo contado. No mueve el almacén. */
+            update: (id, body, options) => this.put(`/stock-counts/${id}`, body, options),
+            /**
+             * Confirma: emite los ajustes en bloque. La respuesta trae el resumen en
+             * `meta` — cuántas líneas se ajustaron, cuántas cuadraban, cuántas
+             * quedaron sin contar y cuántas se movieron mientras se contaba.
+             */
+            confirm: (id, options) => this.post(`/stock-counts/${id}/confirm`, {}, options),
+            /** Cancela un borrador. Uno confirmado ya movió el almacén: 422. */
+            cancel: (id, options) => this.post(`/stock-counts/${id}/cancel`, {}, options),
+            /**
+             * Borra un recuento que no ha movido nada. Uno confirmado **no se
+             * borra**: sus asientos explican el saldo de hoy.
+             */
+            delete: (id, options) => this.delete(`/stock-counts/${id}`, options),
+        };
+    }
+    /**
+     * El libro del almacén: por qué un artículo tiene el saldo que tiene. Exige
+     * `items:read` — leer el libro es leer el catálogo que explica— y, a
+     * diferencia de almacenes y recuentos, **NO va tras el módulo `stock`**: el
+     * libro es N1 y N1 es de todos.
+     *
+     * ## El COMPROMETIDO, en la cabecera de `forItem`
+     *
+     * `meta.committed` responde la otra mitad de la pregunta: no «cuánto tengo»
+     * sino **«cuánto de lo que tengo puedo vender»**. Trae la cantidad, el
+     * disponible (saldo − comprometido) y el DESGLOSE de los documentos que lo
+     * comprometen.
+     *
+     * ⛔ **Tres cosas que hay que tener delante:**
+     *
+     * 1. **Es una cifra DERIVADA**: no hay columna que escribir, no existe un
+     *    `PUT` para reservar. Comprometen el albarán y la factura **en
+     *    borrador**, y dejan de hacerlo solos cuando mueven el almacén (al
+     *    entregar y al publicar). El presupuesto aceptado NO compromete: nada en
+     *    el núcleo dice cuándo se cumplió.
+     * 2. ⚠️ **`committed` a `null` NO es cero.** Es «no se está calculando» — la
+     *    empresa no tiene el módulo `stock`, o tiene el ciclo de inventario
+     *    apagado. Pintar un 0 ahí afirma «nada comprometido», que es justo lo
+     *    que no se sabe. Igual con `committed_quantity` en el artículo.
+     * 3. **Es GLOBAL por artículo, sin dimensión de almacén**: de los documentos
+     *    que comprometen solo el albarán declara almacén.
+     */
+    get stockMovements() {
+        return {
+            /**
+             * El libro entero de la empresa, filtrable por artículo, almacén, motivo
+             * y fechas. Su `meta` trae además el valor informativo del almacén
+             * (`stock_value_cents`), que NO es valoración contable.
+             */
+            list: (query, options) => this.get('/stock-movements', query, options),
+            /**
+             * El libro de UN artículo, con la cabecera que lo explica: saldo
+             * (`meta.opening_stock`), reparto por almacén (`meta.warehouse_stock`) y
+             * comprometido (`meta.committed`).
+             */
+            forItem: (itemId, query, options) => this.get(`/items/${itemId}/stock-movements`, query, options),
+            /**
+             * El ajuste manual con motivo: la corrección que deja rastro, frente al
+             * `PUT /items/{item}` que pisa el contador sin decir por qué. Cantidad
+             * FIRMADA (± decimal) y `note` obligatoria; `warehouse_id` opcional.
+             */
+            adjust: (itemId, body, options) => this.post(`/items/${itemId}/stock-adjustments`, body, options),
+        };
+    }
     get(path, query, options) {
         return this.request(path, { ...options, method: 'GET', query });
     }

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * salen los tipos de `./api`.
  */
 export { PimiaClient, toFormData } from './client.js';
-export type { ContractRequest, ContractResource, CustomerRequest, CustomerResource, EstimateResource, EstimatesRequest, InvoiceResource, InvoicesRequest, ItemWarehouseStockResource, PimiaClientOptions, RateLimit, ReadOptions, RequestOptions, ResourceEnvelope, ResponseMeta, ResponseWithMeta, WarehouseRequest, WarehouseResource, WriteOptions, } from './client.js';
+export type { ContractRequest, ContractResource, CustomerRequest, CustomerResource, EstimateResource, EstimatesRequest, InvoiceResource, InvoicesRequest, ItemWarehouseStockResource, PimiaClientOptions, RateLimit, ReadOptions, RequestOptions, ResourceEnvelope, ResponseMeta, ResponseWithMeta, StockCountRequest, StockCountResource, WarehouseRequest, WarehouseResource, WriteOptions, } from './client.js';
 export { OAuth, createPkceChallenge, createState } from './oauth.js';
 export type { AuthorizationServerMetadata, AuthorizeUrlOptions, OAuthConfig, PkceChallenge, } from './oauth.js';
 export { MemoryTokenStore, isExpired, tokenSetFromResponse } from './tokens.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pimia/sdk",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Cliente TypeScript de la API de Pimia para apps de partner: OAuth con PKCE, rotación de refresh persistida, reintentos de rate limit y tipos generados del OpenAPI.",
   "license": "MIT",
   "author": "Pimia (https://pimia.es)",