Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.siplex.cl/llms.txt

Use this file to discover all available pages before exploring further.

Formato

Todos los errores siguen el mismo formato JSON:
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "El campo rutEmpresa es requerido",
    "details": null,
    "requestId": "uuid"
  }
}

Códigos HTTP

StatusSignificado
400Error de validación — revisa los campos enviados
401No autenticado — token inválido, expirado o faltante
404Recurso no encontrado
409Conflicto — operación no puede completarse (ej: folios agotados)
500Error interno — reintentar o contactar soporte
502Backend inalcanzable — servicio downstream no responde
504Timeout — la operación tardó más de 30 segundos

Códigos de error comunes

CódigoHTTPDescripción
VALIDATION_ERROR400Campos inválidos o faltantes
UNAUTHORIZED401Token no proporcionado o inválido
SESSION_EXPIRED401Sesión expirada
NOT_FOUND404Tenant, DTE, folio o recurso no encontrado
NO_FOLIOS_AVAILABLE409No hay folios disponibles para ese tipo de DTE
FOLIO_CONFLICT409Conflicto de concurrencia al consumir folio
API_KEY_NOT_FOUND404API key no encontrada o ya revocada
WEBHOOKS_NOT_CONFIGURED404La cuenta no tiene webhooks configurados
GATEWAY_TIMEOUT504Backend no respondió a tiempo
BAD_GATEWAY502Backend inalcanzable

Reintentos

Para errores 5xx, es seguro reintentar con backoff exponencial. Los errores 4xx generalmente no se resuelven reintentando — revisa los campos o el estado del recurso.