Saltar al contenido principal
POST
/
v1
/
exceptions
/
{exceptionId}
/
adjust-entry
Asiento de ajuste para una excepción
curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/exceptions/{exceptionId}/adjust-entry \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 150.5,
  "currency": "USD",
  "effectiveAt": "2023-11-07T05:31:56Z",
  "notes": "Correcting processing fee discrepancy",
  "reasonCode": "FEE_ADJUSTMENT"
}
'
{
  "assignedTo": "user@example.com",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "dueAt": "2025-01-20T10:30:00.000Z",
  "externalIssueId": "RECON-1234",
  "externalSystem": "JIRA",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "Amount mismatch detected",
  "resolutionNotes": "Resolved via force match",
  "resolutionReason": "BUSINESS_DECISION",
  "resolutionType": "FORCE_MATCH",
  "severity": "HIGH",
  "status": "OPEN",
  "transactionId": "550e8400-e29b-41d4-a716-446655440001",
  "updatedAt": "2025-01-15T10:30:00.000Z"
}

Autorizaciones

​
Authorization
string
header
requerido

Autenticación con token Bearer (formato: "Bearer {token}")

Encabezados

​
X-Request-Id
string

Un identificador único para rastrear la solicitud a través de los servicios.

​
X-Idempotency-Key
string

Una clave única para asegurar reintentos seguros de la solicitud.

Parámetros de ruta

​
exceptionId
string
requerido

ID de la excepción

Cuerpo

application/json

Datos del asiento de ajuste

Datos de solicitud de asiento de ajuste

​
amount
number
requerido

Monto del ajuste

Ejemplo:

150.5

​
currency
string
requerido

Código de moneda (ISO 4217)

Ejemplo:

"USD"

​
effectiveAt
string<date-time>
requerido

Cuándo entra en vigor el ajuste

​
notes
string
requerido

Notas adicionales explicando el ajuste

Maximum string length: 1000
Ejemplo:

"Correcting processing fee discrepancy"

​
reasonCode
string
requerido

Código de razón para el ajuste

Maximum string length: 255
Ejemplo:

"FEE_ADJUSTMENT"

Respuesta

Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados.

Detalles de la excepción

​
assignedTo
string

Usuario al que está asignada la excepción

Ejemplo:

"user@example.com"

​
createdAt
string

Marca de tiempo de creación en formato RFC3339

Ejemplo:

"2025-01-15T10:30:00.000Z"

​
dueAt
string

Fecha límite para resolución en formato RFC3339

Ejemplo:

"2025-01-20T10:30:00.000Z"

​
externalIssueId
string

ID del issue externo en el sistema externo

Ejemplo:

"RECON-1234"

​
externalSystem
string

Sistema externo donde se despachó la excepción

Ejemplo:

"JIRA"

​
id
string

Identificador único para la excepción

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
reason
string

Razón por la cual se generó la excepción

Ejemplo:

"Amount mismatch detected"

​
resolutionNotes
string

Notas de resolución cuando se resuelve

Ejemplo:

"Resolved via force match"

​
resolutionReason
string

Razón de la resolución

Ejemplo:

"BUSINESS_DECISION"

​
resolutionType
enum<string>

Tipo de resolución aplicada

Opciones disponibles:
FORCE_MATCH,
ADJUST_ENTRY
Ejemplo:

"FORCE_MATCH"

​
severity
enum<string>

Nivel de severidad

Opciones disponibles:
LOW,
MEDIUM,
HIGH,
CRITICAL
Ejemplo:

"HIGH"

​
status
enum<string>

Estado actual

Opciones disponibles:
OPEN,
ASSIGNED,
RESOLVED
Ejemplo:

"OPEN"

​
transactionId
string

ID de la transacción para la cual es esta excepción

Ejemplo:

"550e8400-e29b-41d4-a716-446655440001"

​
updatedAt
string

Marca de tiempo de última actualización en formato RFC3339

Ejemplo:

"2025-01-15T10:30:00.000Z"