En este artículo

Integración con Alegra

Alegra es la plataforma de contabilidad y facturación electrónica más usada en Latinoamérica. En República Dominicana está certificada por la DGII como proveedor autorizado de e-CF (Comprobantes Fiscales Electrónicos).

Si conectas Vendabo con Alegra, cada pedido pagado emite su factura fiscal en Alegra, obtiene el NCF / e-CF oficial y queda listo para descarga e impresión. Tu equipo no tiene que entrar a Alegra a facturar a mano.

Antes de conectar Alegra, configura el módulo de facturación de Vendabo (datos fiscales y casilla "Habilitar facturación"). Si todavía no lo hiciste, revisa Facturación y sus ajustes.

Qué hace el conector (y qué no)

Vendabo empuja información hacia Alegra después de una venta. No es una sincronización bidireccional de ERP (eso es otro tipo de integración, como Odoo).

Lo que sí hace

• Emite facturas de venta en Alegra al confirmarse el pago de un pedido.
• Asigna el tipo de comprobante correcto: B01 (Crédito Fiscal) o B02 (Consumidor Final).
• Obtiene el NCF / e-CF y el PDF fiscal firmado por Alegra.
• Registra el pago asociado a esa factura (para que tu contabilidad quede al día).
• Crea o reutiliza el cliente en Alegra según cédula o RNC.
• Crea productos en Alegra la primera vez que se facturan (buscando por SKU). Los siguientes pedidos reutilizan ese ítem.
• Emite notas de crédito (B04) cuando reembolsas o anulas un pedido ya facturado.

Lo que no hace

• No sincroniza tu catálogo completo de Vendabo hacia Alegra (ni al revés). El catálogo de la tienda se carga y mantiene en Vendabo (CSV, admin, etc.).
• No sincroniza inventario entre ambos sistemas.
• No reemplaza la carga de productos en Vendabo: Alegra es el emisor fiscal, no el maestro de tu tienda online.

Requisitos previos

1. Cuenta Alegra activa en República Dominicana con facturación electrónica (e-CF) habilitada ante la DGII. Si aún no la tienes, regístrate en alegra.com/republica-dominicana.
2. Plan de Alegra con acceso a la API. Alegra exige un plan compatible (por ejemplo Plus u otro que incluya Integración Manual / API). Si no ves la sección de token, contacta a soporte de Alegra o sube de plan.
3. Datos fiscales de tu empresa en Alegra: RNC, razón social, dirección. Alegra usa esos datos como emisor.
4. Plantillas de numeración NCF activas en Alegra para los tipos que vas a emitir (B01, B02 y B04 para notas de crédito). Esto lo gestiona Alegra con la DGII al activar el plan.
5. Email + Token API de tu cuenta Alegra (ver sección siguiente).
6. Tienda Vendabo en República Dominicana con datos fiscales completos (RNC, razón social, dirección) y facturación habilitada.

Cómo entrar en Vendabo

1. En el menú lateral entra a Ajustes.
2. Elige Facturación.
3. Baja a la sección Integraciones. Ahí verás la tarjeta de Alegra.

Obtener el email y el token en Alegra

Vendabo autentica contra Alegra con dos datos: el correo (usuario) y el token API. El token funciona como una contraseña: quien lo tenga puede crear facturas y modificar datos de tu cuenta.

Opción rápida

Desde la pantalla de configuración en Vendabo, haz clic en "Obtener credenciales de Alegra". Te lleva directo a:

https://mi.alegra.com/integrations/api

Paso a paso en Alegra

Si prefieres navegar desde el panel de Alegra (menú actual de Alegra):

1. Inicia sesión en mi.alegra.com (o app.alegra.com).
2. Haz clic en el ícono de Soluciones (los nueve puntos) y elige Administrar mis soluciones.
3. En el menú lateral entra a Integraciones.
4. Abre Integración Manual (API).
5. Copia:
   • Usuario → es el email que pegarás en Vendabo como "Email de Alegra".
   • Token → pégalo en Vendabo como "Token API".

Si en tu cuenta todavía aparece el acceso antiguo: Configuración → API - Integraciones con otros sistemas, el resultado es el mismo: correo + token.

Renovar el token

Si sospechas que el token se filtró, o quieres desconectar integraciones anteriores:

1. Entra a la misma pantalla Integración Manual (API).
2. Haz clic en Renovar token.
3. Copia el token nuevo y actualízalo de inmediato en Vendabo.

Al renovar, el token anterior deja de funcionar. Cualquier integración que aún lo use (incluida Vendabo) fallará hasta que pegues el nuevo.

Seguridad del token

• Trátalo como una contraseña: no lo compartas por WhatsApp, correo sin cifrar ni capturas públicas.
• Solo pégalo en Vendabo (o en sistemas de confianza).
• Si alguien de tu equipo deja la empresa y tenía acceso al token, renueva el token y actualízalo en Vendabo.

Configurar la integración en Vendabo

Con el email y el token listos:

1. Activa facturación y datos fiscales

En Ajustes → Facturación:

1. Marca "Habilitar facturación".
2. Completa Datos Fiscales (RNC, razón social, nombre comercial, dirección, teléfono, email de facturación).

Sin estos datos, Alegra rechazará las facturas.

2. Elige Alegra como proveedor

En la sección Integraciones:

1. Haz clic en la tarjeta de Alegra (logo verde).
2. Completa:
   • Email de Alegra — el usuario/correo de la pantalla de API.
   • Token API — el token que copiaste. Si ya tenías uno guardado, deja el campo vacío para mantenerlo.
3. Haz clic en "Probar conexión".
   • Éxito: verás un mensaje verde de conexión correcta.
   • Error: revisa email/token (sin espacios de más), que tu plan Alegra incluya API, y que la cuenta esté activa.
4. Marca "Sincronizar automáticamente al registrar pagos" si quieres emisión automática al confirmar cada pago. Si lo dejas desmarcado, podrás emitir o reintentar desde el pedido/factura.
5. (Opcional) Completa Plantillas de Numeración (NCF):
   • Consumidor Final (B02) — ID de la plantilla B02 en Alegra.
   • Crédito Fiscal (B01) — ID de la plantilla B01 en Alegra.
   • Si los dejas vacíos, Alegra usa su plantilla por defecto.
6. Haz clic en "Guardar".

Cómo sacar el ID de una plantilla NCF

1. En Alegra entra a la configuración de Numeraciones (o plantillas de comprobantes).
2. Abre la plantilla B01 o B02 que uses.
3. Mira la barra de dirección del navegador: el número al final de la URL es el ID.
4. Pégalo en el campo correspondiente de Vendabo.

Actualiza estos IDs si la DGII te asigna un rango nuevo o cambias de plantilla en Alegra. Hasta que lo hagas, Vendabo seguirá intentando usar la plantilla anterior.

Cómo se decide B01 vs B02

Vendabo elige el tipo según lo que el cliente indicó en el checkout:

Situación en checkout	Comprobante
El cliente marcó "Necesito comprobante fiscal" y cargó un RNC activo en DGII	B01 Crédito Fiscal
El cliente no marcó la casilla, o solo dejó cédula	B02 Consumidor Final

Vendabo valida el RNC contra la DGII en el checkout. Si el RNC está inactivo o no existe, el cliente debe corregirlo antes de pagar.

Flujo completo cuando se paga un pedido

1. El cliente paga y el pago queda confirmado en Vendabo.
2. Vendabo crea una factura interna con productos, cliente, montos y tipo de comprobante.
3. Si Alegra está conectado y la sincronización automática está activa, Vendabo envía la factura a Alegra.
4. Alegra:
   • Busca o crea el contacto (por cédula/RNC).
   • Busca o crea cada producto por SKU (la primera vez lo crea; después lo reutiliza).
   • Asigna el siguiente NCF / e-CF según plantilla B01 o B02.
   • Devuelve el número y el PDF.
5. Vendabo guarda el NCF en la factura y deja el PDF disponible para descarga.
6. Vendabo registra también el pago en Alegra, vinculado a esa factura.

Si algo falla (credenciales, dato inválido, Alegra temporalmente caído), verás un aviso en el pedido/factura con opción de "Reintentar".

Qué pasa con ITBIS y precios

Los precios en Vendabo suelen ir con ITBIS incluido. Al enviar a Alegra, Vendabo calcula el precio base (sin impuesto) y manda el ITBIS por separado (18%, 16% o exento), para que el total cuadre con lo que pagó el cliente.

El envío también se factura como línea "Gastos de envío" (con ITBIS 18% incluido, como en RD).

Notas de crédito automáticas

Cuando reembolsas o cancelas un pedido ya facturado, Vendabo genera una nota de crédito (B04) y la sincroniza con Alegra:

• Reembolso parcial (un producto de varios) → NC por ese monto.
• Anulación completa → NC por el total de la factura.
• Reembolso de envío → NC por el costo de envío.

La NC obtiene su propio NCF (B04) y queda en Facturación → Notas de crédito.

Una vez sincronizada con Alegra, una nota de crédito no se puede anular (norma DGII / Alegra). Si necesitas corregir, emite otro documento compensatorio.

Acciones desde el admin

Desde Facturación → Facturas puedes:

• Ver el listado filtrable (fecha, estado, cliente, pedido).
• Abrir el detalle con NCF, montos y cliente.
• Descargar el PDF fiscal firmado por Alegra.
• Anular una factura emitida (genera la NC correspondiente).
• Reintentar sincronización si quedó fallida.

El enlace del PDF de Alegra es temporal. Si guardas la URL y la abres días después puede haber expirado. Descarga siempre desde Vendabo para obtener un enlace fresco.

Casos típicos

"Mi cliente comercial pide factura con RNC"

El cliente marca "Necesito comprobante fiscal", carga RNC y razón social. Vendabo valida el RNC. Al pagar se emite B01 automáticamente.

"Todavía no tengo e-CF activo en Alegra"

Puedes habilitar facturación interna en Vendabo sin conectar Alegra. Las facturas sirven de control interno sin NCF oficial. Cuando Alegra esté listo, conectas la integración y los pedidos nuevos emiten e-CF reales.

"Una factura falló por un carácter raro en el nombre"

Edita los datos del cliente en el pedido, corrige razón social o dirección, y usa "Reintentar" en la factura. El mensaje de error suele indicar qué campo rechazó Alegra.

"Quiero reembolsar un solo producto"

Haz el reembolso parcial desde el pedido. Vendabo crea la NC parcial, la envía a Alegra y obtiene su NCF. La factura original permanece emitida.

"¿Necesito Alegra si solo vendo a consumidores finales?"

Sí, si quieres entregar comprobantes fiscales válidos ante DGII. Aunque sean B02, los e-CF deben salir por un proveedor autorizado. Sin Alegra, Vendabo solo genera documento de control interno.

"También uso Odoo"

Decide quién emite los e-CF. Solo un sistema debe facturar fiscalmente. Si Odoo ya emite tus comprobantes, mantén Alegra desactivado en Vendabo (y viceversa) para no duplicar.

Errores frecuentes

Síntoma	Qué revisar
"Credenciales inválidas" / falla "Probar conexión"	Email y token exactos; sin espacios; token no renovado/vencido; plan Alegra con API.
Facturas en estado fallido	Datos fiscales incompletos en Vendabo; RNC/razón social del cliente; mensaje exacto del error.
NCF incorrecto o de otra serie	IDs de plantillas B01/B02 en Ajustes → Facturación; plantillas activas en Alegra.
Producto “duplicado” en Alegra	El conector busca por SKU. Si el mismo producto se facturó con SKUs distintos, Alegra crea ítems distintos. Usa SKUs estables.
Cupo de e-CF agotado	Alegra avisa por correo. Sube de plan o amplía cupo; hasta entonces la sync fallará.

Tips finales

• Activa "Sincronizar automáticamente al registrar pagos" desde el día uno. La emisión manual pedido a pedido genera olvidos.
• Completa datos fiscales antes de conectar Alegra.
• Revisa semanalmente facturas en estado Fallida: cada una es un pedido sin comprobante fiscal entregado.
• Si renuevas el token en Alegra, actualízalo el mismo día en Vendabo.
• El catálogo vive en Vendabo: carga productos ahí (CSV o admin). Alegra solo recibe los ítems al facturar.

Siguiente paso

Con Alegra conectado, la operación fiscal queda automatizada. Para el detalle del módulo interno (tipos de comprobante, listados, anulación y checkout fiscal), continúa con Facturación y sus ajustes.