integration_logs:read habilita la consulta de actividad desde el producto Cobrix. Los integradores siguen usando los 17 endpoints públicos documentados en las demás categorías.
integration_logs:read
Qué puedes investigar
Solicitud
Método, ruta, ambiente, timestamp, partner, llave identificada por prefijo y payload sanitizado.
Resultado
Código HTTP, duración,
requestId, código de error y respuesta sanitizada.Idempotencia
Clave protegida, repetición compatible o conflicto de payload y resultado reproducido.
Webhooks
Evento, intento, destino, código HTTP, latencia y próximo reintento sin revelar el secreto.
Flujo de diagnóstico
1
Captura el requestId
Todas las respuestas de error de la API de integraciones incluyen
error.requestId. En documentos públicos, conserva también fecha, método e identificador público.2
Busca la petición en Cobrix
Entra a Configuración → Integraciones, abre el partner o llave correspondiente y consulta su actividad reciente.
3
Compara contrato y payload
Revisa scope, headers, firma, idempotencia, tipos, campos obligatorios y unidades monetarias antes de reenviar.
4
Escala con evidencia mínima
Comparte
requestId, ambiente, método, ruta y hora. Nunca envíes la API key completa, la firma ni el secreto del webhook.Bad Request: ¿qué debo mirar?
Bad Request: ¿qué debo mirar?
Abre el detalle sanitizado y revisa el campo señalado. Confirma especialmente fechas ISO 8601, enteros
Minor, moneda, source, identificadores externos y suma de líneas.Forbidden: ¿la llave es válida?
Forbidden: ¿la llave es válida?
Una llave válida aún puede carecer del scope de la operación, pertenecer a otra empresa o estar asociada a otro
source.Conflict: ¿puedo reintentar?
Conflict: ¿puedo reintentar?
Primero identifica si el conflicto proviene de idempotencia, referencia duplicada, estado financiero o una operación en recuperación. Reintenta con la misma clave solo si el cuerpo es idéntico.
¿Qué datos nunca se muestran?
¿Qué datos nunca se muestran?
Bearer tokens completos, secretos de webhooks y material criptográfico se ocultan. Los payloads sensibles deben aparecer sanitizados según el rol autorizado.
Para soporte, el prefijo visible de la llave y el
requestId son suficientes para correlacionar una petición sin compartir la credencial completa.
