Propósito da API

A API do Facturalusa foi desenvolvida para funcionar como uma ponte entre a aplicação do cliente e o sistema de facturação. O seu principal objectivo é permitir a sincronização e comunicação de dados de forma simples, estável e eficiente, mantendo a lógica de negócio e os mecanismos de pesquisa do lado da aplicação integradora.

Recomendamos que toda a gestão e pesquisa de dados seja efectuada localmente no software integrador. Por exemplo, a pesquisa de clientes deverá ocorrer na base de dados da aplicação interna e não directamente através da API do Facturalusa. Após a criação ou sincronização de um cliente no Facturalusa, o identificador (ID) devolvido pela API deverá ser guardado localmente para utilização futura nos restantes endpoints.

O mesmo princípio aplica-se a outras entidades e integrações, incluindo artigos, vendas, recibos, formas de pagamento, documentos, entre outros. Esta abordagem reduz chamadas desnecessárias à API, melhora a performance global da integração e garante maior fiabilidade operacional.

A API foi concebida para operações de integração e sincronização, não para servir como base de dados principal da aplicação integradora.

Para garantir estabilidade e qualidade de serviço para todos os utilizadores, existem mecanismos automáticos de protecção contra utilização abusiva da API. Chamadas excessivas, spam, polling agressivo ou padrões de utilização indevidos poderão resultar em limitações temporárias ou bloqueios permanentes da aplicação integradora. Recomendamos a implementação de boas práticas de cache, sincronização inteligente e reutilização de identificadores previamente armazenados.