Cómo integrar CONTPAQi o Aspel con tu sistema

Casi todas las empresas medianas en México llevan su contabilidad y su facturación en CONTPAQi o en Aspel. Y casi todas, tarde o temprano, necesitan que ese sistema hable con algo más: el portal de pedidos, el almacén, la app de campo, el CRM.

Ahí empieza la confusión, porque «integrar con CONTPAQi» no es una sola cosa. Hay caminos distintos según qué producto tengas y si corre en tu servidor o en la nube, y elegir el equivocado cuesta meses. Esta guía explica cuál aplica en cada caso.

Primero: qué producto tienes exactamente

La pregunta que ordena todo lo demás. Bajo el mismo nombre comercial conviven productos con arquitecturas distintas.

CONTPAQi mantiene su línea de escritorio —Comercial Premium, Contabilidad, Nóminas— instalada en un servidor propio, y por separado una línea en la nube con sus propias APIs publicadas.

Aspel fue adquirida por Siigo en 2022 y hoy opera como Siigo Aspel. La línea de escritorio de siempre —SAE, COI, NOI— sigue viva, y en paralelo está Siigo Nube, que es el producto con API.

Esa diferencia importa más que cualquier detalle técnico: el camino de integración de un producto de escritorio y el de uno en la nube no se parecen en nada.

Las cuatro vías, y cuándo aplica cada una

1. SDK de CONTPAQi — para la línea de escritorio

CONTPAQi publica un SDK en .NET que permite consultar, crear, editar y eliminar información dentro de sus sistemas: documentos, catálogos de clientes, proveedores y productos, y timbrado de CFDI.

Cuándo: tienes CONTPAQi Comercial Premium o Contabilidad instalado en tu servidor.

Lo que hay que saber: el SDK corre donde corre el sistema. Si tu aplicación nueva vive en la nube y el CONTPAQi está en una máquina en tus oficinas, necesitas un componente intermedio que corra del lado del servidor y exponga una API hacia afuera. Ese componente es parte del proyecto y suele subestimarse al cotizar.

2. API de nube — CONTPAQi Nube y Siigo API

Ambos proveedores publican APIs para sus productos en la nube. En el caso de Siigo, la API está disponible en los planes de Siigo Nube Gestión; no es una función que venga con cualquier licencia.

Cuándo: ya migraste a la versión en nube, o estás considerando hacerlo.

Lo que hay que saber: verifica que tu plan la incluya antes de diseñar la integración. Es la causa más común de un proyecto que se detiene a la mitad.

3. Archivos e importadores

Poco elegante y todavía la respuesta correcta en varios casos. Los dos sistemas importan y exportan layouts, y un proceso programado que deja archivos en una ruta acordada resuelve muchos escenarios.

Cuándo: el producto no expone API útil, o el volumen es bajo y por lotes.

Lo que hay que saber: esto no es tiempo real. Si el negocio necesita saber el inventario al minuto, no sirve.

4. Lectura directa de la base de datos

Se puede leer. No se debe escribir.

Cuándo: solo lectura, para reportes o tableros, y sabiendo que el esquema puede cambiar con cada actualización.

Lo que hay que saber: escribir directo en las tablas es el error más caro de esta lista, y lo desarrollamos abajo.

El error que rompe la contabilidad

Escribir directamente en las tablas de CONTPAQi o de Aspel funciona. Funciona hasta la siguiente actualización del sistema, y entonces rompe.

Peor: rompe en el lugar donde más duele. Estos sistemas mantienen saldos, movimientos y pólizas cuadrados mediante lógica que vive en la aplicación, no en la base de datos. Un INSERT que pone un movimiento sin actualizar los acumulados deja la contabilidad descuadrada, y nadie se entera hasta el cierre del mes.

La regla es simple: escribe solo por donde el proveedor lo soporta —el SDK, la API, el importador— aunque sea más lento de programar. Leer directo para un reporte es otra cosa y es aceptable.

Las decisiones que hay que tomar antes de escribir código

Decisión	La pregunta concreta
Fuente de verdad	¿El precio lo manda el ERP o el e-commerce? ¿El inventario, el almacén o el ERP?
Frecuencia	¿Tiempo real, cada quince minutos, o nocturno? No todo merece tiempo real
Dirección	¿Solo lectura hacia tu sistema, o también escritura de regreso?
Qué pasa al fallar	Reintentos, bitácora de lo que no pasó, y a quién se le avisa
Catálogos	¿Cómo se relacionan tus productos con los códigos del ERP? Este mapeo siempre toma más de lo estimado

La primera es la que más conflictos evita. Cada campo necesita un solo dueño; si no se define, dos sistemas acaban escribiendo el mismo dato y gana el último, que no siempre es el correcto.

Lo que conviene dejar en el ERP

La tentación al construir un sistema nuevo es moverlo todo. Casi nunca conviene.

Se queda en el ERP: la contabilidad, el timbrado de CFDI, las pólizas, la declaración. Es lo que el sistema hace bien y está actualizado ante cambios fiscales sin que tú hagas nada.

Se construye afuera: lo que el ERP no cubre y hoy vive en Excel y WhatsApp. El portal de clientes, la captura en campo, la aprobación de órdenes, el tablero de dirección, el seguimiento de servicio.

Se comparte: catálogos de clientes y productos. Con dueño definido y sincronización en una sola dirección.

Esa división es la que hace que el proyecto sea de semanas y no de años. Reemplazar un ERP contable que ya funciona, para volver a construir facturación y cumplimiento fiscal desde cero, es de las decisiones más caras que puede tomar una empresa mediana.

Cómo lo hacemos en Newsoft

Empezamos siempre por el inventario: qué producto exacto, qué versión, dónde corre y qué plan de licencia. Con eso la vía de integración queda decidida en la primera sesión, y evita el escenario de diseñar contra una API que el plan del cliente no incluye.

Después construimos la capa de operación alrededor del ERP —no encima de él— con la contabilidad quedándose donde está. El enfoque general de integración lo desarrollamos en cómo integrar tu ERP con tus demás sistemas, y el modelo bajo el que lo operamos está en plataformas administradas.

Si tienes CONTPAQi o Aspel y necesitas que hable con algo más, cuéntanos tu caso. El discovery es gratuito y sale con la vía de integración definida.

Conclusión

«Integrar con CONTPAQi» o «con Aspel» no es una sola cosa: depende de si tu producto es de escritorio o de nube, y de qué incluye tu licencia. Resuelve eso antes de cotizar.

Y sea cual sea la vía, no escribas directo en las tablas del ERP. Funciona hasta la siguiente actualización, y lo que se rompe es la contabilidad.