Registros de Operations, suministro y facturación
Esta página complementa la vista general de Operations y cubre los registros que no son fichas de compromisos o fulfillment.
Si una fila muestra un ID técnico en lugar de un nombre claro o un código de artículo, no lo trate como un dato de negocio. Actualice la ficha o avise al responsable y no use esa vista en la documentación pública.
En la versión actual, algunas etiquetas de las listas y del módulo (incluidos filtros, estados y acciones) pueden aparecer en inglés mientras los mensajes traducidos del idioma elegido no estén completos. Las reglas de datos y de proceso descritas abajo no cambian.
Resumen y compromisos
/operations/summary agrupa compromisos que requieren revisión, próximos vencimientos, derechos de servicio y facturas pendientes. Es una vista de triaje, no un balance contable. Un número sin fila, período o estado no es un total confirmado.
Si alguna fuente del resumen aún no está lista, es posible que las tarjetas no se carguen por completo. Antes de repetir, compruebe los permisos y la disponibilidad de los datos. Vuelva a intentar el resumen en un minuto y no trate los valores ausentes o cero como el total final; ante un fallo de carga normal, reintente la instantánea completa y no una métrica individual.
Servicios y derechos
/operations/services muestra por defecto los derechos de servicio visibles para la persona activa en todo el portal. El selector de cliente solo reduce la lista localmente y no guarda el filtro; la primera carga devuelve hasta 25 filas y Mostrar más continúa la misma selección. La ficha concreta se abre en /operations/services/:entitlementId. Un resultado vacío tras filtrar no equivale a un registro global vacío ni significa que el derecho sea cero.
Cuando las relaciones se resuelven, la ficha del derecho también enlaza al cliente y al compromiso de origen. Si no se puede leer el enriquecimiento, la ficha sigue disponible con una etiqueta neutra; eso no demuestra que falte la relación. El historial de uso y sus transiciones requieren sus propias comprobaciones de permisos y versión actual.
La ficha también muestra periodos con cantidades concedidas, usadas, reservadas y disponibles, además de una tabla de uso con los estados pending_approval, captured, allocated, approved, posted, rejected y reversed. Registrar uso, Aprobar y Contabilizar son acciones distintas con permisos distintos; quien crea el registro no puede aprobarlo. Comprueba el saldo disponible antes de introducir uso, pero no prometas un rechazo inmediato por exceso: el registro puede guardarse y el exceso detectarse solo al aprobar o contabilizarlo otra persona. Vuelve a leer la ficha después de cada transición y no muestres códigos técnicos en capturas públicas.
Las cantidades de tiempo pueden expresarse exactamente en la unidad comprada: 480 y 390 minutos se muestran usando una o varias unidades configuradas para ese derecho. Es solo el formato mostrado: introduce el valor en la unidad que aparece junto al campo. No redondees por intuición los valores fraccionarios o negativos.
Cuando el periodo actual y el saldo disponible están permitidos, el formulario Registrar uso aparece directamente en la ficha del derecho, junto al historial. Introduce una cantidad entera positiva en la unidad que aparece junto al campo (por ejemplo, minutos) y añade opcionalmente un motivo como solicitud, tarea o nota. Guardar crea un registro de uso y no sustituye las acciones separadas Aprobar y Contabilizar. Si no aparece el formulario o la unidad, no adivines ni repitas la solicitud a ciegas.
En el frontend actual, estas etiquetas de servicios y detalle todavía pueden aparecer en inglés fuera de ruso e inglés; no las trates como evidencia localizada hasta que se desplieguen traducciones nativas y se revisen visualmente.
Suministro, almacenes y compras
/operations/supply tiene pestañas de compras y almacenes. Una fila abre /operations/supply/warehouses/:warehouseId con tipo, estado, zona horaria, ubicaciones y existencias. Las etapas de borrador, activo y suspendido requieren permisos; el estado suspendido pausa recepción, reservas y movimientos.
En la interfaz actual, el ciclo de vida del almacén se limita al borrador, la activación y la suspensión: activar, suspender y reanudar solo están disponibles para administradores y exigen un motivo. Las ubicaciones solo se pueden añadir mientras el almacén está activo. No prometas acciones de retirada o cierre en esta pantalla.
Crear un almacén abre un modal: el código y el nombre son obligatorios, y el tipo y la zona horaria deben elegirse explícitamente. Si faltan permisos de administrador, el código ya está en uso o se rechazó un campo, corrija los datos o solicite acceso; no repita la creación a ciegas. Para probar, use un almacén sintético y no direcciones reales.
Los almacenes y las facturas se cargan en páginas de hasta 25 filas. Mostrar más carga la siguiente página sin recalcular las filas ya visibles. La pestaña de compras solicita hasta 50 solicitudes y pedidos a proveedores sin control Mostrar más. El filtro de cliente limita la lista al cliente seleccionado; sin él, el registro muestra todos los registros disponibles para usted.
Las solicitudes de compra y los pedidos a proveedores aparecen en la pestaña de compras. Una solicitud puede crearse automáticamente desde un pedido confirmado bajo una configuración de fulfillment que compre el faltante, o crearse manualmente. El detalle está en /operations/procurement/requisitions/:requisitionId; durante la búsqueda de proveedor muestra una línea de demanda inmutable con su cantidad exacta y un selector de proveedor. Aprobar, rechazar, iniciar la búsqueda de proveedor o cancelar exige motivo y versión actual. Después de asignar proveedor, la solicitud queda lista para un pedido, pero el pedido al proveedor todavía no se construye a propósito: si la relación o el siguiente paso aún no están listos, no aparecerá automáticamente. Compruebe el estado de la solicitud y consulte al administrador; una lista vacía puede ser un estado honesto de los datos actuales, no un fallo de interfaz.
Durante la búsqueda de proveedor puedes elegirlo o cambiarlo para esa línea. La asignación se bloquea si falta la línea o la cantidad, la búsqueda no está disponible, no hay resultados o la empresa no puede actuar como proveedor; actualiza y comprueba el estado antes de reintentarlo.
Si la versión actual muestra Nueva solicitud, la entrada manual es /operations/procurement/requisitions/new. Elige un artículo de bienes y la cantidad; la unidad, la versión y la precisión proceden del catálogo, el comprador procede de una entidad legal disponible y la fecha límite y la nota son opcionales. El proveedor, el precio y el almacén se deciden después. Si faltan permisos, la solicitud ya existe o se rechazó un campo, comprueba el estado y corrige los datos antes de reintentar.
Facturación
/operations/billing es el registro de facturas con filtro opcional por cliente; /operations/billing/invoices/:invoiceId abre la ficha de una factura. La factura aparece después de que el cliente tome una decisión de aceptación: mientras la aceptación solo esté lista y aún no se haya enviado al cliente, el registro puede permanecer vacío. En ese estado usa Abrir aceptación, no Catálogo. Comprueba número, estado, fechas de emisión y pago, total y pendiente; una lista vacía no significa deuda cero.
En la misma ruta, la pestaña Cargos muestra importes de servicios que todavía no se han facturado. No es una lista de facturas: cada fila describe un cargo y su período de servicio, no demuestra que ya exista una factura. Un cargo pendiente puede tener importe desconocido y no importe cero; si faltan período, nombre legible o importe, no los inventes ni deduzcas una deuda. Crear factura cambia datos: una revisión de solo lectura solo puede abrir la pestaña y comprobar nombres claros, período, estado y moneda, sin seleccionar filas ni crear o enviar una factura.
La ficha de factura es de solo lectura: emitir, aprobar y cambiar datos corresponde a un rol autorizado. Los estados pueden ser borrador, pendiente de aprobación, aprobado, emitido, enviado, pagado parcialmente, pagado, vencido, anulado o cancelado. Compara total, pagado, credited y pendiente; después revisa descripciones, cantidades, importes y documentos vinculados. Reintenta un error de carga tras comprobar el estado y distingue una factura vacía de un objeto no disponible.
En /operations/billing/invoices/:invoiceId, la factura y sus líneas se cargan en paralelo: carga, error con reintento, factura ausente o no disponible y líneas vacías son estados distintos. Una captura sintética correcta debe mostrar número, estado, fechas, total/pagado/acreditado/pendiente en la moneda de la locale elegida, líneas y documentos vinculados. Es una vista de solo lectura: no emitas, pagues ni modifiques la factura y no uses datos reales de pago o clientes.
Para cada importe verifica que la moneda mostrada corresponde al mercado y que el redondeo es coherente. No reutilices un ejemplo financiero de otro mercado.
Ajustes y órdenes de trabajo
La página de configuración /operations/settings define las entidades legales que pueden aparecer como nuestra parte en pedidos, facturas y documentos de entrega. Sin una entidad seleccionada, la creación puede bloquearse para no adivinar el emisor. Guardar puede bloquearse por permisos, una versión obsoleta o una indisponibilidad temporal: comprueba el acceso, actualiza la página y vuelve a intentarlo más tarde.
La ficha de una orden de trabajo se abre en /operations/work-orders/:workOrderId, normalmente desde el recorrido de fulfillment. No existe un registro separado; un enlace ausente puede indicar que el paquete no se creó o no está disponible por permisos, no que se haya perdido.
La ficha de una orden de trabajo puede mostrar Planificar → Listo para trabajar → En curso y un paquete de tareas. Sin embargo, en la interfaz actual ese paquete no tiene una acción para crear o asignar un componente de tarea: el estado de la orden por sí solo no prueba que una persona ejecutora haya recibido o completado una tarea. Si el proceso necesita una tarea de la orden, detenga la entrega o el traspaso y acuerde el siguiente paso con la persona responsable de Operations; no lo sortee mediante una llamada directa a la API ni un identificador técnico.
Errores y revisión segura
Distingue entre lista vacía, lista vacía tras filtrar, falta de acceso, objeto no disponible, conflicto, campos rechazados y fallo temporal. Tras un resultado parcial, vuelve a leer el registro e historial antes de reintentar con la versión actual. Para ejemplos planificados de solo lectura usa la misma cadena: cliente Demo Client North, derecho Support package — test y oferta de origen Support hours — test. No mezcles los tipos de entidad; nunca muestres datos bancarios, facturas, contratos ni datos reales de clientes. Antes de iniciar o compartir, comprueba las etiquetas de sección, estado y acción y la moneda mostrada en el idioma elegido del portal.