Introducción: En esta guía práctica aprenderás a conectar una app de Shopify con un backend NestJS en tu máquina local para procesar webhooks de pedidos y ejecutar lógica de negocio de forma segura y escalable. Esta solución es ideal para equipos que desarrollan aplicaciones a medida y software a medida orientado a comercio electrónico.
Qué construiremos: una app de Shopify que recibe webhooks sobre orders create, y un backend NestJS que procesa esos webhooks. La app de Shopify reenviará los datos de pedido al API de NestJS en localhost para que puedas desarrollar y depurar el flujo completo.
Parte 1 Configurar la app de Shopify Paso 1 Crear la app Ejecuta en terminal npm init @shopify/app@latest y responde los prompts. Recomiendo nombrarla bridge-app, seleccionar Public y plantilla Remix TypeScript. Paso 2 Ir al directorio cd bridge-app Paso 3 Configurar permisos y webhooks Edita el archivo shopify.app.toml y actualiza scopes a write_products,read_orders,write_orders. Añade una suscripción a webhooks para orders create con uri /webhooks/orders/create. Paso 4 Iniciar la app Ejecuta shopify app dev y sigue las instrucciones para elegir o crear una tienda de desarrollo y permitir actualización automática de la URL. Mantén este terminal abierto.
Parte 2 Configurar el backend NestJS Paso 1 Abre un nuevo terminal sin cerrar la app de Shopify. Paso 2 Crear proyecto Instala el CLI con npm i -g @nestjs/cli, luego crea el proyecto con nest new bridgeapp-api y entra al directorio cd bridgeapp-api. Paso 3 Crear controlador de webhook Crea la carpeta src/webhook y el archivo src/webhook/webhook.controller.ts. En el controlador define un endpoint POST shopify order que reciba body y headers, registre en logs la cabecera y el body y devuelva un OK. Paso 4 Actualizar app.module.ts registra WebhookController en controllers. Paso 5 Iniciar NestJS Ejecuta npm run start:dev y verifica que la API esté en https://localhost:3000
Parte 3 Puente entre Shopify y NestJS En la app de Shopify crea el archivo app/routes/webhooks.orders.create.tsx. Usa la función authenticate.webhook para validar el webhook, extrae topic shop y payload, escribe logs y luego reenvía mediante fetch a https://localhost:3000/webhook/shopify/order con método POST y body JSON que incluya shop y order. Maneja respuestas exitosas y errores de conexión con logs para depuración.
Parte 4 Pruebas Paso 1 Instala la app usando la preview URL que muestra shopify app dev. Paso 2 Prueba directa a la API en un tercer terminal con curl -X POST https://localhost:3000/webhook/shopify/order -H Content-Type: application/json -d '{'shop':'test-shop.myshopify.com','order':{'id':123,'name':'#1001'}}' y revisa los logs en el terminal de NestJS. Paso 3 Prueba de extremo a extremo crea un pedido en el admin de la tienda de desarrollo y observa logs en ambos terminales.
Qué verás Logs en el terminal de Shopify indicando webhook recibido topic orders/create y el intento de enviar a NestJS. En el terminal de NestJS verás registros del controlador WebhookController con headers y body JSON del pedido.
Sugerencias de resolución de problemas Si aparece connection refused verifica que NestJS está en el puerto 3000. Si no llega el webhook revisa que el archivo webhooks.orders.create.tsx esté guardado y reinicia la app de Shopify. Si el puerto está ocupado cambia el puerto en main.ts y actualiza la URL de reenvío en la app de Shopify.
Beneficios para tu empresa y servicios de Q2BSTUDIO En Q2BSTUDIO somos especialistas en desarrollo de software a medida y aplicaciones a medida, ayudando a empresas a integrar soluciones backend como NestJS con plataformas SaaS como Shopify. Podemos ayudarte a añadir lógica de negocio, integrar APIs externas como mensajería o gateways de pago, o almacenar datos en bases robustas. Si necesitas una solución orientada a negocio y dashboards te invitamos a conocer nuestras capacidades en inteligencia artificial visitando servicios de inteligencia artificial de Q2BSTUDIO y para proyectos de software personalizado revisa nuestra página de desarrollo de aplicaciones y software a medida.
Palabras clave y propuestas de valor Esta guía está pensada para equipos que buscan integrar inteligencia artificial, ia para empresas, agentes IA, power bi y servicios inteligencia de negocio en flujos productivos. Además ofrecemos servicios cloud aws y azure y soluciones de ciberseguridad y pentesting para proteger integraciones sensibles. Si tu proyecto necesita automatización de procesos o integración con Power BI podemos diseñar la arquitectura y la implementación completa.
Próximos pasos Recomendamos dentro del backend NestJS agregar validación HMAC si vas a exponer endpoints públicos, implementar almacenamiento en base de datos y añadir pruebas end to end. Para escalar a producción considera despliegue en servicios cloud y configuración de certificados y seguridad.
Contacto y ayuda Si quieres que Q2BSTUDIO te acompañe en el desarrollo, integración o puesta en producción de la solución, solicita una consultoría y aprovecharemos nuestra experiencia en software a medida, inteligencia artificial, ciberseguridad y servicios cloud aws y azure para diseñar la mejor arquitectura para tu negocio.
