Internal Teams API
Acceso a compras e inventario para tus equipos internos de servicio: solicitudes de compra, órdenes de compra, recibos, partes y stockLa Internal Teams API es la superficie de integración para los sistemas detrás de las compras e inventario de tus equipos internos de servicio: solicitudes de compra y sus líneas, órdenes de compra hasta la recepción, catálogos de partes y equipo, ubicaciones de stock y las partes consumidas en órdenes de trabajo.
URL base
/v1/partners/.
Autenticación
Estos endpoints requieren una clave de API de partner, una credencial separada de las claves de comprador y de proveedor. Una clave de API de comprador no funcionará contra los endpoints/v1/partners/, aunque esta sección viva bajo la documentación de la Buyer API.
Cada solicitud debe llevar dos cabeceras: X-API-KEY (la clave de partner) y OW-KEY (el secreto compartido de OpenWrench emitido junto a ella). La clave delimita automáticamente cada solicitud a los datos de tu empresa. Las solicitudes a las que les falte cualquiera de las cabeceras devuelven 401.
Límites de tasa
10 solicitudes por ventana de 20 segundos por clave. Al superarlo recibirás429 Too Many Requests. Aplica back off y reintenta.
Envoltura de respuesta
Respuestas de una sola entidad:count total:
401 significa clave faltante o inválida; 400 cubre entrada inválida, filtros incorrectos y denegaciones de permisos; 429 es el límite de tasa.
Paginación y filtrado
Los endpoints de listado aceptanoffset, limit (por defecto 10, máx. 25), sort_by y order (asc | desc). Los parámetros de consulta adicionales se tratan como filtros de campo: pasa un nombre de campo con un valor (separa varios valores por coma) para filtrar el conjunto de resultados.
El flujo de compras
Una integración típica sigue el ciclo de compras: lee solicitudes de compra aprobadas y sus líneas, crea una orden de compra contra un proveedor, asocia las líneas de PR a líneas de PO, marca la PO como ordenada y registra recibos a medida que llegan los artículos (las cantidades recibidas negativas registran devoluciones). Partes, tipos de equipo, proveedores y ubicaciones de stock completan los datos de referencia.Guías detalladas
Flujo de compras
El ciclo de vida de extremo a extremo: solicitudes, órdenes, líneas y recibos.
Catálogo y stock
Partes, equipo, proveedores, ubicaciones de stock y consumo de órdenes de trabajo.