Integrações Pardal

API para ligar a sua facturação aos seus sistemas.

Automatize a ligação entre o Pardal e o seu ERP, loja online ou aplicação própria. As chaves têm permissões explícitas e ficam vinculadas a uma única empresa.

Ver documentação completaCriar conta

A API v1 está disponível no plano que inclui integrações. Proprietários e administradores criam e revogam chaves dentro da plataforma, em Integrações > Chaves da API.

Como começar

1. Active o acessoUse um plano com API e entre na empresa que irá integrar.
2. Crie uma chaveEscolha um nome, uma expiração opcional e apenas as permissões necessárias.
3. Faça o primeiro pedidoGuarde o token no momento da criação e envie-o como Bearer token.
curl https://facturas.pardal.app/api/v1/me \ -H "Authorization: Bearer SEU_TOKEN" \ -H "Accept: application/json"

O que pode integrar

GET/api/v1/customers

Consulte clientes e sincronize a sua base de dados.

POST/api/v1/customers

Crie clientes a partir de outro sistema.

GET/api/v1/products

Consulte produtos e serviços.

POST/api/v1/invoices

Emita facturas para clientes e séries da empresa.

GET/api/v1/invoices

Consulte facturas e obtenha os respectivos PDFs.

POST/api/v1/invoices/{id}/send

Envie facturas por email com uma permissão própria.

Segurança e isolamento

Cada chave é limitada à empresa em que foi criada. A integração não pode escolher outra empresa por parâmetro, e cada operação exige a permissão correspondente. Pode definir uma data de expiração e revogar uma chave a qualquer momento.

Nunca coloque uma chave de API no código do navegador, em páginas públicas ou em repositórios. Guarde-a num cofre de segredos do seu servidor.

Referência técnica

A documentação completa inclui todos os endpoints, payloads, permissões, códigos de resposta e limites de pedidos.

Abrir documentação da API