API Équipes internes
Accès achats et inventaire pour vos équipes de service internes — demandes d’achat, bons de commande, réceptions, pièces et stockL’API Équipes internes est la surface d’intégration pour les systèmes derrière les achats et l’inventaire de vos équipes de service internes : demandes d’achat et leurs postes, bons de commande jusqu’à la réception, catalogues de pièces et d’équipement, emplacements de stock et pièces consommées sur les bons de travail.
URL de base
/v1/partners/.
Authentification
Ces endpoints requièrent une clé d’API partenaire, un identifiant distinct des clés d’API acheteur et fournisseur. Une clé d’API acheteur ne fonctionnera pas contre les endpoints/v1/partners/, même si cette section vit sous la documentation API Acheteur.
Chaque requête doit comporter deux en-têtes : X-API-KEY (la clé partenaire) et OW-KEY (le secret partagé OpenWrench émis avec la clé). La clé restreint automatiquement chaque requête aux données de votre entreprise. Les requêtes auxquelles il manque l’un des en-têtes renvoient 401.
Limites de débit
10 requêtes par fenêtre de 20 secondes par clé. Au-delà, vous recevrez429 Too Many Requests. Espacez vos appels et réessayez.
Enveloppe de réponse
Réponses à entité unique :count total :
401 signifie une clé manquante ou invalide; 400 couvre les entrées incorrectes, les filtres invalides et les refus de permission; 429 correspond à la limite de débit.
Pagination et filtrage
Les endpoints de liste acceptentoffset, limit (par défaut 10, maximum 25), sort_by et order (asc | desc). Les autres paramètres de requête sont traités comme des filtres de champ. Passez un nom de champ avec une valeur (séparez plusieurs valeurs par des virgules) pour filtrer l’ensemble de résultats.
Le flux d’achats
Une intégration typique suit le cycle de vie des achats : lire les demandes d’achat approuvées et leurs postes, créer un bon de commande auprès d’un vendeur, associer les postes de DA aux postes de BC, marquer le BC commandé, et enregistrer les réceptions au fur et à mesure que les articles arrivent (les quantités reçues négatives enregistrent des retours). Les pièces, types d’équipement, vendeurs et emplacements de stock complètent les données de référence.Guides détaillés
Flux d'achats
Le cycle de vie de bout en bout : demandes, commandes, postes et réceptions.
Catalogue et stock
Pièces, équipement, vendeurs, emplacements de stock et consommation sur bons de travail.