{"openapi":"3.1.0","info":{"title":"API pública de HolaERP","version":"1.0.0","description":"API REST de lectura para integraciones. Guía completa: /v1/docs."},"servers":[{"url":"https://api.holaerp.com","description":"Producción"}],"security":[{"apiKey":[]}],"tags":[{"name":"Clientes"},{"name":"Facturas emitidas"},{"name":"Artículos"},{"name":"Facturas recibidas"},{"name":"Proveedores"},{"name":"Tesorería"}],"paths":{"/v1/customers":{"get":{"operationId":"facturacion_clientes_listar","tags":["Clientes"],"summary":"Clientes","description":"Lista los clientes de la empresa con los filtros de la pantalla «Clientes»: texto, archivados, rol comercial, población, régimen fiscal y país del NIF. Por cliente: id, nombre, razón social, país del NIF, rol, régimen fiscal, estado VIES, población, forma y plazo de pago por defecto y fechas. Sin NIF, email ni teléfono.\n\nPermiso: `facturacion.clientes.read`. Cuota: `list`. Página máxima: 100.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":255},"description":"Texto libre: nombre, razón social, NIF o contacto principal, sin acentos."},{"name":"includeArchived","in":"query","required":false,"schema":{"type":"boolean"},"description":"true para incluir los archivados, que por defecto no salen."},{"name":"commercialRole","in":"query","required":false,"schema":{"type":"string","enum":["customer","supplier","both"]},"description":"Rol efectivo: both = cliente y proveedor; customer o supplier = solo ese."},{"name":"city","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120},"description":"Población, contiene."},{"name":"taxRegime","in":"query","required":false,"schema":{"type":"string","enum":["general","equivalence_surcharge","simplified","agricultural","recc","rebu","not_applicable"]},"description":"Régimen fiscal."},{"name":"taxIdCountry","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$"},"description":"País del NIF (ISO 3166-1 alfa-2)."},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["name","legalName","createdAt"]},"description":"Orden. Por defecto name."},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]},"description":"Sentido del orden."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Elementos por página, de 1 al máximo del listado. Se fija en la primera página: con cursor, el mismo o ninguno."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de `page.nextCursor` para pedir la página siguiente, con los mismos filtros y la misma clave. Caduca en 24 horas."}],"responses":{"200":{"description":"Una página del listado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FacturacionClientesListarRow"}},"page":{"$ref":"#/components/schemas/Page"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"facturacion_clientes_listar","version":1,"rateClass":"list","requiredPermissions":["facturacion.clientes.read"],"anyOfPermissions":[]}}},"/v1/customers/{customerId}":{"get":{"operationId":"facturacion_cliente_ver","tags":["Clientes"],"summary":"El cliente","description":"Devuelve la ficha de UN cliente: nombre, razón social, país del NIF, rol, régimen fiscal, estado VIES, población y valores por defecto de facturación (forma y plazo de pago, moneda, impuesto, tarifa, idioma, límite de crédito). No devuelve el NIF, el email, el teléfono, las direcciones ni las cuentas bancarias.\n\nPermiso: `facturacion.clientes.read`. Cuota: `read`.","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id del cliente (campo entityId del listado)."}],"responses":{"200":{"description":"El recurso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/FacturacionClienteVer"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"facturacion_cliente_ver","version":1,"rateClass":"read","requiredPermissions":["facturacion.clientes.read"],"anyOfPermissions":[]}}},"/v1/invoices":{"get":{"operationId":"facturacion_facturas_emitidas_listar","tags":["Facturas emitidas"],"summary":"Facturas emitidas","description":"Lista las facturas de venta (emitidas) de la empresa con los mismos filtros que la pantalla «Facturas emitidas». Úsala para preguntas sobre facturas concretas o sobre qué se ha facturado: por estado, cliente, serie, fechas de emisión, cobro, o estado de FACe, SII o Veri*Factu. Devuelve un conjunto de datos (datasetId, total, muestra de hasta 20 filas y las columnas) con, por factura: id, número, tipo, estado, fechas de emisión y vencimiento, cliente, moneda, total, cobrado y estados fiscales. Hasta 2.000 filas, las más recientes primero. Para sumar, agrupar por mes o por cliente o sacar rankings NO calcules tú: llama después a estadisticas_calcular con el datasetId. Con status vacío salen también los borradores, que no están facturados: para importes facturados filtra por estado. Las rectificativas (invoiceKind = rectifying) corrigen facturas anteriores y vienen en el mismo listado. No devuelve las líneas ni el desglose de impuestos (para eso, facturacion_factura_emitida_ver) ni las facturas recibidas de proveedores.\n\nPermiso: `facturacion.invoices.view`. Cuota: `list`. Página máxima: 200.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":255},"description":"Texto libre: busca en el número de factura y en el nombre del cliente."},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["draft","issued","partially_paid","paid","overdue","rectified"]},"minItems":1,"maxItems":6},"description":"Estados a incluir. Sin este filtro salen también los borradores (sin número ni fecha): para lo ya facturado usa issued, partially_paid, paid y overdue.","style":"form","explode":true},{"name":"invoiceKind","in":"query","required":false,"schema":{"type":"string","enum":["normal","rectifying","simplified"]},"description":"normal, rectifying (rectificativa) o simplified (simplificada)."},{"name":"customerEntityId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Id de un cliente (campo customerEntityId o entityId de otra consulta)."},{"name":"seriesId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Id de una serie de facturación."},{"name":"issueDateFrom","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Fecha de emisión desde, inclusive (AAAA-MM-DD). Excluye los borradores."},{"name":"issueDateTo","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Fecha de emisión hasta, inclusive (AAAA-MM-DD)."},{"name":"faceStatus","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["not_applicable","pending","presented","accepted","paid","rejected","cancelled","error"]},"minItems":1,"maxItems":8},"description":"Estados de presentación en FACe (facturas a Administraciones Públicas).","style":"form","explode":true},{"name":"siiStatus","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["not_applicable","pending","accepted","accepted_with_errors","rejected"]},"minItems":1,"maxItems":5},"description":"Estados del envío al SII de la AEAT.","style":"form","explode":true},{"name":"siiOverdue","in":"query","required":false,"schema":{"type":"boolean"},"description":"true: solo las facturas del SII en cola con el plazo legal ya vencido."},{"name":"verifactuStatus","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["not_applicable","pending","accepted","accepted_with_warnings","rejected","recorded"]},"minItems":1,"maxItems":6},"description":"Estados del envío a Veri*Factu.","style":"form","explode":true},{"name":"includeArchived","in":"query","required":false,"schema":{"type":"boolean"},"description":"true para incluir las archivadas, que por defecto no salen."},{"name":"archivedOnly","in":"query","required":false,"schema":{"type":"boolean"},"description":"true para listar SOLO las archivadas (la vista «Archivadas» de la pantalla). Gana a includeArchived."},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["issueDate","invoiceNumber","total","createdAt"]},"description":"Orden del listado. Por defecto issueDate."},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]},"description":"Por defecto desc (lo último primero)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Elementos por página, de 1 al máximo del listado. Se fija en la primera página: con cursor, el mismo o ninguno."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de `page.nextCursor` para pedir la página siguiente, con los mismos filtros y la misma clave. Caduca en 24 horas."}],"responses":{"200":{"description":"Una página del listado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FacturacionFacturasEmitidasListarRow"}},"page":{"$ref":"#/components/schemas/Page"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"facturacion_facturas_emitidas_listar","version":1,"rateClass":"list","requiredPermissions":["facturacion.invoices.view"],"anyOfPermissions":[]}}},"/v1/invoices/{invoiceId}":{"get":{"operationId":"facturacion_factura_emitida_ver","tags":["Facturas emitidas"],"summary":"La factura","description":"Devuelve la ficha de UNA factura emitida: número, tipo, estado, fechas, cliente, totales (subtotal, descuentos, base imponible, impuestos, retenciones, total y cobrado) y estado en Veri*Factu, SII y FACe. Úsala cuando el usuario pregunta por una factura concreta o tiene una abierta en pantalla; necesita el id de la factura, que sale de facturacion_facturas_emitidas_listar (columna id). No devuelve las líneas (facturacion_factura_emitida_lineas) ni el desglose por tipo de impuesto (facturacion_factura_emitida_impuestos), ni los vencimientos o los cobros uno a uno. Para varias facturas usa el listado.\n\nPermiso: `facturacion.invoices.view`. Cuota: `read`.","parameters":[{"name":"invoiceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id de la factura (campo id del listado de facturas emitidas)."}],"responses":{"200":{"description":"El recurso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/FacturacionFacturaEmitidaVer"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"facturacion_factura_emitida_ver","version":1,"rateClass":"read","requiredPermissions":["facturacion.invoices.view"],"anyOfPermissions":[]}}},"/v1/items":{"get":{"operationId":"facturacion_articulos_listar","tags":["Artículos"],"summary":"Artículos","description":"Lista los artículos del catálogo con los mismos filtros que la pantalla «Artículos»: texto, tipo, estado, familias, impuestos, fecha de alta, si tienen variantes y si se venden. El tipo (kind) es la naturaleza: product, service, digital o expense. Que un artículo tenga variantes (hasVariants, con variantCount) o sea un pack (bundleExpansionMode: lines, de sueltos; none, empaquetado) va aparte; una variante lleva variantLabel. Devuelve un conjunto de datos (datasetId, total, muestra de hasta 20 filas y las columnas) con, por artículo: id, referencia, nombre, tipo, si tiene variantes, variante, pack, familia, unidad, precio de venta y si se vende, lleva existencias y está activo. Hasta 1.000 filas. Para contar o agrupar (por familia, por tipo) llama después a estadisticas_calcular con el datasetId. Para exportar el listado a un fichero genera el informe facturacion.articulos.catalog con los filtros renombrados: q → q, kind → kind (un solo tipo), hasVariants → has_variants, isPack → is_pack (o catalogType pack_lines / pack_none), categoryId → category_id, isSellable → is_sellable, isActive → is_active, includeArchived → include_archived. Con importJobId (lo importado en una importación de datos), el informe no puede filtrar por la importación: saldría el catálogo entero. Dilo antes de generarlo y ofrece la lista o las cuentas en el chat. No devuelve precios de compra ni existencias por almacén ni ventas del artículo (para eso, facturacion_ventas_por_articulo).\n\nPermiso: `facturacion.articulos.read`. Cuota: `list`. Página máxima: 100.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":255},"description":"Texto libre: busca sin tildes en la referencia, el nombre y la variante, y el código de barras exacto."},{"name":"catalogType","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["product","service","digital","expense","pack_lines","pack_none"]},"minItems":1,"maxItems":6},"description":"Tipo tal como lo ve la pantalla, varios a la vez: product, service, digital y expense son la naturaleza y no incluyen los packs; pack_lines (pack de artículos sueltos) y pack_none (pack empaquetado), los packs.","style":"form","explode":true},{"name":"kind","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["product","service","digital","expense"]},"minItems":1,"maxItems":4},"description":"Naturaleza (product, service, digital, expense), packs incluidos.","style":"form","explode":true},{"name":"hasVariants","in":"query","required":false,"schema":{"type":"boolean"},"description":"true: solo las cabeceras de artículos con variantes; false: todo lo demás, variantes incluidas."},{"name":"isPack","in":"query","required":false,"schema":{"type":"boolean"},"description":"true: solo los packs; false: lo que no es un pack."},{"name":"groupVariants","in":"query","required":false,"schema":{"type":"boolean"},"description":"true, como la pantalla: las variantes no salen como filas, solo su cabecera (el total es el de la pantalla). Las variantes de una cabecera se piden con parentArticleId."},{"name":"parentArticleId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Solo las variantes de esa cabecera (su id)."},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["active","inactive","archived"]},"minItems":1,"maxItems":3},"description":"Estados, varios a la vez: active, inactive (sin archivar y apagado) y archived. Si viene, manda sobre isActive e includeArchived.","style":"form","explode":true},{"name":"categoryId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Id de una familia de artículos."},{"name":"categoryIds","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":50},"description":"Ids de varias familias: casa el artículo que esté en alguna.","style":"form","explode":true},{"name":"taxCodeIds","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":50},"description":"Ids de los impuestos de venta por defecto del artículo.","style":"form","explode":true},{"name":"createdFrom","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Dado de alta desde, inclusive (AAAA-MM-DD)."},{"name":"createdTo","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Dado de alta hasta, inclusive (AAAA-MM-DD)."},{"name":"isSellable","in":"query","required":false,"schema":{"type":"boolean"},"description":"true: solo los que se venden; false: solo los que no. Sin él, todos."},{"name":"isActive","in":"query","required":false,"schema":{"type":"boolean"},"description":"true: solo los activos; false: solo los inactivos. Sin él, todos."},{"name":"includeArchived","in":"query","required":false,"schema":{"type":"boolean"},"description":"true devuelve SOLO los archivados (no los suma a los vivos)."},{"name":"importJobId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Solo los artículos que creó o actualizó esa importación de datos (el listado abierto desde «Ver lo importado»)."},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["name","code","kind","createdAt"]},"description":"Orden del listado. Por defecto name."},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]},"description":"Por defecto asc."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Elementos por página, de 1 al máximo del listado. Se fija en la primera página: con cursor, el mismo o ninguno."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de `page.nextCursor` para pedir la página siguiente, con los mismos filtros y la misma clave. Caduca en 24 horas."}],"responses":{"200":{"description":"Una página del listado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FacturacionArticulosListarRow"}},"page":{"$ref":"#/components/schemas/Page"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"facturacion_articulos_listar","version":1,"rateClass":"list","requiredPermissions":["facturacion.articulos.read"],"anyOfPermissions":[]}}},"/v1/items/{itemId}":{"get":{"operationId":"facturacion_articulo_ver","tags":["Artículos"],"summary":"El artículo","description":"Devuelve la ficha de UN artículo: referencia, nombre, descripción, tipo, estructura (variantes o pack), unidad, precio de venta, impuesto de venta por defecto, familia, código de barras y estado. No devuelve el precio de compra, las variantes una a una, la composición ni las existencias.\n\nPermiso: `facturacion.articulos.read`. Cuota: `read`.","parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id del artículo (campo id del listado de artículos)."}],"responses":{"200":{"description":"El recurso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/FacturacionArticuloVer"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"facturacion_articulo_ver","version":1,"rateClass":"read","requiredPermissions":["facturacion.articulos.read"],"anyOfPermissions":[]}}},"/v1/purchase-invoices":{"get":{"operationId":"facturacion_facturas_recibidas_listar","tags":["Facturas recibidas"],"summary":"Facturas recibidas","description":"Lista las facturas recibidas de proveedores con los filtros de la pantalla «Facturas recibidas»: texto, estado, tipo, proveedor y fechas. Por factura: id, número y serie del proveedor, tipo, estado, fechas, proveedor, moneda, totales, pagado, cotejo y estado SII. Sin NIF ni dirección del proveedor.\n\nPermiso: `facturacion.purchase_invoices.view`. Cuota: `list`. Página máxima: 100.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":255},"description":"Texto libre: número, serie, referencia o proveedor."},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["draft","recorded","partially_paid","paid","disputed","rectified"]},"minItems":1,"maxItems":6},"description":"Estados a incluir. Sin este filtro salen también los borradores.","style":"form","explode":true},{"name":"invoiceKind","in":"query","required":false,"schema":{"type":"string","enum":["normal","rectifying","simplified","import"]},"description":"Tipo de factura recibida."},{"name":"supplierEntityId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Id de un proveedor."},{"name":"dateFrom","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Fecha de la factura desde, inclusive (AAAA-MM-DD)."},{"name":"dateTo","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Fecha de la factura hasta, inclusive (AAAA-MM-DD)."},{"name":"includeArchived","in":"query","required":false,"schema":{"type":"boolean"},"description":"true para incluir las archivadas, que por defecto no salen."},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["issueDate","receivedDate","accountingDate","supplierInvoiceNumber","total","createdAt"]},"description":"Orden. Por defecto createdAt."},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]},"description":"Sentido del orden."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Elementos por página, de 1 al máximo del listado. Se fija en la primera página: con cursor, el mismo o ninguno."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de `page.nextCursor` para pedir la página siguiente, con los mismos filtros y la misma clave. Caduca en 24 horas."}],"responses":{"200":{"description":"Una página del listado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FacturacionFacturasRecibidasListarRow"}},"page":{"$ref":"#/components/schemas/Page"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"facturacion_facturas_recibidas_listar","version":1,"rateClass":"list","requiredPermissions":["facturacion.purchase_invoices.view"],"anyOfPermissions":[]}}},"/v1/purchase-invoices/{purchaseInvoiceId}":{"get":{"operationId":"facturacion_factura_recibida_ver","tags":["Facturas recibidas"],"summary":"La factura recibida","description":"Devuelve la cabecera de UNA factura recibida: número y serie del proveedor, tipo, estado, fechas, proveedor, moneda, totales, pagado, cotejo y estado SII. No devuelve las líneas, el desglose de impuestos, los vencimientos ni el NIF o la dirección del proveedor.\n\nPermiso: `facturacion.purchase_invoices.view`. Cuota: `read`.","parameters":[{"name":"purchaseInvoiceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id de la factura recibida (campo id del listado de facturas recibidas)."}],"responses":{"200":{"description":"El recurso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/FacturacionFacturaRecibidaVer"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"facturacion_factura_recibida_ver","version":1,"rateClass":"read","requiredPermissions":["facturacion.purchase_invoices.view"],"anyOfPermissions":[]}}},"/v1/suppliers":{"get":{"operationId":"facturacion_proveedores_listar","tags":["Proveedores"],"summary":"Proveedores","description":"Lista los proveedores de la empresa con los filtros de la pantalla «Proveedores»: texto, archivados, rol comercial, población, régimen fiscal y país del NIF. Por proveedor: id, nombre, razón social, país del NIF, rol, régimen fiscal, estado VIES, población, forma y plazo de pago por defecto y fechas. Sin NIF, email, teléfono ni IBAN.\n\nPermiso: `facturacion.proveedores.read`. Cuota: `list`. Página máxima: 100.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":255},"description":"Texto libre: nombre, razón social, NIF o contacto principal, sin acentos."},{"name":"includeArchived","in":"query","required":false,"schema":{"type":"boolean"},"description":"true para incluir los archivados, que por defecto no salen."},{"name":"commercialRole","in":"query","required":false,"schema":{"type":"string","enum":["customer","supplier","both"]},"description":"Rol efectivo: both = cliente y proveedor; customer o supplier = solo ese."},{"name":"city","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120},"description":"Población, contiene."},{"name":"taxRegime","in":"query","required":false,"schema":{"type":"string","enum":["general","equivalence_surcharge","simplified","agricultural","recc","rebu","not_applicable"]},"description":"Régimen fiscal."},{"name":"taxIdCountry","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$"},"description":"País del NIF (ISO 3166-1 alfa-2)."},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["name","legalName","createdAt"]},"description":"Orden. Por defecto name."},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]},"description":"Sentido del orden."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Elementos por página, de 1 al máximo del listado. Se fija en la primera página: con cursor, el mismo o ninguno."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de `page.nextCursor` para pedir la página siguiente, con los mismos filtros y la misma clave. Caduca en 24 horas."}],"responses":{"200":{"description":"Una página del listado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FacturacionProveedoresListarRow"}},"page":{"$ref":"#/components/schemas/Page"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"facturacion_proveedores_listar","version":1,"rateClass":"list","requiredPermissions":["facturacion.proveedores.read"],"anyOfPermissions":[]}}},"/v1/suppliers/{supplierId}":{"get":{"operationId":"facturacion_proveedor_ver","tags":["Proveedores"],"summary":"El proveedor","description":"Devuelve la ficha de UN proveedor: nombre, razón social, país del NIF, rol, régimen fiscal, estado VIES, población y valores por defecto de facturación (forma y plazo de pago, moneda, impuesto, tarifa, idioma). No devuelve el NIF, el email, el teléfono, las direcciones ni las cuentas bancarias.\n\nPermiso: `facturacion.proveedores.read`. Cuota: `read`.","parameters":[{"name":"supplierId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id del proveedor (campo entityId del listado)."}],"responses":{"200":{"description":"El recurso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/FacturacionProveedorVer"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"facturacion_proveedor_ver","version":1,"rateClass":"read","requiredPermissions":["facturacion.proveedores.read"],"anyOfPermissions":[]}}},"/v1/treasury/bank-position":{"get":{"operationId":"tesoreria_posicion_bancaria","tags":["Tesorería"],"summary":"El saldo de los bancos","description":"Devuelve la posición de Tesorería: una fila por banco propio con su saldo (el contable y, si el banco no lo da, el disponible; balanceKind dice cuál) y su saldo disponible, la fecha y el origen del saldo (banco conectado o último extracto importado), los movimientos pendientes de conciliar y el estado de la conexión bancaria. Úsala para preguntas del tipo «¿cuánto tengo en bancos?», «¿cuánto hay en BBVA?», «¿qué cuentas tengo conectadas?» o «¿cuándo caduca la conexión?». Para el total, suma balanceBooked con estadisticas_calcular y agrupa por currencyCode: no mezcles monedas. Si balanceKind es «available», ese saldo es el disponible del banco y no el contable (hay bancos que no dan el contable): dilo así al responder. Un balanceBooked vacío significa que NO se conoce el saldo de esa cuenta (no hay extracto ni lectura del banco): no es cero, no lo sumes ni lo cuentes como cero, y dilo. Los saldos son los del último dato: mira siempre balanceReferenceDate antes de decir «hoy». No devuelve movimientos (para eso, tesoreria_movimientos_por_conciliar), no concilia ni conecta bancos, y no incluye el IBAN.\n\nPermiso: uno de `facturacion.treasury.bank_connections.view`, `facturacion.treasury.bank_statements.view`. Cuota: `read`.","parameters":[{"name":"companyId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Id de una empresa emisora. Sin él salen los bancos de todas."}],"responses":{"200":{"description":"Una página del listado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TesoreriaPosicionBancariaRow"}},"page":{"$ref":"#/components/schemas/SinglePage"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"tesoreria_posicion_bancaria","version":1,"rateClass":"read","requiredPermissions":[],"anyOfPermissions":["facturacion.treasury.bank_connections.view","facturacion.treasury.bank_statements.view"]}}},"/v1/treasury/cash-forecast":{"get":{"operationId":"tesoreria_prevision","tags":["Tesorería"],"summary":"La previsión de tesorería","description":"Devuelve la previsión de tesorería a 30, 60 o 90 días: el saldo de hoy de los bancos, los cobros y pagos previstos según los vencimientos de las facturas pendientes, el saldo previsto al final del horizonte y el punto más bajo (el día y el saldo en que menos dinero habrá). Una sola fila. Úsala para preguntas del tipo «¿me va a faltar dinero este mes?», «¿cuál es mi saldo previsto a 60 días?» o «¿cuándo estaré más justo de caja?». Si lowestPointBalance es negativo, falta dinero ese día: dilo con la fecha. Elige el horizonte que pide el usuario (30 por defecto). Parte del saldo conocido de los bancos: si accountsWithoutBalance es mayor que cero, esas cuentas no están incluidas y la previsión es incompleta; avísalo en la respuesta. Lo vencido sin cobrar ni pagar sale aparte (overdueCollections y overduePayments) salvo que se pida includeOverdue. Es una proyección con los vencimientos tal como están, no una garantía de cobro. Va en una sola moneda y no la convierte. No devuelve el desglose por días ni por factura: para eso, la pantalla Panel financiero de Finanzas. Mínimo de seguridad: con companyId devuelve minimumBalance (vacío si la empresa no lo tiene), minimumBreachDate y minimumBreachBalance (el primer día en que el saldo previsto baja del mínimo y el saldo de ese día) y, hasta tres, los pagos más grandes hasta ese día (paymentBeforeBreach1…3: tipo, concepto o número, proveedor, fecha e importe). Para explicar «¿por qué me avisa del mínimo?» pide horizonDays 90 sin includeOverdue, que es como se calcula el aviso, y nombra la fecha y los pagos que coinciden. Si minimumBreachDate está vacío, la previsión no baja del mínimo en el horizonte.\n\nPermiso: `facturacion.treasury.forecast.view`. Cuota: `read`.","parameters":[{"name":"horizonDays","in":"query","required":false,"schema":{"enum":[30,60,90],"type":"integer"},"description":"Días a mirar hacia delante: 30, 60 o 90. Por defecto 30."},{"name":"currency","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{3}$"},"description":"Moneda de la previsión, de tres letras. Por defecto EUR. No se convierten monedas."},{"name":"includeOverdue","in":"query","required":false,"schema":{"type":"boolean"},"description":"true para sumar a la previsión lo vencido sin cobrar ni pagar. Por defecto no se suma y sale aparte."},{"name":"companyId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Id de la empresa emisora. Con él la previsión es solo de esa empresa y trae su mínimo de seguridad, el día en que el saldo previsto baja de él y los pagos más grandes hasta ese día. Sin él, todas las empresas y sin mínimo."}],"responses":{"200":{"description":"Una página del listado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TesoreriaPrevisionRow"}},"page":{"$ref":"#/components/schemas/SinglePage"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"tesoreria_prevision","version":1,"rateClass":"read","requiredPermissions":["facturacion.treasury.forecast.view"],"anyOfPermissions":[]}}},"/v1/treasury/unreconciled-bank-lines":{"get":{"operationId":"tesoreria_movimientos_por_conciliar","tags":["Tesorería"],"summary":"Movimientos bancarios sin conciliar","description":"Lista los movimientos bancarios que todavía no están conciliados con una factura, un cobro o un pago, como la cola de la pantalla de Conciliación de Tesorería: por movimiento, la fecha, el importe con signo (negativo es un cargo o salida, positivo un ingreso), la moneda, la contraparte y el origen (banco conectado o fichero importado). Úsala para preguntas del tipo «¿qué movimientos me faltan por conciliar?», «¿cuántos cargos sin conciliar hay?» o «¿qué ingresos sin conciliar tiene BBVA?». Filtra por banco propio (bankAccountId) y por fechas. Devuelve un conjunto de datos (hasta 1.000 filas, las más recientes primero): para contar, sumar, agrupar o filtrar por importe (por ejemplo los cargos de más de 1.000 €, que son los de amount menor o igual a -1000) llama después a estadisticas_calcular con el datasetId; no calcules tú. Solo salen los que están sin conciliar, no los conciliados en parte ni los ignorados. No concilia, no clasifica ni registra cobros o pagos: si el usuario quiere hacerlo, indícale la pantalla de Conciliación.\n\nPermiso: `facturacion.treasury.bank_statements.view`. Cuota: `list`. Página máxima: 100.","parameters":[{"name":"bankAccountId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Id de un banco propio (campo bankAccountId de tesoreria_posicion_bancaria)."},{"name":"dateFrom","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Movimientos desde esta fecha, inclusive (AAAA-MM-DD)."},{"name":"dateTo","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Movimientos hasta esta fecha, inclusive (AAAA-MM-DD)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Elementos por página, de 1 al máximo del listado. Se fija en la primera página: con cursor, el mismo o ninguno."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor opaco de `page.nextCursor` para pedir la página siguiente, con los mismos filtros y la misma clave. Caduca en 24 horas."}],"responses":{"200":{"description":"Una página del listado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TesoreriaMovimientosPorConciliarRow"}},"page":{"$ref":"#/components/schemas/Page"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-holaerp-capability":{"name":"tesoreria_movimientos_por_conciliar","version":1,"rateClass":"list","requiredPermissions":["facturacion.treasury.bank_statements.view"],"anyOfPermissions":[]}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"hoe_<live|test>_<keyId>_<secreto>","description":"Clave de API de una cuenta de integración: `Authorization: Bearer hoe_live_…` (o `hoe_test_…` en tenants de demo)."}},"headers":{"RequestId":{"description":"Id de la petición. Cítalo al pedir soporte.","schema":{"type":"string"}},"RateLimitLimit":{"description":"Llamadas permitidas en la ventana de un minuto.","schema":{"type":"integer"}},"RateLimitRemaining":{"description":"Llamadas que quedan en la ventana.","schema":{"type":"integer"}},"RateLimitReset":{"description":"Segundos hasta que se renueva la ventana.","schema":{"type":"integer"}},"RetryAfter":{"description":"Segundos que hay que esperar antes de reintentar.","schema":{"type":"integer"}},"Deprecation":{"description":"La operación está anunciada para retirarse: `@<segundos desde 1970>`.","schema":{"type":"string"}},"Sunset":{"description":"Fecha HTTP a partir de la cual deja de responder (al menos 6 meses después del aviso).","schema":{"type":"string"}}},"responses":{"BadRequest":{"description":"Entrada no válida. Códigos: `VALIDATION_FAILED`, `PUBLIC_API_INVALID_LIMIT`, `PUBLIC_API_INVALID_CURSOR`.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Sin clave, o clave inválida, revocada o caducada. Códigos: `UNAUTHORIZED`, `EXTERNAL_ACCESS_CREDENTIAL_INVALID`, `EXTERNAL_ACCESS_CREDENTIAL_EXPIRED`.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"La clave no puede hacer esto. Códigos: `PERMISSION_DENIED`, `MODULE_NOT_CONTRACTED`, `EXTERNAL_ACCESS_CHANNEL_DISABLED`, `EXTERNAL_ACCESS_NOT_ENABLED`, `EXTERNAL_ACCESS_IP_NOT_ALLOWED`, `EXTERNAL_ACCESS_NOT_ALLOWED`.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"El recurso no existe en tu empresa, o la ruta no existe. Códigos: `NOT_FOUND`, `PUBLIC_API_ROUTE_NOT_FOUND`.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"TooManyRequests":{"description":"Cuota agotada. Códigos: `RATE_LIMITED`.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServiceUnavailable":{"description":"Servicio no disponible: reintenta más tarde. Códigos: `SERVICE_UNAVAILABLE`.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Page":{"type":"object","required":["nextCursor"],"properties":{"nextCursor":{"type":["string","null"],"description":"Cursor de la página siguiente, o `null` en la última."}}},"SinglePage":{"type":"object","required":["nextCursor"],"description":"Respuesta de una sola página: `nextCursor` siempre es `null`.","properties":{"nextCursor":{"type":"null"}}},"ValidationIssue":{"type":"object","required":["path","code","message"],"properties":{"path":{"type":"string","description":"Parámetro que no es válido."},"code":{"type":"string","description":"Código estable del problema."},"message":{"type":"string","description":"Mensaje en español."},"params":{"type":"object","additionalProperties":true}}},"Error":{"type":"object","required":["error"],"properties":{"statusCode":{"type":"integer","description":"Estado HTTP (heredado; usar el de la respuesta)."},"message":{"type":"string","description":"Heredado; usar `error.message`."},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Código estable: es lo que hay que comparar."},"message":{"type":"string","description":"Mensaje en español, para personas."},"messageKey":{"type":"string"},"params":{"type":"object","additionalProperties":true},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ValidationIssue"}},"details":{"type":"object","additionalProperties":true,"properties":{"requestId":{"type":"string","description":"El de `X-Request-Id`: cítalo al pedir soporte."},"path":{"type":"string"},"statusCode":{"type":"integer"}}}}}}},"FacturacionClientesListarRow":{"type":"object","required":["entityId","name","legalName","taxIdCountry","commercialRole","isCustomer","isSupplier","taxRegime","viesStatus","city","defaultPaymentMethodId","defaultPaymentTermsId","archivedAt","createdAt","updatedAt"],"properties":{"entityId":{"type":["string","null"],"description":"Id. Identificador."},"name":{"type":["string","null"],"description":"Nombre"},"legalName":{"type":["string","null"],"description":"Razón social"},"taxIdCountry":{"type":["string","null"],"description":"País del NIF"},"commercialRole":{"type":["string","null"],"description":"Rol comercial"},"isCustomer":{"type":["string","null"],"description":"Es cliente"},"isSupplier":{"type":["string","null"],"description":"Es proveedor"},"taxRegime":{"type":["string","null"],"description":"Régimen fiscal"},"viesStatus":{"type":["string","null"],"description":"Estado VIES"},"city":{"type":["string","null"],"description":"Población"},"defaultPaymentMethodId":{"type":["string","null"],"description":"Id de la forma de pago. Identificador."},"defaultPaymentTermsId":{"type":["string","null"],"description":"Id del plazo de pago. Identificador."},"archivedAt":{"type":["string","null"],"format":"date-time","description":"Archivado el. Fecha y hora ISO 8601."},"createdAt":{"type":["string","null"],"format":"date-time","description":"Alta. Fecha y hora ISO 8601."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"Modificado el. Fecha y hora ISO 8601."}},"title":"FacturacionClientesListarRow"},"FacturacionClienteVer":{"type":"object","required":["entityId","name","legalName","taxIdCountry","commercialRole","isCustomer","isSupplier","taxRegime","viesStatus","city","defaultPaymentMethodId","defaultPaymentTermsId","archivedAt","createdAt","updatedAt","defaultCurrencyCode","defaultDueDays","defaultTaxCodeId","defaultPriceListId","documentLanguage","creditLimit","isExportDefault","isIntracomDefault","internalReference"],"properties":{"entityId":{"type":["string","null"],"description":"Id. Identificador."},"name":{"type":["string","null"],"description":"Nombre"},"legalName":{"type":["string","null"],"description":"Razón social"},"taxIdCountry":{"type":["string","null"],"description":"País del NIF"},"commercialRole":{"type":["string","null"],"description":"Rol comercial"},"isCustomer":{"type":["string","null"],"description":"Es cliente"},"isSupplier":{"type":["string","null"],"description":"Es proveedor"},"taxRegime":{"type":["string","null"],"description":"Régimen fiscal"},"viesStatus":{"type":["string","null"],"description":"Estado VIES"},"city":{"type":["string","null"],"description":"Población"},"defaultPaymentMethodId":{"type":["string","null"],"description":"Id de la forma de pago. Identificador."},"defaultPaymentTermsId":{"type":["string","null"],"description":"Id del plazo de pago. Identificador."},"archivedAt":{"type":["string","null"],"format":"date-time","description":"Archivado el. Fecha y hora ISO 8601."},"createdAt":{"type":["string","null"],"format":"date-time","description":"Alta. Fecha y hora ISO 8601."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"Modificado el. Fecha y hora ISO 8601."},"defaultCurrencyCode":{"type":["string","null"],"description":"Moneda"},"defaultDueDays":{"type":["integer","null"],"description":"Días de vencimiento"},"defaultTaxCodeId":{"type":["string","null"],"description":"Id del impuesto. Identificador."},"defaultPriceListId":{"type":["string","null"],"description":"Id de la tarifa. Identificador."},"documentLanguage":{"type":["string","null"],"description":"Idioma de los documentos"},"creditLimit":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Límite de crédito. Cadena decimal con 2 decimales."},"isExportDefault":{"type":["string","null"],"description":"Exportación"},"isIntracomDefault":{"type":["string","null"],"description":"Intracomunitario"},"internalReference":{"type":["string","null"],"description":"Referencia interna"}},"title":"FacturacionClienteVer"},"FacturacionFacturasEmitidasListarRow":{"type":"object","required":["id","invoiceNumber","invoiceKind","status","issueDate","dueDate","customerEntityId","customerDisplayName","currencyCode","total","amountPaid","verifactuStatus","siiStatus","faceStatus"],"properties":{"id":{"type":["string","null"],"description":"Id de la factura. Identificador."},"invoiceNumber":{"type":["string","null"],"description":"Número"},"invoiceKind":{"type":["string","null"],"description":"Tipo de factura. Valores conocidos: `normal` (Normal), `rectifying` (Rectificativa), `simplified` (Simplificada). Puede llegar otro código."},"status":{"type":["string","null"],"description":"Estado. Valores conocidos: `draft` (Borrador), `issued` (Emitida), `partially_paid` (Cobro parcial), `paid` (Cobrada), `overdue` (Vencida), `rectified` (Rectificada). Puede llegar otro código."},"issueDate":{"type":["string","null"],"description":"Fecha de emisión. Fecha ISO 8601."},"dueDate":{"type":["string","null"],"description":"Fecha de vencimiento. Fecha ISO 8601."},"customerEntityId":{"type":["string","null"],"description":"Id del cliente. Identificador."},"customerDisplayName":{"type":["string","null"],"description":"Cliente"},"currencyCode":{"type":["string","null"],"description":"Moneda"},"total":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Total. Cadena decimal con 2 decimales."},"amountPaid":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Cobrado. Cadena decimal con 2 decimales."},"verifactuStatus":{"type":["string","null"],"description":"Estado Veri*Factu. Valores conocidos: `not_applicable` (No aplica), `pending` (Pendiente), `accepted` (Aceptada), `accepted_with_warnings` (Aceptada con avisos), `rejected` (Rechazada), `recorded` (Registrada sin envío). Puede llegar otro código."},"siiStatus":{"type":["string","null"],"description":"Estado SII. Valores conocidos: `not_applicable` (No aplica), `pending` (Pendiente), `accepted` (Aceptada), `accepted_with_errors` (Aceptada con errores), `rejected` (Rechazada). Puede llegar otro código."},"faceStatus":{"type":["string","null"],"description":"Estado FACe. Valores conocidos: `not_applicable` (No aplica), `pending` (Pendiente de presentar), `presented` (Presentada en FACe), `accepted` (Obligación reconocida), `paid` (Pagada), `rejected` (Rechazada por la Administración), `cancelled` (Anulada), `error` (Error al presentar). Puede llegar otro código."}},"title":"FacturacionFacturasEmitidasListarRow"},"FacturacionFacturaEmitidaVer":{"type":"object","required":["header","hasIssuedRectification"],"properties":{"header":{"type":"object","required":["invoiceNumber","invoiceKind","status","issueDate","operationDate","dueDate","paidAt","customerEntityId","customer","currencyCode","totals","verifactu","sii","face","rectification"],"properties":{"invoiceNumber":{"type":["string","null"],"description":"Número"},"invoiceKind":{"type":["string","null"],"description":"Tipo de factura. Valores conocidos: `normal` (Normal), `rectifying` (Rectificativa), `simplified` (Simplificada). Puede llegar otro código."},"status":{"type":["string","null"],"description":"Estado. Valores conocidos: `draft` (Borrador), `issued` (Emitida), `partially_paid` (Cobro parcial), `paid` (Cobrada), `overdue` (Vencida), `rectified` (Rectificada). Puede llegar otro código."},"issueDate":{"type":["string","null"],"description":"Fecha de emisión. Fecha ISO 8601."},"operationDate":{"type":["string","null"],"description":"Fecha de la operación. Fecha ISO 8601."},"dueDate":{"type":["string","null"],"description":"Primer vencimiento. Fecha ISO 8601."},"paidAt":{"type":["string","null"],"format":"date-time","description":"Cobrada el. Fecha y hora ISO 8601."},"customerEntityId":{"type":["string","null"],"description":"Id del cliente. Identificador."},"customer":{"type":"object","required":["legalName","countryCode"],"properties":{"legalName":{"type":["string","null"],"description":"Cliente"},"countryCode":{"type":["string","null"],"description":"País del cliente"}}},"currencyCode":{"type":["string","null"],"description":"Moneda"},"totals":{"type":"object","required":["subtotal","totalDiscount","taxableBase","totalTax","totalRetention","totalEquivalenceSurcharge","roundingAdjustment","total","amountPaid"],"properties":{"subtotal":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Subtotal. Cadena decimal con 2 decimales."},"totalDiscount":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Descuentos. Cadena decimal con 2 decimales."},"taxableBase":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Base imponible. Cadena decimal con 2 decimales."},"totalTax":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Impuestos. Cadena decimal con 2 decimales."},"totalRetention":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Retenciones. Cadena decimal con 2 decimales."},"totalEquivalenceSurcharge":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Recargo de equivalencia. Cadena decimal con 2 decimales."},"roundingAdjustment":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Ajuste de redondeo. Cadena decimal con 2 decimales."},"total":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Total. Cadena decimal con 2 decimales."},"amountPaid":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Cobrado. Cadena decimal con 2 decimales."}}},"verifactu":{"type":"object","required":["status"],"properties":{"status":{"type":["string","null"],"description":"Estado Veri*Factu. Valores conocidos: `not_applicable` (No aplica), `pending` (Pendiente), `accepted` (Aceptada), `accepted_with_warnings` (Aceptada con avisos), `rejected` (Rechazada), `recorded` (Registrada sin envío). Puede llegar otro código."}}},"sii":{"type":"object","required":["status"],"properties":{"status":{"type":["string","null"],"description":"Estado SII. Valores conocidos: `not_applicable` (No aplica), `pending` (Pendiente), `accepted` (Aceptada), `accepted_with_errors` (Aceptada con errores), `rejected` (Rechazada). Puede llegar otro código."}}},"face":{"type":"object","required":["status"],"properties":{"status":{"type":["string","null"],"description":"Estado FACe. Valores conocidos: `not_applicable` (No aplica), `pending` (Pendiente de presentar), `presented` (Presentada en FACe), `accepted` (Obligación reconocida), `paid` (Pagada), `rejected` (Rechazada por la Administración), `cancelled` (Anulada), `error` (Error al presentar). Puede llegar otro código."}}},"rectification":{"type":"object","required":["rectificationType","parentInvoiceId"],"properties":{"rectificationType":{"type":["string","null"],"description":"Tipo de rectificación. Valores conocidos: `substitution` (Por sustitución), `by_difference` (Por diferencias). Puede llegar otro código."},"parentInvoiceId":{"type":["string","null"],"description":"Id de la factura que rectifica. Identificador."}}}}},"hasIssuedRectification":{"type":["string","null"],"description":"Tiene una rectificativa emitida"}},"title":"FacturacionFacturaEmitidaVer"},"FacturacionArticulosListarRow":{"type":"object","required":["id","code","name","kind","hasVariants","variantCount","variantLabel","bundleExpansionMode","categoryName","unitCode","basePrice","isSellable","isStocked","isActive"],"properties":{"id":{"type":["string","null"],"description":"Id del artículo. Identificador."},"code":{"type":["string","null"],"description":"Referencia"},"name":{"type":["string","null"],"description":"Nombre"},"kind":{"type":["string","null"],"description":"Tipo. Valores conocidos: `product` (Producto), `service` (Servicio), `digital` (Digital), `expense` (Gastos). Puede llegar otro código."},"hasVariants":{"type":["string","null"],"description":"Con variantes"},"variantCount":{"type":["integer","null"],"description":"Variantes"},"variantLabel":{"type":["string","null"],"description":"Variante"},"bundleExpansionMode":{"type":["string","null"],"description":"Pack. Valores conocidos: `lines` (Pack de artículos sueltos), `none` (Pack empaquetado). Puede llegar otro código."},"categoryName":{"type":["string","null"],"description":"Familia"},"unitCode":{"type":["string","null"],"description":"Unidad"},"basePrice":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Precio de venta. Cadena decimal con 6 decimales."},"isSellable":{"type":["string","null"],"description":"Se vende"},"isStocked":{"type":["string","null"],"description":"Lleva existencias"},"isActive":{"type":["string","null"],"description":"Activo"}},"title":"FacturacionArticulosListarRow"},"FacturacionArticuloVer":{"type":"object","required":["id","code","name","description","kind","hasVariants","parentArticleId","variantLabel","variantCount","bundleExpansionMode","componentCount","unitCode","unitName","basePrice","priceStrategy","defaultTaxCode","categoryId","categoryName","barcode","isSellable","isStocked","isActive","archivedAt","createdAt","updatedAt"],"properties":{"id":{"type":["string","null"],"description":"Id del artículo. Identificador."},"code":{"type":["string","null"],"description":"Referencia"},"name":{"type":["string","null"],"description":"Nombre"},"description":{"type":["string","null"],"description":"Descripción"},"kind":{"type":["string","null"],"description":"Tipo"},"hasVariants":{"type":["string","null"],"description":"Con variantes"},"parentArticleId":{"type":["string","null"],"description":"Id de la cabecera. Identificador."},"variantLabel":{"type":["string","null"],"description":"Variante"},"variantCount":{"type":["integer","null"],"description":"Variantes"},"bundleExpansionMode":{"type":["string","null"],"description":"Pack"},"componentCount":{"type":["integer","null"],"description":"Componentes"},"unitCode":{"type":["string","null"],"description":"Unidad"},"unitName":{"type":["string","null"],"description":"Nombre de la unidad"},"basePrice":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Precio de venta. Cadena decimal con 6 decimales."},"priceStrategy":{"type":["string","null"],"description":"Estrategia de precio"},"defaultTaxCode":{"type":"object","required":["code","name","rate"],"properties":{"code":{"type":["string","null"],"description":"Impuesto"},"name":{"type":["string","null"],"description":"Nombre del impuesto"},"rate":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Tipo del impuesto. Cadena decimal."}}},"categoryId":{"type":["string","null"],"description":"Id de la familia. Identificador."},"categoryName":{"type":["string","null"],"description":"Familia"},"barcode":{"type":["string","null"],"description":"Código de barras"},"isSellable":{"type":["string","null"],"description":"Se vende"},"isStocked":{"type":["string","null"],"description":"Lleva existencias"},"isActive":{"type":["string","null"],"description":"Activo"},"archivedAt":{"type":["string","null"],"format":"date-time","description":"Archivado el. Fecha y hora ISO 8601."},"createdAt":{"type":["string","null"],"format":"date-time","description":"Alta. Fecha y hora ISO 8601."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"Modificado el. Fecha y hora ISO 8601."}},"title":"FacturacionArticuloVer"},"FacturacionFacturasRecibidasListarRow":{"type":"object","required":["id","supplierInvoiceNumber","supplierSeries","internalReference","invoiceKind","status","issueDate","operationDate","receivedDate","accountingDate","dueDate","supplierEntityId","supplierCountryCode","currencyCode","amountPaid","paidAt","matchingStatus","sii","parentPurchaseInvoiceId","archivedAt","createdAt","updatedAt","supplierName","totals"],"properties":{"id":{"type":["string","null"],"description":"Id de la factura. Identificador."},"supplierInvoiceNumber":{"type":["string","null"],"description":"Número del proveedor"},"supplierSeries":{"type":["string","null"],"description":"Serie del proveedor"},"internalReference":{"type":["string","null"],"description":"Referencia interna"},"invoiceKind":{"type":["string","null"],"description":"Tipo de factura"},"status":{"type":["string","null"],"description":"Estado"},"issueDate":{"type":["string","null"],"description":"Fecha de la factura. Fecha ISO 8601."},"operationDate":{"type":["string","null"],"description":"Fecha de la operación. Fecha ISO 8601."},"receivedDate":{"type":["string","null"],"description":"Fecha de recepción. Fecha ISO 8601."},"accountingDate":{"type":["string","null"],"description":"Fecha contable. Fecha ISO 8601."},"dueDate":{"type":["string","null"],"description":"Primer vencimiento. Fecha ISO 8601."},"supplierEntityId":{"type":["string","null"],"description":"Id del proveedor. Identificador."},"supplierCountryCode":{"type":["string","null"],"description":"País del proveedor"},"currencyCode":{"type":["string","null"],"description":"Moneda"},"amountPaid":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Pagado. Cadena decimal con 2 decimales."},"paidAt":{"type":["string","null"],"format":"date-time","description":"Pagada el. Fecha y hora ISO 8601."},"matchingStatus":{"type":["string","null"],"description":"Cotejo"},"sii":{"type":"object","required":["status"],"properties":{"status":{"type":["string","null"],"description":"Estado SII"}}},"parentPurchaseInvoiceId":{"type":["string","null"],"description":"Id de la factura que rectifica. Identificador."},"archivedAt":{"type":["string","null"],"format":"date-time","description":"Archivada el. Fecha y hora ISO 8601."},"createdAt":{"type":["string","null"],"format":"date-time","description":"Creada el. Fecha y hora ISO 8601."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"Modificada el. Fecha y hora ISO 8601."},"supplierName":{"type":["string","null"],"description":"Proveedor"},"totals":{"type":"object","required":["subtotal","totalDiscount","taxableBase","totalTax","totalRetention","totalEquivalenceSurcharge","total"],"properties":{"subtotal":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Subtotal. Cadena decimal con 2 decimales."},"totalDiscount":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Descuentos. Cadena decimal con 2 decimales."},"taxableBase":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Base imponible. Cadena decimal con 2 decimales."},"totalTax":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Impuestos. Cadena decimal con 2 decimales."},"totalRetention":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Retenciones. Cadena decimal con 2 decimales."},"totalEquivalenceSurcharge":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Recargo de equivalencia. Cadena decimal con 2 decimales."},"total":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Total. Cadena decimal con 2 decimales."}}}},"title":"FacturacionFacturasRecibidasListarRow"},"FacturacionFacturaRecibidaVer":{"type":"object","required":["header","totals"],"properties":{"header":{"type":"object","required":["id","supplierInvoiceNumber","supplierSeries","internalReference","invoiceKind","status","issueDate","operationDate","receivedDate","accountingDate","dueDate","supplierEntityId","supplierCountryCode","currencyCode","amountPaid","paidAt","matchingStatus","sii","parentPurchaseInvoiceId","archivedAt","createdAt","updatedAt","supplierLegalName"],"properties":{"id":{"type":["string","null"],"description":"Id de la factura. Identificador."},"supplierInvoiceNumber":{"type":["string","null"],"description":"Número del proveedor"},"supplierSeries":{"type":["string","null"],"description":"Serie del proveedor"},"internalReference":{"type":["string","null"],"description":"Referencia interna"},"invoiceKind":{"type":["string","null"],"description":"Tipo de factura"},"status":{"type":["string","null"],"description":"Estado"},"issueDate":{"type":["string","null"],"description":"Fecha de la factura. Fecha ISO 8601."},"operationDate":{"type":["string","null"],"description":"Fecha de la operación. Fecha ISO 8601."},"receivedDate":{"type":["string","null"],"description":"Fecha de recepción. Fecha ISO 8601."},"accountingDate":{"type":["string","null"],"description":"Fecha contable. Fecha ISO 8601."},"dueDate":{"type":["string","null"],"description":"Primer vencimiento. Fecha ISO 8601."},"supplierEntityId":{"type":["string","null"],"description":"Id del proveedor. Identificador."},"supplierCountryCode":{"type":["string","null"],"description":"País del proveedor"},"currencyCode":{"type":["string","null"],"description":"Moneda"},"amountPaid":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Pagado. Cadena decimal con 2 decimales."},"paidAt":{"type":["string","null"],"format":"date-time","description":"Pagada el. Fecha y hora ISO 8601."},"matchingStatus":{"type":["string","null"],"description":"Cotejo"},"sii":{"type":"object","required":["status"],"properties":{"status":{"type":["string","null"],"description":"Estado SII"}}},"parentPurchaseInvoiceId":{"type":["string","null"],"description":"Id de la factura que rectifica. Identificador."},"archivedAt":{"type":["string","null"],"format":"date-time","description":"Archivada el. Fecha y hora ISO 8601."},"createdAt":{"type":["string","null"],"format":"date-time","description":"Creada el. Fecha y hora ISO 8601."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"Modificada el. Fecha y hora ISO 8601."},"supplierLegalName":{"type":["string","null"],"description":"Proveedor (razón social)"}}},"totals":{"type":"object","required":["subtotal","totalDiscount","taxableBase","totalTax","totalRetention","totalEquivalenceSurcharge","total"],"properties":{"subtotal":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Subtotal. Cadena decimal con 2 decimales."},"totalDiscount":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Descuentos. Cadena decimal con 2 decimales."},"taxableBase":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Base imponible. Cadena decimal con 2 decimales."},"totalTax":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Impuestos. Cadena decimal con 2 decimales."},"totalRetention":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Retenciones. Cadena decimal con 2 decimales."},"totalEquivalenceSurcharge":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Recargo de equivalencia. Cadena decimal con 2 decimales."},"total":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Total. Cadena decimal con 2 decimales."}}}},"title":"FacturacionFacturaRecibidaVer"},"FacturacionProveedoresListarRow":{"type":"object","required":["entityId","name","legalName","taxIdCountry","commercialRole","isCustomer","isSupplier","taxRegime","viesStatus","city","defaultPaymentMethodId","defaultPaymentTermsId","archivedAt","createdAt","updatedAt"],"properties":{"entityId":{"type":["string","null"],"description":"Id. Identificador."},"name":{"type":["string","null"],"description":"Nombre"},"legalName":{"type":["string","null"],"description":"Razón social"},"taxIdCountry":{"type":["string","null"],"description":"País del NIF"},"commercialRole":{"type":["string","null"],"description":"Rol comercial"},"isCustomer":{"type":["string","null"],"description":"Es cliente"},"isSupplier":{"type":["string","null"],"description":"Es proveedor"},"taxRegime":{"type":["string","null"],"description":"Régimen fiscal"},"viesStatus":{"type":["string","null"],"description":"Estado VIES"},"city":{"type":["string","null"],"description":"Población"},"defaultPaymentMethodId":{"type":["string","null"],"description":"Id de la forma de pago. Identificador."},"defaultPaymentTermsId":{"type":["string","null"],"description":"Id del plazo de pago. Identificador."},"archivedAt":{"type":["string","null"],"format":"date-time","description":"Archivado el. Fecha y hora ISO 8601."},"createdAt":{"type":["string","null"],"format":"date-time","description":"Alta. Fecha y hora ISO 8601."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"Modificado el. Fecha y hora ISO 8601."}},"title":"FacturacionProveedoresListarRow"},"FacturacionProveedorVer":{"type":"object","required":["entityId","name","legalName","taxIdCountry","commercialRole","isCustomer","isSupplier","taxRegime","viesStatus","city","defaultPaymentMethodId","defaultPaymentTermsId","archivedAt","createdAt","updatedAt","defaultCurrencyCode","defaultDueDays","defaultTaxCodeId","defaultPriceListId","documentLanguage","creditLimit","isExportDefault","isIntracomDefault","internalReference"],"properties":{"entityId":{"type":["string","null"],"description":"Id. Identificador."},"name":{"type":["string","null"],"description":"Nombre"},"legalName":{"type":["string","null"],"description":"Razón social"},"taxIdCountry":{"type":["string","null"],"description":"País del NIF"},"commercialRole":{"type":["string","null"],"description":"Rol comercial"},"isCustomer":{"type":["string","null"],"description":"Es cliente"},"isSupplier":{"type":["string","null"],"description":"Es proveedor"},"taxRegime":{"type":["string","null"],"description":"Régimen fiscal"},"viesStatus":{"type":["string","null"],"description":"Estado VIES"},"city":{"type":["string","null"],"description":"Población"},"defaultPaymentMethodId":{"type":["string","null"],"description":"Id de la forma de pago. Identificador."},"defaultPaymentTermsId":{"type":["string","null"],"description":"Id del plazo de pago. Identificador."},"archivedAt":{"type":["string","null"],"format":"date-time","description":"Archivado el. Fecha y hora ISO 8601."},"createdAt":{"type":["string","null"],"format":"date-time","description":"Alta. Fecha y hora ISO 8601."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"Modificado el. Fecha y hora ISO 8601."},"defaultCurrencyCode":{"type":["string","null"],"description":"Moneda"},"defaultDueDays":{"type":["integer","null"],"description":"Días de vencimiento"},"defaultTaxCodeId":{"type":["string","null"],"description":"Id del impuesto. Identificador."},"defaultPriceListId":{"type":["string","null"],"description":"Id de la tarifa. Identificador."},"documentLanguage":{"type":["string","null"],"description":"Idioma de los documentos"},"creditLimit":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Límite de crédito. Cadena decimal con 2 decimales."},"isExportDefault":{"type":["string","null"],"description":"Exportación"},"isIntracomDefault":{"type":["string","null"],"description":"Intracomunitario"},"internalReference":{"type":["string","null"],"description":"Referencia interna"}},"title":"FacturacionProveedorVer"},"TesoreriaPosicionBancariaRow":{"type":"object","required":["bankAccountId","alias","currencyCode","balanceBooked","balanceKind","balanceAvailable","balanceReferenceDate","balanceSource","unreconciledCount","unreconciledAmount","institutionName","connectionStatus","connectionHealth","lastSyncedDate","accessExpiresDate"],"properties":{"bankAccountId":{"type":["string","null"],"description":"Id del banco propio. Identificador."},"alias":{"type":["string","null"],"description":"Cuenta"},"currencyCode":{"type":["string","null"],"description":"Moneda"},"balanceBooked":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Saldo de la cuenta (contable o, si el banco no lo da, disponible). Cadena decimal con 2 decimales."},"balanceKind":{"type":["string","null"],"description":"Tipo de saldo. Valores conocidos: `booked` (Contable), `available` (Disponible (el banco no da el contable)). Puede llegar otro código."},"balanceAvailable":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Saldo disponible. Cadena decimal con 2 decimales."},"balanceReferenceDate":{"type":["string","null"],"description":"Fecha del saldo. Fecha ISO 8601."},"balanceSource":{"type":["string","null"],"description":"Origen del saldo. Valores conocidos: `api` (Banco conectado), `statement` (Extracto importado). Puede llegar otro código."},"unreconciledCount":{"type":["integer","null"],"description":"Movimientos sin conciliar"},"unreconciledAmount":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Importe sin conciliar. Cadena decimal con 2 decimales."},"institutionName":{"type":["string","null"],"description":"Banco conectado"},"connectionStatus":{"type":["string","null"],"description":"Estado de la conexión. Valores conocidos: `pending_authorization` (Pendiente de autorizar), `linked` (Conectada), `expired` (Caducada), `suspended` (Suspendida), `rejected` (Rechazada), `cancelled` (Cancelada), `revoked` (Revocada), `disconnected` (Desconectada), `suspended_unlicensed` (Suspendida por falta de licencia). Puede llegar otro código."},"connectionHealth":{"type":["string","null"],"description":"Estado de la sincronización. Valores conocidos: `ok` (Sincronizando con normalidad), `processing` (Sincronizando ahora), `rate_limited` (Límite del banco alcanzado), `failing` (Con errores), `suspended` (Suspendida), `revoked` (Revocada), `expired` (Caducada). Puede llegar otro código."},"lastSyncedDate":{"type":["string","null"],"description":"Última sincronización. Fecha ISO 8601."},"accessExpiresDate":{"type":["string","null"],"description":"La conexión caduca. Fecha ISO 8601."}},"title":"TesoreriaPosicionBancariaRow"},"TesoreriaPrevisionRow":{"type":"object","required":["currencyCode","horizonDays","startingBalance","accountsWithoutBalance","expectedCollections","expectedPayments","endingBalance","lowestPointDate","lowestPointBalance","overdueCollections","overduePayments","overdueIncluded","minimumBalance","minimumBreachDate","minimumBreachBalance","paymentBeforeBreach1Kind","paymentBeforeBreach1Concept","paymentBeforeBreach1ThirdParty","paymentBeforeBreach1Date","paymentBeforeBreach1Amount","paymentBeforeBreach2Kind","paymentBeforeBreach2Concept","paymentBeforeBreach2ThirdParty","paymentBeforeBreach2Date","paymentBeforeBreach2Amount","paymentBeforeBreach3Kind","paymentBeforeBreach3Concept","paymentBeforeBreach3ThirdParty","paymentBeforeBreach3Date","paymentBeforeBreach3Amount"],"properties":{"currencyCode":{"type":["string","null"],"description":"Moneda"},"horizonDays":{"type":["integer","null"],"description":"Horizonte (días)"},"startingBalance":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Saldo de hoy. Cadena decimal con 2 decimales."},"accountsWithoutBalance":{"type":["integer","null"],"description":"Cuentas sin saldo conocido"},"expectedCollections":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Cobros previstos. Cadena decimal con 2 decimales."},"expectedPayments":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Pagos previstos. Cadena decimal con 2 decimales."},"endingBalance":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Saldo previsto al final. Cadena decimal con 2 decimales."},"lowestPointDate":{"type":["string","null"],"description":"Día del saldo más bajo. Fecha ISO 8601."},"lowestPointBalance":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Saldo más bajo previsto. Cadena decimal con 2 decimales."},"overdueCollections":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Cobros vencidos. Cadena decimal con 2 decimales."},"overduePayments":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Pagos vencidos. Cadena decimal con 2 decimales."},"overdueIncluded":{"type":["string","null"],"description":"Vencidos incluidos"},"minimumBalance":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Mínimo de seguridad. Cadena decimal con 2 decimales."},"minimumBreachDate":{"type":["string","null"],"description":"Día en que baja del mínimo. Fecha ISO 8601."},"minimumBreachBalance":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Saldo previsto ese día. Cadena decimal con 2 decimales."},"paymentBeforeBreach1Kind":{"type":["string","null"],"description":"Pago 1 antes del cruce: tipo"},"paymentBeforeBreach1Concept":{"type":["string","null"],"description":"Pago 1 antes del cruce: concepto o número"},"paymentBeforeBreach1ThirdParty":{"type":["string","null"],"description":"Pago 1 antes del cruce: proveedor"},"paymentBeforeBreach1Date":{"type":["string","null"],"description":"Pago 1 antes del cruce: fecha. Fecha ISO 8601."},"paymentBeforeBreach1Amount":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Pago 1 antes del cruce: importe. Cadena decimal con 2 decimales."},"paymentBeforeBreach2Kind":{"type":["string","null"],"description":"Pago 2 antes del cruce: tipo"},"paymentBeforeBreach2Concept":{"type":["string","null"],"description":"Pago 2 antes del cruce: concepto o número"},"paymentBeforeBreach2ThirdParty":{"type":["string","null"],"description":"Pago 2 antes del cruce: proveedor"},"paymentBeforeBreach2Date":{"type":["string","null"],"description":"Pago 2 antes del cruce: fecha. Fecha ISO 8601."},"paymentBeforeBreach2Amount":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Pago 2 antes del cruce: importe. Cadena decimal con 2 decimales."},"paymentBeforeBreach3Kind":{"type":["string","null"],"description":"Pago 3 antes del cruce: tipo"},"paymentBeforeBreach3Concept":{"type":["string","null"],"description":"Pago 3 antes del cruce: concepto o número"},"paymentBeforeBreach3ThirdParty":{"type":["string","null"],"description":"Pago 3 antes del cruce: proveedor"},"paymentBeforeBreach3Date":{"type":["string","null"],"description":"Pago 3 antes del cruce: fecha. Fecha ISO 8601."},"paymentBeforeBreach3Amount":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Pago 3 antes del cruce: importe. Cadena decimal con 2 decimales."}},"title":"TesoreriaPrevisionRow"},"TesoreriaMovimientosPorConciliarRow":{"type":"object","required":["id","transactionDate","amount","amountRemaining","currencyCode","counterpartyName","origin","status"],"properties":{"id":{"type":["string","null"],"description":"Id del movimiento. Identificador."},"transactionDate":{"type":["string","null"],"description":"Fecha. Fecha ISO 8601."},"amount":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Importe. Cadena decimal con 2 decimales."},"amountRemaining":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","description":"Pendiente de conciliar. Cadena decimal con 2 decimales."},"currencyCode":{"type":["string","null"],"description":"Moneda"},"counterpartyName":{"type":["string","null"],"description":"Contraparte"},"origin":{"type":["string","null"],"description":"Origen. Valores conocidos: `api` (Banco conectado), `file` (Fichero importado). Puede llegar otro código."},"status":{"type":["string","null"],"description":"Estado. Valores conocidos: `unreconciled` (Sin conciliar), `partially_reconciled` (Conciliado en parte), `reconciled` (Conciliado), `ignored` (Ignorado). Puede llegar otro código."}},"title":"TesoreriaMovimientosPorConciliarRow"}}}}