Una tienda en Tiendanube arranca simple: se cargan los productos, se vende y alguien pasa los pedidos al sistema de gestión. Cuando las ventas crecen, esa carga a mano empieza a costar: productos que se venden sin stock, precios desactualizados en la tienda, pedidos que se facturan tarde o dos veces. En las semanas de más venta del año —las ofertas de noviembre y las fiestas— el problema se multiplica. Esta guía explica cómo se integra Tiendanube con tu sistema de gestión: qué datos se conectan, en qué sentido, cómo se evita la sobreventa y cómo sale la factura de ARCA sin cargar nada dos veces.
Qué se integra: un dueño para cada dato
La regla que ordena toda la integración es simple: cada dato tiene un solo dueño. Si el stock se puede cambiar en la tienda y también en el sistema de gestión, tarde o temprano no coinciden y nadie sabe cuál es el bueno. Lo habitual en una pyme con local, depósito o venta mayorista es esto:
- Productos, stock y precios: los manda el sistema de gestión y van hacia la tienda.
- Pedidos y clientes nuevos: los manda la tienda y entran al sistema de gestión.
- Factura: la emite el sistema de gestión con ARCA y le llega al cliente por mail.
Tiendanube ofrece para eso una API REST oficial y avisos automáticos (webhooks) cuando pasa algo en la tienda: un pedido nuevo, un pedido pagado, uno cancelado, un producto modificado. La integración se instala como una aplicación de la tienda, con permiso del dueño, y no necesita tocar el diseño ni el checkout.
Pedidos: que entren solos y una sola vez
Cada vez que un pedido se crea, se paga o se cancela, Tiendanube avisa al instante a la integración. El aviso trae el identificador interno del pedido, que no es el número que ve el comprador: con ese identificador la integración pide el pedido completo a la API (productos, cliente, envío, medio de pago) y lo registra en el sistema de gestión. Conviene separar los momentos: al crearse, el pedido reserva el stock aunque el pago esté pendiente; al pagarse, se factura; si se cancela sin pagar, la reserva se libera. Tres detalles de la documentación de Tiendanube definen cómo hay que armarlo:
- Hay que responder en 3 segundos. Por eso el aviso se recibe, se guarda en una cola y se procesa después. Si se procesa en el momento y el sistema de gestión tarda, Tiendanube lo da por fallido.
- Si falla, reintenta durante 48 horas. Hasta 16 intentos: eso cubre los cortes temporales del sistema. Lo que no llegue dentro de esa ventana lo recupera la revisión periódica de más abajo.
- Un aviso puede llegar dos veces o fuera de orden. Cada pedido se registra por su identificador interno, junto con el de la tienda: si ya existe, se actualiza en lugar de crearse de nuevo. Así no hay pedidos duplicados.
Además de los avisos, conviene una revisión cada tanto que compare los pedidos de la tienda con los del sistema y recupere cualquiera que se haya escapado. Es el respaldo que deja tranquilo al que factura.
Stock: cómo evitar vender lo que no hay
Una causa muy común de sobreventa: el stock se sincroniza una vez por día o por planilla, y en el medio se vende en el local, en otro canal o al por mayor. La solución es que cada movimiento de stock en el sistema de gestión se mande a la tienda en el momento, sólo del producto que cambió.
- Cada variante tiene que tener su par. Lo más simple es que cada variante (talle, color) tenga el mismo SKU en la tienda y en el sistema. Si no se puede, se arma una tabla que diga qué variante de un lado corresponde a cuál del otro. Ordenarlo suele ser el primer trabajo.
- No se publica todo el stock. A la tienda va lo disponible: lo del depósito, menos lo reservado para pedidos todavía no entregados (también los que esperan el pago), menos un margen de seguridad para los productos que se venden en varios lugares.
- Varios depósitos: si la tienda usa más de una ubicación, el stock se publica por cada una.
- Sólo lo que cambió. La API de Tiendanube acepta en general unas 2 consultas por segundo por tienda (diez veces más en sus planes más altos). Mandar el catálogo entero cada pocos minutos choca con ese límite justo en los días de más venta.
Precios y promociones
Los precios también salen del sistema de gestión, desde una lista de precios propia de la tienda online, que puede ser distinta de la del local o la mayorista. Dos cuidados: la tienda muestra precios finales, con impuestos incluidos, así que la integración tiene que convertirlos si el sistema guarda precios netos; y el redondeo tiene que ser el mismo en los dos lados, para que la factura dé exactamente lo que pagó el cliente. Las promociones con fecha se cargan en el sistema y la integración publica el precio promocional mientras dura.
Factura de ARCA: del pedido pagado al CAE
Con el pedido pago dentro del sistema, la factura sale sola: el sistema pide el CAE a ARCA por web service, guarda el comprobante y se lo manda al cliente. Lo que hay que resolver antes:
- Cuándo se factura. En la venta de bienes a consumidores finales, el comprobante va con el cobro, total o parcial, o con la entrega, lo que pase primero. En una tienda online eso suele ser cuando se acredita el pago, no cuando se crea el pedido: un pedido con transferencia pendiente puede no pagarse nunca. Si después se cancela, sale la nota de crédito.
- Qué comprobante corresponde. Depende de los dos lados. Si sos monotributista, emitís factura C a todos tus clientes. Si sos responsable inscripto, factura B a un consumidor final y factura A a otro responsable inscripto. El checkout de Tiendanube toma el DNI o el CUIT del comprador; con el CUIT, la condición frente al IVA se valida contra el padrón de ARCA.
- El 1 de diciembre de 2026. Desde esa fecha ARCA rechaza las solicitudes de CAE que no informan la condición frente al IVA del receptor. Si tu integración factura ventas online, tiene que mandarla. Lo explicamos en factura electrónica ARCA 2026.
- Una sola factura por pedido. Cada pedido guarda si ya se facturó. Si se corta la comunicación con ARCA justo al pedir el CAE, antes de volver a pedirlo se consulta a ARCA si el comprobante quedó autorizado: pedirlo de nuevo a ciegas puede duplicar la factura.
¿Una app de la tienda o una integración a medida?
Si tu sistema de gestión es conocido, puede que ya exista una aplicación en la tienda de apps de Tiendanube que lo conecte. Conviene probarla primero: si cubre tus casos, puede ser lo más rápido. Compará su costo mensual, lo que hay que configurar y lo que no cubre.
Una integración a medida conviene cuando:
- Tu sistema de gestión es propio o está muy adaptado.
- Tenés reglas que una app genérica no contempla: combos y kits que descuentan varios productos, varios depósitos, listas de precios por canal, mayoristas que compran en la misma tienda.
- Vendés también en otros canales, como Mercado Libre, y el stock tiene que ser uno solo para todos.
- Necesitás que el pedido siga después: preparación en el depósito, envío, seguimiento para el cliente.
Si estás en esa decisión, te sirve software a medida vs SaaS. Y cuando hay varios canales, lo que se arma es una capa de integración en el medio, con colas y reintentos, para que la tienda, los marketplaces y el sistema de gestión no dependan uno del otro: es la forma de trabajar que contamos en microservicios.
Errores comunes
- Dos dueños para el mismo dato. Si el stock se toca en la tienda y en el sistema, se pisan.
- Sincronizar por planilla una vez por día. En una venta fuerte, la sobreventa aparece en horas.
- Procesar el aviso en el momento. Si el sistema tarda más de 3 segundos, Tiendanube lo da por fallido y lo vuelve a mandar.
- No preparar los duplicados. Un mismo pedido entra dos veces y se factura dos veces.
- Variantes sin su par. Si no se sabe qué variante de la tienda es cuál del sistema, el stock se descuenta del producto equivocado.
- «Consumidor final» por defecto. Completa el campo, pero a una empresa le llega una factura que no le sirve.
- Probar recién en la semana de más venta. La integración se prueba con un pico de pedidos simulado, antes.
Checklist antes de la temporada alta
- Revisá que cada variante tenga su SKU, igual en la tienda y en el sistema o con una tabla de correspondencia.
- Definí quién es el dueño de cada dato: productos, stock, precios, pedidos, clientes.
- Fijá el margen de seguridad de stock para lo que se vende en más de un canal.
- Decidí en qué momento se factura y qué pasa con las cancelaciones.
- Probá la factura en homologación de ARCA, con la condición frente al IVA del receptor.
- Simulá un día de mucha venta y mirá que no se pierdan ni se dupliquen pedidos.
Cómo te ayudamos desde Intway
Hacemos integraciones de e-commerce y marketplaces a medida: conectamos Tiendanube y Mercado Libre con tu sistema de gestión, tu ERP y la factura electrónica, con avisos en tiempo real, colas y reintentos, y un registro de cada pedido. Si todavía no tenés un sistema que facture, tenemos un sistema de facturación, stock y CRM con factura electrónica, y si querés una tienda propia en lugar de una plantilla, una tienda online a medida. Y si además querés que tus clientes mayoristas vean sus pedidos y facturas, se suma un portal de autogestión sobre los mismos datos.