Errores

Todos los errores de Deliver tienen la misma forma, con un estado HTTP y un código estable contra el que programar.

Toda respuesta de error tiene esta forma:

{
  "error": "La clave no tiene habilitado este canal.",
  "codigo": "CANAL_NO_PERMITIDO"
}

• codigo es estable: programa contra él.
• error es el mensaje para personas y su redacción puede mejorar sin aviso.
• detalle es opcional y trae más contexto, por ejemplo qué campo del cuerpo es inválido.

Códigos

Esta tabla sale del mismo catálogo que usa la API. El mensaje es el texto de error que devuelve.

Código	HTTP	Mensaje (error)
CLAVE_AUSENTE	401	Falta la cabecera authorization: Bearer <clave>.
CLAVE_INVALIDA	401	La clave no existe o fue revocada.
CLAVE_NO_VERIFICABLE	503	No se pudo verificar la clave. Reintenta en unos segundos.
CANAL_NO_PERMITIDO	403	La clave no tiene habilitado este canal.
RUTA_NO_ENCONTRADA	404	La ruta no existe.
METODO_NO_PERMITIDO	405	Método no permitido en esta ruta.
PETICION_INVALIDA	400	El cuerpo de la petición no cumple el contrato.
CONTENIDO_LIBRE_NO_PERMITIDO	403	La clave no permite enviar contenido libre; usa una plantilla.
CANAL_NO_DISPONIBLE	501	Este canal todavía no está disponible para envío.
ADJUNTOS_DEMASIADO_GRANDES	413	Los adjuntos superan el tamaño máximo permitido (10 MB en total).
MENSAJE_NO_ENCONTRADO	404	No existe un mensaje con ese id para esta clave.
MARCA_NO_ENCONTRADA	404	La marca no existe o tu aplicación no está autorizada para usarla.
PLANTILLA_NO_ENCONTRADA	404	No existe esa plantilla o ese diseño.
VARIABLES_FALTANTES	422	Faltan datos que la plantilla necesita.
DESTINATARIO_SUPRIMIDO	422	El destinatario se dio de baja o rebotó en este canal.
LIMITE_EXCEDIDO	429	Se superó el límite de envíos de la clave.
SESION_INVALIDA	401	La sesión no es válida o expiró. Vuelve a ingresar.
SIN_ACCESO	403	Tu cuenta no tiene acceso a Deliver. Pídele a un administrador que te habilite.
PERMISO_INSUFICIENTE	403	Tu rol no permite esta acción.
CONFLICTO	409	La operación no se puede aplicar en el estado actual.
ERROR_INTERNO	500	Error inesperado. Ya quedó registrado.

Qué reintentar

• 503 CLAVE_NO_VERIFICABLE, 500 ERROR_INTERNO y 429 LIMITE_EXCEDIDO (parte del contrato; los límites de envío aún no se aplican) son temporales: reintenta con espera y la misma Idempotency-Key. Ver Idempotencia y reintentos.
• Los demás 4xx no cambian al reintentar: corrige la petición, la clave o los datos.