Beta privada · apertura 23 de diciembre
Reintenta una entrega
POST /v1/conecta/entregas/{id}/reintentar
Vuelve a encolar una entrega fallida o pausada. El evento conserva su id para que no lo dupliques.
| Dato | Valor |
|---|---|
| Permiso | webhooks:administrar |
| Cobro | No cobra. |
Idempotency-Key |
Opcional |
| Herramienta MCP | entrega_reintentar (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
id |
path | Sí | string | Identificador que empieza con ent_. |
Idempotency-Key |
header | No | string | Identifica una operación para que repetirla no la duplique. Si repites la petición con la misma clave y el mismo cuerpo, recibes la misma respuesta; con otro cuerpo, idempotencia_en_conflicto. Se guarda 24 horas. |
X-Request-Id |
header | No | string | Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl -X POST "https://api-sandbox.opennexum.com/v1/conecta/entregas/ent_8f2c1a7d9e/reintentar" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»Entrega en cola.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
id |
string | Sí | Identificador que empieza con ent_. |
webhook_id |
string | Sí | Identificador que empieza con whk_. |
evento_id |
string | Sí | Identificador que empieza con evt_. |
tipo_evento |
“mensaje.recibido” | “mensaje.estado” | “conexion.estado” | “plantilla.estado” | “webhook.prueba” | Sí | |
estado |
“pendiente” | “entregada” | “fallida” | “pausada” | Sí | |
intentos |
integer | Sí | |
ultimo_codigo_http |
integer | null | Sí | |
ultimo_error |
string | null | Sí | |
proximo_intento_en |
string (date-time) | null | Sí | Reintentamos hasta 8 veces con espera creciente. |
creada_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
entregada_en |
string (date-time) | null | Sí |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 404
no_encontrado - 409
idempotencia_en_conflicto - 409
solicitud_en_curso - 409
estado_no_permite - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible