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. También permite cancelar requisiciones que tu ERP anuló: qué pasa en cada caso está explicado en Triage de requisiciones.

¿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.

Seguimiento de entregas por API

Si tu organización tiene habilitado el módulo de seguimiento de entregas, tu sistema puede crear y administrar seguimientos directamente por la API pública: cargar o actualizar líneas de tus órdenes de compra, consultar sus estados y las respuestas de los proveedores, y marcar una línea como entregada, pausarla, reanudarla, marcarla urgente o cancelarla.

Estos seguimientos conviven con los que se cargan por Excel/CSV en Carga de Datos y con los que llegan por sincronización con tu ERP: cada línea la administra una sola fuente. Si tu sistema la crea o actualiza por API, esa línea deja de tocarse desde la carga de archivos o desde el ERP (y al revés).

La referencia técnica completa (endpoints, parámetros y ejemplos) está en la Documentación de API: pasala a tu equipo de sistemas.

Eventos de webhook de entregas

Si usás la API de seguimiento de entregas, podés suscribir tus webhooks a estos cuatro eventos (se eligen junto con los demás al crear o editar un webhook):

• delivery_tracking.response_received: el proveedor respondió sobre una línea.
• delivery_tracking.status_changed: cambió el estado de una línea (por ejemplo, de Enviado a Confirmado).
• delivery_tracking.delivered: se marcó una línea como entregada.
• delivery_tracking.cancelled: se canceló una línea.

Igual que el resto de los webhooks, tu endpoint tiene que ser HTTPS y responder rápido; la referencia de la firma y el formato de cada evento está en la Documentación de API.