Saltar al contenido principal
Dos familias de endpoints responden a “¿quién puede hacer este trabajo?”: el listado de instalaciones de proveedor (toda tu red) y el endpoint de red privada jerarquizado (la lista corta ordenada para una ubicación y tipo de problema). Junto con el parche de reasignación de la orden de trabajo, te permiten automatizar el despacho. Todos los ejemplos asumen:

Tu red de proveedores

GET /v1/buyer/supplier_facilities devuelve cada relación de proveedor no eliminada de tu empresa. A diferencia de la mayoría de los endpoints de listado, soporta un conjunto documentado de filtros:
Obtén una instalación con GET /v1/buyer/supplier_facilities/{id}.

Proveedores de red privada jerarquizados

Para el despacho automatizado, pide la lista jerarquizada para un par (ubicación, tipo de problema):
GET /v1/buyer/private_network/buyer_supplier_relationships/ranked/{locationId}/{problemTypeId} devuelve relaciones comprador-proveedor, cada una hidratada con los detalles de tu relación (contactos y correos de enrutamiento).
El orden del array expresa el rango. Cualquier sort_by que pases se descarta deliberadamente para que el orden del array siempre equivalga al rango. El endpoint es paginado (por defecto 10, máx. 25 por página), así que el rango continúa entre páginas: el primer elemento de la página dos es el rango 11.

Patrón de despacho automatizado

  1. Llega una orden de trabajo (o se crea sin asignar).
  2. Llama al endpoint jerarquizado con el locationId y problemTypeId de la orden de trabajo.
  3. Toma la instalación de proveedor de la primera relación y asígnala, ya sea al crear (supplierFacilityId en el cuerpo de creación) o después con PATCH /v1/buyer/work_order/work_orders/{id}.
  4. Si el proveedor rechaza, la orden de trabajo vuelve a PendingApproval (o OpenWrench puede seleccionar automáticamente un proveedor de red privada, según tu configuración). Al rechazar, vuelve a ejecutar la jerarquización y asigna el siguiente candidato.
Las escaleras de escalamiento, los SLA de tiempo de respuesta y los conteos de rechazos pueden apilarse sobre este ciclo. El endpoint de jerarquización te da los candidatos ordenados, y statusChanges de la orden de trabajo te dice cómo fue cada intento.