Cambios y hoja de ruta

Versiones

1.0.0

Primera versión pública del API, en https://api.golem.ec/v1:

• Emisión de facturas, notas de crédito y comprobantes de retención (esquema 1.0.0 del SRI), con espera de la autorización hasta 12 segundos e Idempotency-Key.
• Consulta por clave de acceso, listado con filtros y seguimiento de cambios con cambiadoDesde.
• Descarga del XML autorizado con el envoltorio del SRI y del RIDE en PDF.
• Reproceso y reenvío del correo.
• Consulta de la empresa del token y de un RUC en el catastro del SRI.
• Catálogos del SRI y especificación OpenAPI 3.1 públicos.

Política de cambios

La versión va en la ruta (/v1). Dentro de una versión, los cambios son compatibles:

• Campos nuevos en las respuestas.
• Campos opcionales nuevos en las solicitudes.
• Valores nuevos en las enumeraciones de las respuestas, como un estado o un origen.
• Operaciones, catálogos y códigos de catálogo nuevos.
• Mensajes de error con otra redacción (el codigo no cambia).

Tu integración debe ignorar los campos y los valores de enumeración que no conozca. Las solicitudes, en cambio, rechazan los campos desconocidos: no envíes campos que esta documentación no describe.

Un cambio incompatible (quitar o renombrar un campo, cambiar su tipo o una regla de validación de forma que una solicitud válida deje de serlo) va en una versión nueva de la ruta, /v2. Las dos versiones funcionan en paralelo al menos 6 meses.

Retiro de rutas

Una ruta que se va a retirar:

1. Se anuncia en esta página con su fecha de retiro.
2. Responde con las cabeceras Deprecation y Sunset (fecha de retiro, RFC 8594) y un enlace a esta página en Link.
3. Después de la fecha, responde 410 RECURSO_RETIRADO.

Ninguna ruta de la versión 1 está en retiro.

Ruta de integración anterior

La ruta anterior a la versión 1, POST /api/api/v1/generate/factura, sigue funcionando para las integraciones que la usan, con su token propio. Sus respuestas llevan Deprecation: true y un enlace a esta página; la fecha de retiro se anunciará aquí.

Para migrar a POST /v1/comprobantes/facturas:

• El token va en la cabecera Authorization, no en el cuerpo. Crea uno en Cuenta > API e integraciones.
• Golem calcula los subtotales, el IVA y el total desde la cantidad, el precio unitario sin IVA y el descuento de cada ítem. Para comparar con tu cálculo, envía totalEsperado.
• La fecha de emisión es la de hoy (o la de ayer), como exige el SRI desde 2026.
• La respuesta trae el estado del SRI, el número, la clave de acceso y los enlaces al XML y al RIDE.

Disponibilidad y mantenimientos

Los mantenimientos programados se avisan por correo con 24 horas de anticipación. Durante un mantenimiento el API responde 503 MANTENIMIENTO con Retry-After. Golem no ofrece un acuerdo de nivel de servicio con un porcentaje de disponibilidad.

Próximas funciones

Funciones previstas, sin fechas comprometidas:

• Webhooks firmados: avisos a tu sistema cuando un comprobante se autoriza, se devuelve o se anula. Mientras tanto, usa el listado con cambiadoDesde.
• Modo sandbox: emisión simulada, sin SRI y sin créditos, para probar la integración.
• Notas de débito, liquidaciones de compra y guías de remisión.
• Retención con el esquema 2.0.0 del SRI.
• Precios con IVA incluido y cantidades y precios con hasta 6 decimales. Mientras tanto, la guía de facturas explica cómo convertir un precio con IVA.
• SDK para Node.js y PHP.

Si tu integración necesita alguna de estas funciones, escribe a [email protected].