Faturamento

Dados fiscais da empresa, histórico de movimentos e faturas em PDF dos pagamentos.

  • Categoria: Pagamentos e administração
  • Estado: Disponível
  • Requisitos: Ser membro da empresa para ver; admin para editar os dados fiscais
  • Ferramentas MCP (Só leem): ver_consumo_periodo_empresa

Markdown

O que permite fazer?

  • Introduzir os dados fiscais: país, NIF ou número de IVA, nome fiscal, morada e email de contato.
  • Ver o histórico de movimentos, paginado, com o tipo.
  • Baixar o PDF de cada fatura emitida.

Quando convém usar?

Antes dos primeiros pagamentos, para que as faturas saiam com os dados corretos, e sempre que for preciso um comprovativo.

Como funciona na ArduMaker?

Só os pagamentos (movimentos positivos e bem-sucedidos) são faturáveis; cobranças, consumos e comissões não geram fatura. Cada fatura está associada a um pagamento e guarda uma cópia dos dados fiscais do momento da emissão: mudar os dados depois não altera as faturas já emitidas.

As faturas são emitidas pela ArduMaker sobre os pagamentos faturáveis. Sem NIF nem nome, a fatura é emitida a consumidor final. O histórico é paginado de 50 em 50 por omissão, até 100.

O que muda realmente?

Editar os dados fiscais atualiza a empresa. Emitir uma fatura cria o documento com o PDF, associado ao pagamento.

Resultado esperado

No histórico, cada pagamento faturado mostra a sua fatura. O PDF baixa-se através da ArduMaker, que verifica que quem o pede pertence à empresa.

Erros e resolução

  • 403 ao editar dados fiscais: só um admin da empresa os pode mudar.
  • 404 `factura_not_found`: a fatura não pertence a essa empresa.
  • 404 sem PDF: a fatura existe mas o PDF ainda não foi gerado.
  • Pagamento sem fatura: o movimento é faturável e a fatura ainda não foi emitida.

Relação com MCP

Um agente pode ler o histórico de movimentos de um período com ver_consumo_periodo_empresa. Não há ferramentas para dados fiscais nem faturas. Ver /mcp/docs.

Funcionalidades relacionadas