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

Envío del pendiente completo por API

Si tu sistema puede mandar en un solo envío todas las líneas que tenés pendientes de entrega, usá el envío de pendiente completo (snapshot). Sourced actualiza las líneas que ya existían, agrega las nuevas y cierra como entregadas las que dejaron de venir, igual que la carga de CSV con la opción «Marcar como entregados los items que no aparecen en el CSV».

Solo se cierran líneas cargadas por API; las que llegan por CSV o por el ERP no se tocan. Como protección, si un envío fuera a cerrar más de 20 líneas y más de la mitad de las líneas cargadas por API que siguen abiertas, no se cierra ninguna (las altas y actualizaciones se aplican igual) y el resultado lo indica: suele ser un envío incompleto. Cada línea cerrada genera el evento de entregada con el motivo absent_from_api_snapshot, que tu sistema ve en los eventos del seguimiento por API y en el webhook delivery_tracking.delivered.

El detalle técnico está en la Documentación de API.

Unidad de negocio en el seguimiento de entregas

Cada línea que mandás al seguimiento de entregas puede incluir la unidad de negocio de la orden de compra: business_unit_code y, si querés, business_unit_name para mostrarla con su nombre. Con ese dato, los usuarios de Sourced pueden filtrar sus seguimientos por unidad de negocio.

Son campos opcionales: si no los enviás, la línea conserva el valor que ya tenía. Vuelven en las consultas y en los webhooks del seguimiento, y el listado se puede filtrar con business_unit_code. El detalle técnico está en la Documentación de API.