# Faturamento

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

Fonte: https://ardumaker.com/pt/docs/facturacion/

- 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`

## 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](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Saldo por empresa](https://ardumaker.com/pt/docs/saldo-por-empresa/)
- [Recargas de saldo](https://ardumaker.com/pt/docs/recargas/)
- [Consumo de serviços](https://ardumaker.com/pt/docs/consumo-de-servicios/)
- [Empresas](https://ardumaker.com/pt/docs/empresas/)