Simplo
Descripción general
Simplo API 0.2.0
Sección titulada «Simplo API 0.2.0»API REST de facturación electrónica chilena (DTE) de Simplo.
Permite emitir y consultar Documentos Tributarios Electrónicos (DTE), administrar CAFs (folios autorizados por el SII), datos de la empresa emisora, certificado digital, webhooks de eventos, y catálogos de clientes y productos.
Autenticación
Dos mecanismos:
- API Key (
X-Api-Key): pensada para integraciones servidor a servidor. - Bearer JWT (
Authorization: Bearer ...): token de sesión de la plataforma Simplo, usado por las aplicaciones oficiales.
Beta privada: la emisión de DTE y en general las operaciones de escritura vía API key están en beta privada. Hoy las API keys operan en modo lectura. Para solicitar acceso de escritura escriba a hola@simplo.cl.
Toda petición opera en el contexto de la empresa (tenant) asociada a la credencial. No es necesario enviar el RUT de la empresa emisora en cada llamada.
Emisión de DTE (flujo asíncrono)
POST /api/v1/billing/dte valida el documento, asigna folio desde el CAF
activo, genera el XML, lo timbra (TED) y lo firma digitalmente. La
respuesta 201 retorna de inmediato con estado firmado. El envío al SII
ocurre de forma asíncrona: siga el estado con
GET /api/v1/billing/dte/{id} (polling) o suscribiendo un webhook.
Idempotencia
POST /api/v1/billing/dte exige el header Idempotency-Key (UUID).
Reintentar con la misma key retorna la respuesta original con el header
X-Idempotency-Replay: true. Reutilizar una key con un body distinto
retorna 422 (IDEMPOTENCY_BODY_MISMATCH); una key aún en proceso
retorna 409 (IDEMPOTENCY_IN_PROGRESS).
Paginación
Los listados paginados usan cursor: parámetros cursor y limit;
la respuesta incluye items (o data en clientes/productos),
next_cursor (null cuando no hay más páginas) y, donde aplica,
total_count.
Errores
Todos los errores usan un sobre común (ErrorResponse) con code
máquina-legible y message descriptivo; los errores de validación
agregan details por campo.
Autenticación
Sección titulada «Autenticación»ApiKeyAuth
Sección titulada «ApiKeyAuth»API key de integración servidor a servidor. La emisión y en general las operaciones de escritura vía API key están en beta privada (solicitar acceso: hola@simplo.cl); hoy las keys operan en modo lectura.
Security scheme type: apiKey
Header parameter name: X-Api-Key
BearerAuth
Sección titulada «BearerAuth»JWT de sesión de la plataforma Simplo (RS256). Contiene el contexto de la empresa (tenant) para multi-tenancy.
Security scheme type: http
Bearer format: JWT