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 /pedidoscon unidgenerado en el teléfono (ADR 0004) al guardar por primera vez; después,PUTcon 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_pedidonifecha_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 decat_motivos_cancelacion_pedido. Un borrador se borra, no se cancela. - Productos de la API de SIGFA con un
Diopropio y la variable opcionalSIGFA_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).localesnullsó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_URLla 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-clientesresponda, 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.