Diseño funcional cerrado y navegable: 36 pantallas para 8 perfiles, la máquina de 14 estados del pedido, parámetros por cliente, posventa con doble aprobación e integración por API con Affinity Cloud y Pharex. Un solo lugar con el estado real del proyecto para Moore y Puig.
Cinco fases: levantamiento y diseño cerrados, construcción es la siguiente. Cada estación declara su entregable y la condición que la cierra: sin esa condición no avanza, aunque el calendario diga otra cosa.
Ocho perfiles sobre el mismo shell, cada uno con su menú. Las pantallas P vienen del diseño original; las N se agregaron en la v2. Nada existe sin una regla que lo sostenga.
Wireframes originales en Canva ↗ Abrir el demo navegable v2 ↗Las pantallas con su especificación, la máquina de estados del pedido y de la nota crédito, el catálogo de parámetros por cliente, las 33 reglas de negocio y, desde septiembre, lo que PwC y Pharex confirmaron de sus APIs. El demo navegable v2 es la referencia visual.
Abrir los documentos de diseño en Drive ↗El menú se construye del rol en el servidor. Ocho perfiles: el comercial ve su cartera y la de quien respalda (D01); Finanzas de Puig y Dirección entran como perfiles propios.
Arriba el nombre del sistema, abajo lo que lee el usuario. Ningún botón del portal existe fuera de esta máquina.
Cinco de los siete escenarios reales son parciales. PwC confirmó el 8 de septiembre que la nota crédito parcial está en el alcance de posventa, sin fecha: el estado bloqueado sostiene el módulo mientras llega.
Nada de la interfaz existe sin una regla que lo sostenga. Cada ficha declara para qué existe, quién la usa, sus componentes con fuente de dato, los retos técnicos y qué actividad del proceso actual elimina.
33 reglas rastreables al levantamiento. Ninguna vive como texto de ayuda: cada una es una restricción visible en alguna pantalla.
Estado al 15 de septiembre: las 28 decisiones tienen respuesta. Lo que queda son tareas de configuración e insumos de terceros; el estado vivo está en la pestaña Decisiones, que lee Jira.
Respuestas del equipo técnico de PwC del 8 de septiembre de 2026 a las nueve preguntas de integración, y contrato del servicio web de creación de pedidos de Pharex (APIPED-001). Los manuales técnicos de Affinity Cloud siguen pendientes.
| Tema | Qué confirmó PwC | Efecto en el portal |
|---|---|---|
| Arquitectura | Puig va sobre Affinity Cloud, por API REST. Sin conexión a Legacy ni a la base de datos. | El adaptador se escribe contra servicios REST. Se descarta el escenario del monolito. |
| Remisión y factura | No hay webhooks. La trazabilidad documental del pedido (remisiones, facturas, anulaciones, estados e identificadores) se consulta por API. | El acuse se obtiene consultando. P-10 y P-11 muestran el pedido en ámbar mientras la consulta no devuelva documentos. |
| Idempotencia | Cada pedido lleva una referencia externa única. Affinity la usa para reconocer reintentos y evitar duplicados. | La clave de idempotencia del portal es esa referencia. Reintentar con la misma clave es seguro. |
| Workflow | El flujo de Puig se configura por etapas: pedido, remisión y factura. Enviar el pedido no implica facturar de inmediato. | La ventana de emisión de P-11 se aplica sobre la factura, no sobre el envío del pedido. |
| Impuestos | Simulación tributaria sin crear documentos, con IVA, ICA y retención en la fuente, con las mismas reglas del cálculo definitivo. Exige tercero y maestros existentes. | La previsualización de P-11 usa ese cálculo. Tercero o maestro faltante se detecta antes de escribir. |
| Validaciones | Esquema estricto: tercero, inventario, centro y subcentro de costo, proyecto, oficina, moneda y producto rechazan el pedido si fallan. Un servicio caído también impide crearlo. | Toda validación es hard-fail. Los códigos funcionales separan error de dato, duplicado y falla temporal: solo la temporal se reintenta. |
| Maestros | APIs de productos, inventarios, terceros, precios, centros y subcentros, proyectos, oficinas, bodegas, monedas y tasas, con paginación, filtro por empresa y sincronización incremental. | El espejo de maestros (P-16) sincroniza por incremento. Tamaños de página y límites llegan con la documentación. |
| Terceros | Con createThirdParty: false Affinity no crea el tercero y rechaza el pedido con código y mensaje que lo identifican. | Coherente con P5: el portal no crea terceros. El rechazo abre novedad con el tercero nombrado. |
| Posventa | La nota crédito parcial está en el alcance: relación con la factura original, control de cantidades y saldos, límite de líneas y mapeo DIAN. | BLOQUEADA_SISTEMA se mantiene como puente y se conecta cuando PwC la habilite, sin recapturar. |
Un POST con un JSON que trae la cabecera y la lista lineas_pedidos. Reemplaza el archivo por FTP de la operación enviar_pedido. El pedido de Puig se identifica con CODPED, que hace de clave de idempotencia frente al operador.
| Cabecera | Descripción | Tipo | Obligatorio |
|---|---|---|---|
| CODPED | Código de pedido | C(20) | Sí |
| SUPEDIDO | Pedido interno del cliente | C(20) | Sí |
| CODCLI | Código del destinatario | C(20) | Sí |
| NIT | NIT del destinatario | C(20) | Sí |
| DESCLI | Nombre del destinatario | C(40) | Sí |
| POBLACION | Ciudad de destino | C(20) | Sí |
| DIRECCION | Dirección de destino | C(60) | Sí |
| TELEFONO | Teléfono del destinatario | C(20) | No |
| FECHA_ENTREGA | Fecha estimada de entrega o cita | C(10) | No |
| FECHA_PEDIDO | Fecha de generación | C(10) | Sí |
| VALOR_ASEGURADO | Valor de seguro | INT | Sí |
| OBSERVACION | Detalle adicional | C(60) | No |
| CLIENTE · USUARIO · CLAVE | Credenciales de acceso que entrega Pharex | C(4) · C(20) | Sí |
| Líneas | Descripción | Tipo | Obligatorio |
|---|---|---|---|
| CODART | Código del artículo | C(20) | Sí |
| DESART | Descripción del artículo | C | No |
| CANTIDAD | Unidades | — | Sí, en el ejemplo |
| CODLOT · CADUCI · DIAS_CADUCIDAD | Lote, caducidad y días | C(20) · INT | No |
| ACON · DESCRIPCION_ACON | Requiere acondicionamiento (S/N) y detalle | C(1) · C(60) | Sí · No |
| VALOR_UNITARIO | Valor unitario | FLOAT | No |
CANTIDAD aparece en el ejemplo pero no en la tabla, ACON está repetido y la descripción de DESART no corresponde. La URL publicada es http y las credenciales viajan en el cuerpo: se revisa contra la política AD-PL-11 de Moore antes de producción.Cada una depende de una respuesta de Moore, Puig, PwC o Pharex. Mientras esté abierta, la pantalla que gobierna queda marcada como dependiente. Despliega cada fila para ver la respuesta y su efecto en el portal.
Siete principios de diseño, las siete restricciones duras de Affinity con lo que PwC confirmó en septiembre, y la matriz de permisos de los ocho perfiles. Nada del portal existe sin una de estas reglas detrás.
Lectura directa del tablero del proyecto. Este panel no es un reporte que alguien escribe: es el mismo dato que ve el equipo, con la hora del último sincronismo.
El diseño aprobado del portal, funcionando. Elige un perfil para entrar: cada uno tiene su propio menú. Los datos son de trabajo, la autenticación es simulada y el simulador de sistemas externos (N-16) provoca las respuestas de Affinity y Pharex.