Saltar al contenido principal

Integración con SmartBill

SmartBill es la principal plataforma de facturación en la nube en Rumanía 🇷🇴, diseñada específicamente para los requisitos fiscales y legales rumanos. Cuando está configurada en CADENSA, puedes emitir facturas legalmente válidas (facturi fiscale) directamente desde tus entradas de tiempo registradas, con pleno cumplimiento de e-Factura / ANAF.

Países admitidos

SmartBill está diseñado para empresas registradas en Rumanía 🇷🇴 (con un CIF / CUI válido). Soporta tanto empresas pagadoras de TVA como no pagadoras.

Cumplimiento e-Factura

Rumanía exige el reporte de e-Factura a ANAF para transacciones B2B (sistema RO e-Invoice). SmartBill gestiona automáticamente la transmisión a ANAF cuando está configurado correctamente en tu cuenta de SmartBill Cloud.

Antes de Comenzar​

Necesitas:

  • Una cuenta activa de SmartBill Cloud (cloud.smartbill.ro)
  • Tu token API de SmartBill (ver más abajo)
  • Tu CIF / CUI de empresa (código de identificación fiscal, p. ej., RO12345678)
  • Unidad CADENSA con al menos el rol de Administrador

Paso 1 — Obtener tu Token API de SmartBill​

  1. Inicia sesión en cloud.smartbill.ro
  2. Ve a Contul Meu (menú arriba a la derecha)
  3. Navega a Integrări (Integraciones)
  4. Desplázate hasta la sección API
  5. Copia tu token API — o genera uno nuevo
Mantén tu token API en secreto

Nunca compartas tu token API ni lo incluyas en sistemas de control de versiones. Cualquier persona con el token puede crear y gestionar facturas en tu nombre.

Para la documentación oficial de la API de SmartBill, consulta: api.smartbill.ro

Paso 2 — Configurar en CADENSA​

  1. Abre Configuración → Factura en CADENSA
  2. Selecciona SmartBill 🇷🇴 como proveedor
  3. Rellena los campos de credenciales:
  • Clave API → pega tu token API de SmartBill
  • Correo de Cuenta (Secreto API) → tu dirección de correo de inicio de sesión en SmartBill
  • ID de Empresa → el CIF/CUI de tu empresa (p. ej., RO12345678 o solo 12345678)
  1. Haz clic en Probar Conexión — un verde confirma que las credenciales son válidas
  2. Haz clic en Guardar
Se requieren dos credenciales

SmartBill usa autenticación HTTP básica combinando tu correo y token API. Ambos campos son obligatorios. Tu correo se almacena como el campo "Secreto API" en CADENSA.

Paso 3 — Configurar Valores Predeterminados​

Tras guardar, configura los valores predeterminados de la factura:

ConfiguraciónValor recomendado
MonedaRON
Tipo de IVA19% (cota normală)
Plazo de pago30 días

SmartBill admite múltiples tipos de TVA rumanos:

Tipo de TVANombre en SmartBillDescripción
19%NormalaCota standard
9%RedusaAlimentos, medicamentos, hostelería
5%Redusa1Libros, periódicos, vivienda social
0%ScutitExento de TVA

CADENSA selecciona automáticamente el nombre de TVA correcto de SmartBill según el tipo de IVA que configures.

Paso 4 — Configurar las Series de Facturas en SmartBill​

SmartBill requiere que las series de facturas estén definidas en tu cuenta Cloud antes de usar la API:

  1. Inicia sesión en cloud.smartbill.ro
  2. Ve a Configurare → Serii
  3. Asegúrate de tener al menos una serie activa para facturi (p. ej., FCT)
  4. CADENSA usa FCT como nombre de serie predeterminado — puedes cambiarlo para que coincida con tu configuración
La serie debe existir en SmartBill

Si la serie FCT no existe en tu cuenta de SmartBill Cloud, la creación de facturas fallará. Verifica siempre el nombre de la serie en tu cuenta de SmartBill.

Datos del Cliente (Facturar a)​

La API REST de SmartBill no expone un endpoint de lista de clientes, por lo que no hay selector de socios en el diálogo Generar Factura cuando SmartBill es tu proveedor activo.

Rellena todos los campos del cliente manualmente:

CampoDescripción
Nombre de EmpresaObligatorio. Nombre registrado de la empresa del cliente
Nombre de ContactoOpcional. Persona de contacto individual
CorreoOpcional. Usado para enviar la factura por correo
PaísObligatorio. Selecciona en el desplegable de búsqueda (código ISO, p. ej., RO, HU, DE)
DirecciónObligatorio
Código PostalObligatorio
CiudadObligatorio
NIF / Número FiscalOpcional, pero obligatorio para facturas de inversión del sujeto pasivo UE (B2B)

Los datos del cliente que introduces se envían directamente a SmartBill como parte de la solicitud POST /invoice. SmartBill puede opcionalmente guardar el cliente en tu base de datos de contactos — esto se controla con el parámetro saveToDb (activado por defecto en CADENSA).

Cómo se Crean las Facturas​

Cuando haces clic en Generar Factura, CADENSA:

  1. Toma los datos del cliente que introdujiste manualmente en el diálogo Generar Factura
  2. Mapea tus entradas de tiempo → partidas de SmartBill (products)
  3. Envía POST /invoice a la API de SmartBill (incluidos los datos del cliente)
  4. SmartBill asigna el siguiente número disponible en la serie configurada
  5. CADENSA almacena el {serie}-{número} devuelto como referencia externa (p. ej., FCT-0023)
  6. El PDF de la factura está disponible a través de Descargar PDF en el historial de facturas

Mapeo de partidas​

Campo CADENSACampo SmartBill
Descripciónname
Cantidad (horas)quantity
Precio unitarioprice
Unidad (hora/día/unidad)measuringUnitName (ora/zi/buc)
Tipo de IVAtaxName + taxPercentage
Proyecto / tareaproductDescription

Todos los precios se envían netos (sin TVA) — SmartBill calcula automáticamente los importes de TVA.

Anular una Factura​

Para anular una factura en CADENSA:

  1. Ve a Informes → Historial de Facturas
  2. Busca la factura y haz clic en Anular
  3. CADENSA envía PUT /invoice/cancel a SmartBill (anulación suave — la factura se marca como anulada pero permanece en el sistema)
Diferencia entre eliminar y anular

SmartBill admite tanto eliminar (solo para la última factura de una serie) como anular (anulare, para cualquier factura). CADENSA siempre usa anulación para preservar el rastro de auditoría.

Resolución de Problemas​

"401 Unauthorized"​

  • Verifica que el token API es correcto y no ha expirado
  • Verifica que la dirección de correo coincide con la cuenta de SmartBill usada para generar el token
  • Verifica que el CIF coincide exactamente con la empresa en tu cuenta de SmartBill Cloud

"Serie inexistenta" (Serie no encontrada)​

  • La serie predeterminada FCT no existe en tu cuenta de SmartBill
  • Ve a Configurare → Serii documente en SmartBill Cloud y crea una serie FCT (tipo: Factura)

"Cota TVA nu a fost gasita" (Tipo de IVA no encontrado)​

  • La combinación de tipo de IVA (nombre + porcentaje) debe estar definida en Configurare → Cote TVA en SmartBill Cloud
  • Ejemplo: si usas el 19%, asegúrate de que Normala al 19% está activado en tu cuenta

"403 Forbidden" (Límite de peticiones)​

  • SmartBill limita las peticiones a 30 llamadas por 10 segundos. Si se supera este límite, el acceso se bloquea durante 10 minutos
  • CADENSA está diseñado para mantenerse muy por debajo de este límite en uso normal

La prueba de conexión falla pero las credenciales parecen correctas​

  • Asegúrate de que tu empresa tiene una suscripción activa a SmartBill Cloud
  • Comprueba que el usuario de la API tiene los permisos necesarios (creación de facturas, acceso de lectura)
  • Contacta con el soporte de SmartBill en api@smartbill.ro si el problema persiste

Recursos Relacionados​