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. Além de consultar dados, a API pública permite operar sobre ordens de compra: por exemplo, informar o número da OC do seu ERP ou atualizar seu status.

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 S/4HANA, SAP Business One, Oracle, JD Edwards, 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.

Um conector não traz apenas requisições. Conforme o que estiver habilitado, pode sincronizar:

• Requisições e suas linhas, que alimentam a triagem, com fechamento automático das linhas que deixam de estar abertas do lado do ERP.

• Documentos anexos do ERP, que viajam com o pedido de cotação ao fornecedor.

• O mestre de materiais, por varredura incremental do que mudou.

• Ordens de compra aprovadas e seus recebimentos, que alimentam o acompanhamento de entregas.

O alcance pode ser delimitado —por exemplo, a determinados grupos de compras— para que a Sourced veja somente a porção do ERP que corresponde.

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.