OpenJack › Conectores › Vendus POS e Faturação

Contabilidade e faturação · Vendus

Vendus POS e Faturação

Pergunte ao Claude sobre as suas vendas Vendus: faturas, totais por loja ou método de pagamento, clientes e artigos.

Acesso só de leitura a uma conta Vendus (Cegid Vendus) através da API oficial v1.1. Lista faturas, faturas simplificadas, faturas-recibo e notas de crédito com totais, abre qualquer documento com as suas linhas, discriminação do IVA e métodos de pagamento, e agrega as vendas por dia, mês, loja, método de pagamento ou tipo de documento em qualquer período. Também lista clientes, artigos com preços e stock, e lojas. Nada é alguma vez escrito no Vendus.

O que pode perguntar

Vendas por loja ontemQuanto faturámos em numerário e em cartão este mês?Lista as notas de crédito de outubro e diz-me a que clientes se referemMostra-me a fatura FT 01P2026/133 com as linhas e o IVAQue artigos têm menos de 10 unidades em stock na Loja Baixa?

Ferramentas e preços

6 ferramentas

FerramentaO que fazPor chamada
vendus_list_documentsFaturas, recibos, notas de crédito e outros documentos de um período, com totais0,01 €
vendus_get_documentUm documento com as suas linhas, discriminação do IVA e métodos de pagamento0,01 €
vendus_sales_summaryTotais de vendas por dia, mês, loja, método de pagamento ou tipo num período0,05 €
vendus_list_clientsClientes com NIF e contactos, com pesquisa0,01 €
vendus_list_productsArtigos com preços, código de IVA e stock por loja0,01 €
vendus_list_storesLojas e armazéns com os respetivos ids0,01 €

Só é cobrado quando a chamada é bem-sucedida. Listar as ferramentas é gratuito.

Como ligar

Adicione-o ao Claude

Crie uma conta OpenJack e copie a sua chave de ligação em a sua conta.
No Claude, abra «Settings → Connectors → Add custom connector» e cole https://vendus.openjack.dev/mcp.
Clique em «Connect». Na página de ligação, introduza a sua chave de ligação e as suas credenciais de Vendus. São verificadas em tempo real e guardadas encriptadas.

Requisitos

FAQ

O Claude pode emitir ou alterar faturas?

Não. Todas as ferramentas são só de leitura; o conector apenas faz pedidos GET à API do Vendus.

A que é que a chave de API dá acesso?

Exatamente ao que o utilizador Vendus dono da chave consegue ver. Crie um utilizador dedicado com permissões limitadas se quiser restringir o Claude a uma loja ou área.

Como são calculados os totais de vendas?

Os documentos FT, FS, FR e FG são somados, as notas de crédito NC são subtraídas e os documentos anulados são ignorados. Os documentos pagos com vários métodos são repartidos proporcionalmente. As faturas liquidadas mais tarde por um recibo separado não mostram método de pagamento na própria fatura.

Há limites?

O Vendus pagina as coleções até 1000 itens e aplica limites de pedidos por conta (indicados nos cabeçalhos Rate-Limit-*). Um resumo de vendas percorre todos os documentos do período, até 5000 por tipo de documento, por isso reduza o período em contas muito grandes.

Também no OpenJack