Saltar a contenido

0013. Toma de pedidos: borrador en el servidor con id del teléfono y precio escrito a mano

Estado: Propuesto Fecha: 2026-11-02 Autor: David Garcia Módulo(s) afectado(s): modules/pedidos/, core/network/, core/config/

Contexto

Fuerza de ventas modela la preventa: BORRADOR → CONFIRMADO y CANCELADO sólo desde confirmado. El id lo puede enviar la app, el PUT reemplaza todas las líneas y el servidor calcula los montos sin validar el precio (ADR 0039, 0041 y 0043 de fuerza de ventas). Al crear y editar el borrador, fuerza de ventas valida cliente y local contra crm-svc-clientes y copia su nombre en destino: 400 si no existen, están borrados o el local es de otro cliente; 503 si clientes no responde, sin escribir nada (ADR 0066 de fuerza de ventas, propuesto). Los productos salen de la API de SIGFA, que la web usa como prueba interna y opcional: busca productos pedibles por SKU o descripción y el precio se escribe a mano, porque las sucursales no usan listas de precios. Su /precios/cotizar pide códigos de SIGFA (co_sucursal, co_empresa), no los ids de la plataforma.

Decisión

  • Un pedido nace de un cliente de la cartera, desde la visita en curso (lleva visita_id) o desde la ficha del cliente.
  • El borrador vive en el servidor: POST /pedidos con un id generado en el teléfono (ADR 0004) al guardar por primera vez; después, PUT con todas las líneas. Un reintento con los mismos datos responde 200.
  • Confirmar y cancelar toman el momento al tocar el botón, pero con conexión no envían fecha_pedido ni fecha_cancelacion: la hora la pone el servidor y un reenvío sin hora responde 200 en vez de 409 (ADR 0004; ADR 0043 de fuerza de ventas). Cancelar pide un motivo de cat_motivos_cancelacion_pedido. Un borrador se borra, no se cancela.
  • Productos de la API de SIGFA con un Dio propio y la variable opcional SIGFA_API_URL (ADR 0005): búsqueda por SKU o descripción desde 2 caracteres, sólo pedibles. La línea copia código, descripción, unidad, factor e impuesto del producto.
  • Precio escrito a mano, como en la web. La app muestra un total estimado mientras se edita; el que vale es el del servidor, que se muestra al guardar.
  • Los decimales viajan como texto y se calculan con un tipo decimal, nunca con double (ADR 0006).
  • El pedido se nombra con su destino, en el detalle y en la bandeja, como la visita (ADR 0011). local es null sólo si no hay local de entrega.
  • Un 503 al guardar es reintentable: la app conserva lo cargado en la pantalla y ofrece reintentar con el mismo id; un 400 se muestra como rechazo con su motivo.
  • Sin SIGFA_API_URL la pestaña Pedidos sólo lista y no ofrece tomar pedidos.

Alternativas descartadas

  • Borrador sólo en el teléfono hasta confirmar — se pierde si se borra la app y la web no ve lo que el promotor está armando; vuelve con el modo sin conexión.
  • Usar /precios/cotizar — exige códigos de SIGFA que la plataforma no tiene; se retoma cuando exista la correspondencia o la tarificación.
  • Calcular los montos en la app como fuente de verdad — duplica reglas del servidor.

Consecuencias

  • Sin señal no se toman pedidos en la primera versión (ADR 0004).
  • Guardar un borrador depende de que crm-svc-clientes responda, además de fuerza de ventas.
  • Sucursal, canal, término de pago y moneda son obligatorios en el alta: de dónde salen por defecto (el cliente, la sesión) se fija con el primer formulario, igual que en la web.
  • Cuando la API de productos deje de ser una prueba, se revisa este ADR.

Media página como máximo. Si el ADR crece más que eso, probablemente estás documentando el diseño completo del módulo, no una decisión puntual — separa.