Saltar al contenido principal

​
Ventana operativa

La ventana efectiva de un día combina tres fuentes. GET /v1/policy/window devuelve cuál de ellas decidió (source).
  • El horario oficial del STR, publicado por Lerian SPB. Los cambios de horario que el STR anuncia durante el día se aplican sin reiniciar.
  • El horario de corte de la institución, opcional, siempre igual o anterior al cierre oficial. TED Lerian rechaza un horario posterior con TED-0081.
  • El calendario nacional de feriados, mantenido por año.

​
Límites de uso

  • Por cuenta de origen: un máximo por transferencia, un total por día y un total por mes, por día y mes calendario en hora de Brasilia (America/Sao_Paulo). Los topes siguen el orden transferencia ≤ día ≤ mes. Un tope ausente significa que no hay tope.
  • Cuentan el total debitado: el monto más la comisión.
  • Una institución debe configurar sus límites antes de la primera TED. Sin ellos, TED Lerian rechaza cada envío con 503 TED-0080.
  • Por encima de un límite, TED Lerian rechaza la TED antes de la retención con 422 TED-0030. La respuesta indica el límite.
  • Una transferencia rechazada o cancelada los libera de nuevo.
  • Con enabled=false, los límites no cuentan nada y no rechazan nada.
  • Solo el administrador los cambia. Cada cambio registra quién lo hizo y cuándo.

​
Comisiones

  • Cobrar una comisión es opcional y está deshabilitado de forma predeterminada. Mientras está deshabilitado, toda comisión es cero: en la cotización, en el envío y en la recepción.
  • Cuando está habilitado para una institución, Midaz calcula la comisión a partir del paquete de comisiones configurado (feePackageId).
  • La cotización muestra la comisión y el total sin efecto financiero. La comisión cotizada es la comisión que retendría el envío de la misma solicitud.
  • Si el cálculo no está disponible cuando envías, TED Lerian rechaza la TED con 503 TED-0040. En ese caso, la institución puede elegir enviar con comisión cero.
  • En una TED entrante, la comisión aparece en feeAmount y el monto acreditado en creditedAmount. Si el cálculo falla, el cliente recibe el monto completo con comisión cero.
  • Cuando otra institución devuelve una TED, TED Lerian no reembolsa la comisión de envío de forma predeterminada. La institución puede habilitar el reembolso, y returned.feeRefunded muestra lo que pasó.

​
Idempotencia y solicitudes duplicadas

  • Cada escritura necesita el header X-Idempotency: de 1 a 128 caracteres ASCII imprimibles. Sin él, la respuesta es 400 TED-0011.
  • La misma clave con el mismo cuerpo devuelve la respuesta original con X-Idempotency-Replayed: true. TED Lerian no crea ninguna transferencia nueva.
  • X-TTL define durante cuántos segundos TED Lerian repite la respuesta (predeterminado 300). Solo cuenta el TTL de la primera solicitud.
  • Una solicitud con la misma clave y otro cuerpo recibe 422 TED-0012. En POST /v1/transfers, la clave queda vinculada a la transferencia que creó: una solicitud posterior con la misma clave nunca crea una segunda transferencia.
  • Una solicitud con la misma clave todavía en curso recibe 409 TED-0013 con Retry-After.
  • Independientemente de la clave, POST /v1/transfers rechaza una solicitud materialmente idéntica en la misma ventana antiduplicidad (5 minutos de forma predeterminada) con 409 TED-0014.

​
Plazos regulatorios

GET /v1/operations/sla muestra p50, p95 y p99 de cada plazo, los incumplimientos del día y los ítems en riesgo.

​
Datos personales

  • Respuestas de la API: el nombre y el CPF o CNPJ del remitente y del destinatario vienen completos, para los roles que tienen permiso para leerlos.
  • Logs: TED Lerian enmascara los documentos y los nombres.
  • Eventos de TEDs enviadas (transfer.*) no llevan datos de la contraparte.
  • Eventos de TEDs entrantes (incoming_transfer.*) llevan completo al destinatario, el cliente de la propia institución. El remitente, cliente de otra institución, está enmascarado.
  • La descripción en texto libre de una TED entrante se publica tal como la escribió la institución emisora.

​
Aislamiento entre instituciones

Cada registro pertenece a una institución. La institución siempre viene del token autenticado, nunca de un campo de la solicitud. Un identificador de otra institución responde como no encontrado (404), sin revelar que existe.

​
Auditoría

Cada transferencia tiene una línea de tiempo que nunca se edita. Registra cada cambio de estado con la fecha y la hora, el origen (API, RAIL, STR, LEDGER, WORKER, OPERATOR, SYSTEM), el motivo oficial y, en las acciones de operador, quién actuó. TED Lerian no elimina ningún registro de negocio.