@pimia/sdk 0.8.0 → 0.10.0

package/dist/api.d.ts

@@ -167,7 +167,7 @@ export interface paths {
          *       `group_by=customer` añade by_customer; con `group_by=category`, by_category.
          *       Lo consumen las tools MCP de informes (invoice-shelf-mcp).
          *
-         *     Importes en céntimos, como el resto de la API.
+         *     Importes en subunidades enteras de la moneda, como el resto de la API.
          *
          *     QUÉ FACTURAS CUENTAN, que es la clase de cifra que un integrador no puede
          *     verificar por su cuenta y que hasta el 2026-08-24 el contrato no decía:
@@ -375,7 +375,13 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get available CSV presets */
+        /**
+         * Los formatos de CSV que el importador reconoce, por nombre
+         * @description Son las claves de `CsvBankParser::PRESETS` —cadenas— y es lo que se manda
+         *     en `preset` al importar un extracto. El `@response` está porque
+         *     `array_keys()` devuelve un `array` sin más, y el contrato publicaba
+         *     `data: unknown[]`: un cliente generado no veía siquiera que eran textos.
+         */
         get: operations["bankImport.presets"];
         put?: never;
         post?: never;
@@ -576,7 +582,6 @@ export interface paths {
         /**
          * Update the Admin profile.
          *     Includes name, email and (or) password
-         * @description **No disponible para integradores.** Exige `admin:write`, que el Authorization Server de Pimia no emite: la acción la realiza el dueño desde su panel y un token de partner recibe `403`. Aparece en el contrato para que el hueco sea explícito, no para que se llame.
          */
         put: operations["company.updateProfile"];
         post?: never;
@@ -674,6 +679,95 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/settings/connected-apps": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Apps a las que este usuario ha autorizado el acceso a su cuenta
+         * @description **Reservada al panel de Pimia.** Exige `admin:read`, que el Authorization Server emite SOLO al client de primera parte: un client de integrador no puede pedir ese scope —se le rechaza en el registro y no se le anuncia— y con cualquier otro token la llamada recibe `403`. Está en el contrato porque es el panel web de Pimia quien la consume, y sus tipos salen de aquí.
+         *
+         *     `credentials` son las sesiones vivas del grant: una por dispositivo o
+         *     proceso que completó una ceremonia OAuth. `connected_at` es el instante
+         *     de ESA ceremonia y no el de la última renovación, que es lo que hace que
+         *     la pantalla pueda decir «conectado desde el 25» de una sesión que rota su
+         *     refresh cada día.
+         *
+         *     `last_used_at` sale del PAT emparejado y no del refresh: el grant se toca
+         *     en canje/refresh —una vez al día— y el PAT en CADA petición, así que es
+         *     el único que sabe si esa sesión sigue trabajando. Sale null mientras la
+         *     credencial no haya hecho ninguna petición todavía.
+         *
+         *     `active_tokens` se queda como estaba (cuenta los PAT del client, rotados
+         *     aún no caducados incluidos) para no romper a quien ya lo lee; lo que
+         *     cuenta dispositivos es `credentials`.
+         */
+        get: operations["connectedApps.index"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/settings/connected-apps/credentials/{credentialId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Cierra UNA credencial —un dispositivo— sin tocar las demás ni el grant
+         * @description **Reservada al panel de Pimia.** Exige `admin:write`, que el Authorization Server emite SOLO al client de primera parte: un client de integrador no puede pedir ese scope —se le rechaza en el registro y no se le anuncia— y con cualquier otro token la llamada recibe `403`. Está en el contrato porque es el panel web de Pimia quien la consume, y sus tipos salen de aquí.
+         *
+         *     La app sigue conectada desde donde siga viva; para retirarle el acceso
+         *     entero está `destroy`. Por eso esta operación no emite `app.revoked`: al
+         *     integrador no le ha caído la puerta, se le ha caído una sesión.
+         *
+         *     El grant sale de la propia credencial y se comprueba con el mismo filtro
+         *     que el resto de la pantalla (este usuario, este tenant, sin revocar), así
+         *     que la ruta no lo nombra: no hay forma de pedir un par descuadrado.
+         *
+         *     404 cuando la credencial no existe, no es de este usuario o ya no está
+         *     viva (rotada, revocada o caducada): quien cierra estaba mirando una lista
+         *     de hace un momento y lo que necesita es recargarla, no un error distinto
+         *     por cada motivo.
+         */
+        delete: operations["connectedApps.destroyCredential"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/settings/connected-apps/{authorizationId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Retira el acceso de la app entera: cae el grant, sus refresh tokens y los
+         *     PAT que esa app acuñó para este usuario. Todas sus credenciales con él
+         * @description **Reservada al panel de Pimia.** Exige `admin:write`, que el Authorization Server emite SOLO al client de primera parte: un client de integrador no puede pedir ese scope —se le rechaza en el registro y no se le anuncia— y con cualquier otro token la llamada recibe `403`. Está en el contrato porque es el panel web de Pimia quien la consume, y sus tipos salen de aquí.
+         */
+        delete: operations["connectedApps.destroy"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/contacts": {
         parameters: {
             query?: never;
@@ -1286,6 +1380,36 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/expenses/{expense}/receipt": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Sube o reemplaza el justificante de un gasto
+         * @description Es la mitad que faltaba: hasta aquí, adjuntar un papel a un gasto que ya
+         *     existe **no se podía hacer desde ningún cliente del contrato**. El `PUT`
+         *     lo publicaba como multiparte y no puede cumplirlo (ver `update()`), y el
+         *     otro camino —`POST /expenses/{expense}/upload/receipts`— pide base64 y
+         *     solo acepta `gif`, `jpg` y `png`, así que rechaza el PDF que el propio
+         *     alta sí admite (#498).
+         *
+         *     Misma forma que `receivedInvoices.uploadDocument`, que es el precedente
+         *     de la casa para esto: `POST`, multiparte, se limpia la colección antes de
+         *     añadir —así no se acumulan huérfanos en cada resubida— y se devuelve el
+         *     recurso.
+         */
+        post: operations["expenses.uploadReceipt"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/expenses/delete": {
         parameters: {
             query?: never;
@@ -3167,7 +3291,23 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List bank transactions with filters */
+        /**
+         * Movimientos bancarios, filtrados y paginados
+         * @description Los cinco filtros y el tamaño de página se VALIDAN, y por eso están en el
+         *     contrato: el generador no ve un `$request->bank_account_id` —acceso
+         *     dinámico— y hasta el 2026-08-25 esta operación publicaba `parameters: []`
+         *     mientras el controlador leía seis. Un integrador leyendo el spec no podía
+         *     saber que se puede filtrar.
+         *
+         *     ⚠️ Filtrar por un `status` o un `type` que no existe ya no devuelve la
+         *     lista entera sin filtrar: da 422. Es el mismo criterio que el resto de la
+         *     API y lo que evita el «pedí los pendientes y me los dio todos».
+         *
+         *     La respuesta es el paginador de Laravel PELADO (`data`, `current_page`,
+         *     `total`…), no el sobre `{data, meta}` del resto de la casa. Cada fila
+         *     lleva además `bank_account` y `reconciliations[]`, que el listado carga
+         *     siempre.
+         */
         get: operations["reconciliation.transactions"];
         put?: never;
         post?: never;
@@ -3184,7 +3324,20 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get summary statistics */
+        /**
+         * Recuento de movimientos por estado, y los dos totales
+         * @description Los cuatro recuentos salen de un `count()` y son ENTEROS. Se declaran a
+         *     mano porque Scramble tipa bien `Builder::count()` pero no sabe resolver
+         *     `(clone $query)->pending()`: el scope local devuelve `mixed` y degradaba
+         *     los cuatro a `string`, mientras `total` —que no pasa por un scope— salía
+         *     `integer` en la misma respuesta. Cuatro cadenas y un número para el mismo
+         *     tipo de dato.
+         *
+         *     ⚠️ `total_credits` y `total_debits` SÍ son cadenas, y a propósito: son
+         *     `SUM(amount)` sobre una columna `decimal(15,2)` que PostgreSQL entrega
+         *     como texto, y van en la UNIDAD MAYOR de la moneda, con decimales, como el
+         *     resto de la banca —no en subunidades enteras como el resto de la API.
+         */
         get: operations["reconciliation.summary"];
         put?: never;
         post?: never;
@@ -3224,10 +3377,10 @@ export interface paths {
          *     ordenados por `score` descendente (importe, proximidad de fecha,
          *     referencia y nombre del cliente).
          *
-         *     **`amount` va en céntimos**, como el `total` del que sale y como todo
-         *     importe de documento en esta API. No lo confundas con
-         *     `bank_transactions.amount`, que sí va en euros con decimales por ser el
-         *     reflejo de un extracto bancario. `number` es `null` en los borradores,
+         *     **`amount` va en subunidades enteras**, como el `total` del que sale y como
+         *     todo importe de documento en esta API. No lo confundas con
+         *     `bank_transactions.amount`, que sí va en la unidad mayor con decimales por
+         *     ser el reflejo de un extracto bancario. `number` es `null` en los borradores,
          *     que nacen sin numerar: el identificador estable es `model.id`.
          */
         get: operations["reconciliation.suggestions"];
@@ -4031,7 +4184,7 @@ export interface paths {
         put?: never;
         /**
          * POST tasks/{task}/delegate — delega esta tarea CRM a su agente Pim
-         * @description **No disponible para integradores.** Exige `delegation:write`, que el Authorization Server de Pimia no emite: la acción la realiza el dueño desde su panel y un token de partner recibe `403`. Aparece en el contrato para que el hueco sea explícito, no para que se llame.
+         * @description **Reservada al panel de Pimia.** Exige `crm:write`, `delegation:write`, que el Authorization Server emite SOLO al client de primera parte: un client de integrador no puede pedir esos scopes —se le rechazan en el registro y no se le anuncian— y con cualquier otro token la llamada recibe `403`. Está en el contrato porque es el panel web de Pimia quien la consume, y sus tipos salen de aquí.
          *
          *     Reusa el plano async `delegated_tasks` (el mismo que ya cierra el round-trip
          *     delegar→agente→callback→sello): compone un context rico desde la tarea (título,
@@ -5046,7 +5199,7 @@ export interface components {
             name: string;
             iban: string | null;
             bank_name: string | null;
-            /** @description EUROS con decimales (`2322.11` = 2.322,11 €), a diferencia del resto de la API, que cuenta el dinero en céntimos enteros. La banca es la excepción porque es lo que trae un extracto bancario: redondearlo a céntimos enteros perdería los decimales del apunte. La conciliación convierte al comparar con facturas y gastos. */
+            /** @description En la UNIDAD MAYOR de la moneda de la cuenta, con decimales (`2322.11` son 2.322,11 de la moneda que declare su `currency_code`), a diferencia del resto de la API, que cuenta el dinero en SUBUNIDADES enteras (céntimos, en una moneda de dos decimales). La banca es la excepción porque es lo que trae un extracto bancario: redondearlo a la subunidad perdería los decimales del apunte. La conciliación convierte al comparar con facturas y gastos. */
             opening_balance: string;
             currency_code: string;
             enabled: boolean;
@@ -5056,7 +5209,7 @@ export interface components {
             updated_at: string | null;
             /** Format: date-time */
             deleted_at: string | null;
-            /** @description EUROS con decimales (`2322.11` = 2.322,11 €), a diferencia del resto de la API, que cuenta el dinero en céntimos enteros. La banca es la excepción porque es lo que trae un extracto bancario: redondearlo a céntimos enteros perdería los decimales del apunte. La conciliación convierte al comparar con facturas y gastos. */
+            /** @description En la UNIDAD MAYOR de la moneda de la cuenta, con decimales (`2322.11` son 2.322,11 de la moneda que declare su `currency_code`), a diferencia del resto de la API, que cuenta el dinero en SUBUNIDADES enteras (céntimos, en una moneda de dos decimales). La banca es la excepción porque es lo que trae un extracto bancario: redondearlo a la subunidad perdería los decimales del apunte. La conciliación convierte al comparar con facturas y gastos. */
             balance: string;
         };
         /** BankImport */
@@ -5085,13 +5238,21 @@ export interface components {
             transaction_date: string;
             /** Format: date-time */
             value_date: string | null;
-            /** @description EUROS con decimales (`2322.11` = 2.322,11 €), a diferencia del resto de la API, que cuenta el dinero en céntimos enteros. La banca es la excepción porque es lo que trae un extracto bancario: redondearlo a céntimos enteros perdería los decimales del apunte. La conciliación convierte al comparar con facturas y gastos. */
+            /** @description En la UNIDAD MAYOR de la moneda de la cuenta, con decimales (`2322.11` son 2.322,11 de la moneda que declare su `currency_code`), a diferencia del resto de la API, que cuenta el dinero en SUBUNIDADES enteras (céntimos, en una moneda de dos decimales). La banca es la excepción porque es lo que trae un extracto bancario: redondearlo a la subunidad perdería los decimales del apunte. La conciliación convierte al comparar con facturas y gastos. */
             amount: string;
-            type: string;
+            /**
+             * @description Signo del apunte tal y como lo trae el extracto: `credit` entra dinero, `debit` sale. El importe va siempre en positivo, así que el signo es esto.
+             * @enum {string}
+             */
+            type: "credit" | "debit";
             concept: string | null;
             reference: string | null;
             raw_data: string | null;
-            status: string;
+            /**
+             * @description Punto del ciclo de conciliación en el que está el apunte: `pending` recién importado y sin cruzar, `matched` propuesto contra un documento (por `POST /banking/transactions/{id}/match` o por el automático), `reconciled` confirmado, `ignored` apartado a mano porque no corresponde a ninguno.
+             * @enum {string}
+             */
+            status: "pending" | "matched" | "reconciled" | "ignored";
             import_batch: string | null;
             /** Format: date-time */
             created_at: string | null;
@@ -5099,6 +5260,10 @@ export interface components {
             updated_at: string | null;
             /** Format: date-time */
             deleted_at: string | null;
+            /** @description La cuenta del apunte, con `id` y `name` y nada más. Llega en el listado (`GET /banking/transactions`), que la carga siempre; en las respuestas de una operación sobre un apunte suelto no tiene por qué estar. */
+            bank_account?: Record<string, never> | null;
+            /** @description Los cruces del apunte con documentos del ERP, cada uno con su `reconcilable` (la factura, el gasto o la recibida). Como `bank_account`: la trae el listado, que la carga siempre. */
+            reconciliations?: Record<string, never>[] | null;
         };
         /** BulkExchangeRateRequest */
         BulkExchangeRateRequest: {
@@ -6004,10 +6169,11 @@ export interface components {
             sub_total?: number | null;
             total?: number | null;
             /**
-             * @description `integer` porque son CÉNTIMOS. Sin regla de tipo, el contrato
-             *     publicaba este campo como `string` —el generador deduce el tipo
-             *     de las reglas— y la API aceptaba «10.5», que la columna guardaba
-             *     como 10,5 céntimos: medio céntimo, que no significa nada.
+             * @description `integer` porque son SUBUNIDADES enteras de la moneda. Sin regla
+             *     de tipo, el contrato publicaba este campo como `string` —el
+             *     generador deduce el tipo de las reglas— y la API aceptaba «10.5»,
+             *     que la columna guardaba como 10,5: media subunidad, que no
+             *     significa nada.
              */
             tax?: number | null;
             template_name?: string | null;
@@ -6149,10 +6315,11 @@ export interface components {
             exchange_rate?: string | null;
             payment_method_id?: string | null;
             /**
-             * @description `integer` porque son CÉNTIMOS. Sin regla de tipo, el contrato
-             *     publicaba este campo como `string` —el generador deduce el tipo
-             *     de las reglas— y la API aceptaba «10.5», que la columna guardaba
-             *     como 10,5 céntimos: medio céntimo, que no significa nada.
+             * @description `integer` porque son SUBUNIDADES enteras de la moneda. Sin regla
+             *     de tipo, el contrato publicaba este campo como `string` —el
+             *     generador deduce el tipo de las reglas— y la API aceptaba «10.5»,
+             *     que la columna guardaba como 10,5: media subunidad, que no
+             *     significa nada.
              */
             amount: number;
             customer_id?: string | null;
@@ -6253,9 +6420,9 @@ export interface components {
             residual_value: number;
             useful_life_years: number;
             depreciation_method: string;
-            annual_depreciation: string;
-            accumulated_depreciation: string;
-            net_book_value: string;
+            annual_depreciation: number;
+            accumulated_depreciation: number;
+            net_book_value: number;
             depreciation_schedule: string;
             company_id: number;
             /** Format: date-time */
@@ -6386,9 +6553,7 @@ export interface components {
              *     respuestas de escritura, con `[]` cuando la línea no cobra
              *     ninguno; en el índice no viaja.
              */
-            time_entry_ids?: {
-                [key: string]: unknown;
-            };
+            time_entry_ids?: number[];
             taxes?: components["schemas"]["TaxResource"][];
             fields?: components["schemas"]["CustomFieldValueResource"][];
         };
@@ -6410,10 +6575,10 @@ export interface components {
             discount_val: number;
             sub_total: number;
             total: number;
-            effective_total: string;
+            effective_total: number;
             tax: number;
             due_amount: number;
-            effective_due_amount: string;
+            effective_due_amount: number;
             sent: string;
             viewed: string;
             /**
@@ -6443,10 +6608,11 @@ export interface components {
             creator_id: number | null;
             base_tax: number;
             base_due_amount: number;
-            effective_base_total: string;
-            effective_base_due_amount: string;
-            credited_total: string;
-            credited_base_total: string;
+            effective_base_total: number;
+            /** @description NULL cuando la factura no tiene `base_due_amount` calculado, y entonces es un hueco, no un cero: una factura que no ha calculado su deuda en moneda base no es una factura que no deba nada. */
+            effective_base_due_amount: number | null;
+            credited_total: number;
+            credited_base_total: number;
             currency_id: number | null;
             formatted_created_at: string;
             invoice_pdf_url: string;
@@ -6572,8 +6738,8 @@ export interface components {
              *     que esto no cueste ni una consulta, y que el scope sea
              *     obligatorio en cualquier índice que sirva este recurso.
              */
-            effective_total: string;
-            effective_due_amount: string;
+            effective_total: number;
+            effective_due_amount: number;
             effective_paid_status: string;
             effective_overdue: string;
             currency_id: number | null;
@@ -6689,10 +6855,11 @@ export interface components {
             sub_total?: number | null;
             total?: number | null;
             /**
-             * @description `integer` porque son CÉNTIMOS. Sin regla de tipo, el contrato
-             *     publicaba este campo como `string` —el generador deduce el tipo
-             *     de las reglas— y la API aceptaba «10.5», que la columna guardaba
-             *     como 10,5 céntimos: medio céntimo, que no significa nada.
+             * @description `integer` porque son SUBUNIDADES enteras de la moneda. Sin regla
+             *     de tipo, el contrato publicaba este campo como `string` —el
+             *     generador deduce el tipo de las reglas— y la API aceptaba «10.5»,
+             *     que la columna guardaba como 10,5: media subunidad, que no
+             *     significa nada.
              */
             tax?: number | null;
             /**
@@ -6870,10 +7037,11 @@ export interface components {
         ItemsRequest: {
             name: string;
             /**
-             * @description `integer` porque son CÉNTIMOS. Sin regla de tipo, el contrato
-             *     publicaba este campo como `string` —el generador deduce el tipo
-             *     de las reglas— y la API aceptaba «10.5», que la columna guardaba
-             *     como 10,5 céntimos: medio céntimo, que no significa nada.
+             * @description `integer` porque son SUBUNIDADES enteras de la moneda. Sin regla
+             *     de tipo, el contrato publicaba este campo como `string` —el
+             *     generador deduce el tipo de las reglas— y la API aceptaba «10.5»,
+             *     que la columna guardaba como 10,5: media subunidad, que no
+             *     significa nada.
              */
             price: number;
             /** @enum {string|null} */
@@ -7172,12 +7340,20 @@ export interface components {
             currency?: components["schemas"]["CurrencyResource"] | null;
             transaction?: components["schemas"]["TransactionResource"] | null;
         };
-        /** ProfileRequest */
+        /**
+         * ProfileRequest
+         * @description `PUT /me` — el nombre, el correo y la contraseña de quien llama.
+         *
+         *     Cambiar el **correo** o la **contraseña** exige `current_password`, la
+         *     vigente. Cambiar solo el nombre no: `name` y `email` son los dos `required`,
+         *     así que reenviar el mismo correo no cuenta como cambio.
+         */
         ProfileRequest: {
             name: string;
             password?: string | null;
             /** Format: email */
             email: string;
+            current_password?: string;
         };
         /** ProjectRequest */
         ProjectRequest: {
@@ -7313,10 +7489,11 @@ export interface components {
             sub_total: number;
             total: number;
             /**
-             * @description `integer` porque son CÉNTIMOS. Sin regla de tipo, el contrato
-             *     publicaba este campo como `string` —el generador deduce el tipo
-             *     de las reglas— y la API aceptaba «10.5», que la columna guardaba
-             *     como 10,5 céntimos: medio céntimo, que no significa nada.
+             * @description `integer` porque son SUBUNIDADES enteras de la moneda. Sin regla
+             *     de tipo, el contrato publicaba este campo como `string` —el
+             *     generador deduce el tipo de las reglas— y la API aceptaba «10.5»,
+             *     que la columna guardaba como 10,5: media subunidad, que no
+             *     significa nada.
              */
             tax: number;
             /**
@@ -7433,10 +7610,11 @@ export interface components {
             sub_total?: number | null;
             total?: number | null;
             /**
-             * @description `integer` porque son CÉNTIMOS. Sin regla de tipo, el contrato
-             *     publicaba este campo como `string` —el generador deduce el tipo
-             *     de las reglas— y la API aceptaba «10.5», que la columna guardaba
-             *     como 10,5 céntimos: medio céntimo, que no significa nada.
+             * @description `integer` porque son SUBUNIDADES enteras de la moneda. Sin regla
+             *     de tipo, el contrato publicaba este campo como `string` —el
+             *     generador deduce el tipo de las reglas— y la API aceptaba «10.5»,
+             *     que la columna guardaba como 10,5: media subunidad, que no
+             *     significa nada.
              */
             tax?: number | null;
             /**
@@ -7562,7 +7740,7 @@ export interface components {
             discount_per_item: string | null;
             notes: string | null;
             discount_type: string | null;
-            discount: string | null;
+            discount: number | null;
             discount_val: number | null;
             sub_total: number | null;
             total: number | null;
@@ -8435,7 +8613,7 @@ export interface operations {
     "absence.teamCalendar": {
         parameters: {
             query?: {
-                month?: string;
+                month?: string | null;
             };
             header?: never;
             path?: never;
@@ -8461,6 +8639,7 @@ export interface operations {
                 };
             };
             403: components["responses"]["AuthorizationException"];
+            422: components["responses"]["ValidationException"];
         };
     };
     "absence.approve": {
@@ -8602,7 +8781,7 @@ export interface operations {
         };
         responses: {
             /** @description `AbsenceResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -8724,7 +8903,7 @@ export interface operations {
                 };
                 content: {
                     "application/json": {
-                        version: null | unknown[] | string | Record<string, never>;
+                        version: string | null;
                         /** @constant */
                         channel: "stable";
                     };
@@ -9266,7 +9445,7 @@ export interface operations {
                 };
                 content: {
                     "application/json": {
-                        data: unknown[];
+                        data: string[];
                     };
                 };
             };
@@ -9451,7 +9630,7 @@ export interface operations {
         requestBody?: never;
         responses: {
             /** @description `EstimateResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -9478,7 +9657,7 @@ export interface operations {
         requestBody?: never;
         responses: {
             /** @description `InvoiceResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -9688,6 +9867,94 @@ export interface operations {
             };
         };
     };
+    "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: {
@@ -9728,7 +9995,7 @@ export interface operations {
         };
         responses: {
             /** @description `ContactResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -9966,7 +10233,7 @@ export interface operations {
         };
         responses: {
             /** @description `CustomFieldResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -10187,7 +10454,7 @@ export interface operations {
     "customers.index": {
         parameters: {
             query?: {
-                /** @description Con `summary`, cada fila trae solo los campos del listado: nombre, contacto, NIF, saldo pendiente neto en céntimos y fechas — sin direcciones, campos personalizados, empresa, moneda ni método de pago, y sin el avatar (que cuesta una consulta por fila). Pensado para índices y para recuentos que solo leen el `meta`; la ficha completa sigue en el detalle y en el índice sin este parámetro. */
+                /** @description Con `summary`, cada fila trae solo los campos del listado: nombre, contacto, NIF, saldo pendiente neto en subunidades y fechas — sin direcciones, campos personalizados, empresa, moneda ni método de pago, y sin el avatar (que cuesta una consulta por fila). Pensado para índices y para recuentos que solo leen el `meta`; la ficha completa sigue en el detalle y en el índice sin este parámetro. */
                 view?: "summary";
                 /** @description Devuelve solo el recurso que lleve esta referencia externa. El alcance es el client OAuth del token: cada integrador consulta las suyas y nunca ve las de otro. Combinado con la escritura de `external_ref`, es el find-or-create sin mantener ningún mapeo local. */
                 external_ref?: string;
@@ -10601,7 +10868,7 @@ export interface operations {
         };
         responses: {
             /** @description `DeliveryNoteResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -10753,7 +11020,7 @@ export interface operations {
         };
         responses: {
             /** @description `EmployeeProfileResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -10912,7 +11179,7 @@ export interface operations {
         };
         responses: {
             /** @description `EstimateSeriesResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -11068,7 +11335,7 @@ export interface operations {
     "estimates.index": {
         parameters: {
             query?: {
-                /** @description Con `summary`, cada fila trae solo los campos del listado: fechas, número, estado, importes en céntimos, el cliente reducido a `{id, name, email, phone}` y la URL del PDF — sin líneas, impuestos, empresa ni moneda. Pensado para índices y para recuentos que solo leen el `meta`; el documento completo sigue en el detalle y en el índice sin este parámetro. */
+                /** @description Con `summary`, cada fila trae solo los campos del listado: fechas, número, estado, importes en subunidades, el cliente reducido a `{id, name, email, phone}` y la URL del PDF — sin líneas, impuestos, empresa ni moneda. Pensado para índices y para recuentos que solo leen el `meta`; el documento completo sigue en el detalle y en el índice sin este parámetro. */
                 view?: "summary";
                 /** @description Devuelve solo el recurso que lleve esta referencia externa. El alcance es el client OAuth del token: cada integrador consulta las suyas y nunca ve las de otro. Combinado con la escritura de `external_ref`, es el find-or-create sin mantener ningún mapeo local. */
                 external_ref?: string;
@@ -11119,7 +11386,7 @@ export interface operations {
         };
         responses: {
             /** @description `EstimateResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -11229,7 +11496,7 @@ export interface operations {
         };
         responses: {
             /** @description `ExpenseCategoryResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -11328,6 +11595,44 @@ export interface operations {
             404: components["responses"]["ModelNotFoundException"];
         };
     };
+    "expenses.uploadReceipt": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The expense ID */
+                expense: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "multipart/form-data": {
+                    /**
+                     * Format: binary
+                     * @description Maximum file size: 20000 kilobytes.
+                     */
+                    receipt: Blob;
+                };
+            };
+        };
+        responses: {
+            /** @description `ExpenseResource` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ExpenseResource"];
+                    };
+                };
+            };
+            403: components["responses"]["AuthorizationException"];
+            404: components["responses"]["ModelNotFoundException"];
+            422: components["responses"]["ValidationException"];
+        };
+    };
     "expenses.delete": {
         parameters: {
             query?: never;
@@ -11395,7 +11700,7 @@ export interface operations {
         };
         responses: {
             /** @description `ExpenseResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -11950,7 +12255,7 @@ export interface operations {
         };
         responses: {
             /** @description `IncidenceResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -12132,7 +12437,7 @@ export interface operations {
         };
         responses: {
             /** @description `InvestmentAssetResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -12339,7 +12644,7 @@ export interface operations {
         };
         responses: {
             /** @description `InvoiceSeriesResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -12470,7 +12775,7 @@ export interface operations {
         };
         responses: {
             /** @description `InvoiceTemplateResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -12639,7 +12944,7 @@ export interface operations {
         };
         responses: {
             /** @description `InvoiceTemplateResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -12849,7 +13154,7 @@ export interface operations {
         parameters: {
             query?: {
                 limit?: string;
-                /** @description Con `summary`, cada fila trae solo los campos del listado: fechas, número, los tres ejes de estado (documento, cobro y AEAT), importes en céntimos —incluidos los netos de rectificativas—, el cliente reducido a `{id, name, email, phone}` y la URL del PDF; sin líneas, impuestos, pagos, empresa ni la factura rectificada. Pensado para índices y para recuentos que solo leen el `meta`; el documento completo sigue en el detalle y en el índice sin este parámetro. */
+                /** @description Con `summary`, cada fila trae solo los campos del listado: fechas, número, los tres ejes de estado (documento, cobro y AEAT), importes en subunidades —incluidos los netos de rectificativas—, el cliente reducido a `{id, name, email, phone}` y la URL del PDF; sin líneas, impuestos, pagos, empresa ni la factura rectificada. Pensado para índices y para recuentos que solo leen el `meta`; el documento completo sigue en el detalle y en el índice sin este parámetro. */
                 view?: "summary";
                 /** @description Devuelve solo el recurso que lleve esta referencia externa. El alcance es el client OAuth del token: cada integrador consulta las suyas y nunca ve las de otro. Combinado con la escritura de `external_ref`, es el find-or-create sin mantener ningún mapeo local. */
                 external_ref?: string;
@@ -13690,7 +13995,7 @@ export interface operations {
         };
         responses: {
             /** @description `LeadResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -14194,7 +14499,7 @@ export interface operations {
         };
         responses: {
             /** @description `NoteResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -14585,7 +14890,7 @@ export interface operations {
         };
         responses: {
             /** @description `PaymentMethodResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -15064,7 +15369,7 @@ export interface operations {
         };
         responses: {
             /** @description `ProjectResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -15417,7 +15722,14 @@ export interface operations {
     };
     "reconciliation.transactions": {
         parameters: {
-            query?: never;
+            query?: {
+                bank_account_id?: number | null;
+                status?: "pending" | "matched" | "reconciled" | "ignored" | null;
+                type?: "credit" | "debit" | null;
+                from_date?: string | null;
+                to_date?: string | null;
+                per_page?: number | null;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -15455,11 +15767,14 @@ export interface operations {
                     };
                 };
             };
+            422: components["responses"]["ValidationException"];
         };
     };
     "reconciliation.summary": {
         parameters: {
-            query?: never;
+            query?: {
+                bank_account_id?: number | null;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -15474,16 +15789,17 @@ export interface operations {
                     "application/json": {
                         data: {
                             total: number;
-                            pending: string;
-                            matched: string;
-                            reconciled: string;
-                            ignored: string;
+                            pending: number;
+                            matched: number;
+                            reconciled: number;
+                            ignored: number;
                             total_credits: string;
                             total_debits: string;
                         };
                     };
                 };
             };
+            422: components["responses"]["ValidationException"];
         };
     };
     "reconciliation.autoMatch": {
@@ -15493,7 +15809,13 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody?: {
+            content: {
+                "application/json": {
+                    bank_account_id?: number | null;
+                };
+            };
+        };
         responses: {
             200: {
                 headers: {
@@ -15522,6 +15844,7 @@ export interface operations {
                     };
                 };
             };
+            422: components["responses"]["ValidationException"];
         };
     };
     "reconciliation.suggestions": {
@@ -15729,7 +16052,7 @@ export interface operations {
         };
         responses: {
             /** @description `RecurringInvoiceResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -15990,7 +16313,7 @@ export interface operations {
         };
         responses: {
             /** @description `RoleResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -17293,7 +17616,7 @@ export interface operations {
         };
         responses: {
             /** @description `TaskResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -17451,7 +17774,7 @@ export interface operations {
         };
         responses: {
             /** @description `TaxTypeResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -17952,7 +18275,7 @@ export interface operations {
         };
         responses: {
             /** @description `TimeClockCorrectionResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -18091,7 +18414,7 @@ export interface operations {
         };
         responses: {
             /** @description `TimeEntryResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -20888,7 +21211,7 @@ export interface operations {
         };
         responses: {
             /** @description `UnitResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -21096,7 +21419,7 @@ export interface operations {
         };
         responses: {
             /** @description `UserResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -21650,7 +21973,7 @@ export interface operations {
         };
         responses: {
             /** @description `HolidayResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -21730,7 +22053,7 @@ export interface operations {
         };
         responses: {
             /** @description `WorkCalendarResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -21868,7 +22191,7 @@ export interface operations {
         };
         responses: {
             /** @description `WorkScheduleResource` */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };

package/dist/client.d.ts

@@ -211,10 +211,10 @@ export declare class PimiaClient {
             discount_val: number;
             sub_total: number;
             total: number;
-            effective_total: string;
+            effective_total: number;
             tax: number;
             due_amount: number;
-            effective_due_amount: string;
+            effective_due_amount: number;
             sent: string;
             viewed: string;
             sent_at: string;
@@ -234,10 +234,10 @@ export declare class PimiaClient {
             creator_id: number | null;
             base_tax: number;
             base_due_amount: number;
-            effective_base_total: string;
-            effective_base_due_amount: string;
-            credited_total: string;
-            credited_base_total: string;
+            effective_base_total: number;
+            effective_base_due_amount: number | null;
+            credited_total: number;
+            credited_base_total: number;
             currency_id: number | null;
             formatted_created_at: string;
             invoice_pdf_url: string;
@@ -298,10 +298,10 @@ export declare class PimiaClient {
             discount_val: number;
             sub_total: number;
             total: number;
-            effective_total: string;
+            effective_total: number;
             tax: number;
             due_amount: number;
-            effective_due_amount: string;
+            effective_due_amount: number;
             sent: string;
             viewed: string;
             sent_at: string;
@@ -321,10 +321,10 @@ export declare class PimiaClient {
             creator_id: number | null;
             base_tax: number;
             base_due_amount: number;
-            effective_base_total: string;
-            effective_base_due_amount: string;
-            credited_total: string;
-            credited_base_total: string;
+            effective_base_total: number;
+            effective_base_due_amount: number | null;
+            credited_total: number;
+            credited_base_total: number;
             currency_id: number | null;
             formatted_created_at: string;
             invoice_pdf_url: string;
@@ -491,10 +491,10 @@ export declare class PimiaClient {
             discount_val: number;
             sub_total: number;
             total: number;
-            effective_total: string;
+            effective_total: number;
             tax: number;
             due_amount: number;
-            effective_due_amount: string;
+            effective_due_amount: number;
             sent: string;
             viewed: string;
             sent_at: string;
@@ -514,10 +514,10 @@ export declare class PimiaClient {
             creator_id: number | null;
             base_tax: number;
             base_due_amount: number;
-            effective_base_total: string;
-            effective_base_due_amount: string;
-            credited_total: string;
-            credited_base_total: string;
+            effective_base_total: number;
+            effective_base_due_amount: number | null;
+            credited_total: number;
+            credited_base_total: number;
             currency_id: number | null;
             formatted_created_at: string;
             invoice_pdf_url: string;

package/dist/index.d.ts

@@ -37,8 +37,21 @@ export declare const SCOPES: {
     readonly reportsRead: "reports:read";
     /** Leer la configuración de la empresa (impuestos, preferencias, series). */
     readonly settingsRead: "settings:read";
+    /**
+     * Configurar la empresa: impuestos, preferencias, campos personalizados y el
+     * perfil del propio usuario (`PUT /me`). Ojo con ese último: cambiar el
+     * correo o la contraseña exige además `current_password`, que es del usuario
+     * y no tuya.
+     */
+    readonly settingsWrite: "settings:write";
+    /** Cerrar y reabrir los trimestres fiscales del tenant. */
+    readonly reportsWrite: "reports:write";
     /** Ver la tienda de módulos y qué tiene contratado el tenant. */
     readonly storeRead: "store:read";
+    /** Instalar módulos de la tienda en el tenant. */
+    readonly storeWrite: "store:write";
+    /** Leer documentos con IA (OCR de gastos y de facturas recibidas). */
+    readonly ocrWrite: "ocr:write";
     /** Leer la gestión de personal: empleados, ausencias, fichajes, calendarios. */
     readonly hrRead: "hr:read";
     /** Gestionar el personal: altas, ausencias, correcciones de fichaje, horarios. */

package/dist/index.js

@@ -33,8 +33,21 @@ export const SCOPES = {
     reportsRead: 'reports:read',
     /** Leer la configuración de la empresa (impuestos, preferencias, series). */
     settingsRead: 'settings:read',
+    /**
+     * Configurar la empresa: impuestos, preferencias, campos personalizados y el
+     * perfil del propio usuario (`PUT /me`). Ojo con ese último: cambiar el
+     * correo o la contraseña exige además `current_password`, que es del usuario
+     * y no tuya.
+     */
+    settingsWrite: 'settings:write',
+    /** Cerrar y reabrir los trimestres fiscales del tenant. */
+    reportsWrite: 'reports:write',
     /** Ver la tienda de módulos y qué tiene contratado el tenant. */
     storeRead: 'store:read',
+    /** Instalar módulos de la tienda en el tenant. */
+    storeWrite: 'store:write',
+    /** Leer documentos con IA (OCR de gastos y de facturas recibidas). */
+    ocrWrite: 'ocr:write',
     /** Leer la gestión de personal: empleados, ausencias, fichajes, calendarios. */
     hrRead: 'hr:read',
     /** Gestionar el personal: altas, ausencias, correcciones de fichaje, horarios. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pimia/sdk",
-  "version": "0.8.0",
+  "version": "0.10.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)",