Si llevas tu contabilidad en Aliaddo y vendes por internet, tarde o temprano te preguntas qué se puede automatizar entre tu tienda y tu cuenta. La respuesta corta: bastante, pero conviene conocer cómo funciona su API y dónde están sus límites antes de montar una integración.
Esta guía resume qué permite hacer la API de Aliaddo para un negocio de ecommerce, qué debes revisar de tu cuenta y cómo conectarla sin escribir código.
Qué puede automatizar la API de Aliaddo
Aliaddo ofrece una API para su software contable y administrativo. Para una tienda online interesan sobre todo cinco áreas:
- Facturas de venta: crear la factura con cliente, productos, impuestos, descuentos y forma de pago, y consultar su estado ante la DIAN y su CUFE.
- Contactos: buscar clientes por identificación y crearlos si no existen.
- Productos: consultar el catálogo con su stock, y crearlos o editarlos.
- Inventario: consultar el stock de cada producto por bodega.
- Catálogos de apoyo: sucursales, vendedores, impuestos, categorías, unidades de medida y bodegas.
Con eso se cubre el ciclo completo de un pedido: el cliente compra en tu tienda, el pedido se convierte en factura y el stock se actualiza.
Cómo se conecta: token y base de la API
El acceso se hace con un token de integración que generas en tu propia cuenta de Aliaddo y que se envía como credencial en cada solicitud. Guárdalo como una contraseña: quien lo tenga puede actuar sobre tu cuenta.
Aliaddo publica varias direcciones de acceso según el producto que uses (su ERP en la nube y sus plataformas de facturación). Por eso, al conectar, confirma con Aliaddo cuál corresponde a tu cuenta.
Lo que debes tener listo en tu cuenta
- Facturación electrónica activa y una sucursal con resolución vigente.
- Productos con código (SKU), el mismo que usa tu tienda.
- Un producto de servicio para el envío, si cobras flete.
- Impuestos configurados, especialmente el IVA que aplicas.
- Caja o banco donde se registran las ventas pagadas.
Límites que conviene conocer
Ninguna API lo permite todo. Estos son los puntos a tener en cuenta con Aliaddo:
- Límite de solicitudes: hay un máximo por minuto (entre 50 y 150 según el plan) y un tope diario. Para una tienda con muchos pedidos, la integración debe espaciar las llamadas.
- Nota crédito: por la API se puede crear la de anulación de una factura completa. Una devolución parcial se hace desde Aliaddo.
- Eliminar productos: se hace desde la aplicación, no por la API.
- Stock inicial: se carga al crear el producto; luego se ajusta con movimientos de inventario.
- Búsqueda por código parcial: al buscar un SKU pueden aparecer coincidencias parciales, así que la integración debe exigir coincidencia exacta.
Conocerlos desde el principio evita sorpresas: por ejemplo, que una devolución parcial no se pueda automatizar o que un lote grande de pedidos tarde unos minutos.
Qué ganas al automatizarlo
- Cero digitación: cada pedido pagado se convierte en factura.
- Menos errores: el IVA, el envío y el documento del comprador salen bien calculados y los pedidos con datos faltantes quedan marcados.
- Stock confiable: ves qué productos tienen distinta cantidad entre tu tienda y Aliaddo.
- Trazabilidad: un registro de qué se facturó, cuándo y qué falló.
Si quieres entender el contexto fiscal, lee qué necesitas para la factura electrónica DIAN en una tienda online.
Cómo lo resuelve Tingo
Tingo ya trae la conexión con Aliaddo lista: pegas tu token y el código de tu caja o banco, y la plataforma detecta la sucursal, el vendedor, el IVA y el producto de envío. Desde ahí cada pedido de Shopify, WooCommerce o MercadoLibre se convierte en una factura de tu Aliaddo, y tus productos se comparan por SKU.
Empieza en modo simulación para ver cómo quedarían tus facturas sin escribir nada en tu cuenta. Revisa las integraciones disponibles: Shopify con Aliaddo, WooCommerce con Aliaddo y MercadoLibre con Aliaddo. Y prueba 14 días gratis, sin tarjeta.
Preguntas frecuentes
¿Aliaddo emite la factura electrónica ante la DIAN?
Sí. La factura se crea y se transmite desde tu cuenta de Aliaddo, con tu resolución. La integración solo le entrega los datos del pedido.
¿Cuánto cuesta usar la API de Aliaddo?
Depende de tu plan con Aliaddo. Consulta con ellos si tu licencia incluye acceso a la API.
¿Puedo hacer devoluciones parciales desde la integración?
Por la API de Aliaddo solo está disponible la anulación de la factura completa. Las devoluciones parciales se crean en Aliaddo.
¿Qué pasa si supero el límite de solicitudes?
Aliaddo responde con un aviso de límite. Una buena integración espera un momento y reintenta.
¿Necesito programar para conectarla?
No. Con una integración dedicada solo pegas el token y confirmas los datos que se detectan.
Conclusión
La API de Aliaddo permite automatizar lo más pesado de una tienda online: facturas, clientes y productos. Con tus SKU ordenados, el token a mano y claros los límites, la integración queda estable desde el primer día.
Esta guía es informativa y no reemplaza la asesoría de tu contador ni la documentación oficial de Aliaddo.
