Introdução
Os Webhooks permitem configurar notificações automáticas em tempo real que enviam dados para sistemas externos quando ocorrem eventos específicos no Fisclow — como uma anomalia detectada num SAF-T ou uma reconciliação concluída. Este guia explica como configurar e gerir webhooks eficazmente.
Dica
Pré-requisitos
- Acesso como Proprietário ou Administrador do escritório
- Um URL de endpoint seguro (HTTPS) para receber os payloads
- Conhecimento dos eventos que pretende monitorizar
- Método de autenticação para o seu endpoint
Conceitos Base
Webhooks
Callbacks HTTP que enviam dados para URLs externas quando eventos ocorrem no seu escritório Fisclow.
Tipos de Eventos
Categorias de eventos que podem despoletar webhooks:
- Eventos de reconciliação: reconciliação concluída, movimentos não reconciliados detectados
- Eventos SAF-T: análise concluída, erros críticos detectados, scoring abaixo do limite
- Eventos de faturas: lote processado, duplicado detectado, NIF inválido
- Eventos de equipa: novo membro adicionado, função alterada
- Eventos de sistema: limite de plano atingido, pagamento processado
Segurança
Os webhooks requerem endpoints seguros com autenticação (chaves API, assinaturas) e HTTPS obrigatório.
Guia Passo a Passo
Aceder à Página de Webhooks
Navegue até Definições → Administração → Webhooks no painel lateral.
Criar um Novo Webhook
Clique em Criar Webhook e configure:
- Nome: Identificador descritivo (ex: "Slack — Alertas SAF-T")
- URL: O URL do seu endpoint
- Eventos: Seleccione os tipos de evento que despoletam o webhook
- Método: Método HTTP (normalmente POST)
- Headers: Headers de autenticação se necessário
Testar o Webhook
Use a função de teste para enviar um payload de exemplo e verificar que o endpoint o recebe correctamente antes de activar em produção.
Monitorizar e Gerir
Veja o estado do webhook, registos de entrega e taxas de sucesso. Edite ou elimine webhooks conforme necessário.
Configuração do Webhook
Prop
Type
Resolução de Problemas
Boas Práticas
Ler mais