Fichas de compromisos y acuerdos
/operations/commitments y /operations/agreements representan niveles distintos. El compromiso es un pasaporte derivado y de solo lectura de lo que debe entregarse; el acuerdo gestiona condiciones, partes, fechas y transiciones.
Registro de acuerdos
En /operations/agreements, una persona con acceso a la sección ve el registro común; cliente es un filtro adicional, no el único límite. La franja de estados filtra draft, review, awaiting_signature, active, suspended, expiring, expired, terminated y superseded. El contador cubre todo el resultado disponible para el filtro elegido, no solo las filas ya cargadas. Tabla/Tarjetas cambia la vista de los mismos resultados y una fila abre el pasaporte del acuerdo.
Cada fila muestra la dirección (Cliente, Proveedor o Interno) junto al nombre. El plazo combina fecha inicial y final; sin fecha final se muestra sin fecha de fin. Continúe por la lista hasta llegar al resultado necesario: una página parcial no es el registro completo.
Pasaporte del compromiso
El pasaporte también muestra Creado y Actualizado como metadatos de auditoría; el compromiso derivado sigue siendo de solo lectura.
Abra una ficha desde /operations/commitments o un pasaporte concreto en /operations/commitments/:commitmentId para ver tipo, cantidad/unidad prometida, fecha de entrada en vigor cuando se entrega, estado de cumplimiento, etapa, base de condiciones y pedido de origen. La fecha actual de entrega puede faltar en el pasaporte: no infiera un vencimiento de campos ausentes ni del grupo Abiertos; compruebe la fecha de entrega y el plazo en el pedido y contrato de origen.
El compromiso se deriva del pedido y no se edita aquí. Cambie cantidad, fecha de vencimiento o condiciones en el pedido de origen tras comprobar permisos e historial. Error de carga, vacío y falta de enriquecimiento son estados distintos.
Pasaporte del acuerdo
La ficha del acuerdo en /operations/agreements muestra dirección, estado, fechas, partes legales, versión actual, número de líneas y si exige documento firmado. Los nombres deben venir del contexto, no de identificadores técnicos.
El bloque de prepago muestra una cuenta vinculada al acuerdo, a una revisión de sus condiciones y a la moneda de liquidación; no es una cartera del cliente. No se introduce importe: seleccione un pago confirmado, aún no asignado y en la misma moneda. Abrir y abonar requiere permisos y puede aplicar separación de funciones: quien registró el pago no lo confirma de nuevo. Carga, lista vacía, error de lectura, conflicto de versión y operación pendiente son estados distintos; vacío o no disponible no equivale a saldo cero. No permite gastar, crear o liberar una reserva de línea de factura ni reembolsar; solo abre la cuenta, permite elegir un pago y muestra su estado. Si el pago se ha vinculado pero aún no se ha abonado, la ficha mantiene seleccionado el mismo pago y pide pulsar de nuevo Abonar; no seleccione otro pago. pending_funding o una escritura pendiente significa esperar y volver a leer la ficha, no que el saldo sea cero.
El saldo principal es Disponible: Disponible = abonado − retenido − gastado; un valor no nulo de Reembolsado se muestra aparte. La tarjeta también muestra la revisión vigente de las condiciones y la moneda de liquidación: una nueva revisión de las condiciones inicia un circuito de reserva independiente; el saldo de la revisión sustituida no se traslada. “Gastado” indica el vínculo con una línea de factura emitida, no una función de gasto en este bloque: aquí no hay acciones para gastar, crear/liberar una reserva ni reembolsar.
En awaiting_signature, el acuerdo espera la confirmación de la firma fuera del portal: el portal registra esa decisión, pero no la toma. Por eso aquí no hay un botón separado de Activar; comprueba el proceso externo y la copia del documento vinculado. El siguiente paso práctico es obtener el ejemplar firmado y pulsar Añadir en la sección de documentos; no aparecerá automáticamente.
Debajo de las condiciones hay una sección separada de documentos vinculados con Añadir y Ver todos. Puede estar vacía mientras se espera la copia firmada; no es un fallo de acceso. Creado y Actualizado aportan contexto adicional de auditoría.
Ver todos abre el registro de documentos ya filtrado por este acuerdo: /documents?sourceType=agreement&sourceId=<agreementId>. Solo deben aparecer sus documentos y el título, la etiqueta de contexto y el estado vacío deben estar localizados y ser claros; un ID técnico o un archivo de otro acuerdo no demuestra un filtro correcto.
Cada transición requiere estado compatible y la versión actual de la ficha para no sobrescribir cambios ajenos. Escriba un motivo obligatorio: queda guardado en el historial del acuerdo.
Puedes crear un acuerdo en /operations/agreements/new si tienes permiso de escritura. El formulario crea un borrador; para un acuerdo en draft o review, abre la edición de condiciones en /operations/agreements/:agreementId/terms, que sustituye las condiciones actuales. Si la ficha cambió o aparece un conflicto, vuelve a leerla y prueba de nuevo. La interfaz no ofrece una vuelta separada a una versión anterior; volver de review a draft forma parte de editar las condiciones.
Después de elegir el cliente y la primera oferta/precio, el portal sugiere un nombre como «oferta — cliente». Mientras no lo edites, cambiar la selección actualiza la sugerencia; tras editarla manualmente, el portal conserva tu texto. El acuerdo exige un nombre, así que usa datos claros en lugar de inventados; editar un acuerdo existente no sobrescribe su nombre.
En el selector de prepago actual, la fecha del pago puede aparecer como ISO sin procesar YYYY-MM-DD en lugar del formato del locale activo. Es un bloqueo de fuente: no lo trates como evidencia de fecha localizada ni promociones un marco con dinero sin currency.expected/currency.observed y revisión de fecha en un build coincidente.
Transiciones permitidas
draft→review: Enviar a revisión;review→awaiting_signature: Enviar a firma;activeoexpiring→suspended: Suspender;suspended→active: Reanudar;- cualquier estado modificable →
terminated: Terminar, irreversible.
La activación no es un botón de esta ficha: active llega tras la firma legal o desde un sistema documental externo. El vencimiento y la sustitución los procesa el sistema.
Si cambia la versión o aparece un conflicto, recargue y use los datos actuales; no repita una acción antigua a ciegas.
Seguridad
Revise la versión, el documento firmado, la entidad legal, el cliente, las fechas y el acceso. Use contratos y cantidades ficticios en ejemplos; no muestre datos bancarios, clientes ni identificadores técnicos.
Páginas relacionadas