# Construye tu app de reportería comercial y de inventario con Puente OS

> Fuente: https://www.puente.xyz/recursos/guia-reporteria-comercial · Autor: Cris Ugarte, CEO de Puente OS · Actualizado: 2026-10-08
> Especificación para agentes de código: https://www.puente.xyz/recursos/guia-reporteria-comercial/spec.md

Esta guía enseña a un gerente de operaciones o de finanzas a construir con Puente OS una app con ventas, presupuesto, margen, cierre e inventario, actualizada cada noche. Nueve pasos, cada uno con un ejemplo y una prueba.

> Los pantallazos y animaciones vienen de una app demo construida en Puente OS siguiendo estos pasos, con datos ficticios de Empresa Demo SpA.

## En 1 minuto

La app de reportería comercial y de inventario reemplaza las hojas de cálculo que el equipo arma a mano: cada noche copia los datos del sistema de gestión y muestra venta, presupuesto, margen, cierre del mes y cobertura del stock.

- **Qué construyes:** una app web de siete pestañas con una carga de datos nocturna.
- **Para quién:** gerentes de operaciones, comerciales y de finanzas de empresas de comercio.
- **¿Hay que programar?** No necesitas programar. Tú defines las reglas; la construye el equipo de Puente en Puente OS, o tu agente de IA con la especificación.
- **Cuánto toma:** de 2 a 5 días, según cuántos pasos incluyas y cuántos sistemas conectes.
- **Cuánto cuesta:** el precio se define según tu operación.
- **Qué necesitas tener listo:** acceso a tu sistema de gestión, el presupuesto y las respuestas a las 11 preguntas de la guía.
- **Cómo empezar:** con un piloto de un mes junto al equipo de Puente.

Puente OS es la plataforma que construye los sistemas que operan tu negocio. Los ejemplos usan Empresa Demo SpA, una empresa ficticia con cifras inventadas.

## Qué vas a construir

**El problema.** En Empresa Demo SpA, cada analista cruza a mano la venta del sistema de gestión (el ERP, como SAP Business One, Defontana, Odoo o Softland) con el presupuesto, y cada uno calcula distinto.

**El resultado.** Una app que responde cinco preguntas:

1. ¿Cuánto vendimos contra el presupuesto y contra el año anterior?
2. ¿Cuánto margen y cuántas unidades dejó esa venta?
3. ¿Cómo va cada mes, semana, día y tienda?
4. ¿Para cuántos meses alcanza el inventario?
5. ¿Cómo cerramos el mes y a qué cliente visitamos primero?

La app abre en la pestaña Ventas, con el acumulado de 2026: $606,2 millones.

![Pestaña Ventas: ingreso neto $606,2 M, +19,9 % contra el año anterior, 28.377 unidades, margen 43,3 %](https://www.puente.xyz/recursos/guia-reporteria-comercial/ventas.webp)

*Figura: Fíjate en la línea de arriba a la derecha: dice hasta qué día llegan las cifras.*

**El mapa.** La información recorre tres etapas.

| Etapa | Flujo |
|---|---|
| **Cargar** | Sistema de gestión, contador de tráfico y hojas de cálculo → *Carga nocturna* (lee, ordena y guarda) → Tablas listas para consultar |
| ↓ *la app lee* | |
| **Ver** | App web: ventas, margen, resumen, cierre, inventario, seguimiento y documentos |
| ↓ *se envía* | |
| **Distribuir** | *Envío por correo* → informe para gerencia, tiendas y abastecimiento |

## Los bloques de Puente OS que usa esta guía

- **Apps.** Una app es una página web que tu equipo abre con un enlace, como un tablero siempre al día.
- **Tablas.** Una tabla es una lista de datos con columnas fijas, como una hoja de cálculo ordenada. Guardan la venta, el presupuesto y el stock.
- **Workflows.** Un workflow es una tarea que corre sola, como un analista que actualiza las cifras de madrugada.
- **Integraciones.** Una integración conecta Puente OS con otro sistema: el de gestión, el contador de personas de las tiendas o el correo, como Gmail.
- **Agentes.** Un agente es un asistente de IA que hace tareas con herramientas; quedan para una segunda etapa.

## Antes de empezar

Responde por escrito estas 11 preguntas. Cada respuesta fija una decisión.

| # | Pregunta | Qué decide |
|---|---|---|
| 1 | ¿Qué sistema guarda tus ventas, costos y stock? | De dónde lee la carga |
| 2 | ¿Cuáles son tus canales y tiendas? | Los nombres oficiales |
| 3 | ¿Qué ventas dejas fuera del reporte? | *Exclusiones* |
| 4 | ¿Tu presupuesto es mensual o diario? | *Presupuesto diario* |
| 5 | ¿Comparas con la misma fecha o con el mismo día de la semana? | *Año anterior* |
| 6 | ¿Para cuántos meses de venta quieres tener stock? | *Ventana de cobertura* |
| 7 | ¿Algún almacén abastece a varios canales? | *Almacenes compartidos* |
| 8 | ¿Qué documento respalda tu venta y qué impuesto lleva? | *Documento e impuesto* |
| 9 | ¿Qué cifra proyecta hoy alguien a mano? | *Captura manual* |
| 10 | ¿A qué hora nadie usa tu sistema de gestión? | *Hora de la carga* |
| 11 | ¿Tienes contador de personas en tus tiendas? | *Tráfico* |

### Por dónde empezar

Puntúa cada módulo del 1 al 5 según cuánto duele hoy y cuántos módulos necesita, y resta. Empieza por el mayor: en Empresa Demo SpA, ventas contra presupuesto saca 4 (5 − 1) e inventario, 1 (4 − 3). Una tienda usa los pasos 1 a 3; una cadena con mayoristas, los 9.

## Paso 1 · Ordena tus datos en tablas y cárgalos cada noche

**Qué resuelve.** Define las tablas de la app y la carga nocturna, el workflow que cada madrugada copia los datos del sistema de gestión.

**Un ejemplo con Empresa Demo SpA (datos ficticios).** Hoy es 15 de octubre de 2026 y la carga revisa del 15 de septiembre al 14 de octubre. Ayer, una tienda anuló una factura del 2 de septiembre: la carga relee desde esa fecha y septiembre queda igual que en el sistema de gestión.

**Las tablas.** Son 17: 6 universales (venta diaria, venta por producto, presupuesto mensual, stock actual, stock al cierre y nombres oficiales) y 11 opcionales.

**La receta de la carga nocturna.**

1. Fija el período a revisar: desde hace 30 días hasta ayer.
2. Busca documentos creados o anulados en ese período con fecha anterior. Si aparecen, amplía el período hasta el más antiguo, con un límite.
3. Lee ese período, quita las ventas excluidas y une los nombres escritos distinto («TDA NORTE» y «Tienda Norte»).
4. Compara con cada tabla: agrega lo que falta y borra lo que sobra.
5. Entrega un resumen de las filas que cambió.

**La regla.** La carga se amplía cuando el pasado cambió. El encabezado lo resume: «Carga nocturna: 15-oct-2026 03:00 · venta hasta el 14-oct».

**Por qué funciona así.** En la práctica, revisar 60 días tardó demasiado y se bajó a 30. Si un sistema falla y entrega cero filas, la tabla conserva lo que tenía.

**Cómo lo adaptas.** Decisiones *Ventana de la carga*, *Hora de la carga* y *Exclusiones*.

**Cómo sabes que quedó bien.** Un mes cerrado coincide exacto al peso con tu sistema de gestión. Septiembre de 2026 suma $63.360.715.

## Paso 2 · Compara tus ventas con el presupuesto y con el año anterior

**Qué resuelve.** La pestaña Ventas compara la venta con el presupuesto y el año anterior en cuatro tarjetas: ingreso, unidades, contribución y margen.

**Un ejemplo con Empresa Demo SpA (datos ficticios).** Al 15 de octubre de 2026, la empresa lleva vendidos $606,2 millones; el año anterior, a la misma fecha, $505,6 millones: +19,9 %. Contra todo 2025 ($697,9 millones) mostraría −13,1 %, una caída falsa. Contra el presupuesto anual de $799,4 millones va en −24,2 %. Las otras tarjetas muestran 28.377 unidades, $262,3 millones de contribución y margen de 43,3 %.

![Tarjetas: ingreso $606,2 M (+19,9 % y −24,2 %), 28.377 unidades, contribución $262,3 M, margen 43,3 %](https://www.puente.xyz/recursos/guia-reporteria-comercial/ventas.webp)

*Figura: Sin filtro de mes, el presupuesto es el del año completo.*

Al elegir octubre, todo usa el mismo período: $30,7 millones al día 14, +8,6 % contra octubre de 2025 cortado también al día 14.

![Filtro de mes de Año a Octubre: ingreso de $606,2 M a $30,7 M, +8,6 % contra el año anterior](https://www.puente.xyz/recursos/guia-reporteria-comercial/mes.gif)

*Figura: Venta, año anterior y presupuesto cambian juntos.*

El filtro de tiendas comparables deja las que vendían en los dos años. Sin la Tienda Sur, abierta en junio de 2025, la venta es $531,3 millones y la variación, +12,8 %.

![Filtro Comparables: ingreso $531,3 M, +12,8 % contra el año anterior](https://www.puente.xyz/recursos/guia-reporteria-comercial/sss.gif)

*Figura: La tienda nueva sale de la venta, del año anterior y del presupuesto a la vez.*

**La regla.** El año anterior se corta siempre en la misma fecha que el actual. Si falta la base de una comparación, la tarjeta muestra «--».

**Por qué funciona así.** Una sola regla decide el período de la venta, del año anterior y del presupuesto. Cuando cada gráfico lo calculaba aparte, uno miraba un día y otro siete.

**Cómo lo adaptas.** Decisión *Presupuesto con filtro de mes*: mes completo o hasta la fecha.

**Cómo sabes que quedó bien.** La tarjeta de ingreso muestra +19,9 % y −24,2 %. En 2025, sin presupuesto, muestra «--».

## Paso 3 · Mide el margen y las unidades

**Qué resuelve.** La pestaña Margen y unidades muestra el margen de cada categoría y producto. La contribución es venta neta menos costo; el margen, contribución dividida por venta.

**Un ejemplo con Empresa Demo SpA (datos ficticios).** En 2026, Calzado vendió $272,1 millones y contribuyó $105,1 millones: margen 38,6 %. Ahora, dos tiendas: la A vende $100 con margen 50 % y la B vende $900 con margen 20 %. El promedio simple da 35 %. El margen real suma las contribuciones: (50 + 180) ÷ 1.000 = 23 %.

Los diez que más contribuyen parten con Running de la Marca A ($24,6 millones, 38,4 %); los diez más vendidos, con Poleras de la Marca A (2.724 unidades).

![Diez que más contribuyen: 1. Running · Marca A, $24,6 M, 38,4 %. Diez más vendidos: 1. Poleras · Marca A, 2.724 unidades](https://www.puente.xyz/recursos/guia-reporteria-comercial/margen.webp)

*Figura: El color del margen marca de un vistazo qué producto deja poco.*

**La regla.** Todo porcentaje de un grupo se calcula desde sus sumas. Los porcentajes nunca se promedian.

**Por qué funciona así.** Un promedio de porcentajes pesa igual a una tienda chica y a una grande: en el ejemplo, infla el margen en 12 puntos. La lista de los diez sale de una tabla liviana; si ignora algún filtro, la pantalla lo dice.

**Cómo lo adaptas.** Elige el largo del ranking y los colores; la demo usa rojo bajo 35 %, ámbar hasta 45 % y verde desde 45 %.

**Cómo sabes que quedó bien.** La contribución de las tres categorías suma $105,1 + $99,2 + $58,0 = $262,3 millones, la cifra de la tarjeta.

## Paso 4 · Resume la venta por mes, semana, día y tienda

**Qué resuelve.** La pestaña Resumen entrega una matriz por períodos o por tiendas con venta, ticket promedio, unidades por boleta y conversión.

**Un ejemplo con Empresa Demo SpA (datos ficticios).** De enero a octubre de 2026, la Tienda Norte vendió $137,3 millones (+9,9 %) con 4.273 boletas y 6.426 unidades. El ticket promedio es venta ÷ boletas: $32.132. Las unidades por boleta (UPT) son 1,5. Entraron 20.197 personas, así que la conversión, boletas ÷ entradas, es 21,2 %.

![Matriz por tienda, enero a octubre 2026: Tienda Norte $137,3 M, +9,9 %, ticket $32.132, conversión 21,2 %; Sitio web sin conversión](https://www.puente.xyz/recursos/guia-reporteria-comercial/resumen.gif)

*Figura: El sitio web muestra conversión «--» porque no tiene contador de personas.*

**La regla.** Cada indicador usa las mismas tiendas y meses arriba y abajo de la división. La conversión existe solo por mes, porque el contador entrega meses. Al filtrar por categoría, marca o vendedor, los indicadores por boleta se apagan.

**Por qué funciona así.** En comercio pesa el día de la semana: por semana y por día, el año anterior usa el día equivalente, la fecha menos 364 días. El miércoles 14 de octubre de 2026 se compara con el miércoles 15 de octubre de 2025. Por la misma razón, la app usa el presupuesto diario del equipo cuando existe.

**Cómo lo adaptas.** Decisiones *Año anterior*, *Presupuesto diario* y *Tráfico*.

**Cómo sabes que quedó bien.** La Tienda Norte muestra ticket $32.132 y conversión 21,2 %. Las filas por mes suman $606,2 millones.

## Paso 5 · Revisa el cierre del mes con su cobertura de stock

**Qué resuelve.** La pestaña Cierre muestra el mes cerrado por canal: meta (el presupuesto del mes), venta, stock y cobertura. Los meses de inventario (MOI) miden cuántos meses cubre el stock según lo vendido; los de stock (MOS), según lo presupuestado.

**Un ejemplo con Empresa Demo SpA (datos ficticios).** En septiembre de 2026, Tiendas propias tenía meta de $34,1 millones y vendió $34,8 millones: +1,9 %. Su stock valía $90,3 millones a costo y el costo de lo vendido fue $18,7 millones: MOI = 4,8. El costo presupuestado de octubre a diciembre promedia $23,0 millones al mes: MOS = 3,9.

![Cierre de septiembre 2026: Tiendas propias meta $34,1 M, venta $34,8 M, +1,9 %, stock $90,3 M, MOI 4,8, MOS 3,9](https://www.puente.xyz/recursos/guia-reporteria-comercial/cierre.gif)

*Figura: Al pasar de julio a septiembre, todo se recalcula con el stock al cierre de ese mes.*

**La regla.** MOI = stock al cierre ÷ costo de venta del mes. MOS = stock ÷ costo presupuestado promedio de los 3 meses siguientes; en diciembre queda vacío. Colores: bajo 1, rojo; bajo 3, ámbar; 3 o más, verde.

**Por qué funciona así.** El stock de cada cierre queda guardado como una foto: septiembre usa el stock del 30 de septiembre. El stock sin canal sigue sumando en el total de la empresa.

**Cómo lo adaptas.** Decisión *Ventana de cobertura* y los cortes de color.

**Cómo sabes que quedó bien.** Calcula a mano el MOI de un canal con tu sistema de gestión. Tiendas propias da 4,8 en septiembre.

## Paso 6 · Mide para cuántos meses alcanza tu inventario

**Qué resuelve.** La pestaña Inventario muestra el stock de hoy por categoría, marca y producto, con su MOI, su MOS y las unidades de cada almacén.

**Un ejemplo con Empresa Demo SpA (datos ficticios).** Calzado tiene 3.829 unidades, $110,9 millones a costo. Su costo de venta de julio a septiembre promedia $19,0 millones al mes: MOI = 5,8. El presupuestado de noviembre y diciembre, $24,2 millones: MOS = 4,6.

Un almacén compartido abastece a varios canales. Si tiene $600.000 de stock y el Canal A vende tres veces lo del B, al A le tocan $450.000 y al B, $150.000. Sin reparto, el MOI del B saldría cuatro veces más alto.

![Árbol de inventario: Calzado 3.829 unidades, $110,9 M, MOI 5,8, MOS 4,6; Marca A abierta con 4 productos](https://www.puente.xyz/recursos/guia-reporteria-comercial/arbol.gif)

*Figura: Al abrir la Marca A aparecen sus 4 productos: la app los pide recién en ese momento.*

SKU-1003 tiene 506 unidades: 426 en la bodega central y 32, 29 y 19 en las tiendas.

![Stock por almacén de SKU-1003 Urbano A Base: Bodega central 426, Tienda Norte 32, Tienda Centro 29, Tienda Sur 19 unidades](https://www.puente.xyz/recursos/guia-reporteria-comercial/inventario.webp)

*Figura: Los cuatro almacenes suman las 506 unidades del árbol.*

**La regla.** La pantalla muestra el stock completo de cada almacén. Al filtrar por canal, el MOI y el MOS usan solo la parte del almacén compartido que le toca a ese canal.

**Por qué funciona así.** El árbol carga primero unas 600 filas resumidas, en unos 2 segundos, y pide los productos al abrir una rama.

**Cómo lo adaptas.** Decisión *Almacenes compartidos*: reparto por costo de venta, unidades o presupuesto.

**Cómo sabes que quedó bien.** El valor a costo de las tres categorías suma $168,6 millones, igual a tu sistema de gestión.

## Paso 7 · Proyecta el cierre del mes y elige a qué cliente visitar

**Qué resuelve.** La pestaña Seguimiento proyecta el cierre del mes por canal y ordena a los clientes mayoristas por cuánto falta venderles.

**Un ejemplo con Empresa Demo SpA (datos ficticios).** Mayorista tiene meta de octubre de $19,3 millones. Al día 14 lleva $8,7 millones vendidos y $9,8 millones en pedidos abiertos. La gerente teclea un Empuje de $4.500.000, lo que estima vender además. Cierre proyectado: 8,7 + 9,8 + 4,5 = $23,0 millones, 119,1 % de la meta.

![Octubre por canal: Mayorista con meta $19,3 M, real $8,7 M, pedidos $9,8 M, Empuje 4.500.000, cierre $23,0 M, 119,1 %](https://www.puente.xyz/recursos/guia-reporteria-comercial/empuje.gif)

*Figura: Al teclear el Empuje, el cierre y el cumplimiento se recalculan.*

El Cliente B, con la Marca A, tiene meta acumulada a octubre de $43,1 millones (anual, $51,8 millones) y vendió $32,7 millones: le faltan $10,4 millones, la mayor brecha de su marca. Su cumplimiento es 84,2 %. Con otro Empuje de 1.500.000 en E-commerce, octubre proyecta $48,7 millones, 72,7 %.

![Lista mayorista: Cliente B · Marca A, meta $51,8 M, real $32,7 M, 84,2 %, falta $10,4 M, prioridad 1. Total de octubre $48,7 M, 72,7 %](https://www.puente.xyz/recursos/guia-reporteria-comercial/seguimiento.webp)

*Figura: La prioridad ordena dentro de cada marca: primero el cliente al que más le falta.*

**La regla.** Cierre proyectado = venta del mes + pedidos abiertos + Empuje. Cuánto venderle = meta acumulada menos la venta de los meses cerrados, con mínimo cero.

**Por qué funciona así.** La pestaña replica, fórmula por fórmula, la hoja que el equipo ya usa. Guardar un Empuje reemplaza el anterior.

**Cómo lo adaptas.** Decisiones *Captura manual* y *Meta mensual*.

**Cómo sabes que quedó bien.** Teclea 4.500.000 en Mayorista: el cumplimiento llega a 119,1 %. Recarga la página y el valor sigue ahí.

## Paso 8 · Busca cualquier boleta o factura por su folio

**Qué resuelve.** La pestaña Documentos busca una boleta o factura por su folio, el número impreso, y muestra cada línea con precio, descuento y margen.

**Un ejemplo con Empresa Demo SpA (datos ficticios).** El folio 4821, del 14 de octubre, tiene 2 mochilas con precio de lista de $23.800 con IVA. La venta neta, sin IVA, es $17.000 y el costo, $12.000. Con IVA de 19 %, el cliente pagó $20.230. Descuento: 23.800 − 20.230 = $3.570, o 15,0 %. Margen: 5.000 ÷ 17.000 = 29,4 %.

![Búsqueda del folio 4821: SKU-1037 Mochilas A Base, 2 unidades, lista $23.800, venta neta $17.000](https://www.puente.xyz/recursos/guia-reporteria-comercial/folio.gif)

*Figura: Al completar el número, la app busca el folio exacto.*

![Folio 4821 del 14 de octubre: lista $23.800, venta neta $17.000, descuento $3.570 (15,0 %), margen 29,4 %](https://www.puente.xyz/recursos/guia-reporteria-comercial/documentos.webp)

*Figura: El descuento compara precios con IVA en los dos lados.*

**La regla.** Una búsqueda de solo dígitos busca el folio exacto; otro texto busca por nombre o código de producto. Un folio inexistente muestra un mensaje claro.

**Por qué funciona así.** La carga nocturna deja calculados la lista total y el margen de cada línea: la búsqueda responde al instante. En la práctica, ningún código de producto tenía solo dígitos; confírmalo en tu catálogo.

**Cómo lo adaptas.** Decisión *Documento e impuesto*, y qué canales entran.

**Cómo sabes que quedó bien.** El folio 4821 muestra descuento de $3.570 y margen de 29,4 %. Una boleta tuya coincide con el papel.

## Paso 9 · Descarga la información en una hoja de cálculo que cuadra

**Qué resuelve.** El botón Descargar CSV, al pie de la pestaña Ventas, entrega los datos en un archivo que abre cualquier hoja de cálculo.

**Un ejemplo con Empresa Demo SpA (datos ficticios).** La descarga de 2026 trae 900 filas. Antes de entregarla, la app compara la venta del archivo, $606.245.052, con la pantalla. Cuadra, y la app confirma: «Descargadas 900 filas · venta $606.245.052 · cuadra con la pantalla». Con más de un peso de diferencia, la descarga se detiene y la app lo advierte.

**La regla.** Cada fila es un registro, sin subtotales ni porcentajes. La primera fila trae los encabezados. Los números usan coma decimal y las tildes se leen bien.

**Por qué funciona así.**
- Una tabla dinámica suma mal los subtotales y porcentajes, y las filas de título la rompen.
- Un archivo con un error destruye la confianza en todo el reporte. El control de cuadre lo detiene antes.

**Cómo lo adaptas.** Elige el separador y el máximo de filas. Sugerencia sin probar: un workflow que envíe el informe cada lunes por correo, por ejemplo con Gmail.

**Cómo sabes que quedó bien.** En una tabla dinámica, la venta suma $606.245.052.

## Adáptalo a tu empresa

Las decisiones de la guía, con sus opciones.

| Decisión | Opciones | Cuándo elegir cada una |
|---|---|---|
| Ventana de la carga | 7, 30 o 60 días | Más días si hay muchas anulaciones |
| Hora de la carga | Cualquier hora | Cuando nadie usa el sistema |
| Año anterior | Día equivalente o misma fecha | Día equivalente si pesa el día de la semana |
| Presupuesto con filtro de mes | Mes completo o hasta la fecha | Mes completo para ver cuánto falta |
| Presupuesto diario | Curva propia o reparto parejo | Curva si la tienes |
| Ventana de cobertura | 3, 6 o 12 meses | 3 para temporada corta (sugerencia sin probar) |
| Almacenes compartidos | Por costo de venta, unidades o presupuesto | Tu dato más confiable |
| Exclusiones | Arriendos, activos fijos, ventas internas | Lo que finanzas deja fuera |
| Captura manual | Un valor o historial | Historial para auditar |
| Meta mensual | Anual ÷ 12 o mes a mes | Mes a mes si hay temporadas |
| Tráfico | Con o sin contador | Según tus tiendas |
| Documento e impuesto | Boleta, factura o CFDI | El que respalda tu venta |

## Cómo sabes que tu app quedó bien

- [ ] Septiembre de 2026 suma $63.360.715, exacto al peso.
- [ ] La tarjeta de ingreso muestra +19,9 % contra el año anterior, nunca −13,1 %.
- [ ] Un año sin presupuesto muestra «--».
- [ ] La contribución de las categorías suma $262,3 millones.
- [ ] La Tienda Norte muestra ticket $32.132 y conversión 21,2 %.
- [ ] Tiendas propias cierra septiembre con MOI 4,8 y MOS 3,9.
- [ ] El inventario suma $168,6 millones a costo.
- [ ] Un Empuje de 4.500.000 lleva a Mayorista a 119,1 % y sigue ahí al recargar.
- [ ] El folio 4821 muestra margen de 29,4 %.
- [ ] La descarga suma $606.245.052.

## Preguntas frecuentes

### ¿Para quién es esta guía?
Para gerentes de operaciones, comerciales y de finanzas que arman sus reportes a mano, desde una tienda hasta una cadena.

### ¿Necesito saber programar?
No necesitas programar. Defines las reglas con las 11 preguntas; la app la construye el equipo de Puente en Puente OS, o tu agente de IA con la especificación.

### ¿Cuánto toma construirla?
De 2 a 5 días, según cuántos pasos incluyas y cuántos sistemas conectes.

### ¿Cuánto cuesta?
El precio se define según tu operación.

### ¿Funciona con mi sistema de gestión?
Sí, si permite leer ventas, costos y stock, como SAP Business One, Defontana, Odoo o Softland.

### ¿Sirve en Perú o México?
Sí. Cambian el documento y el impuesto: IGV de 18 % en Perú; CFDI con IVA de 16 % en México.

## Usa esta guía con tu agente de IA

Para tu asistente de IA hay dos versiones: la [guía en texto](https://www.puente.xyz/recursos/guia-reporteria-comercial/guia.md), para resumir, y la [especificación](https://www.puente.xyz/recursos/guia-reporteria-comercial/spec.md), con tablas, reglas, pruebas y datos de ejemplo.

**¿Quieres un resumen?** Pega esto en ChatGPT, Claude, Perplexity o Gemini:

```text
Lee https://www.puente.xyz/recursos/guia-reporteria-comercial/guia.md y resúmeme, para un gerente de operaciones, qué app construiría, qué necesito tener listo, cuánto toma y por dónde empiezo.
```

**¿Quieres que un agente de código la construya contigo?** Crea una carpeta vacía, abre ahí Claude Code, Codex o Cursor, y pega esto:

```text
Quiero construir para mi empresa la app de la guía «Construye tu app de reportería comercial y de inventario con Puente OS».

1. Descarga la especificación completa y guárdala sin resumir:
   curl -sL https://www.puente.xyz/recursos/guia-reporteria-comercial/spec.md -o SPEC.md
2. Lee SPEC.md completo. Antes de planificar, hazme las preguntas de la sección 9, una por vez, y guarda mis respuestas en DECISIONES.md. Si no sé alguna, usa el valor por defecto de la sección 8.
3. Escribe PLAN.md siguiendo el orden de la sección 5 y espera mi aprobación.
4. Construye una tarea a la vez. Al cerrar cada una, corre sus criterios de aceptación con los datos de ejemplo de la sección 7 y muéstrame el resultado. Avanza cuando todos pasen.
5. Escribe la lógica general: los datos de ejemplo sirven para probar.
6. Explícame cada paso en lenguaje simple, para alguien de operaciones o finanzas.
```

**¿Usas v0, Lovable o Bolt?** Adjunta la especificación y pega esto:

```text
Adjunto SPEC.md, la especificación de una app de reportería comercial.
Construye solo las tareas T-01 y T-03: las tablas y la vista Ventas, con los datos de ejemplo de la sección 7.
Cuando termines, dime qué muestra la tarjeta de ingreso contra el año anterior: debe ser +19,9 % (criterio CA-05).
Antes de construir, hazme las preguntas que necesites.
```

## Glosario

- **Sistema de gestión (ERP):** el software donde registras ventas, compras y stock.
- **Venta neta:** la venta sin impuesto. La contribución es venta neta menos costo; el margen, contribución dividida por venta neta.
- **Boleta:** comprobante de venta al consumidor; en México, ticket o CFDI.
- **MOI y MOS:** meses que cubre el stock según la venta reciente (MOI) o la presupuestada (MOS).
- **Almacén compartido:** abastece a varios canales; en Chile, bodega.

## Siguiente paso

Esta guía muestra cómo construir una app de reportería comercial y de inventario para gerentes de operaciones y finanzas. Para hacerla con el equipo de Puente, empieza con un piloto de un mes: conectamos tu sistema de gestión, cargamos tus datos y dejamos funcionando los primeros pasos. Agenda una conversación en [www.puente.xyz](https://www.puente.xyz).
