OpenJack › Conectores › Vendus TPV y Facturación

Contabilidad y facturación · Vendus

Vendus TPV y Facturación

Pregunta a Claude por tus ventas en Vendus: facturas, totales por tienda o método de pago, clientes y productos.

Acceso de solo lectura a una cuenta de Vendus (Cegid Vendus) a través de su API oficial v1.1. Enumera facturas, facturas simplificadas, facturas-recibo y notas de crédito con totales, abre cualquier documento con sus líneas, desglose del IVA y métodos de pago, y agrega las ventas por día, mes, tienda, método de pago o tipo de documento en cualquier periodo. También enumera clientes, productos con precios y stock, y tiendas. Nunca se escribe nada en Vendus.

Qué puedes preguntar

Ventas por tienda de ayer¿Cuánto facturamos en efectivo y cuánto con tarjeta este mes?Enumera las notas de crédito de octubre y dime a qué clientes correspondenEnséñame la factura FT 01P2026/133 con sus líneas y el IVA¿Qué productos tienen menos de 10 unidades en stock en Loja Baixa?

Herramientas y precios

6 herramientas

HerramientaQué hacePor llamada
vendus_list_documentsFacturas, recibos, notas de crédito y otros documentos de un periodo, con totales0,01 €
vendus_get_documentUn documento con sus líneas, desglose del IVA y métodos de pago0,01 €
vendus_sales_summaryTotales de ventas por día, mes, tienda, método de pago o tipo en un periodo0,05 €
vendus_list_clientsClientes con NIF y contactos, con búsqueda0,01 €
vendus_list_productsProductos con precios, código de IVA y stock por tienda0,01 €
vendus_list_storesTiendas y almacenes con sus ids0,01 €

Solo se cobra cuando la llamada se completa con éxito. Listar las herramientas es gratis.

Cómo conectarlo

Añádelo a Claude

Crea una cuenta de OpenJack y copia tu clave de conexión desde tu cuenta.
En Claude, abre «Settings → Connectors → Add custom connector» y pega https://vendus.openjack.dev/mcp.
Haz clic en «Connect». En la página de conexión, introduce tu clave de conexión y tus credenciales de Vendus. Se comprueban en tiempo real y se guardan cifradas.

Requisitos

FAQ

¿Puede Claude emitir o modificar facturas?

No. Todas las herramientas son de solo lectura; el conector solo realiza peticiones GET a la API de Vendus.

¿A qué da acceso la clave de API?

Exactamente a lo que puede ver el usuario de Vendus propietario de la clave. Crea un usuario dedicado con permisos limitados si quieres restringir Claude a una tienda o área.

¿Cómo se calculan los totales de ventas?

Se suman los documentos FT, FS, FR y FG, se restan las notas de crédito NC y se ignoran los documentos anulados. Los documentos pagados con varios métodos se reparten proporcionalmente. Las facturas liquidadas más tarde mediante un recibo aparte no muestran método de pago en la propia factura.

¿Hay límites?

Vendus pagina las colecciones hasta 1000 elementos y aplica límites de peticiones por cuenta (indicados en las cabeceras Rate-Limit-*). Un resumen de ventas recorre todos los documentos del periodo, hasta 5000 por tipo de documento, así que acota el periodo en cuentas muy grandes.

También en OpenJack