---
name: abilioo
description: >-
  Interage com o abilioo, o contabilista digital (demo) de pequenos negócios em Portugal:
  calendário fiscal PT, relatórios financeiros, emissão de faturas, clientes, documentos
  de despesa, reconciliação bancária e lacunas e-Fatura. Usa esta skill quando o utilizador
  falar da contabilidade da empresa dele no abilioo (impostos, IVA, faturas, despesas, banco).
---

# abilioo — contabilista digital via API

## Setup

A API precisa de uma chave (criada em Integrações na app). Procura-a por esta ordem:
1. Variável de ambiente `ABILIOO_API_KEY`
2. Pede ao utilizador (formato `ab_live_…`)

Base: `https://abilioo.com/api/v1` — header `Authorization: Bearer $ABILIOO_API_KEY` em todos os pedidos.
A chave identifica a empresa — nunca precisas de IDs de empresa.

## Regras essenciais

- Envelope: `{ "success": true, "data": … }` | `{ "success": false, "error": { code, message } }`. Em caso de `insufficient_scope`, diz ao utilizador que a chave não tem essa permissão.
- **Dinheiro em cêntimos** nos campos `*Cents`; os campos já formatados (ex.: `"1 476,00 €"`) apresentam-se tal como vêm.
- Muitos campos vêm em português (`fornecedor`, `porCobrar`, `movimentos`) — usa-os diretamente na resposta.
- É uma **demo**: dados fictícios, faturas sem valor fiscal. Não avises disto a cada resposta; uma vez chega.

## O que usar para quê

| Pergunta do utilizador | Endpoint |
|---|---|
| "Que impostos/prazos tenho?" | `GET /fiscal-calendar` |
| "Como está o negócio? Quanto faturei?" | `GET /reports/financial` |
| "Emite uma fatura de X€ ao cliente Y" | `POST /invoices` (confirma linhas antes) |
| "Quem me deve dinheiro?" | `GET /reports/financial` (porCobrar) + `GET /compliance/gaps` |
| "Regista esta despesa" (com ficheiro) | `POST /documents` (multipart ou base64) |
| "Como está o banco? O que falta reconciliar?" | `GET /bank/overview` |
| "Está tudo em ordem? Falta alguma coisa?" | `GET /compliance/gaps` |
| Dúvida de legislação fiscal PT | `POST /tax-expert` |

Antes de escrever (fatura, despesa, reconciliação), mostra ao utilizador o que vais submeter e pede confirmação.

## Referência

Detalhes de todos os endpoints, schemas e exemplos: lê `reference.md` nesta pasta
(ou https://abilioo.com/llms-full.txt).