Changelog

Los cambios compatibles se anuncian aquí. Los incompatibles nunca ocurren dentro de v1; ver Versionado.

1.2.0 — 2026-10-12

Agentes: bots y agentes de IA que trabajan en el negocio con los permisos del equipo, y los datos que necesitan para decidir.

Nuevo

• Agentes, en Configuración → Equipo → Agentes: miembros del equipo que son bots, con rol y permisos del mismo catálogo que las personas, un responsable, un techo de lo que se les puede dar, autonomía por acción, topes diarios, puntuación de seguridad, pausa automática e interruptores. Sus claves caducan a los 90 días por defecto. Ver Agentes.
• Plantillas de partida: Analista, Asistente de ventas, Cobranza, Compras y gastos, Contable (lectura) e Integración ERP.
• Permiso sensible datos.personales, desactivado en todo agente salvo que se active a propósito. Sin él, el agente recibe enmascarados los correos, teléfonos, direcciones e identificaciones en todas las respuestas (salvo GET /me y GET /establishments), no descarga PDF ni XML y no busca por esos datos.
• Las claves de agente respetan las sucursales del agente y ventas.ver_ajenas al listar, consultar y emitir comprobantes.
• Idempotency-Key es obligatoria para los agentes al emitir.
• GET /kpis: catálogo de KPIs con su definición y unidad, y GET /kpis/{summary,sales,receivables,withholdings,purchases,finance,inventory,daily,recurring}. Ver KPIs.
• GET /expenses, GET /purchase-invoices, GET /contacts, GET /products y GET /quotes. Ver Listados.
• GET /reports/{nombre}: balance de comprobación, estado de resultados, balance general, flujo de efectivo, cambios en el patrimonio, libro mayor y libro diario. Ver Reportes contables.
• GET /me devuelve, con la clave de un agente, el bloque agente: permisos efectivos, autonomía, límites y puntuación de seguridad.
• GET /establishments devuelve el id de cada establecimiento, que es lo que espera el parámetro sucursal.
• Errores agent_required, insufficient_permissions, branch_not_allowed, idempotency_key_required, agent_without_access, agent_paused, agent_suspended, agent_revoked, agents_paused, agents_disabled, agent_action_forbidden, agent_action_requires_approval, agent_limit_exceeded, range_too_large y plan_feature_required. Ver Errores.
• llms.txt y llms-full.txt en el portal, para que los agentes de IA lean esta documentación.

Cambio

• Con la clave de un agente, el límite de peticiones por minuto se cuenta por agente: todas sus claves comparten el cupo.
• Las claves de integración no cambian en la API: scopes, lista de IPs, caducidad y límite por clave, como hasta ahora. No pueden usar los endpoints de datos (agent_required).
• En Configuración → Integraciones, nadie puede dar a una clave de integración un scope cuyos permisos no tenga, y los propietarios reciben un aviso de cada clave nueva.

1.1.0 — 2026-09-25

Los otros comprobantes electrónicos de Ecuador, con las mismas siete operaciones que la factura.

Nuevo

• POST /credit-notes/issue, POST /debit-notes/issue: notas de crédito y débito sobre una factura autorizada. Ver Notas de crédito y Notas de débito.
• POST /withholdings/issue: comprobantes de retención de renta, IVA e ISD con su documento sustento. Ver Retenciones.
• POST /waybills/issue: guías de remisión, con la factura de Olympus como documento sustento. Ver Guías de remisión.
• POST /purchase-settlements/issue: liquidaciones de compra. Ver Liquidaciones de compra.
• Para cada recurso: GET /{recurso}, GET /{recurso}/{id}, /pdf, /xml, POST …/retry y POST …/send-email, con los scopes documents:write y documents:read.
• GET /documents/{clave_acceso} devuelve cada comprobante con la forma de su recurso.
• Catálogos retention-codes, support-types y document-types.
• Errores invoice_not_found, invoice_not_authorized y document_type_not_supported.

Corregido

• enviar_email: false ya evita el correo al autorizarse, también en facturas.

1.0.0 — 2026-09-25

Primera versión pública de la API de integración.

Nuevo

• Autenticación por API key (X-API-Key), con permisos por scope, restricción por IP, caducidad y rotación con periodo de gracia.
• POST /invoices/issue: emisión de facturas electrónicas del SRI.
• GET /invoices, GET /invoices/{id}: consulta y listado con filtros y paginación por cursor.
• GET /invoices/{id}/pdf y /xml: descarga del RIDE y del XML autorizado.
• POST /invoices/{id}/retry: reintento de envío al SRI.
• POST /invoices/{id}/send-email: reenvío del comprobante por correo.
• GET /documents/{clave_acceso}: consulta de cualquier comprobante del negocio.
• GET /me, GET /establishments, GET /catalogs/{catalogo}.
• Idempotency-Key en las emisiones.
• Esquema OpenAPI público en /api/v1/openapi.json.
• Apartado Configuración → Integraciones en Olympus: gestión de claves, auditoría y registro de peticiones.

En preparación

Sin fecha comprometida; se anunciarán aquí al publicarse.

• Webhooks: aviso de invoice.authorized, document.authorized y demás, firmados con HMAC, para dejar de consultar en bucle.
• Facturas rectificativas en España por la API.
• Contactos y productos: crearlos y actualizarlos desde la API (consultarlos ya se puede con la clave de un agente).
• Agentes: bandeja de aprobación, acciones de escritura (borradores, cotizaciones, cobros), Ari para bots y servidor MCP.
• ICE e IRBPNR además del IVA.
• Colección de Postman y ejemplos descargables.