API, integraciones y webhooks

Sourced se integra con tu ERP y tus sistemas por tres vías: la API pública (con API keys), los conectores gestionados y los webhooks de notificación. Además de consultar datos, la API pública permite operar sobre órdenes de compra: por ejemplo, cargar el número de OC de tu ERP o actualizar su estado.

¿Buscás cómo llamar a la API? La referencia técnica completa (endpoints, parámetros y ejemplos) está en la Documentación de API.

API keys

• Creá una credencial con un nombre descriptivo ("Integración SAP productivo"). La clave completa se muestra una sola vez, así que copiala y guardala en tu gestor de secretos.

• Se usa como Authorization: Bearer sk_live_… contra la API pública (ver la Documentación de API).

• El listado muestra el prefijo, el estado y el último uso, lo que sirve para detectar integraciones muertas. Revocá las que no se usen; la revocación es inmediata.

Logs de API

Auditoría de cada llamada: fecha, método, ruta, código de respuesta, latencia y qué key la hizo. Filtrá por ruta o solo errores (≥400) para diagnosticar problemas de integración.

Webhooks

Notificaciones salientes en tiempo real hacia tus sistemas cuando pasan cosas en Sourced (solicitud creada o aprobada, OC generada, etc.). El listado muestra URL, eventos suscritos y estado. La configuración de endpoints se hace junto con Sourced; tu endpoint debe ser HTTPS y responder rápido.

Conectores ERP

El estado de los conectores gestionados (SAP S/4HANA, SAP Business One, Oracle, JD Edwards, NetSuite, Sage…): última conexión, último error y fallos consecutivos. Las credenciales y la configuración las administra Sourced. Si ves fallos sostenidos, reportalo a tu canal de soporte con el nombre del conector.

Un conector no trae solo requisiciones. Según lo que esté habilitado, puede sincronizar:

• Requisiciones y sus líneas, que alimentan el triage, con cierre automático de las líneas que dejan de estar abiertas del lado del ERP.

• Documentos adjuntos del ERP, que viajan con el pedido de cotización al proveedor.

• El maestro de materiales, por barrido incremental de lo que cambió.

• Órdenes de compra aprobadas y sus recepciones, que alimentan el seguimiento de entregas.

El alcance se puede acotar —por ejemplo, a determinados grupos de compras— para que Sourced vea solo la porción del ERP que corresponde.

Esta sección está dirigida al equipo técnico o de IT de tu organización. Si sos comprador, aprobador o tenés otro rol operativo, no necesitás configurar nada de esto: las integraciones las gestiona el equipo técnico junto con Sourced.