API, integrações e webhooks

O Sourced integra-se ao seu ERP e aos seus sistemas por três vias: a API pública (com API keys), os conectores gerenciados e os webhooks de notificação.

Procurando como chamar a API? A referência técnica completa (endpoints, parâmetros e exemplos) está na Documentação da API.

API keys

• Crie uma credencial com um nome descritivo ("Integração SAP produtivo"). A chave completa é exibida uma única vez, então copie-a e guarde-a no seu gerenciador de segredos.

• É usada como Authorization: Bearer sk_live_… na API pública (veja a Documentação da API).

• A lista mostra o prefixo, o status e o último uso, o que serve para detectar integrações mortas. Revogue as que não forem usadas; a revogação é imediata.

Logs da API

Auditoria de cada chamada: data, método, rota, código de resposta, latência e qual key a fez. Filtre por rota ou apenas erros (≥400) para diagnosticar problemas de integração.

Webhooks

Notificações de saída em tempo real para os seus sistemas quando acontecem coisas no Sourced (PR criada ou aprovada, PO gerada, etc.). A lista mostra a URL, os eventos assinados e o status. A configuração dos endpoints é feita em conjunto com o Sourced; o seu endpoint deve ser HTTPS e responder rápido.

Conectores ERP

O status dos conectores gerenciados (SAP, Oracle, NetSuite, Sage…): última conexão, último erro e falhas consecutivas. As credenciais e a configuração são administradas pelo Sourced. Se você vir falhas sustentadas, reporte ao seu canal de suporte com o nome do conector.

Esta seção é dirigida à equipe técnica ou de TI da sua organização. Se você é comprador, aprovador ou tem outro papel operacional, não precisa configurar nada disto: as integrações são gerenciadas pela equipe técnica em conjunto com o Sourced.