michangarrito/backups/docs-backup-2026-01-10/docs/01-epicas/MCH-007-templates-catalogos.md

MCH-007: Templates y Catalogos

Metadata

• Codigo: MCH-007
• Fase: 2 - Inteligencia
• Prioridad: P1
• Estado: Completado
• Fecha completado: 2026-01-10

Descripcion

Sistema de templates pre-cargados con productos de proveedores comunes en Mexico (Sabritas, Coca-Cola, Bimbo, etc.) organizados por giro de negocio para acelerar el setup inicial.

Objetivos

1. Catalogos de productos por proveedor
2. Templates por giro de negocio
3. Precios sugeridos actualizados
4. Imagenes de productos
5. Codigos de barras correctos

Alcance

Incluido

• Catalogo Sabritas/PepsiCo
• Catalogo Coca-Cola FEMSA
• Catalogo Bimbo/Marinela
• Catalogo Gamesa
• Catalogo productos genericos
• Giros: abarrotes, papeleria, farmacia, ferreteria

Excluido

• Integracion en tiempo real con mayoristas
• Precios automaticos (requiere acuerdo)
• Productos frescos/perecederos

Estructura de Templates

Por Proveedor

templates/
├── proveedores/
│   ├── sabritas/
│   │   ├── metadata.json
│   │   └── productos.json (150+ SKUs)
│   ├── coca-cola/
│   │   ├── metadata.json
│   │   └── productos.json (100+ SKUs)
│   ├── bimbo/
│   ├── marinela/
│   └── gamesa/
└── giros/
    ├── abarrotes.json
    ├── papeleria.json
    ├── farmacia.json
    └── ferreteria.json

Por Giro de Negocio

// giros/abarrotes.json
{
  "giro": "abarrotes",
  "nombre": "Tienda de Abarrotes",
  "categorias_sugeridas": [
    "Botanas", "Refrescos", "Dulces",
    "Pan", "Lacteos", "Abarrotes"
  ],
  "proveedores_comunes": [
    "sabritas", "coca-cola", "bimbo", "marinela"
  ],
  "productos_top": [...]
}

Modelo de Datos

Tablas

product_templates (global, sin tenant)

• id, provider, giro, category
• sku, name, description, barcode
• suggested_price, image_url
• metadata (JSONB), active

template_imports (por tenant)

• id, tenant_id, template_id
• imported_at, products_count

Endpoints API

Metodo	Endpoint	Descripcion
GET	/templates/giros	Listar giros
GET	/templates/giros/:giro	Productos de un giro
GET	/templates/providers	Listar proveedores
GET	/templates/providers/:provider	Productos de proveedor
POST	/templates/import	Importar template a tenant
GET	/templates/search	Buscar en templates

Flujos de Usuario

Seleccionar Template al Onboarding

1. Sistema detecta giro del negocio
2. Muestra templates sugeridos
3. Dueno selecciona proveedores
4. Productos se importan al catalogo
5. Dueno ajusta precios si necesario

Agregar Producto desde Template

1. Dueno busca producto en POS
2. No existe en su catalogo
3. Sistema busca en templates
4. Muestra "Coca-Cola 600ml - Agregar?"
5. Dueno confirma
6. Producto agregado con imagen y barcode

Datos de Templates

Sabritas (ejemplo)

SKU	Producto	Barcode	Precio Sugerido
SAB001	Sabritas Original 45g	7501011111111	$18
SAB002	Doritos Nacho 62g	7501011111112	$22
SAB003	Cheetos Flamin Hot 52g	7501011111113	$20
SAB004	Ruffles Queso 50g	7501011111114	$20

Coca-Cola (ejemplo)

SKU	Producto	Barcode	Precio Sugerido
CC001	Coca-Cola 600ml	7501055300000	$18
CC002	Coca-Cola 2L	7501055300001	$35
CC003	Sprite 600ml	7501055300002	$18
CC004	Fanta 600ml	7501055300003	$18

Entregables

Entregable	Estado	Archivo
templates.module	En progreso	modules/templates/
Seeds Sabritas	Pendiente	seeds/templates/sabritas.json
Seeds Coca-Cola	Pendiente	seeds/templates/coca-cola.json
Seeds Bimbo	Pendiente	seeds/templates/bimbo.json

Dependencias

Depende de

• MCH-003 (Productos)

Bloquea a

• MCH-006 (Onboarding)

Criterios de Aceptacion

• 500+ productos en templates
• Imagenes de alta calidad
• Barcodes correctos y verificados
• Precios actualizados (2026)
• Import rapido (<5 seg para 100 productos)

Actualizacion de Precios

• Frecuencia: Trimestral
• Fuente: Precios de lista de proveedores
• Nota: Son precios sugeridos, dueno puede ajustar

---

Ultima actualizacion: 2026-01-10