Confirmado
·
Izipay es el gateway actual.
·
Quieren sumar PowerPay como cuotas / financiamiento.
·
V-CHAIN exporta CSV manual cada mañana.
·
Ese CSV si incluye SKU.
·
El catalogo ronda 300 productos.
·
La facturacion actual pasa por V-CHAIN.
MIYAUCHI
Brief técnico para integrar Shopify, V-CHAIN e Izipay / PowerPay
Este documento aterriza que debemos pedir, validar y probar antes de prometer una integracion robusta. La idea no es quedarnos en "tiene API", sino convertir esa afirmacion en una arquitectura verificable.
Negocio
Play! Board Game Store
Stack elegido
Shopify como motor del ecommerce
Inventario online
Una sola sede
Estado actual
V-CHAIN exporta CSV con SKU y declara APIs/integraciones
01
Arquitectura propuesta
01
Shopify = storefront, checkout y catalogo visible
Shopify maneja producto visible, colecciones, SEO, experiencia de compra, paginas legales, cuentas de cliente y automatizaciones comerciales.
02
V-CHAIN = operacion e inventario
Mientras no haya otra migracion operativa, V-CHAIN se mantiene como fuente de verdad para stock y posiblemente para registro interno / facturacion.
03
Conector intermedio = capa de control
La tienda no debe depender de una sola via de sync. El conector debe permitir API/webhooks si existen, polling si hace falta y CSV solo como fallback.
La decision correcta no es "CSV o API". La decision correcta es diseñar la capa intermedia para que la via pueda cambiar sin rehacer la tienda.
02
Que ya sabemos
No confirmado
·
Documentacion tecnica de la API de V-CHAIN.
·
Webhooks disponibles.
·
Sandbox o ambiente de pruebas.
·
Compatibilidad real PowerPay + Izipay dentro del flujo Shopify.
·
Implementacion publica plug-and-play de Izipay para Shopify.
03
Preguntas tecnicas para V-CHAIN
Estas son las preguntas que vale la pena mandar al proveedor o equipo tecnico. Sin estas respuestas, cualquier promesa de integracion sigue siendo una hipotesis.
API docs: ¿tienen documentacion formal, Postman, Swagger o PDF tecnico?
Autenticacion: ¿usan API key, bearer token, basic auth, firma o IP allowlist?
Stock: ¿podemos leer stock por SKU y por sede? ¿devuelve valor absoluto o movimientos?
Pedidos: ¿podemos crear pedidos desde Shopify en V-CHAIN? ¿con que campos minimos?
Estados: ¿podemos consultar cancelaciones, devoluciones, fulfillment o reservas?
Eventos: ¿hay webhooks o solo polling?
Sandbox: ¿existe ambiente de pruebas con credenciales reales de testing?
Soporte: ¿quien acompaña QA, salida a produccion y troubleshooting?
04
Datos minimos para la integracion
| Bloque | Dato minimo | Por que importa |
|---|---|---|
| Inventario | SKU, stock disponible, sede, timestamp | Permite sincronizar a Shopify con una unica ubicacion online sin vender a ciegas. |
| Pedidos | ID, SKU, cantidad, cliente, direccion, forma de pago, estado | Sin esto no se puede empujar la venta online a la operacion. |
| Catalogo | SKU, nombre, precio base, categoria, marca | No es obligatorio para el storefront, pero si ayuda a reconciliar datos. |
| Facturacion | Numero de comprobante, estado, fecha, anulacion | Evita que el proceso comercial y el contable queden desconectados. |
05
Rutas posibles de implementacion
Plan A
API + webhooks. Es el camino ideal: menos friccion, mejor latencia, mejor trazabilidad.
·
V-CHAIN expone cambios de stock
·
Shopify recibe pedidos y los empuja al sistema
·
Conector intermedio maneja mapping SKU y reintentos
Plan B / C
Polling o CSV. Son caminos validos para lanzar, pero no deben confundirse con la vision final.
·
Polling si hay API pero no eventos
·
CSV si solo necesitamos sobrevivir al lanzamiento
·
El conector debe soportar migrar de una via a otra
06
Brief para Izipay y PowerPay
Izipay: ¿la implementacion Shopify es por app, partner, API o redireccion?
Izipay: ¿como se manejan devoluciones, anulaciones y pruebas de QA?
PowerPay: ¿el modulo para Shopify requiere un gateway especifico o convive con Izipay?
PowerPay: ¿el widget vive en PDP, carrito, checkout o post-checkout?
Ambos: ¿que soporte entregan para puesta en produccion?
La pregunta decisiva no es "¿se integra?". La pregunta decisiva es "¿como se implementa, quien la soporta y que pasa cuando algo falla?".
07
Criterio de salida
A
Podemos cerrar la arquitectura
Cuando tengamos respuesta tecnica de V-CHAIN + ruta real de Izipay + confirmacion de si PowerPay entra en fase 1 o fase 2.
B
Podemos construir PoC
Cuando tengamos al menos credenciales de prueba o documentacion para inventario, aunque todavia no exista el flujo completo de pedidos.
C
Podemos lanzar
Si hay una ruta de stock confiable, incluso aunque el primer release salga por polling o CSV controlado.
08
Fuentes y contexto