Documentação da API

A API REST da Pardal permite a integração do nosso sistema de facturação com o seu software ERP, loja online (e-commerce) ou sistema de gestão personalizado. Esta funcionalidade é exclusiva para o plano Empresarial.

1. Autenticação

A API utiliza tokens Bearer (Sanctum/Passport). Pode gerar um token de acesso nas configurações da sua conta, no separador "API Keys".

Authorization: Bearer seu_token_aqui
Accept: application/json

2. Endpoints Principais

Criar Factura

POST /api/v1/invoices

{
  "customer_nuit": "123456789",
  "customer_name": "Empresa Cliente Lda",
  "items": [
    {
      "description": "Serviços de Consultoria",
      "quantity": 1,
      "unit_price": 50000.00,
      "tax_rate": 16
    }
  ]
}

Consultar Factura

GET /api/v1/invoices/{numero}

Descarregar PDF

GET /api/v1/invoices/{numero}/pdf

3. Limites (Rate Limits)

A API permite até 60 pedidos por minuto por token. Em caso de excesso, a API retornará o código HTTP 429 (Too Many Requests).

4. Suporte à Integração

Para obter ajuda na integração da API com o seu sistema, os clientes do plano Empresarial têm acesso a suporte técnico dedicado. Contacte-nos através do painel de suporte.