Contenido del artículo
- ¿Cómo conecto mi tienda Magento con CONTPAQi?
- ¿Qué es el SDK de CONTPAQi y qué pide?
- ¿Qué datos se sincronizan entre Magento y CONTPAQi?
- ¿Cómo se facturan los pedidos en línea con CONTPAQi?
- Errores comunes al integrar Magento con CONTPAQi
- Lo que hemos visto integrando Magento con ERPs
- ¿Cuándo NO conviene integrar Magento con CONTPAQi?
- Preguntas frecuentes
- ¿Existe un conector oficial de CONTPAQi para Magento?
- ¿La integración puede correr en la nube?
- ¿Qué licencia de CONTPAQi necesito para timbrar desde la tienda?
- ¿Funciona con CONTPAQi Comercial Start o Pro?
- ¿Qué pasa cuando actualizo CONTPAQi?
- ¿Funciona si mi tienda usa Hyvä?
- Fuentes
- CONTPAQi no anuncia un conector oficial con Magento; lo que publica es un SDK (kit de desarrollo) para Comercial Premium y Factura Electrónica.
- El SDK pide tener Comercial Premium instalado en el equipo donde corre el programa, así que la integración no vive en la nube: vive junto a tu CONTPAQi.
- Para emitir documentos con el SDK en Comercial Premium 12.1.0, CONTPAQi pide una licencia de 5 usuarios o más.
- La versión del SDK debe coincidir con la de tu sistema: cada actualización mayor de CONTPAQi se prueba también en la integración.
¿Cómo conecto mi tienda Magento con CONTPAQi?
Con tres piezas: la API REST de Magento, que expone pedidos, clientes, productos y existencias; el SDK de CONTPAQi Comercial Premium, que permite a un programa leer y escribir en tu base de CONTPAQi; y un conector en medio que traduce entre los dos, reintenta cuando algo falla y deja bitácora.
La diferencia con ERPs en la nube como NetSuite u Odoo es dónde corre ese conector. Según el manual de referencia del SDK, se necesita CONTPAQi Comercial Premium o Factura Electrónica instalado, como monousuario o como estación. En la práctica, eso significa un equipo Windows de tu oficina (o del servidor donde vive tu CONTPAQi) que habla con Magento por internet.
| Pieza | Dónde vive | Qué hace |
|---|---|---|
| Magento (API REST) | Tu hosting | Publica pedidos, clientes, productos y existencias |
| Conector | Equipo Windows con Comercial Premium | Lee y escribe en CONTPAQi con el SDK y habla con Magento |
| CONTPAQi Comercial Premium | Tu red o servidor | Inventario, pedidos, facturas y timbrado |
| Esquema de referencia. La ubicación exacta se define en el diagnóstico. | ||
¿Qué es el SDK de CONTPAQi y qué pide?
Es el kit de desarrollo que CONTPAQi publica para que un programador cree aplicaciones que trabajen con Comercial Premium y Factura Electrónica. Para Comercial Premium, la librería se llama MGWServicios y se instala con el sistema; se programa en lenguajes como Visual Basic, Delphi, C o .NET.
Del manual hay cuatro puntos que cambian el proyecto:
- Sistema instalado: el programa necesita Comercial Premium en la misma computadora, como monousuario o estación.
- Licencia por función: algunas funciones, como la de emisión de documentos (fEmiteDocumento), piden una licencia con un número mínimo de usuarios. En Comercial Premium 12.1.0 son 5 usuarios o más.
- Inicio y cierre de sesión: toda aplicación inicializa el SDK (fInicializaSDK) y lo termina al final (fTerminaSDK). CONTPAQi advierte que, si no se termina la sesión, el servicio puede quedarse colgado.
- Control de versiones: CONTPAQi no recomienda usar una aplicación hecha con el SDK de una versión contra otra versión del sistema.
Un detalle de catálogo: según la documentación de CONTPAQi, Comercial Start y Comercial Pro no aparecen entre los sistemas con SDK. Si usas uno de ellos, el primer paso es revisar qué alternativas tienes antes de hablar de integración.
¿Qué datos se sincronizan entre Magento y CONTPAQi?
Existencias, precios y catálogo hacia la tienda; pedidos y clientes hacia CONTPAQi; factura y estatus de regreso. Lo que hace que la integración funcione no es que todo viaje para los dos lados, sino que cada dato tenga un solo dueño.
| Dato | Quién manda normalmente | Dirección | Comentario |
|---|---|---|---|
| Existencias | CONTPAQi | CONTPAQi → Magento | Se define de qué almacén sale lo que ve el cliente |
| Precios | CONTPAQi | CONTPAQi → Magento | Lista de precios por tipo de cliente si vendes B2B |
| Catálogo base (código, nombre) | CONTPAQi | CONTPAQi → Magento | Fotos, descripciones y SEO viven solo en Magento |
| Pedidos | Magento | Magento → CONTPAQi | Entran como documento de pedido o de venta |
| Clientes | Magento | Magento → CONTPAQi | Con RFC y datos fiscales si piden factura |
| Factura y estatus | CONTPAQi | CONTPAQi → Magento | El cliente ve su CFDI y el avance en su cuenta |
| Esquema de referencia. En cada proyecto se define según cómo opera la empresa. | |||
El código de producto es la llave de todo. Si el SKU de Magento no es idéntico al código de CONTPAQi, la integración no tiene forma confiable de saber de qué producto hablas. Por eso, antes de programar, se limpia y se amarra el catálogo.
¿Cómo se facturan los pedidos en línea con CONTPAQi?
El conector da de alta el pedido como documento en CONTPAQi (el SDK tiene funciones como fAltaDocumento para eso) y, cuando el pedido está pagado, lo convierte en factura y la timbra. Para que el timbrado lo haga la integración, recuerda el requisito de licencia de 5 usuarios o más en Comercial Premium 12.1.0.
Hay dos formas de operarlo, y la decide tu área de facturación:
- Factura automática: el cliente captura su RFC, razón social, régimen fiscal y código postal en el checkout, y la factura se emite al confirmar el pago.
- Factura a solicitud: el pedido entra a CONTPAQi como venta y el cliente pide su factura desde su cuenta o un portal. Para ventas a público en general, la empresa sigue facturando como ya lo hace.
En ambos casos, el XML y el PDF regresan a Magento para que el cliente los descargue sin escribirte. Las funciones B2B que más nos piden son precios por volumen, límites de crédito y la generación de CFDI, y en CONTPAQi esta última es la que más hay que cuidar.
Errores comunes al integrar Magento con CONTPAQi
- Códigos que no cuadran. SKUs distintos entre Magento y CONTPAQi generan pedidos con productos equivocados o rechazados.
- Actualizar CONTPAQi sin probar el conector. Como el SDK va atado a la versión, una actualización mayor puede romper la integración un lunes por la mañana.
- Sesiones del SDK que no se cierran. El propio manual advierte que el servicio se puede quedar colgado; un conector serio siempre cierra la sesión, aunque haya error.
- Licencia insuficiente para timbrar. Se descubre al final del proyecto, cuando ya se prometió factura automática.
- El conector en la laptop de alguien. Si la computadora se apaga o sale de la oficina, los pedidos dejan de entrar. Debe ser un equipo que esté siempre encendido y con respaldo.
- Sin cola ni bitácora. Si internet se cae, los pedidos deben esperar en cola y reintentarse, no perderse.
Lo que hemos visto integrando Magento con ERPs
Desde 2011 hemos hecho casi 300 proyectos de ecommerce y hemos integrado Magento con SAP, NetSuite, Zoho, Dynamics, Odoo y desarrollos internos, con y sin documentación de API (los peores son los que no la tienen). El reto mayor casi siempre es el ERP, no Magento.
Los consultores de ERP tienden a adaptar el sistema a la cultura y los procesos del cliente, aunque sean malos. Nuestra postura es aprovechar la integración para llevar al cliente a buenas prácticas. Con CONTPAQi esto se nota mucho: si el catálogo, los almacenes o las listas de precios están desordenados, la integración solo va a llevar ese desorden a tu tienda. Por eso cada proyecto empieza con una auditoría y un mapa de qué dato vive dónde.
Si todavía estás comparando ERPs, lee el panorama de integraciones ERP para ecommerce en México: SAP, Microsip y CONTPAQi. Para el mismo problema con otros sistemas, mira integrar Magento con Odoo e integrar Magento con NetSuite.
¿Cuándo NO conviene integrar Magento con CONTPAQi?
No conviene si vendes pocos pedidos al día o tienes un catálogo de menos de unos 10 productos: capturar a mano puede costar menos que mantener una integración. Tampoco si usas una edición de CONTPAQi sin SDK y no planeas cambiar, ni si nadie en tu empresa puede hacerse cargo del equipo donde corre el conector.
Y no conviene integrar un CONTPAQi que no cuadra por dentro. Primero se ordena el catálogo y el inventario, después se conecta. Ojo también con la idea de que Magento hace todo solo: la integración se configura, se prueba y se mantiene.
Hacemos estos proyectos en integraciones de Magento y, si tu tienda corre con Hyvä, en integraciones de Hyvä Commerce. Si quieres saber qué necesita tu caso, agenda un diagnóstico de integración gratis de 30 minutos.
Preguntas frecuentes
¿Existe un conector oficial de CONTPAQi para Magento?
CONTPAQi no anuncia uno. Lo que publica es un SDK para Comercial Premium y Factura Electrónica, con el que se desarrolla la conexión con tu tienda.
¿La integración puede correr en la nube?
El SDK pide tener Comercial Premium o Factura Electrónica instalado en el equipo donde corre el programa. Por eso el conector vive en una computadora Windows de tu red o en el servidor donde está tu CONTPAQi, y desde ahí habla con Magento.
¿Qué licencia de CONTPAQi necesito para timbrar desde la tienda?
Según el manual del SDK, en Comercial Premium 12.1.0 la función de emisión de documentos pide una licencia de 5 usuarios o más. Confírmalo con tu distribuidor para tu versión.
¿Funciona con CONTPAQi Comercial Start o Pro?
CONTPAQi no los incluye entre sus sistemas con SDK. Si usas uno de ellos, hay que revisar alternativas antes de plantear la integración.
¿Qué pasa cuando actualizo CONTPAQi?
CONTPAQi no recomienda usar una aplicación hecha con el SDK de una versión contra otra versión del sistema. Cada actualización mayor se prueba primero con el conector.
¿Funciona si mi tienda usa Hyvä?
Sí. La integración trabaja con los datos de Magento, no con el frontend, así que Hyvä no la limita.
Fuentes
- CONTPAQi: requerimientos para trabajar con el SDK
- CONTPAQi: SDK, inicialización y terminación
- CONTPAQi: SDK, funciones de lectura y escritura
- CONTPAQi Comercial Premium: cartas técnicas y manual del SDK
- Adobe Commerce: API REST
Transparencia: Panamerik es partner de Cloudways (hosting) y de Hyvä. No obligamos a nadie a usarlos: trabajamos con el hosting y las herramientas que tú prefieras. Los datos de experiencia de este artículo son aproximados y vienen de nuestros proyectos desde 2011.
Apliquemos esto a tu tienda.
Cuéntanos qué quieres mejorar. Nuestro equipo revisará tu contexto y coordinará una conversación exploratoria.
