Arquitectura API-First y Sincronización Omnicanal (CAANMA ERP)
La plataforma web de PETQRO opera bajo un esquema desacoplado y orientado a eventos, permitiendo mantener actualizado el stock de cada una de las sucursales físicas de Querétaro en tiempo real (con un retraso máximo de 5 minutos) y sincronizando los pedidos web directamente al sistema de facturación y almacén del ERP CAANMA.
CAANMA ERP
Servidor Local / VPNBase de datos del negocio (Productos, Ventas, Inventario por sucursal, Clientes, Facturación)
API Gateway & NestJS
Node.js / AWS ECSFiltro de seguridad, cache de consultas, enrutador de colas (RabbitMQ / SQS) para resiliencia ante caídas del ERP
Next.js Frontend & DB
Vercel / PostgreSQL AWS RDSE-commerce ultra veloz, SSR para SEO local, base de datos local replicada para soportar alto tráfico
Sitemap Completo & SEO Mapping
Estructura de URLs optimizada para el rastreo de buscadores y la conversión de usuarios.
-
/ (Home Page) [KW: tienda de mascotas querétaro]
-
/perros [KW: alimento para perros querétaro]
- /perros/alimento-seco
- /perros/premios-y-huesos
- /perros/juguetes
-
/gatos [KW: alimento para gatos querétaro]
- /gatos/alimento
- /gatos/arenas
- /farmacia-mascotas [KW: farmacia mascotas querétaro, medicamentos mascotas]
-
/servicios [KW: estética canina querétaro]
- /servicios/estetica
- /servicios/banos-y-cortes
- /sucursales [KW: tiendas de mascotas la pradera, cerrito colorado queretaro]
- /blog [Guías y consejos, posicionamiento orgánico]
-
/perros [KW: alimento para perros querétaro]
Simulador de Endpoints API (CAANMA ERP WEB)
Haz clic en cualquiera de las consultas API simuladas para ver el payload real JSON que viaja entre el E-commerce y el ERP de PETQRO.
{
"endpoint": "/api/v1/erp/stock/PQ-DOG-ORG-12",
"status": 200,
"timestamp": "2026-06-09T16:50:00Z",
"data": {
"sku": "PQ-DOG-ORG-12",
"product_name": "Alimento Orgánico Premium Perro Adulto",
"price_public": 980.00,
"price_subscription": 882.00,
"global_stock": 20,
"branches": [
{ "branch_id": "PRA-01", "name": "La Pradera", "stock": 12, "shelf_location": "Ais-4-B" },
{ "branch_id": "COL-02", "name": "Cerrito Colorado", "stock": 8, "shelf_location": "Ais-2-A" }
]
}
}
Configuración de Credenciales de Integración CAANMA ERP
Introduce las credenciales seguras proporcionadas por el administrador de CAANMA para habilitar la sincronización omnicanal automática de catálogos, sucursales, productos, precios y existencias.
Conectando con CAANMA ERP...
Iniciando negociación con token de seguridad...
Esquema de Base de Datos PostgreSQL (Omnicanal)
Diseño de base de datos relacional para soportar perfiles de mascotas, compras recurrentes, inventario multi-sucursal y puntos acumulados.
users
Datos de Clientes- id UUID (PK) - Identificador único de usuario
- email VARCHAR(150) (Unique) - Correo electrónico de inicio de sesión
- password_hash VARCHAR(255) - Clave encriptada
- first_name VARCHAR(80) - Nombre del cliente
- last_name VARCHAR(80) - Apellido del cliente
- whatsapp_phone VARCHAR(20) - Celular para notificaciones
- erp_customer_id VARCHAR(50) (Nullable) - ID mapeado en ERP CAANMA
- subscription_status BOOLEAN (Default FALSE) - Estatus de auto-envío
- created_at TIMESTAMP - Fecha de registro
pets
Perfil de Mascotas- id UUID (PK) - Identificador de mascota
- user_id UUID (FK -> users.id) - Dueño de la mascota
- name VARCHAR(50) - Nombre de la mascota
- species VARCHAR(20) - Especie (dog, cat, bird, etc.)
- breed VARCHAR(60) - Raza
- birth_date DATE (Nullable) - Nacimiento para recompensas anuales
- age_stage VARCHAR(20) - Cachorro, Adulto, Senior
- weight_kg DECIMAL(5,2) - Peso actual para dosificación
- special_needs TEXT (Nullable) - Alergias o condiciones médicas
products
Catálogo Sincronizado- id UUID (PK) - ID de producto web
- sku VARCHAR(50) (Unique) - SKU sincronizado con CAANMA ERP
- name VARCHAR(150) - Nombre comercial
- brand VARCHAR(80) - Marca (Royal Canin, Hill's, Pro Plan, etc.)
- category VARCHAR(50) - Alimento, farmacia, higiene, etc.
- erp_price_public DECIMAL(10,2) - Precio público general sincronizado de CAANMA
- erp_price_subscription DECIMAL(10,2) - Precio de suscripción (Auto-envío) sincronizado de CAANMA
- is_recurring_allowed BOOLEAN - Apto para compra recurrente
- life_stage VARCHAR(20) - Etapa recomendada
- image_url VARCHAR(255) - Enlace a imagen del producto
- ingredients TEXT - Lista de ingredientes
- nutritional_facts JSONB - Datos nutricionales en JSON
branch_inventory
Inventario Multi-Sucursal- id UUID (PK) - Identificador único de stock
- product_id UUID (FK -> products.id) - Producto
- branch_name VARCHAR(50) - La Pradera, Cerrito Colorado
- stock_quantity INT - Unidades disponibles en físico
- shelf_location VARCHAR(30) - Ubicación física en pasillo de tienda
- last_synced_at TIMESTAMP - Fecha del último reporte de stock
recurring_subscriptions
Auto-Envío Recurrente- id UUID (PK) - ID de suscripción de recompra
- user_id UUID (FK -> users.id) - Cliente suscrito
- product_id UUID (FK -> products.id) - Producto programado
- frequency_weeks INT - Intervalo de entrega (2, 4, 6 u 8 semanas)
- quantity INT - Cantidad de sacos/artículos por entrega
- next_delivery_date DATE - Fecha programada de siguiente orden
- payment_token VARCHAR(255) - Tokenizado seguro de Mercado Pago
- status VARCHAR(20) - Active, Paused, Cancelled
orders
Registro de Pedidos- id UUID (PK) - ID de orden web
- user_id UUID (FK -> users.id) - Comprador
- erp_order_id VARCHAR(50) (Nullable) - ID mapeado tras sincronizar en CAANMA
- delivery_type VARCHAR(20) - 'home' (envío) o 'collect' (retiro en tienda)
- pickup_branch VARCHAR(50) (Nullable) - Sucursal seleccionada para retiro
- subtotal DECIMAL(10,2) - Subtotal de productos
- discount_amount DECIMAL(10,2) - Descuentos aplicados
- total_amount DECIMAL(10,2) - Total pagado
- payment_gateway VARCHAR(30) - mercado_pago
- is_subscription_order BOOLEAN - Si fue compra recurrente
- erp_sync_status VARCHAR(20) - Pending, Success, Failed
- created_at TIMESTAMP - Fecha del pedido
Estrategia SEO Local en Querétaro
PETQRO competirá con grandes cadenas multinacionales (Petco, Chewy) enfocándose al 100% en el SEO Local y búsquedas con intención geográfica específicas en el estado de Querétaro.
| Palabra Clave Objetivo (KW) | Volumen Mensual Est. | Dificultad (KD) | Estrategia de Optimización en la Plataforma |
|---|---|---|---|
| tienda de mascotas querétaro | 8,100 | Media-Baja | Optimización de la Home con marcado de esquema LocalBusiness de Schema.org. Meta títulos y descripciones enfocados en Querétaro. |
| alimento para perros querétaro | 3,200 | Baja | Páginas de categoría dedicadas con textos optimizados mencionando envío express en Juriquilla, El Refugio, Centro y Álamos. |
| estética canina querétaro | 2,400 | Baja | Página de servicios de estética con mapa integrado de sucursales, horarios, WhatsApp y la herramienta de citas integrada. |
| veterinaria querétaro | 4,500 | Media-Baja | Landing pages por sucursal física de PETQRO con fichas de Google Business Profile enlazadas directamente. |
3 Tácticas Clave para SEO Local:
- Integración con Google Business Profile (GBP): Cada sucursal física de PETQRO tendrá su landing page exclusiva (ej. `/sucursales/juriquilla`) con las reseñas del local embebidas en vivo, fotos actualizadas del inventario físico y la ubicación exacta.
- Contenido de Blog Técnico y Clínico: Creación de artículos veterinarios dirigidos a problemas comunes en Querétaro (ej. "Cómo proteger a tu mascota del calor en Querétaro", "Vacunas obligatorias para perros en el estado de Qro."). Esto genera autoridad e indexación.
- Marcado de Datos Estructurados (Schema Markup): Utilizar código JSON-LD en las fichas de productos para mostrar a Google los precios actualizados en pesos mexicanos y, sobre todo, la disponibilidad física del stock en Querétaro, atrayendo clics de usuarios listos para comprar.
Estrategia de Precios Diferenciados (Público vs Suscripción)
Para incentivar la recompra sin la complejidad de un programa de puntos, PETQRO adopta un modelo de doble precio para todos los productos en catálogo.
Precio Público
Es el precio estándar para compras únicas o esporádicas en web o en sucursales físicas (La Pradera o Cerrito Colorado).
Precio Suscripción
Ahorro del 10% fijo aplicado automáticamente en todos los artículos al activar la entrega recurrente programada.
Fácil Adhesión
El cliente se suscribe en un clic, elige frecuencia de entrega, y cancela o modifica el pedido cuando lo necesite sin penalización.
Beneficios del Modelo de Doble Precio:
- Aumento del CLV (Customer Lifetime Value): Asegura que los dueños de mascotas compren su alimento en PETQRO periódicamente.
- Predicción de Inventario: Al saber cuántas suscripciones están activas para el mes, el ERP CAANMA optimiza las órdenes de compra a proveedores.
- Fidelidad Emocional: Ahorrar dinero directamente en el ticket de compra genera más satisfacción inmediata que acumular puntos abstractos.
Estrategia de Recompra Automática (Compra Recurrente / Auto-Envío)
El 70% del gasto recurrente en mascotas es predecible (alimentos, arena, preventivos). Diseñamos un flujo enfocado en simplificar el reabastecimiento.
Suscripción en Ficha
El cliente activa "Compra Recurrente" con un solo clic en la página del producto y selecciona la frecuencia (cada 2, 4, 6 u 8 semanas).
Procesamiento Automático
El sistema agenda la orden futura y el procesador de pagos (Mercado Pago) realiza el cargo tokenizado seguro el día correspondiente.
Sincronización ERP
La orden ingresa al ERP CAANMA como pedido prioritario, se reserva el stock de la sucursal más cercana y se despacha a la dirección del usuario.
Estrategias de Incentivo a la Suscripción (CRO):
- Ahorro Garantizado: 10% de descuento adicional en el precio de lista para todos los pedidos de suscripción recurrentes.
- Notificación Preventiva vía WhatsApp: 3 días antes de procesar el pedido, el bot de PETQRO envía un mensaje diciendo: "Hola Juan, tu saco de alimento se agendará pronto. ¿Deseas agregar algún juguete, adelantar o posponer la entrega?". Esto reduce fricción y evita reclamaciones.
- Modificación en un Clic: Desde el perfil del cliente, se puede pausar temporalmente, acelerar el pedido (si su mascota comió más rápido) o cambiar la marca del alimento sin cargos adicionales.
Plan de Implementación en Fases
Desglose de fases para un despliegue seguro, minimizando el riesgo de caídas de inventario o descuadres en la facturación del ERP.
Planificación e Infraestructura
Mes 1- Levantamiento de modelos de datos exactos en PostgreSQL.
- Despliegue del Middleware NestJS en AWS y configuración de la VPN segura con el ERP CAANMA local.
- Creación de los ambientes de desarrollo y sandbox para pagos.
Desarrollo del E-commerce & Integración Core
Mes 2 - 3- Programación del Frontend interactivo en Next.js con el sistema de diseño premium.
- Conexión de las APIs de sincronización de inventario de 5 min.
- Integración de la pasarela de pagos (Mercado Pago).
- Desarrollo del módulo de Click & Collect multi-sucursal.
Fidelización, Auto-Envío & Pruebas Beta
Mes 4- Habilitación del registro de mascotas y cálculo de puntos del Club.
- Implementación del servicio de Compra Recurrente con tokenización de cobro automático.
- Integración del chatbot de WhatsApp Business API para alertas de pedidos.
- Pruebas con usuarios seleccionados en Querétaro (Friends & Family).
Lanzamiento & Optimización SEO/CRO
Mes 5+- Lanzamiento comercial público y campañas de marketing local.
- Monitoreo de carga rápida y auditorías de Lighthouse SEO.
- Análisis de embudo de compra (carritos abandonados) para mejoras de conversión.
Dashboard de Métricas E-commerce (KPIs de Conversión)
Métricas clave para la toma de decisiones del Director de E-commerce y el especialista en CRO. (Datos simulados basados en objetivos PETQRO).
Objetivo mensual: $400,000 MXN
Impulsado por el Auto-Envío
Promedio de la industria: 1.8%
Recuperados por WhatsApp: 18%
Participación de Ventas por Sucursal (Click & Collect)
Visualiza qué sucursal de Querétaro tiene mayor flujo de retiros omnicanal.
Productos Más Vendidos (Top Semanal)
Los productos con mayor rotación en la base de datos sincronizada.
-
1120 Unidades $105,960 MXN
-
284 Unidades $52,080 MXN
-
365 Unidades $20,800 MXN
-
448 Unidades $6,720 MXN
Panel de Configuración Web PETQRO (Control Local)
Modifica de manera manual los textos principales de la tienda, datos de contacto, enlaces de redes sociales y montos de envío. Los cambios se guardarán localmente en el navegador de manera inmediata.
Importar Catálogo Manual (CAANMA JSON)
Si no tienes habilitado el middleware de producción con CAANMA ERP, puedes pegar tu catálogo real en formato JSON para que el prototipo lo cargue inmediatamente y actualice las categorías y tarjetas de la tienda.
Estado de Configuración
Ayuda de Parámetros
WhatsApp de Soporte: Este número se utilizará para enlazar el bot de confirmación rápida y los enlaces del chat interactivo.
Envío Gratis: Modificar este valor actualizará el motor de cálculo del carrito de compras de manera reactiva en el showroom.