Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Moloni ON list my companies"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Servidor MCP que expõe a API GraphQL da Moloni ON a clientes de IA como o Claude Code e o Claude Desktop.
A API é grande (497 queries, 464 mutations); este servidor expõe um subconjunto curado de operações, adicionadas uma a uma. Cada operação GraphQL vira uma tool dedicada, tipada e documentada.
Versão atual:
0.867.2— desenvolvimento inicial (ver Versionamento).
Python 3.12 (ver .python-version); o projeto usa pyenv + venv, não uv.
Uma conta Moloni ON com acesso à API e uma API Key gerada.
Related MCP server: moneys3-mcp
pyenv local 3.12.1
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtcp .env.example .envEdita o .env:
MOLONION_API_URL=https://api.molonion.pt/v1
MOLONION_API_KEY=a-tua-api-key
# MOLONION_COMPANY_ID= # opcional, empresa por omissão⚠️ O
.envcontém segredos e está no.gitignore— nunca o commites.
A API Moloni ON usa Bearer token no header Authorization. Este servidor usa
uma API Key de serviço (integração máquina-a-máquina, sem browser):
Na Moloni ON, vai a Conta → API → separador "API Keys" e gera uma key.
Cola-a no .env em MOLONION_API_KEY.
O servidor envia-a em cada chamada como Authorization: Bearer <key>.
A key é permanente (com expiração opcional) — não há renovação de token. Para
confirmar que está tudo bem, chama a tool me (devolve o utilizador e as empresas).
Nota sobre erros: todas as operações devolvem
{ errors, data }. Os erros de negócio vêm com HTTP 200, no arrayerrors— o servidor já os deteta e devolve de forma legível.
Este projeto usa pyenv + venv, por isso não uses mcp dev (arranca com uv,
que não está instalado). Lança o Inspector apontando ao Python do venv:
npx @modelcontextprotocol/inspector .venv/bin/python server.pyAbre o link → Connect → Tools → List Tools e experimenta (começa pelo me).
A partir do projeto onde queres usar o MCP:
claude mcp add molonion -- /CAMINHO/ABSOLUTO/.venv/bin/python /CAMINHO/ABSOLUTO/server.pyO Claude Code arranca o servidor sozinho em cada sessão. Verifica com claude mcp list
ou /mcp. Depois de alterares o server.py, reconecta (/mcp → reconnect).
Tool | Descrição |
| Confirma que o servidor está vivo e mostra a config (sem expor a key). |
| Valida as credenciais; devolve |
| Lista as empresas acessíveis ao utilizador (id, nome, NIF, contactos). |
| Detalhes de uma empresa pelo seu ID (identificação, fiscal, banca, contagens). |
| Histórico de alterações (logs) às definições/dados de empresa. |
| Perfil de permissões (role) de uma empresa, com a lista de permissões. |
| Histórico de alterações (logs) aos perfis de permissões de uma empresa. |
| Lista os perfis de permissões (roles) configurados numa empresa. |
| Definições de comunicação com a Autoridade Tributária (AT) de uma empresa. |
| Valida a configuração AT e indica erros a corrigir no envio automático. |
| Verifica se um utilizador AT existe para as credenciais do Portal das Finanças. |
| Detalhes de um dado bancário (IBAN, SWIFT, banco) de uma empresa. |
| Histórico de alterações (logs) aos dados bancários de uma empresa. |
| Lista os dados bancários configurados de uma empresa (com paginação). |
| Detalhes de uma remessa bancária (SEPA) pelo seu ID. |
| Histórico de alterações (logs) às remessas bancárias de uma empresa. |
| Lista as remessas bancárias (SEPA) de uma empresa (com paginação). |
| Detalhes de uma guia de transporte (documento) pelo seu ID. |
| Token temporário para descarregar o PDF de uma guia de transporte. |
| Token temporário para descarregar várias guias de transporte em ZIP. |
| Histórico de alterações (logs) às guias de transporte de uma empresa. |
| Destinatários e estado de entrega de um envio por email de guias de transporte. |
| Histórico de emails enviados de uma guia de transporte. |
| Próximo número disponível para uma guia de transporte numa série. |
| Lista (paginada) as guias de transporte de uma empresa. |
| Vista consolidada de vários clientes em simultâneo (campos comuns). |
| Vista consolidada de vários produtos em simultâneo (campos comuns). |
| Vista consolidada de vários fornecedores em simultâneo (campos comuns). |
| Lista as subscrições de uma empresa (plano, preço, vigência, estado de pagamento). |
| Perfil de um utilizador numa empresa (identificação, |
| Histórico de alterações (logs) aos utilizadores de uma empresa. |
| Lista os utilizadores de uma empresa (identificação + |
| Detalhes de um país pelo seu ID (ISO 3166-1, nome, VIES, bandeira). |
| Lista os países (tabela de referência: |
| Detalhes de uma nota de crédito pelo seu ID (documento, entidade, reconciliação). |
| Token temporário para descarregar o PDF de uma nota de crédito. |
| Token temporário para descarregar várias notas de crédito em ZIP. |
| Histórico de alterações (logs) às notas de crédito de uma empresa. |
| Destinatários e estado de entrega de um envio por email de notas de crédito. |
| Histórico de emails enviados de uma nota de crédito. |
| Próximo número disponível para uma nota de crédito numa série. |
| Lista (paginada) as notas de crédito de uma empresa. |
| Detalhes de uma moeda pelo seu ID (ISO 4217, símbolo, casas decimais). |
| Lista as moedas (tabela de referência: |
| Lista as denominações (notas/moedas) de uma moeda (tipo, valor, imagem). |
| Taxa de câmbio entre duas moedas pelo seu ID (par, taxa, moedas from/to). |
| Lista as taxas de câmbio configuradas (par, taxa, moedas from/to). |
| Detalhes de um cliente pelo seu ID (identificação, financeiro, IDs associados). |
| Lista (paginada) os clientes de uma empresa (identificação, contactos, saldo). |
| Detalhes de um campo personalizado pelo seu ID (nome, tipo, obrigatório, opções). |
| Histórico de alterações (logs) aos campos personalizados de uma empresa. |
| Lista os campos personalizados configurados numa empresa. |
| Detalhes de uma nota de débito pelo seu ID (documento, entidade, reconciliação, vencimento). |
| Token temporário para descarregar o PDF de uma nota de débito. |
| Token temporário para descarregar várias notas de débito em ZIP. |
| Histórico de alterações (logs) às notas de débito de uma empresa. |
| Destinatários e estado de entrega de um envio por email de notas de débito. |
| Histórico de emails enviados de uma nota de débito. |
| Próximo número disponível para uma nota de débito numa série. |
| Lista (paginada) as notas de débito de uma empresa. |
| Detalhes de um método de entrega pelo seu ID (nome, default, visível). |
| Histórico de alterações (logs) aos métodos de entrega de uma empresa. |
| Lista os métodos de entrega configurados numa empresa. |
| Detalhes de uma guia de remessa pelo seu ID (documento, entidade, reconciliação, vencimento, transporte). |
| Token temporário para descarregar o PDF de uma guia de remessa. |
| Token temporário para descarregar várias guias de remessa em ZIP. |
| Histórico de alterações (logs) às guias de remessa de uma empresa. |
| Destinatários e estado de entrega de um envio por email de guias de remessa. |
| Histórico de emails enviados de uma guia de remessa. |
| Próximo número disponível para uma guia de remessa numa série. |
| Lista (paginada) as guias de remessa de uma empresa. |
| Documento genérico pelo seu ID (campos comuns a qualquer tipo + |
| Estado da comunicação de documentos com a AT (diagnóstico de envios). |
| Eventos associados a um documento (lembretes, tarefas, recorrência). |
| Link público partilhável de documento pelo seu ID (expiração, ficheiro, token). |
| Modelo de mensagem de email para documentos pelo seu ID (nome, conteúdo). |
| Histórico de alterações (logs) aos modelos de mensagem de email para documentos. |
| Lista os modelos de mensagem de email para documentos configurados numa empresa. |
| Próximo número de documento (genérico, por |
| Modelo de impressão de documento pelo seu ID (template HTML, CSS, título). |
| Histórico de alterações (logs) aos modelos de impressão de documento. |
| Lista os modelos de impressão de documento (sem template/css). |
| Documentos de uma entidade relacionáveis a outro documento (genérico, por |
| Lista (paginada) os documentos de uma empresa, de qualquer tipo (+ |
| Detalhes de uma série de documentos pelo seu ID (nome, default, visível). |
| Valida se códigos AT de série estão disponíveis ( |
| Valida um código AT de série para um tipo de documento (booleano). |
| Estado da comunicação de uma série de documentos com a AT pelo seu ID. |
| Histórico de estados da comunicação de séries de documentos com a AT. |
| Histórico de alterações (logs) aos estados AT de séries de documentos. |
| Histórico de alterações (logs) às séries de documentos de uma empresa. |
| Lista as séries de documentos configuradas numa empresa. |
| Séries de numeração disponíveis para um tipo de documento. |
| Séries de numeração para vários tipos de documento de uma vez (agrupadas por tipo). |
| Histórico de alterações (logs) aos documentos de uma empresa (genérico). |
| Detalhes de um tipo de documento pelo seu ID (apiCode, SAF-T, regras). |
| Lista os tipos de documento (tabela de referência: apiCode, SAF-T, título). |
| Detalhes de um código CAE pelo seu ID (código, descrição, default). |
| Histórico de alterações (logs) aos códigos CAE de uma empresa. |
| Lista os códigos CAE configurados numa empresa. |
| Detalhes de um orçamento pelo seu ID (documento, entidade, validade, transporte). |
| Token temporário para descarregar o PDF de um orçamento. |
| Token temporário para descarregar vários orçamentos em ZIP. |
| Histórico de alterações (logs) aos orçamentos de uma empresa. |
| Destinatários e estado de entrega de um envio por email de orçamentos. |
| Histórico de emails enviados de um orçamento. |
| Próximo número disponível para um orçamento numa série. |
| Lista (paginada) os orçamentos de uma empresa. |
| Detalhes de um evento pelo seu ID (nome, data, documento, recorrência). |
| Histórico de alterações (logs) aos eventos de uma empresa. |
| Lista os eventos de uma empresa (lembretes, tarefas, recorrência). |
| Lista os eventos de uma empresa numa data específica (agenda). |
| Lista os eventos de uma empresa no mês da data indicada (vista mensal). |
| Definições de impostos por zona fiscal (regras de faturação por zona). |
| Definições de impostos de uma zona fiscal específica (sem envelope). |
| Detalhes de uma zona geográfica pelo seu ID (nome, abreviatura, notas). |
| Histórico de alterações (logs) às zonas geográficas de uma empresa. |
| Lista as zonas geográficas configuradas numa empresa. |
| Token temporário para descarregar o ficheiro XML de inventário para a AT. |
| Empresa pelo seu |
| Token temporário para descarregar o ficheiro RGPD de um cliente. |
| Documentos associados a um cliente (número, data, total, reconciliação, estado). |
| Token temporário para descarregar o anexo de um documento. |
| Token temporário para descarregar o ficheiro XML de EDI de um documento. |
| Família da taxonomia de um canal/marketplace (id, título, canal). |
| Token temporário para descarregar o ficheiro de erros de uma folha de importação. |
| Token temporário para descarregar o ficheiro de avisos de uma folha de importação. |
| Token temporário para descarregar o ficheiro importado de um trabalho de importação. |
| Token temporário para descarregar um ficheiro PDF (genérico). |
| Documentos elegíveis para uma remessa bancária (SEPA), por categoria. |
| Token temporário para descarregar o ficheiro de erros de uma importação SAF-T. |
| Token temporário para descarregar o ficheiro de avisos de uma importação SAF-T. |
| Token temporário para descarregar o ficheiro SAF-T importado. |
| Token temporário para descarregar o ficheiro XML SAF-T(PT) de uma empresa. |
| Documentos associados a um vendedor (com comissão). |
| Documentos associados a um fornecedor (número, data, total, estado). |
| Token temporário para descarregar um ficheiro XLSX (Excel). |
| Token temporário para descarregar um ficheiro XML (genérico). |
| Detalhes de um webhook pelo seu ID (nome, URL, gatilhos: modelo/operação). |
| Histórico de alterações (logs) aos webhooks de uma empresa. |
| Catálogo de gatilhos disponíveis para webhooks (modelo/operação). |
| Lista os webhooks configurados numa empresa (nome, URL, gatilhos). |
| Detalhes de um template de identificação pelo seu ID (dados alternativos de documento). |
| Histórico de alterações (logs) aos templates de identificação. |
| Lista os templates de identificação configurados numa empresa. |
| Detalhes de uma fatura pelo seu ID (documento, entidade, reconciliação, vencimento, transporte). |
| Token temporário para descarregar o PDF de uma fatura. |
| Token temporário para descarregar várias faturas em ZIP. |
| Histórico de alterações (logs) às faturas de uma empresa. |
| Destinatários e estado de entrega de um envio por email de faturas. |
| Histórico de emails enviados de uma fatura. |
| Próximo número disponível para uma fatura numa série. |
| Lista (paginada) as faturas de uma empresa. |
| Verifica se uma ação sobre um recurso é permitida (controlo de acesso + quotas). |
| Detalhes de um template de etiquetas pelo seu ID (nome, tamanho, default). |
| Histórico de alterações (logs) aos templates de etiquetas. |
| Lista os templates de etiquetas configurados numa empresa. |
| Detalhes de um idioma pelo seu ID (nome, ISO 3166, bandeira). |
| Lista os idiomas (tabela de referência: |
| Totais de stock dos produtos (custo total, valor de venda). |
| Detalhes de uma data de vencimento pelo seu ID (nome, dias, desconto). |
| Histórico de alterações (logs) às datas de vencimento de uma empresa. |
| Lista as datas de vencimento configuradas numa empresa. |
| Atividade recente do utilizador autenticado (clientes de API). |
| Detalhes de uma unidade de medida pelo seu ID (nome, abreviatura, UN/ECE). |
| Unidade de medida da tabela global (sem |
| Lista as unidades de medida da tabela global (sem |
| Histórico de alterações (logs) às unidades de medida de uma empresa. |
| Lista as unidades de medida configuradas numa empresa. |
| Verifica se a API Key está autenticada (booleano). |
| Verifica se uma password corresponde à do utilizador autenticado (booleano). |
| Lista os métodos 2FA configurados pelo utilizador autenticado. |
| Detalhes de uma nota de crédito migrada pelo seu ID (documento histórico). |
| Token temporário para descarregar o PDF de uma nota de crédito migrada. |
| Token temporário para descarregar várias notas de crédito migradas em ZIP. |
| Histórico de alterações (logs) às notas de crédito migradas. |
| Destinatários e estado de entrega de um envio por email de notas de crédito migradas. |
| Histórico de emails enviados de uma nota de crédito migrada. |
| Próximo número disponível para uma nota de crédito migrada numa série. |
| Lista (paginada) as notas de crédito migradas de uma empresa. |
| Detalhes de uma nota de débito migrada pelo seu ID (documento histórico). |
| Token temporário para descarregar o PDF de uma nota de débito migrada. |
| Token temporário para descarregar várias notas de débito migradas em ZIP. |
| Histórico de alterações (logs) às notas de débito migradas. |
| Destinatários e estado de entrega de um envio por email de notas de débito migradas. |
| Histórico de emails enviados de uma nota de débito migrada. |
| Próximo número disponível para uma nota de débito migrada numa série. |
| Lista (paginada) as notas de débito migradas de uma empresa. |
| Detalhes de um orçamento migrado pelo seu ID (documento histórico). |
| Token temporário para descarregar o PDF de um orçamento migrado. |
| Token temporário para descarregar vários orçamentos migrados em ZIP. |
| Histórico de alterações (logs) aos orçamentos migrados. |
| Destinatários e estado de entrega de um envio por email de orçamentos migrados. |
| Histórico de emails enviados de um orçamento migrado. |
| Próximo número disponível para um orçamento migrado numa série. |
| Lista (paginada) os orçamentos migrados de uma empresa. |
| Detalhes de uma fatura migrada pelo seu ID (documento histórico). |
| Token temporário para descarregar o PDF de uma fatura migrada. |
| Token temporário para descarregar várias faturas migradas em ZIP. |
| Histórico de alterações (logs) às faturas migradas. |
| Destinatários e estado de entrega de um envio por email de faturas migradas. |
| Histórico de emails enviados de uma fatura migrada. |
| Próximo número disponível para uma fatura migrada numa série. |
| Detalhes de uma fatura-recibo migrada pelo seu ID (documento histórico). |
| Token temporário para descarregar o PDF de uma fatura-recibo migrada. |
| Token temporário para descarregar várias faturas-recibo migradas em ZIP. |
| Histórico de alterações (logs) às faturas-recibo migradas. |
| Destinatários e estado de entrega de um envio por email de faturas-recibo migradas. |
| Histórico de emails enviados de uma fatura-recibo migrada. |
| Próximo número disponível para uma fatura-recibo migrada numa série. |
| Lista (paginada) as faturas-recibo migradas de uma empresa. |
| Lista (paginada) as faturas migradas de uma empresa. |
| Detalhes de uma encomenda de compra migrada pelo seu ID (documento histórico). |
| Token temporário para descarregar o PDF de uma encomenda de compra migrada. |
| Token temporário para descarregar várias encomendas de compra migradas em ZIP. |
| Histórico de alterações (logs) às encomendas de compra migradas. |
| Destinatários e estado de entrega de um envio por email de encomendas de compra migradas. |
| Histórico de emails enviados de uma encomenda de compra migrada. |
| Próximo número disponível para uma encomenda de compra migrada numa série. |
| Lista (paginada) as encomendas de compra migradas de uma empresa. |
| Detalhes de um recibo migrado pelo seu ID (documento histórico). |
| Token temporário para descarregar o PDF de um recibo migrado. |
| Token temporário para descarregar vários recibos migrados em ZIP. |
| Histórico de alterações (logs) aos recibos migrados. |
| Destinatários e estado de entrega de um envio por email de recibos migrados. |
| Histórico de emails enviados de um recibo migrado. |
| Próximo número disponível para um recibo migrado numa série. |
| Lista (paginada) os recibos migrados de uma empresa. |
| Detalhes de uma fatura simplificada migrada pelo seu ID (documento histórico). |
| Token temporário para descarregar o PDF de uma fatura simplificada migrada. |
| Token temporário para descarregar várias faturas simplificadas migradas em ZIP. |
| Histórico de alterações (logs) às faturas simplificadas migradas. |
| Destinatários e estado de entrega de um envio por email de faturas simplificadas migradas. |
| Histórico de emails enviados de uma fatura simplificada migrada. |
| Próximo número disponível para uma fatura simplificada migrada numa série. |
| Lista (paginada) as faturas simplificadas migradas de uma empresa. |
| Lista as notificações do utilizador autenticado (lida, tipo, título, link). |
| Detalhes de um método de pagamento pelo seu ID (nome, tipo, comissão, default). |
| Histórico de alterações (logs) aos métodos de pagamento de uma empresa. |
| Lista os métodos de pagamento configurados numa empresa. |
| Detalhes de uma devolução de pagamento pelo seu ID (documento, entidade, reconciliação). |
| Token temporário para descarregar o PDF de uma devolução de pagamento. |
| Token temporário para descarregar várias devoluções de pagamento em ZIP. |
| Histórico de alterações (logs) às devoluções de pagamento de uma empresa. |
| Destinatários e estado de entrega de um envio por email de devoluções de pagamento. |
| Histórico de emails enviados de uma devolução de pagamento. |
| Próximo número disponível para uma devolução de pagamento numa série. |
| Lista (paginada) as devoluções de pagamento de uma empresa. |
| Detalhes de uma classe de preço pelo seu ID (nome, visível). |
| Lista as classes de preço configuradas numa empresa. |
| Histórico de alterações (logs) às classes de preço de uma empresa. |
| Número de produtos a que uma classe de preço está aplicada. |
| Detalhes de um produto pelo seu ID (identificação, preços, stock, IDs associados). |
| Lista as categorias de produto (hierarquia, contagens de filhos). |
| Detalhes de uma categoria de produto pelo seu ID (nome, pai, contagens). |
| Histórico de alterações (logs) às categorias de produto de uma empresa. |
| Documentos onde um produto aparece como linha (union; + |
| Histórico de alterações (logs) aos produtos de uma empresa. |
| Lista (paginada) os produtos de uma empresa (referência, nome, preços, stock). |
| Margens de lucro por produto (custo/preço médio, markup, qtd vendida). |
| Linhas de documento que formam a margem de um produto. |
| Totais agregados de margem de lucro (produtos, qtd, margem, markup). |
| Modelos de definições do utilizador para o ecrã de margens de lucro. |
| Detalhes de uma fatura pró-forma pelo seu ID (documento, entidade, reconciliação, validade, transporte). |
| Token temporário para descarregar o PDF de uma fatura pró-forma. |
| Token temporário para descarregar várias faturas pró-forma em ZIP. |
| Histórico de alterações (logs) às faturas pró-forma. |
| Destinatários e estado de entrega de um envio por email de faturas pró-forma. |
| Histórico de envios por email de uma fatura pró-forma. |
| Próximo número disponível para uma fatura pró-forma numa série. |
| Lista paginada das faturas pró-forma de uma empresa. |
| Grupo de propriedades (variantes) com a árvore propriedades → valores. |
| Histórico de alterações (logs) aos grupos de propriedades. |
| Lista paginada dos grupos de propriedades (com as suas propriedades). |
| Detalhes de uma encomenda de compra pelo seu ID (documento, fornecedor, câmbio, reconciliação, transporte). |
| Token temporário para descarregar o PDF de uma encomenda de compra. |
| Token temporário para descarregar várias encomendas de compra em ZIP. |
| Histórico de alterações (logs) às encomendas de compra. |
| Destinatários e estado de entrega de um envio por email de encomendas de compra. |
| Histórico de envios por email de uma encomenda de compra. |
| Próximo número disponível para uma encomenda de compra numa série. |
| Lista paginada das encomendas de compra de uma empresa. |
| Detalhes de um acordo recorrente de compra pelo seu ID (documento-modelo, fornecedor, totais). |
| Token temporário para descarregar o PDF de um acordo recorrente de compra. |
| Token temporário para descarregar vários acordos recorrentes de compra em ZIP. |
| Histórico de alterações (logs) aos acordos recorrentes de compra. |
| Destinatários e estado de entrega de um envio por email de acordos recorrentes de compra. |
| Histórico de envios por email de um acordo recorrente de compra. |
| Próximo número disponível para um acordo recorrente de compra numa série. |
| Lista paginada dos acordos recorrentes de compra de uma empresa. |
| Análise de compras por data, ao nível do produto (qty e valores por período). |
| Análise de compras por data ao nível da linha de documento (com o documento de origem). |
| Análise de compras agregada por produto (qty e valores totais). |
| Análise de compras agregada por categoria de produto. |
| Análise de compras por categoria ao nível da linha de documento (com o documento de origem). |
| Análise de compras por produto ao nível da linha de documento (com o documento de origem). |
| Totais agregados da análise de compras (valores e contagens). |
| Compras pendentes (por liquidar) agrupadas por fornecedor. |
| Documentos de compra pendentes agrupados por data de vencimento (com saldo acumulado). |
| Documentos de compra pendentes de um fornecedor (extrato de contas a pagar, com saldo acumulado). |
| Totais agregados das compras pendentes (montantes, contagens, atraso). |
| Modelos de definições do utilizador para o ecrã de compras pendentes. |
| Extrato de compras a fornecedores (documentos e estado de liquidação). |
| Totais agregados do extrato de compras (valores e contagens). |
| Detalhes de um recibo pelo seu ID (liquidação, reconciliação, entidade). |
| Token temporário para descarregar o PDF de um recibo. |
| Token temporário para descarregar vários recibos em ZIP. |
| Histórico de alterações (logs) aos recibos. |
| Destinatários e estado de entrega de um envio por email de recibos. |
| Histórico de envios por email de um recibo. |
| Próximo número disponível para um recibo numa série. |
| Lista paginada dos recibos de uma empresa. |
| Detalhes de um acordo recorrente de venda pelo seu ID (documento-modelo, cliente, totais). |
| Token temporário para descarregar o PDF de um acordo recorrente de venda. |
| Token temporário para descarregar vários acordos recorrentes de venda em ZIP. |
| Histórico de alterações (logs) aos acordos recorrentes de venda. |
| Destinatários e estado de entrega de um envio por email de acordos recorrentes de venda. |
| Histórico de envios por email de um acordo recorrente de venda. |
| Próximo número disponível para um acordo recorrente de venda numa série. |
| Lista paginada dos acordos recorrentes de venda de uma empresa. |
| Detalhes de uma retenção na fonte pelo seu ID (nome, taxa). |
| Histórico de alterações (logs) às retenções. |
| Lista paginada das retenções na fonte de uma empresa. |
| Análise de vendas por data, ao nível do produto (qty e valores por período). |
| Análise de vendas por data ao nível da linha de documento (com o documento de origem). |
| Análise de vendas agregada por produto (qty e valores totais). |
| Análise de vendas agregada por categoria de produto. |
| Análise de vendas por categoria ao nível da linha de documento (com o documento de origem). |
| Análise de vendas por produto ao nível da linha de documento (com o documento de origem). |
| Totais agregados da análise de vendas (valores e contagens). |
| Vendas pendentes (por receber) agrupadas por cliente. |
| Documentos de venda pendentes agrupados por data de vencimento (com saldo acumulado). |
| Documentos de venda pendentes de um cliente (extrato de contas a receber, com saldo acumulado). |
| Totais agregados das vendas pendentes (montantes, percentagem, atraso). |
| Detalhes de um vendedor pelo seu ID (nome, contactos, comissão-base). |
| Comissões de vendedores por documento (valor, reconciliação, documento de origem). |
| Histórico de alterações (logs) aos vendedores. |
| Detalhes de um pagamento a vendedor pelo seu ID (liquidação de comissões). |
| Comissões saldadas por um pagamento a vendedor (ligações de reconciliação). |
| Token temporário para descarregar o PDF de um pagamento a vendedor. |
| Token temporário para descarregar vários pagamentos a vendedor em ZIP. |
| Histórico de alterações (logs) aos pagamentos a vendedor. |
| Destinatários e estado de entrega de um envio por email de pagamentos a vendedor. |
| Histórico de envios por email de um pagamento a vendedor. |
| Próximo número disponível para um pagamento a vendedor numa série. |
| Lista paginada dos pagamentos a vendedor de uma empresa. |
| Lista paginada dos vendedores de uma empresa. |
| Histórico de pagamentos a vendedores agregado por vendedor. |
| Histórico de pagamentos a vendedores ao nível do documento. |
| Totais agregados do histórico de pagamentos a vendedores. |
| Comissões pendentes (por pagar) agregadas por vendedor. |
| Comissões pendentes (por pagar) ao nível do documento. |
| Totais agregados das comissões pendentes (valor, média, atraso). |
| Extrato de vendas a clientes (documentos e estado de liquidação). |
| Totais agregados do extrato de vendas (valores e contagens). |
| Detalhes de uma nota de acerto pelo seu ID (liquidação, reconciliação, entidade). |
| Token temporário para descarregar o PDF de uma nota de acerto. |
| Token temporário para descarregar várias notas de acerto em ZIP. |
| Histórico de alterações (logs) às notas de acerto. |
| Destinatários e estado de entrega de um envio por email de notas de acerto. |
| Histórico de envios por email de uma nota de acerto. |
| Próximo número disponível para uma nota de acerto numa série. |
| Lista paginada das notas de acerto de uma empresa. |
| Detalhes de uma fatura simplificada pelo seu ID (documento, cliente, totais, reconciliação). |
| Token temporário para descarregar o PDF de uma fatura simplificada. |
| Token temporário para descarregar várias faturas simplificadas em ZIP. |
| Histórico de alterações (logs) às faturas simplificadas. |
| Destinatários e estado de entrega de um envio por email de faturas simplificadas. |
| Histórico de envios por email de uma fatura simplificada. |
| Próximo número disponível para uma fatura simplificada numa série. |
| Lista paginada das faturas simplificadas de uma empresa. |
| Detalhes de um regime especial de imposto (tabela global) pelo seu ID. |
| Lista dos regimes especiais de imposto (tabela global). |
| Histórico de movimentos de stock de um produto (FIFO/LIFO, documento de origem). |
| Produtos com informação de stock (stock, mínimos, valor de inventário). |
| Modelos de definições do utilizador para o ecrã de stock. |
| Módulos/suplementos disponíveis (add-ons) por país e idioma (data JSON). |
| Detalhes de um fornecedor pelo seu ID (contactos, dados bancários, crédito). |
| Detalhes de uma guia de transporte de compra pelo seu ID. |
| Token temporário para descarregar o PDF de uma guia de transporte de compra. |
| Token temporário para descarregar várias guias de transporte de compra em ZIP. |
| Histórico de alterações (logs) às guias de transporte de compra. |
| Destinatários e estado de entrega de um envio por email de guias de transporte de compra. |
| Histórico de envios por email de uma guia de transporte de compra. |
| Próximo número disponível para uma guia de transporte de compra numa série. |
| Lista paginada das guias de transporte de compra de uma empresa. |
| Detalhes de uma nota de crédito de compra pelo seu ID (sem vencimento/transporte). |
| Token temporário para descarregar o PDF de uma nota de crédito de compra. |
| Token temporário para descarregar várias notas de crédito de compra em ZIP. |
| Histórico de alterações (logs) às notas de crédito de compra. |
| Destinatários e estado de entrega de um envio por email de notas de crédito de compra. |
| Histórico de envios por email de uma nota de crédito de compra. |
| Próximo número disponível para uma nota de crédito de compra numa série. |
| Lista paginada das notas de crédito de compra de uma empresa. |
| Detalhes de uma fatura de compra pelo seu ID (documento, fornecedor, vencimento, transporte). |
| Token temporário para descarregar o PDF de uma fatura de compra. |
| Token temporário para descarregar várias faturas de compra em ZIP. |
| Histórico de alterações (logs) às faturas de compra. |
| Destinatários e estado de entrega de um envio por email de faturas de compra. |
| Histórico de envios por email de uma fatura de compra. |
| Próximo número disponível para uma fatura de compra numa série. |
| Lista paginada das faturas de compra de uma empresa. |
| Histórico de alterações (logs) aos fornecedores. |
| Detalhes de uma nota de encomenda de compra a fornecedor pelo seu ID. |
| Token temporário para descarregar o PDF de uma nota de encomenda de compra a fornecedor. |
| Token temporário para descarregar várias notas de encomenda de compra a fornecedor em ZIP. |
| Histórico de alterações (logs) às notas de encomenda de compra a fornecedor. |
| Destinatários e estado de entrega de um envio por email de notas de encomenda de compra a fornecedor. |
| Histórico de envios por email de uma nota de encomenda de compra a fornecedor. |
| Próximo número disponível para uma nota de encomenda de compra a fornecedor numa série. |
| Lista paginada das notas de encomenda de compra a fornecedor de uma empresa. |
| Detalhes de um recibo de compra pelo seu ID (liquidação a fornecedor, reconciliação). |
| Token temporário para descarregar o PDF de um recibo de compra. |
| Token temporário para descarregar vários recibos de compra em ZIP. |
| Histórico de alterações (logs) aos recibos de compra. |
| Destinatários e estado de entrega de um envio por email de recibos de compra. |
| Histórico de envios por email de um recibo de compra. |
| Próximo número disponível para um recibo de compra numa série. |
| Lista paginada dos recibos de compra de uma empresa. |
| Lista paginada dos fornecedores de uma empresa. |
| Detalhes de uma taxa de imposto (IVA) pelo seu ID (valor, zona fiscal, isenção). |
| Lista paginada das taxas de imposto (IVA) de uma empresa. |
| Mapa de impostos/apuramento de IVA (versão atual) — totais e taxas por grupo. |
| Histórico de alterações (logs) às taxas de imposto. |
| Detalhes de um fuso horário (tabela global) pelo seu ID. |
| Lista dos fusos horários (tabela global). |
| Detalhes de uma viatura pelo seu ID (nome, matrícula). |
| Histórico de alterações (logs) às viaturas. |
| Lista paginada das viaturas de uma empresa. |
| Valida um NIF intracomunitário no VIES da UE (nome e morada registados). |
| Detalhes de um armazém pelo seu ID (morada, contactos, stock). |
| Histórico de alterações (logs) aos armazéns. |
| Lista paginada dos armazéns de uma empresa. |
| Detalhes de uma fatura-recibo pelo seu ID (documento, entidade, reconciliação, pagamento). |
| Token temporário para descarregar o PDF de uma fatura-recibo. |
| Token temporário para descarregar várias faturas-recibo em ZIP. |
| Histórico de alterações (logs) às faturas-recibo de uma empresa. |
| Destinatários e estado de entrega de um envio por email de faturas-recibo. |
| Histórico de emails enviados de uma fatura-recibo. |
| Próximo número disponível para uma fatura-recibo numa série. |
| Lista (paginada) as faturas-recibo de uma empresa. |
| Resumo de conta-corrente por cliente (documentos, débito/crédito, saldos). |
| Extrato (conta-corrente) de um cliente: documentos que movimentam a conta + saldo. |
| Modelos de definições do utilizador para o ecrã de conta-corrente de clientes. |
| Histórico de alterações (logs) aos clientes de uma empresa. |
| Próximo número de cliente disponível numa empresa. |
| Detalhes de uma nota de devolução de cliente (documento, entidade, reconciliação, transporte). |
| Token temporário para descarregar o PDF de uma nota de devolução de cliente. |
| Token temporário para descarregar várias notas de devolução de cliente em ZIP. |
| Histórico de alterações (logs) às notas de devolução de cliente. |
| Destinatários e estado de entrega de um envio por email de notas de devolução de cliente. |
| Histórico de emails enviados de uma nota de devolução de cliente. |
| Próximo número disponível para uma nota de devolução de cliente numa série. |
| Lista (paginada) as notas de devolução de cliente de uma empresa. |
⚠️ As mutations alteram dados reais na Moloni ON. As que têm efeitos destrutivos/irreversíveis (apagar, anular, comunicar à AT) estão assinaladas.
Tool | Descrição |
| Marca todas as notificações como lidas/confirmadas na conta autenticada. |
| Marca uma notificação como lida/confirmada na conta autenticada. |
| Aplica uma classe de preço a produtos (ajuste de preço em %, assíncrono). ⚠️ altera preços em massa. |
| Atualiza as definições de comunicação à AT (automáticos, credenciais AT). ⚠️ credenciais sensíveis. |
| Cria um dado bancário (IBAN/SWIFT/conta) numa empresa. |
| Apaga um ou mais dados bancários (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza um dado bancário (rótulo, valor, associação à empresa). |
| Cria uma remessa bancária (SEPA) agrupando documentos. |
| Apaga uma ou mais remessas bancárias (em lote, só não processadas). ⚠️ destrutiva/irreversível. |
| Atualiza uma remessa bancária (tipo, nome, data, documentos, estado). |
| Cria uma ou mais guias de transporte (em lote; input de documento por dict). ⚠️ cria documentos reais. |
| Cria uma guia de transporte (singular; input de documento por dict). ⚠️ cria documento real. |
| Apaga uma ou mais guias de transporte (em lote). ⚠️ destrutiva/irreversível. |
| Reverte uma guia de transporte finalizada para rascunho (reeditar). ⚠️ altera estado. |
| (Re)gera o PDF de uma guia de transporte no servidor (descarregar via token). |
| (Re)gera um ZIP com PDFs de várias guias de transporte (descarregar via token). |
| Anula uma guia de transporte (com motivo). ⚠️ operação fiscal irreversível. |
| Envia guias de transporte por email (to/cc/bcc, mensagem, anexo). ⚠️ envia email real. |
| Atualiza uma guia de transporte (input de documento por dict). ⚠️ altera documento real. |
| Cria um perfil de permissões (role) com permissões recurso-ação. |
| Apaga um ou mais perfis de permissões (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza um perfil de permissões (código, nome, descrição, pai, permissões). |
| Atualiza os dados de uma empresa (parcial; ~80 campos por dict). ⚠️ altera dados fiscais/faturação. |
| Adiciona um utilizador a uma empresa (convite por email, perfil). ⚠️ dá acesso à empresa. |
| Remove um ou mais utilizadores de uma empresa (em lote). ⚠️ destrutiva. |
| Envia email de recuperação de password a um utilizador. ⚠️ envia email real. |
| Atualiza um utilizador de empresa (nome, telefone, perfil, idioma). |
| Cria/regista um utilizador AT (Portal das Finanças). ⚠️ credenciais AT sensíveis. |
| Cria uma ou mais notas de crédito (em lote; corrige documentos de origem). ⚠️ cria documentos reais. |
| Cria uma nota de crédito (singular). ⚠️ cria documento real. |
| Apaga uma ou mais notas de crédito (em lote, só rascunhos). ⚠️ destrutiva/irreversível. |
| Reverte uma nota de crédito finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma nota de crédito no servidor (descarregar via token). |
| (Re)gera um ZIP com PDFs de várias notas de crédito (descarregar via token). |
| Anula uma nota de crédito (com motivo). ⚠️ operação fiscal irreversível. |
| Envia notas de crédito por email (to/cc/bcc, mensagem, anexo). ⚠️ envia email real. |
| Atualiza uma nota de crédito (input de documento por dict). ⚠️ altera documento real. |
| Cria um cliente (number/país/idioma obrigatórios; comuns + extra_fields). |
| Apaga um ou mais clientes (em lote). ⚠️ destrutiva/irreversível. |
| Envia email RGPD a um cliente (relatório de dados, consentimento, apagamento). ⚠️ envia email real. |
| Cria uma ou mais notas de devolução de cliente (em lote). ⚠️ cria documentos reais. |
| Cria uma nota de devolução de cliente (singular). ⚠️ cria documento real. |
| Apaga uma ou mais notas de devolução de cliente (em lote, só rascunhos). ⚠️ destrutiva/irreversível. |
| Reverte uma nota de devolução de cliente finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma nota de devolução de cliente no servidor (descarregar via token). |
| (Re)gera um ZIP com PDFs de várias notas de devolução de cliente (descarregar via token). |
| Anula uma nota de devolução de cliente (com motivo). ⚠️ operação fiscal irreversível. |
| Envia notas de devolução de cliente por email. ⚠️ envia email real. |
| Atualiza uma nota de devolução de cliente (input de documento por dict). ⚠️ altera documento real. |
| Atualiza um cliente (parcial; comuns + extra_fields). |
| Cria uma ou mais notas de débito (em lote; refere documentos de origem). ⚠️ cria documentos reais. |
| Cria uma nota de débito (singular). ⚠️ cria documento real. |
| Apaga uma ou mais notas de débito (em lote, só rascunhos). ⚠️ destrutiva/irreversível. |
| Reverte uma nota de débito finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma nota de débito no servidor (descarregar via token). |
| (Re)gera um ZIP com PDFs de várias notas de débito (descarregar via token). |
| Anula uma nota de débito (com motivo). ⚠️ operação fiscal irreversível. |
| Envia notas de débito por email. ⚠️ envia email real. |
| Atualiza uma nota de débito (input de documento por dict). ⚠️ altera documento real. |
| Cria um método de entrega (nome, por omissão). |
| Apaga um ou mais métodos de entrega (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza um método de entrega (nome, por omissão). |
| Cria uma ou mais guias de remessa (em lote). ⚠️ cria documentos reais. |
| Cria uma guia de remessa (singular). ⚠️ cria documento real. |
| Apaga uma ou mais guias de remessa (em lote, só rascunhos). ⚠️ destrutiva/irreversível. |
| Reverte uma guia de remessa finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma guia de remessa no servidor (descarregar via token). |
| (Re)gera um ZIP com PDFs de várias guias de remessa (descarregar via token). |
| Anula uma guia de remessa (com motivo). ⚠️ operação fiscal irreversível. |
| Envia guias de remessa por email. ⚠️ envia email real. |
| Atualiza uma guia de remessa (input de documento por dict). ⚠️ altera documento real. |
| Marca uma comunicação AT de documento como resolvida (não comunica à AT). |
| Repete a comunicação à AT de um documento. ⚠️ ação fiscal (comunica à AT). |
| Repete todas as comunicações à AT falhadas (em lote). ⚠️ ação fiscal em massa. |
| Atualiza os dados AT de um documento (código AT de transporte). ⚠️ altera dados fiscais. |
| Apaga um ou mais documentos de qualquer tipo (em lote, só rascunhos). ⚠️ destrutiva/irreversível. |
| Cria um modelo de mensagem de email para envio de documentos. |
| Apaga um ou mais modelos de mensagem de email (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza um modelo de mensagem de email (nome, conteúdo). |
| Repete o registo na AT de uma série de documentos. ⚠️ ação fiscal (comunica à AT). |
| Repete todos os registos de séries na AT falhados (em lote). ⚠️ ação fiscal em massa. |
| Cria uma série de documentos (numeração). |
| Apaga uma ou mais séries de documentos (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza uma série de documentos (nome, por omissão, modelo, CAE). |
| Cria um código CAE (código, título, por omissão). |
| Apaga um ou mais códigos CAE (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza um código CAE (código, título, por omissão). |
| Cria um ou mais orçamentos (em lote). ⚠️ cria documentos reais. |
| Cria um orçamento (singular). ⚠️ cria documento real. |
| Apaga um ou mais orçamentos (em lote, só rascunhos). ⚠️ destrutiva/irreversível. |
| Reverte um orçamento finalizado para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de um orçamento no servidor (descarregar via token). |
| (Re)gera um ZIP com PDFs de vários orçamentos (descarregar via token). |
| Anula um orçamento (com motivo). ⚠️ altera estado definitivamente. |
| Envia orçamentos por email. ⚠️ envia email real. |
| Atualiza um orçamento (input de documento por dict). ⚠️ altera documento real. |
| Cria um evento/lembrete (nome, data; repetição via extra_fields). |
| Apaga um ou mais eventos/lembretes (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza um evento/lembrete (nome, data, repetição, documento). |
| Gera o ficheiro de inventário AT (V1) no servidor (descarregar via token). |
| Gera o ficheiro de inventário AT (V2, com método de custeio) no servidor (descarregar via token). |
| Gera um ficheiro EDI XML (UBL/CIUS-PT) de documentos no servidor (descarregar via token). |
| Gera o PDF do mandato de débito direto SEPA de um cliente/fornecedor. |
| Gera o ficheiro SAF-T(PT) XML de um período no servidor (descarregar via token). |
| Exporta uma remessa bancária como SEPA XML (pain.008/pain.001) no servidor. |
| Cria uma zona geográfica (nome, abreviatura). |
| Apaga uma ou mais zonas geográficas (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza uma zona geográfica (nome, abreviatura, notas). |
| Gera o PDF de consentimento RGPD de um cliente no servidor. |
| Gera o PDF com os dados pessoais (RGPD) de um cliente no servidor. |
| Gera o PDF do extrato/histórico de conta-corrente de um cliente no servidor. |
| Gera o XLS do extrato/histórico de conta-corrente de um cliente no servidor. |
| Gera o PDF da lista de clientes (filtrada) no servidor. |
| Gera o XLSX da lista de clientes (filtrada) no servidor. |
| Gera o PDF da lista de categorias de produto (filtrada) no servidor. |
| Gera o XLSX da lista de categorias de produto (filtrada) no servidor. |
| Gera o PDF da lista de produtos (filtrada) no servidor. |
| Gera o XLSX da lista de produtos (filtrada) no servidor. |
| Gera o PDF da análise de compras por data no servidor. |
| Gera o PDF detalhado (single) da análise de compras por data no servidor. |
| Gera o PDF da análise de compras por data com documentos de origem no servidor. |
| Gera o PDF da análise de compras por categoria de produto no servidor. |
| Gera o PDF detalhado (single) da análise de compras por categoria de produto no servidor. |
| Gera o PDF da análise de compras por categoria com documentos de origem no servidor. |
| Gera o PDF da análise de compras por produto no servidor. |
| Gera o PDF detalhado (single) da análise de compras por produto no servidor. |
| Gera o PDF da análise de compras por produto com documentos de origem no servidor. |
| Gera o PDF das compras pendentes por data de vencimento no servidor. |
| Gera o XLSX das compras pendentes por data de vencimento no servidor. |
| Gera o PDF das compras pendentes por fornecedor no servidor. |
| Gera o XLSX das compras pendentes por fornecedor no servidor. |
| Gera o PDF do extrato de compras a fornecedores no servidor. |
| Gera o XLSX do extrato de compras a fornecedores no servidor. |
| Gera o PDF da análise de vendas por data no servidor. |
| Gera o PDF detalhado (single) da análise de vendas por data no servidor. |
| Gera o PDF da análise de vendas por data com documentos de origem no servidor. |
| Gera o PDF da análise de vendas por categoria de produto no servidor. |
| Gera o PDF detalhado (single) da análise de vendas por categoria de produto no servidor. |
| Gera o PDF da análise de vendas por categoria com documentos de origem no servidor. |
| Gera o PDF da análise de vendas por produto no servidor. |
| Gera o PDF detalhado (single) da análise de vendas por produto no servidor. |
| Gera o PDF da análise de vendas por produto com documentos de origem no servidor. |
| Gera o XLS do relatório de análise de vendas no servidor. |
| Gera o PDF das vendas pendentes por cliente no servidor. |
| Gera o XLSX das vendas pendentes por cliente no servidor. |
| Gera o PDF das vendas pendentes por data de vencimento no servidor. |
| Gera o XLSX das vendas pendentes por data de vencimento no servidor. |
| Gera o PDF do histórico de pagamentos de comissões a vendedores no servidor. |
| Gera o XLS do histórico de pagamentos de comissões a vendedores no servidor. |
| Gera o PDF dos pagamentos de comissões a vendedores pendentes no servidor. |
| Gera o XLS dos pagamentos de comissões a vendedores pendentes no servidor. |
| Gera o PDF da lista de vendedores (filtrada) no servidor. |
| Gera o PDF do extrato de vendas a clientes no servidor. |
| Gera o XLSX do extrato de vendas a clientes no servidor. |
| Gera o PDF da ficha detalhada de um cliente no servidor. |
| Gera o PDF do inventário/stock de todos os produtos no servidor. |
| Gera o XLSX do inventário/stock de todos os produtos no servidor. |
| Gera o PDF do stock de produtos (com movimento) no servidor. |
| Gera o XLSX do stock de produtos (com movimento) no servidor. |
| Gera o PDF do detalhe de stock/movimentos de um produto no servidor. |
| Gera o XLSX do detalhe de stock/movimentos de um produto no servidor. |
| Gera o PDF da lista de fornecedores (filtrada) no servidor. |
| Gera o XLSX da lista de fornecedores (filtrada) no servidor. |
| Cria um webhook (URL notificado numa operação sobre uma entidade). |
| Apaga um ou mais webhooks (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza um webhook (url, entidades, operações). |
| Cria um modelo de identificação (cabeçalho de documentos). |
| Apaga um ou mais modelos de identificação (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza um modelo de identificação (nome, dados, contactos). |
| Cria uma ou mais faturas (em lote). ⚠️ cria documentos fiscais reais. |
| Cria uma fatura (singular). ⚠️ cria documento fiscal real. |
| Apaga uma ou mais faturas (em lote, só rascunhos). ⚠️ destrutiva/irreversível. |
| Reverte uma fatura finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma fatura no servidor (descarregar via token). |
| (Re)gera um ZIP com PDFs de várias faturas (descarregar via token). |
| Anula uma fatura (com motivo). ⚠️ ação fiscal irreversível (comunicada à AT). |
| Cria uma ou mais faturas-recibo (em lote, com pagamentos). ⚠️ cria documentos fiscais reais. |
| Cria uma fatura-recibo (singular). ⚠️ cria documento fiscal real. |
| Apaga uma ou mais faturas-recibo (em lote, só rascunhos). ⚠️ destrutiva/irreversível. |
| Reverte uma fatura-recibo finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma fatura-recibo no servidor (descarregar via token). |
| (Re)gera um ZIP com PDFs de várias faturas-recibo (descarregar via token). |
| Anula uma fatura-recibo (com motivo). ⚠️ ação fiscal irreversível (comunicada à AT). |
| Envia faturas-recibo por email. ⚠️ envia email real. |
| Atualiza uma fatura-recibo (input de documento por dict). ⚠️ altera documento real. |
| Envia faturas por email. ⚠️ envia email real. |
| Atualiza uma fatura (input de documento por dict). ⚠️ altera documento real. |
| Gera o PDF de etiquetas de produtos no servidor (descarregar via token). |
| Cria um modelo de etiqueta (tamanho, campos). |
| Cria o conjunto de modelos de etiqueta predefinidos (por idioma). |
| Apaga um ou mais modelos de etiqueta (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza um modelo de etiqueta (nome, tamanho, campos). |
| Cria uma data de vencimento / condição de pagamento (dias, desconto). |
| Apaga uma ou mais datas de vencimento (em lote). ⚠️ destrutiva/irreversível. |
| Atualiza uma data de vencimento (dias, desconto, por omissão). |
| Cria uma unidade de medida (nome, abreviatura, código UN/ECE). |
| Apaga uma ou mais unidades de medida (em lote). ⚠️ destrutiva/irreversível. |
| Importa uma unidade de medida da lista padrão (UN/ECE). |
| Atualiza uma unidade de medida (nome, abreviatura, código UN/ECE). |
| Define a primeira palavra-passe da conta autenticada. ⚠️ altera credenciais. |
| Submete uma candidatura ao programa de parceiros (dados de negócio e contacto). |
| Atualiza uma candidatura ao programa de parceiros existente. |
| Cria um método de pagamento numa empresa (numerário, transferência, MB...). |
| Apaga um ou mais métodos de pagamento (em lote). ⚠️ destrutiva. |
| Atualiza um método de pagamento de uma empresa. |
| Cria uma ou mais devoluções de pagamento/recibo (em lote). ⚠️ cria documentos reais. |
| Cria uma devolução de pagamento/recibo (singular). ⚠️ cria documento real. |
| Apaga uma ou mais devoluções de pagamento/recibo (em lote). ⚠️ destrutiva. |
| Reverte uma devolução de pagamento/recibo finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma devolução de pagamento/recibo. |
| (Re)gera um ZIP com os PDFs de várias devoluções de pagamento/recibo. |
| Anula uma devolução de pagamento/recibo (motivo opcional). ⚠️ fiscal, irreversível. |
| Envia devoluções de pagamento/recibo por email. ⚠️ envia email real. |
| Atualiza uma devolução de pagamento/recibo (só rascunhos). ⚠️ altera documento real. |
| Cria uma classe de preço numa empresa (ajustes de preço por %). |
| Apaga uma ou mais classes de preço (em lote). ⚠️ destrutiva. |
| Duplica uma classe de preço com ajuste por % (assíncrono, |
| Atualiza uma classe de preço de uma empresa (renomear). |
| Cria uma categoria de produtos (hierárquica via |
| Apaga uma ou mais categorias de produtos (em lote). ⚠️ destrutiva. |
| Importa uma categoria de produtos (ex. de SAF-T). |
| Atualiza uma categoria de produtos (renomear, mudar de categoria-mãe). |
| Cria um produto/serviço no catálogo (associações complexas via |
| Apaga um ou mais produtos do catálogo (em lote). ⚠️ destrutiva. |
| Atualiza um produto/serviço do catálogo (associações complexas via |
| Gera um XLS com as margens de lucro (por produto/documento/tudo). |
| Cria uma ou mais faturas pró-forma (em lote). ⚠️ cria documentos reais. |
| Cria uma fatura pró-forma (singular). ⚠️ cria documento real. |
| Apaga uma ou mais faturas pró-forma (em lote). ⚠️ destrutiva. |
| Reverte uma fatura pró-forma finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma fatura pró-forma. |
| (Re)gera um ZIP com os PDFs de várias faturas pró-forma. |
| Anula uma fatura pró-forma (motivo opcional). ⚠️ irreversível. |
| Envia faturas pró-forma por email. ⚠️ envia email real. |
| Atualiza uma fatura pró-forma (só rascunhos). ⚠️ altera documento real. |
| Cria um grupo de propriedades (atributos/variantes de produto). |
| Apaga um ou mais grupos de propriedades (em lote). ⚠️ destrutiva. |
| Atualiza um grupo de propriedades (nome, visibilidade, propriedades). |
| Cria uma ou mais notas de encomenda a fornecedor (em lote). ⚠️ cria documentos reais. |
| Cria uma nota de encomenda a fornecedor (singular). ⚠️ cria documento real. |
| Apaga uma ou mais notas de encomenda a fornecedor (em lote). ⚠️ destrutiva. |
| Reverte uma nota de encomenda a fornecedor finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma nota de encomenda a fornecedor. |
| (Re)gera um ZIP com os PDFs de várias notas de encomenda a fornecedor. |
| Anula uma nota de encomenda a fornecedor (motivo opcional). ⚠️ irreversível. |
| Envia notas de encomenda a fornecedor por email. ⚠️ envia email real. |
| Atualiza uma nota de encomenda a fornecedor (só rascunhos). ⚠️ altera documento real. |
| Cria um ou mais contratos de compra recorrente (em lote). ⚠️ cria documentos reais. |
| Cria um contrato de compra recorrente (singular). ⚠️ cria documento real. |
| Apaga um ou mais contratos de compra recorrente (em lote). ⚠️ destrutiva. |
| Reverte um contrato de compra recorrente finalizado para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de um contrato de compra recorrente. |
| (Re)gera um ZIP com os PDFs de vários contratos de compra recorrente. |
| Anula um contrato de compra recorrente (motivo opcional). ⚠️ irreversível. |
| Envia contratos de compra recorrente por email. ⚠️ envia email real. |
| Atualiza um contrato de compra recorrente (só rascunhos). ⚠️ altera documento real. |
| Gera um XLS do relatório de análise de compras. |
| Recalcula a percentagem de uma classe de preço já aplicada (assíncrono). ⚠️ altera preços em massa. |
| Cria um ou mais recibos (liquida faturas; em lote). ⚠️ cria documentos reais. |
| Cria um recibo (singular). ⚠️ cria documento real. |
| Apaga um ou mais recibos (em lote). ⚠️ destrutiva. |
| Reverte um recibo finalizado para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de um recibo. |
| (Re)gera um ZIP com os PDFs de vários recibos. |
| Anula um recibo (motivo opcional). ⚠️ fiscal, irreversível. |
| Envia recibos por email. ⚠️ envia email real. |
| Atualiza um recibo (só rascunhos). ⚠️ altera documento real. |
| Cria um ou mais contratos de venda recorrente (em lote). ⚠️ cria documentos reais. |
| Cria um contrato de venda recorrente (singular). ⚠️ cria documento real. |
| Apaga um ou mais contratos de venda recorrente (em lote). ⚠️ destrutiva. |
| Reverte um contrato de venda recorrente finalizado para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de um contrato de venda recorrente. |
| (Re)gera um ZIP com os PDFs de vários contratos de venda recorrente. |
| Anula um contrato de venda recorrente (motivo opcional). ⚠️ irreversível. |
| Envia contratos de venda recorrente por email. ⚠️ envia email real. |
| Atualiza um contrato de venda recorrente (só rascunhos). ⚠️ altera documento real. |
| Remove (desaplica) uma classe de preço aplicada, revertendo preços. ⚠️ altera preços em massa. |
| Pede à AT o código de transporte de um documento. ⚠️ comunica à AT. |
| Cria uma retenção na fonte (taxa de retenção/IRS) numa empresa. |
| Apaga uma ou mais retenções na fonte (em lote). ⚠️ destrutiva. |
| Atualiza uma retenção na fonte de uma empresa. |
| Cria um vendedor numa empresa. |
| Apaga um ou mais vendedores (em lote). ⚠️ destrutiva. |
| Cria um ou mais pagamentos de comissões a vendedores (em lote). ⚠️ cria documentos reais. |
| Cria um pagamento de comissões a vendedor (singular). ⚠️ cria documento real. |
| Apaga um ou mais pagamentos de comissões a vendedores (em lote). ⚠️ destrutiva. |
| Reverte um pagamento de comissões a vendedor finalizado para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de um pagamento de comissões a vendedor. |
| (Re)gera um ZIP com os PDFs de vários pagamentos de comissões a vendedores. |
| Anula um pagamento de comissões a vendedor (motivo opcional). ⚠️ irreversível. |
| Envia pagamentos de comissões a vendedores por email. ⚠️ envia email real. |
| Atualiza um pagamento de comissões a vendedor (só rascunhos). ⚠️ altera documento real. |
| Atualiza um vendedor de uma empresa. |
| Cria notas de acerto (documento) em lote. ⚠️ cria documentos reais. |
| Cria uma nota de acerto (documento). ⚠️ cria documento real. |
| Apaga notas de acerto (em lote). ⚠️ destrutivo e irreversível. |
| Reverte uma nota de acerto finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma nota de acerto. |
| (Re)gera um ZIP com PDFs de várias notas de acerto. |
| Anula uma nota de acerto. ⚠️ operação fiscal irreversível. |
| Envia notas de acerto por email. ⚠️ envia email real. |
| Atualiza uma nota de acerto (só rascunhos). ⚠️ altera documento real. |
| Cria faturas simplificadas (documento) em lote. ⚠️ cria documentos reais. |
| Cria uma fatura simplificada (documento). ⚠️ cria documento real. |
| Apaga faturas simplificadas (em lote). ⚠️ destrutivo e irreversível. |
| Reverte uma fatura simplificada finalizada para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma fatura simplificada. |
| (Re)gera um ZIP com PDFs de várias faturas simplificadas. |
| Anula uma fatura simplificada. ⚠️ operação fiscal irreversível. |
| Envia faturas simplificadas por email. ⚠️ envia email real. |
| Atualiza uma fatura simplificada (só rascunhos). ⚠️ altera documento real. |
| Apaga um movimento de stock manual ( |
| Cria um movimento de stock manual de entrada (um produto). ⚠️ aumenta stock. |
| Cria um movimento de stock manual de saída (um produto). ⚠️ reduz stock. |
| Transfere um produto entre armazéns (movimento de stock). ⚠️ move stock. |
| Apaga uma transferência de stock entre armazéns ( |
| Cria guias de transporte de fornecedor (documento) em lote. ⚠️ cria documentos reais. |
| Cria uma guia de transporte de fornecedor (documento). ⚠️ cria documento real. |
| Apaga guias de transporte de fornecedor (em lote). ⚠️ destrutivo e irreversível. |
| Reverte uma guia de transporte de fornecedor para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma guia de transporte de fornecedor. |
| (Re)gera um ZIP com PDFs de várias guias de transporte de fornecedor. |
| Anula uma guia de transporte de fornecedor. ⚠️ operação fiscal irreversível. |
| Envia guias de transporte de fornecedor por email. ⚠️ envia email real. |
| Atualiza uma guia de transporte de fornecedor (só rascunhos). ⚠️ altera documento real. |
| Cria um fornecedor numa empresa. |
| Cria notas de crédito de fornecedor (documento) em lote. ⚠️ cria documentos reais. |
| Cria uma nota de crédito de fornecedor (documento). ⚠️ cria documento real. |
| Apaga notas de crédito de fornecedor (em lote). ⚠️ destrutivo e irreversível. |
| Reverte uma nota de crédito de fornecedor para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma nota de crédito de fornecedor. |
| (Re)gera um ZIP com PDFs de várias notas de crédito de fornecedor. |
| Anula uma nota de crédito de fornecedor. ⚠️ operação fiscal irreversível. |
| Envia notas de crédito de fornecedor por email. ⚠️ envia email real. |
| Atualiza uma nota de crédito de fornecedor (só rascunhos). ⚠️ altera documento real. |
| Apaga fornecedores de uma empresa (em lote). ⚠️ destrutivo e irreversível. |
| Cria faturas de fornecedor (documento) em lote. ⚠️ cria documentos reais. |
| Cria uma fatura de fornecedor (documento). ⚠️ cria documento real. |
| Apaga faturas de fornecedor (em lote). ⚠️ destrutivo e irreversível. |
| Reverte uma fatura de fornecedor para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma fatura de fornecedor. |
| (Re)gera um ZIP com PDFs de várias faturas de fornecedor. |
| Anula uma fatura de fornecedor. ⚠️ operação fiscal irreversível. |
| Envia faturas de fornecedor por email. ⚠️ envia email real. |
| Atualiza uma fatura de fornecedor (só rascunhos). ⚠️ altera documento real. |
| Cria notas de encomenda a fornecedor (documento) em lote. ⚠️ cria documentos reais. |
| Cria uma nota de encomenda a fornecedor (documento). ⚠️ cria documento real. |
| Apaga notas de encomenda a fornecedor (em lote). ⚠️ destrutivo e irreversível. |
| Reverte uma nota de encomenda a fornecedor para rascunho. ⚠️ altera estado. |
| (Re)gera o PDF de uma nota de encomenda a fornecedor. |
| (Re)gera um ZIP com PDFs de várias notas de encomenda a fornecedor. |
| Anula uma nota de encomenda a fornecedor. ⚠️ operação fiscal irreversível. |
| Envia notas de encomenda a fornecedor por email. ⚠️ envia email real. |
| Atualiza uma nota de encomenda a fornecedor (só rascunhos). ⚠️ altera documento real. |
| Cria um ou mais recibos de fornecedor (documento), em lote — liquida documentos de compra. ⚠️ cria documentos reais. |
| Cria um recibo de fornecedor (documento), singular. ⚠️ cria documento real. |
| Apaga um ou mais recibos de fornecedor (só rascunhos), em lote. ⚠️ destrutivo e irreversível. |
| Reverte um recibo de fornecedor finalizado de volta a rascunho. ⚠️ altera o estado do documento. |
| (Re)gera o PDF de um recibo de fornecedor no servidor. |
| (Re)gera um ZIP com os PDFs de vários recibos de fornecedor no servidor. |
| Anula um recibo de fornecedor (marca como anulado). ⚠️ operação fiscal e irreversível. |
| Envia um ou mais recibos de fornecedor por email. ⚠️ envia email real. |
| Atualiza um recibo de fornecedor (só rascunhos). ⚠️ altera documento real. |
| Atualiza um fornecedor (campos comuns + |
| Cria uma taxa de imposto (IVA) numa empresa ( |
| Apaga uma ou mais taxas de imposto (IVA), em lote. ⚠️ destrutivo e irreversível. |
| (Re)gera o PDF do mapa de impostos (IVA) no servidor (filtros por data). |
| (Re)gera o Excel (XLS) do mapa de impostos (IVA) no servidor (filtros por data). |
| Atualiza uma taxa de imposto (IVA) (campos comuns + |
| Cria um veículo numa empresa (transporte/expedição) — |
| Apaga um ou mais veículos, em lote. ⚠️ destrutivo e irreversível. |
| Atualiza um veículo (campos comuns + |
| Cria um armazém numa empresa ( |
| Apaga um ou mais armazéns, em lote. ⚠️ destrutivo e irreversível. |
| Move todo o stock de um armazém para outro. ⚠️ move stock em massa e irreversível. |
| Atualiza um armazém (campos comuns + |
| Atualiza a conta autenticada (nome, email, telefone, idioma, palavra-passe). ⚠️ pode alterar credenciais. |
As restantes operações são adicionadas à medida que avançamos pelos links de docs.molonion.pt/reference.
Cada tool é uma função async decorada com @mcp.tool(). O padrão completo (como
mapear inputs/objects interligados, o envelope {errors, data}, nomes em inglês +
docstrings em português) está documentado no CLAUDE.md.
Como cada selection set e cada lista de parâmetros é escrita à mão, podem divergir
da API real (campos obrigatórios em falta, nomes errados, campos inexistentes). Por isso
fez-se uma passagem de validação que cruza cada tool com as páginas de
docs.molonion.pt/reference (/inputs, /objects,
/mutations, /enums), por input/object partilhado (não tool-a-tool — as tools são
invólucros finos sobre tipos partilhados).
Cobertura atual (✅ validado contra a fonte):
Inputs de escrita — *Insert, *BulkInsert e *Update (documentos + config):
campos obrigatórios, nomes camelCase e estrutura.
Objects de retorno — os selection sets não pedem campos inexistentes.
Listas de referência e inputs de query (paginação/filtro/ordenação).
O processo e as descobertas (ex.: expirationDate é obrigatório na maioria dos documentos
de venda; os movimentos de stock são de um produto, não documentos) estão em
CLAUDE.md. Regra prática: ao adicionar uma tool,
confirma os campos contra /reference em vez de inferir — os bugs encontrados estavam
sempre nas tools construídas por inferência cega.
Usa-se Semantic Versioning — MAJOR.MINOR.PATCH:
MAJOR — mudanças incompatíveis (breaking) na interface das tools.
MINOR — novas tools/funcionalidades retrocompatíveis.
PATCH — correções de bugs retrocompatíveis.
O projeto está em 0.x (desenvolvimento inicial): a API ainda não é estável e
pode mudar a qualquer momento. Cada operação nova → bump MINOR.
Python 3.12 · FastMCP (mcp[cli]) · httpx · python-dotenv · transport stdio.
This server cannot be deployed
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
MCP server exposing klokin time-tracking operations (employees, time entries, stores) to AI clients.
