Resumen
API de SmartBill Cloud para la facturación rumana: emite facturas y estimaciones (proforma) como borradores o documentos finales, crea una factura a partir de una estimación, verifica el estado de pago, descarga PDFs, envía documentos a clientes y lee series de documentos, tasas de IVA y stock por almacén. La reversión, cancelación, eliminación y registro de pagos están desactivados. Correo electrónico y token de API.
Configuración guiada
Conecta SmartBill a Claude en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta SmartBill con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Prueba a pedir
Prompts de ejemplo para SmartBill
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → SmartBill, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
SmartBill + Claude
API de SmartBill Cloud para la facturación rumana: emite facturas y estimaciones (proforma) como borradores o documentos finales, crea una factura a partir de una estimación, verifica el estado de pago, descarga PDFs, envía documentos a clientes y lee series de documentos, tasas de IVA y stock por almacén. La reversión, cancelación, eliminación y registro de pagos están desactivados. Correo electrónico y token de API.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 2 minutos.
- Inicia sesión en SmartBill Cloud y abre Contul meu, Integrari, sección API (https://cloud.smartbill.ro/core/integrari/).
- Copia el Email en
SMARTBILL_EMAIL, el Token enSMARTBILL_API_TOKENy el CIF de la empresa enSMARTBILL_CIF.
Las llamadas utilizan autenticación básica HTTP con el correo electrónico como usuario y el token como contraseña. El conector añade el CIF de la empresa a cada llamada, por lo que un conector funciona en una sola empresa; instálalo de nuevo para una segunda empresa.
Por dónde empezar: smartbill_list_series (los nombres de las series que necesita cada documento) y smartbill_list_taxes (los nombres de las tasas de IVA). Luego smartbill_create_invoice o smartbill_create_estimate.
Lo que la API no puede hacer: V1 no tiene lista ni búsqueda de facturas, clientes o productos y no tiene vista JSON de un documento. Un documento se identifica por su serie y número, que el usuario proporciona o que la llamada de creación devolvió. Mantén el series, number y documentViewUrl de lo que creas.
Facturas: smartbill_create_invoice guarda un borrador a menos que is_draft sea falso. Una factura final obtiene el siguiente número de la serie y es un documento fiscal: SmartBill lo envía a ANAF e-Factura según la configuración de la cuenta, que esta API no controla. smartbill_create_invoice_from_estimate convierte una proforma en una factura. smartbill_get_invoice_payment_status indica lo que está pagado y lo que está pendiente, smartbill_get_invoice_pdf descarga el archivo, smartbill_send_document_email envía una factura o estimación al cliente por correo electrónico. smartbill_reverse_invoice (storno), smartbill_cancel_invoice, smartbill_restore_invoice y smartbill_delete_invoice están instalados desactivados.
Estimaciones (proforme): smartbill_create_estimate, smartbill_get_estimate_invoices (¿se facturó?), smartbill_get_estimate_pdf; smartbill_cancel_estimate, smartbill_restore_estimate y smartbill_delete_estimate están desactivados.
Pagos: smartbill_get_fiscal_receipt_text lee un recibo fiscal. smartbill_register_payment (registra una cobranza o emite un recibo), smartbill_delete_receipt y smartbill_delete_payment están desactivados. Nada aquí carga una tarjeta o mueve dinero: los pagos son registros contables.
Stock: smartbill_list_stocks devuelve cantidades por almacén (gestiune) en una fecha; los nombres de los almacenes son sensibles a mayúsculas.
Escribiendo un documento: seriesName, taxName y measuringUnitName deben coincidir exactamente con la cuenta; nunca los inventes. Los precios son sin IVA a menos que isTaxIncluded sea verdadero. taxPercentage es obligatorio en cada línea (21 es la tasa estándar desde agosto de 2025). Si la cuenta utiliza códigos de producto, cada línea necesita code. Una línea de descuento necesita numberOfItems y un discountValue negativo, de lo contrario se ignora silenciosamente o se añade. Para un cliente en Bucarest, la city debe ser Sector 1 a Sector 6, o e-Factura rechaza la factura. Cada documento, incluidos los borradores, cuenta para los documentos del plan de SmartBill.
Errores: el errorText de la respuesta es la causa, en rumano (por ejemplo Seria nu a fost gasita! para una serie desconocida); puede contener HTML, así que cita solo su primera oración. Una solicitud con un campo desconocido o un tipo incorrecto responde 400 con errors[].message y errors[].param nombrando el campo. 401 significa correo electrónico o token incorrecto, 403 que el usuario no tiene derecho sobre la empresa o serie.
Límites: 30 llamadas por 10 segundos por token; exceder esto bloquea el token durante 10 minutos. Los encabezados X-RateLimit-Remaining y X-RateLimit-Reset muestran lo que queda.
No cubierto: la API más nueva V3 (listas de clientes, productos, almacenes, proveedores y notas de recepción de mercancías) utiliza un token Bearer separado y no es parte de este conector. Los recibos fiscales (bon fiscal) necesitan una caja registradora y no se emiten aquí.
Paso 2 — Instalar el adaptador
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añadir el conector en Claude
La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector, y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala dondequiera que esta guía muestreYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin editar ningún archivo de configuración.
- En Claude, abre Plugins (en algunos planes aún Customize) → Connectors.
- Pulsa + Add y después Add custom connector.
- Escribe un nombre, por ejemplo
SmartBill, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Continue, deja los ajustes detectados y vuelve a pulsar Continue. - Elige Sign in now, pulsa Add e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas a continuación aparecerán en tu chat: comienza a escribir indicaciones.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
smartbill_list_series | Lista las series de documentos configuradas en SmartBill: list con cada serie name, su nextNumber y type (f facturas, p estimaciones y… |
smartbill_list_taxes | Lista las tasas de IVA configuradas en SmartBill: taxes con cada tasa name (por ejemplo, Normala) y percentage. Usa el nombre como taxName y el… |
smartbill_list_stocks | Lee los niveles de stock en una fecha: list con una entrada por almacén (warehouseName, warehouseType en gros o en detail) y sus products… |
smartbill_create_invoice | Crea una factura en SmartBill. Por defecto se guarda como un borrador (sin número), que el usuario verifica y finaliza en SmartBill; con… |
smartbill_create_invoice_from_estimate | Crea una factura a partir de una estimación existente (proforma): el cliente y las líneas se copian de la estimación. Por defecto, la factura se guarda como un… |
smartbill_get_invoice_payment_status | Verifica si una factura está pagada: invoiceTotalAmount (total con IVA), paidAmount, unpaidAmount y paid (verdadero cuando está completamente pagada).… |
smartbill_get_invoice_pdf | Descarga una factura emitida como un archivo PDF. La respuesta es el archivo en sí, entregado como un archivo adjunto; la API no tiene vista JSON de un… |
smartbill_send_document_email | Envía una factura o estimación emitida al cliente por correo electrónico como un archivo adjunto, con el asunto y el texto de la plantilla de correo electrónico configurados en… |
smartbill_reverse_invoice | Emite una factura de reversión (storno) para una factura existente: un nuevo documento fiscal con montos negativos en la misma serie. Cuenta para… |
smartbill_cancel_invoice | Cancela (anulare) una factura emitida. La factura mantiene su número y se marca como cancelada; se puede restaurar con… |
smartbill_restore_invoice | Restaura una factura que fue cancelada, haciéndola válida nuevamente. Instalado desactivado; confirma con el usuario antes de llamarlo |
smartbill_delete_invoice | Elimina una factura de forma permanente. Solo se puede eliminar la última factura de una serie, y esto no se puede deshacer. Instalado desactivado; confirma… |
smartbill_create_estimate | Crea una estimación (proforma) en SmartBill. Por defecto se guarda como un borrador (sin número); con is_draft falso se emite de inmediato con… |
smartbill_get_estimate_invoices | Verifica si una estimación (proforma) fue facturada: areInvoicesCreated y invoices con la series y number de cada factura realizada… |
smartbill_get_estimate_pdf | Descarga una estimación (proforma) como un archivo PDF. La respuesta es el archivo en sí, entregado como un archivo adjunto. Una serie o número incorrecto es… |
smartbill_cancel_estimate | Cancela una estimación (proforma). Mantiene su número y se puede restaurar con smartbill_restore_estimate. Instalado desactivado; confirma… |
smartbill_restore_estimate | Restaura una estimación (proforma) que fue cancelada. Instalado desactivado; confirma con el usuario antes de llamarlo |
smartbill_delete_estimate | Elimina una estimación (proforma) de forma permanente. Esto no se puede deshacer. Instalado desactivado; confirma con el usuario antes de llamarlo |
smartbill_register_payment | Registra un pago recibido de un cliente en SmartBill, opcionalmente contra facturas. El tipo decide qué se crea: Chitanta emite un… |
smartbill_get_fiscal_receipt_text | Lee el contenido de un recibo fiscal (bon fiscal) por su id: message contiene el texto del recibo para la impresora fiscal, codificado en Base64, en… |
smartbill_delete_receipt | Elimina un recibo (chitanta) de forma permanente. Solo se puede eliminar el último recibo de una serie. Instalado desactivado; confirma con el usuario… |
smartbill_delete_payment | Elimina un pago registrado que no es un recibo (Tarjeta, Orden de pago, CEC, etc.). Identifícalo por la factura que liquida (invoice_series… |
Ejemplos de indicaciones
- "¿Qué series de documentos y tasas de IVA están configuradas en SmartBill?"
- "Crea una factura borrador en la serie FCT para SC Exemplu SRL: 10 horas de consultoría a 200 lei más IVA."
- "¿Está pagada la factura FCT 0142, y cuánto queda pendiente?"
- "Convierte la proforma PRF 0031 en una factura y envíala por correo electrónico al cliente."
- "¿Cuál es el stock en el almacén Depozit Central hoy?"
Preguntas frecuentes
¿Funciona con Claude Code así como con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
¿De dónde provienen las credenciales? SmartBill Cloud, Contul meu, Integrari, sección API: copia el Email, el Token y el CIF de la empresa. Un conector funciona en una sola empresa; instálalo de nuevo para una segunda empresa. Este es el token V1, no el token Bearer de la API V3.
¿Qué cubre? Facturas y estimaciones (proforme) como borradores o documentos finales, facturas a partir de estimaciones, estado de pagos, PDFs, envío de documentos a clientes, texto de recibo fiscal, series de documentos, tasas de IVA y stock por almacén. La API V1 no tiene lista ni búsqueda de facturas, clientes o productos: un documento se identifica por su serie y número. Una factura final es un documento fiscal que SmartBill envía a ANAF e-Factura según la configuración de la cuenta.
¿Qué herramientas están instaladas desactivadas? smartbill_reverse_invoice, smartbill_cancel_invoice, smartbill_restore_invoice, smartbill_delete_invoice, smartbill_cancel_estimate, smartbill_restore_estimate, smartbill_delete_estimate, smartbill_register_payment, smartbill_delete_receipt y smartbill_delete_payment. Actívalas en la página del conector solo si la IA debe usarlas. Ninguna herramienta carga una tarjeta o mueve dinero.
Próximos pasos
- Página de inicio del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?