Guía de conector9 minutos de lectura22 herramientas MCP7 idiomas

Conectar SmartBill MCP con ChatGPT

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.

HCPor el equipo de HelpCodeActualizado 9 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

SmartBill

SmartBill

SmartBill Cloud API for Romanian invoicing: issue invoices and estimates (proforme) as drafts or final documents, create an invoice from an estimate, check payment status, download PDFs, email documents to clients, and read document series, VAT rates and stock by warehouse. Reversal, cancel, delete and payment registration are switched off. Email and API token.

herramientas

22

Región

RO

Categoría

Contabilidad

Autenticación

Basic Auth

Env vars requeridas

SMARTBILL_EMAILSMARTBILL_API_TOKENSMARTBILL_CIF
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

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 ChatGPT en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta SmartBill con la configuración guiada y añade tu URL MCP a ChatGPT. Sin código y sin servidores que mantener.

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

El plugin de AnythingMCP en el directorio de ChatGPT responde, en AnythingMCP Cloud, a preguntas sobre las bases de datos de tu empresa (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, solo lectura): abre la ficha (se abre en una pestaña nueva) y pulsa Install plugin. Los demás conectores se añaden a ChatGPT como servidor MCP personalizado con la URL MCP de tu AnythingMCP.

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.

SmartBill · live vía MCP
Compartir
Opus 4.7

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 + ChatGPT

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.

  1. Inicia sesión en SmartBill Cloud y abre Contul meu, Integrari, sección API (https://cloud.smartbill.ro/core/integrari/).
  2. Copia el Email en SMARTBILL_EMAIL, el Token en SMARTBILL_API_TOKEN y el CIF de la empresa en SMARTBILL_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 ChatGPT

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

  1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
  2. Escribe un nombre, por ejemplo Name: SmartBill.
  3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
  4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
  5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

Herramientas disponibles

HerramientaQué hace
smartbill_list_seriesLista las series de documentos configuradas en SmartBill: list con cada serie name, su nextNumber y type (f facturas, p estimaciones y…
smartbill_list_taxesLista 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_stocksLee 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_invoiceCrea 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_estimateCrea 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_statusVerifica si una factura está pagada: invoiceTotalAmount (total con IVA), paidAmount, unpaidAmount y paid (verdadero cuando está completamente pagada).…
smartbill_get_invoice_pdfDescarga 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_emailEnví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_invoiceEmite 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_invoiceCancela (anulare) una factura emitida. La factura mantiene su número y se marca como cancelada; se puede restaurar con…
smartbill_restore_invoiceRestaura una factura que fue cancelada, haciéndola válida nuevamente. Instalado desactivado; confirma con el usuario antes de llamarlo
smartbill_delete_invoiceElimina 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_estimateCrea 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_invoicesVerifica si una estimación (proforma) fue facturada: areInvoicesCreated y invoices con la series y number de cada factura realizada…
smartbill_get_estimate_pdfDescarga 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_estimateCancela una estimación (proforma). Mantiene su número y se puede restaurar con smartbill_restore_estimate. Instalado desactivado; confirma…
smartbill_restore_estimateRestaura una estimación (proforma) que fue cancelada. Instalado desactivado; confirma con el usuario antes de llamarlo
smartbill_delete_estimateElimina una estimación (proforma) de forma permanente. Esto no se puede deshacer. Instalado desactivado; confirma con el usuario antes de llamarlo
smartbill_register_paymentRegistra un pago recibido de un cliente en SmartBill, opcionalmente contra facturas. El tipo decide qué se crea: Chitanta emite un…
smartbill_get_fiscal_receipt_textLee 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_receiptElimina un recibo (chitanta) de forma permanente. Solo se puede eliminar el último recibo de una serie. Instalado desactivado; confirma con el usuario…
smartbill_delete_paymentElimina 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

¿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.

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Próximos pasos

¿Te ha sido útil esta guía?

Conecta SmartBill a ChatGPT en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta SmartBill con la configuración guiada y añade tu URL MCP a ChatGPT. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conectar SmartBill MCP con 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.

Conectores

Conectar SmartBill MCP con Microsoft Copilot

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.

Conectores

Conectar SmartBill MCP con Cursor

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.

Conectores

Conectar SmartBill MCP con Gemini CLI

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.

Conectores

Conectar SmartBill MCP con Meta Muse

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.

Conectores

SmartBill MCP Server: facturas, proformas y stock

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.