Resumen
API de SmartBill Cloud para facturación en Rumanía: emite facturas y estimaciones (proforma) como borradores o documentos finales, crea una factura a partir de una estimación, comprueba 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, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta SmartBill con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
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
API de SmartBill Cloud para facturación en Rumanía: emite facturas y estimaciones (proforma) como borradores o documentos finales, crea una factura a partir de una estimación, comprueba 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
Configurar toma 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 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 dirige 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í.
Requisitos previos: SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige SmartBill y pega las variables de entorno listadas bajo Requisitos previos.
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 revisa 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 | Comprueba 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 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 adjunto, con el asunto y 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 está marcada 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 llamarla |
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 | Comprueba 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 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 llamarla |
smartbill_delete_estimate | Elimina una estimación (proforma) de forma permanente. Esto no se puede deshacer. Instalado desactivado; confirma con el usuario antes de llamarla |
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 solicitudes
- "¿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?"
Próximos pasos
¿Te ha sido útil esta guía?