Articles et quantités
Référence, description, quantité et code d'unité correspondant.
STASTO × VOTRE SYSTÈME D'APPROVISIONNEMENT
Sélectionner en magasin.
Continuer à travailler dans l'ERP.
Ouvrez le catalogue STASTO depuis votre système d'approvisionnement. Trouvez les composants qui vous conviennent et ajoutez-les à votre panier dans le cadre de votre processus d'achat.
Votre système d'approvisionnementLancer la session de catalogue
OCI
STASTO STORETrouver. Choisir. Ajouter au panier.
PneumatiqueRaccords
Transfert du panier
Retour à votre processus d'achatVérifier et poursuivre le traitement dans l'ERP
01 / PUNCHOUT
Quatre étapes pour passer du catalogue à l'achat.
- 01
Démarrer dans l'ERP
Lancez le catalogue STASTO depuis votre système d'approvisionnement. L'accès au catalogue et l'adresse de retour sont transmis à la boutique.
- 02
Sélectionner les composants
Recherchez par référence ou par mot-clé, sélectionnez parmi les images des produits et affinez votre recherche à l'aide des filtres techniques.
- 03
Transférer le panier
Lancez PunchOut depuis le panier. Vérifiez le récapitulatif du transfert, puis validez le retour vers votre ERP.
- 04
Poursuivre mes achats
Vérifiez les postes transférés dans votre système d'approvisionnement et poursuivez votre processus interne de validation et de commande.
Le simple fait de transférer le panier ne déclenche pas encore de commande chez STASTO. Les étapes suivantes du processus d'achat se déroulent dans votre système d'approvisionnement.
02 / CONFIGURATION
Tout ce qu'il faut pour votre équipe d'intégration.
Accès au catalogue
POST
https://www.stasto.eu/oci/catalogPoint de terminaison de production. Avant de procéder à votre test d'intégration, configurez un environnement de test distinct avec STASTO.
| Paramètres | Signification |
|---|---|
HOOK_URL | Obligatoire. L'adresse de redirection fournie par votre système d'approvisionnement pour la session en cours. |
username | Identifiant utilisateur défini pour le catalogue. Obligatoire lors de la connexion via des paramètres. |
mot de passe | Mot de passe de cet accès au catalogue. Obligatoire lors de la connexion via des paramètres. |
Exemple d'appel · POST
Exemple avec des espaces réservés. Transmettez les valeurs sous forme d'URL encodée dans le corps de la requête et remplacez tous les espaces réservés dans votre configuration d'intégration.
POST /oci/catalog HTTP/1.1
Host: www.stasto.eu
Content-Type: application/x-www-form-urlencoded
HOOK_URL=https%3A%2F%2Ferp.example%2Foci%2Freturn&username=STASTO_LOGIN&password=STASTO_PASSWORDAutres méthodes de connexion et comportement pendant la session
L'authentification HTTP Basic est également prise en charge. Dans ce cas, omettez les paramètres « username » et « password » et transmettez les identifiants dans l'en-tête « Authorization ». Le paramètre HOOK_URL reste obligatoire.
GET est accepté pour les systèmes compatibles. Privilégiez le protocole HTTPS avec la méthode POST afin que les identifiants ne apparaissent pas dans l'historique des URL ni dans les journaux d'URL. Une fois la connexion établie, le navigateur est redirigé vers /shop ; conservez la même session de navigation pour le transfert du panier.
03 / DONNÉES
Ce qui est enregistré dans votre ERP.
Le formulaire de retour envoie les données relatives aux articles via une requête POST du navigateur vers votre HOOK_URL. Les champs sont numérotés à partir de 1 pour chaque article du panier. Le tableau présente l'affectation par défaut ; les paramètres personnalisés du client peuvent remplacer certaines valeurs.
Prix et délais de livraison
Prix unitaire après remise, devise et délai de livraison en jours entiers.
Classification et données clients
Catégorie de produits, référence client facultative et image du produit.
Référence de terrain OCI
| Champ | Contenu standard |
|---|---|
NEW_ITEM-VENDORMAT[1] | Référence STASTO. |
NEW_ITEM-DESCRIPTION[1] | Nom du produit. |
NEW_ITEM-LONGTEXT_1:132[] | Description commerciale ou, à défaut, nom du produit. |
NEW_ITEM-QUANTITY[1] | Quantité de l'article dans le panier. |
NEW_ITEM-UNIT[1] | Affectation d'unité spécifique au client, sinon l'unité OCI gérée ; valeur par défaut C62. Des contrôles stricts peuvent bloquer une affectation non valide. |
NEW_ITEM-PRICE[1] | Prix unitaire dans le panier après remise. |
NEW_ITEM-PRICEUNIT[1] | 1 (prix unitaire). |
NEW_ITEM-CURRENCY[1] | Devise du panier, par exemple l'euro. |
NEW_ITEM-VENDOR[1] | Nom de la société STASTO chargée de la vente. |
NEW_ITEM-LEADTIME[1] | Délai de livraison en jours entiers, arrondi à l'unité supérieure. |
NEW_ITEM-MATGROUP[1] | Code eClass configuré ou valeur de repli de catégorie. Voir les remarques sur la classification ci-dessous. |
NEW_ITEM_ATTACHMENT[1] | URL absolue de l'image du produit, si une image a été ajoutée. |
NEW_ITEM_ATTACHMENT_TITLE[1] | Intitulé du produit correspondant à l'image. |
NEW_ITEM-CUST_FIELD1[1] … NEW_ITEM-CUST_FIELD4[1] | Vide par défaut ; des valeurs fixes spécifiques au client peuvent être configurées. |
NEW_ITEM-CUST_FIELD5[1] | Référence client, si elle a été définie, ou une valeur fixe configurée. |
Le formulaire de retour envoie également ~OkCode=ADDI, ~target=_top, ~ForceTarget=yes et ~caller=CTLG. Veuillez valider ces paramètres avec votre destinataire lors de la réception.
eClass, catégories de produits et affectation des unités
eClass 7.1 est la version de référence. eClass 8.1 nécessite que le champ correspondant soit renseigné et que les données soient mises à jour. La première catégorie de site web attribuée détermine la classification ; les tirets sont supprimés du code.
Si le code sélectionné est absent, le système vérifie la version de secours configurée, puis utilise la catégorie interne ou « Général ». Si la classification est désactivée, la valeur « Général » est envoyée. Vérifiez quelles valeurs votre ERP accepte.
Les codes d'unité et les valeurs fixes des champs sont configurés pour l'entreprise cliente. Le champ « Fournisseur » désigne toujours la société vendeuse. Les images des produits sont transmises sous forme de liens ; le transfert du panier ne contient pas de dossier de documents.
04 / VÉRIFICATION
Vérifier le déroulement complet.
Avant de mettre le système à la disposition de vos acheteurs, utilisez un environnement de test configuré et un petit panier d'achat à titre d'exemple.
- Ouvrir le catalogue depuis le progiciel de gestion intégré (ERP) et vérifier le contexte client approprié ainsi que les prix.
- Sélectionnez deux articles différents et modifiez au moins une quantité.
- Vérifier les références, la quantité, l'unité, la devise, le prix et le délai de livraison dans l'aperçu des transferts.
- Confirmer le retour et comparer tous les articles transférés dans le système ERP, y compris leur classification et les champs client.
Dans le panier, l'option de vidage est activée par défaut. Le panier est vidé lors de la création du récapitulatif de transfert, avant que l’ERP ne confirme la réception. Tenez-en compte lorsque vous testez une nouvelle tentative de transfert.
05 / ASSISTANCE
Des questions sur la connexion ?
Lors d'une demande d'assistance, veuillez indiquer votre système d'approvisionnement, l'heure à laquelle vous avez effectué la tentative et le message d'erreur. Ne communiquez vos identifiants d'accès que par un canal sécurisé convenu au préalable.
Discuter de la connexionHOOK_URL est manquant – qu'est-ce que cela signifie ?
Votre ERP doit indiquer l'URL de redirection lors de l'ouverture de /oci/catalog. Vérifiez la casse exacte de HOOK_URL et l'encodage de l'URL.
La connexion échoue. Que faut-il vérifier ?
Vérifiez l'identifiant de connexion au catalogue convenu, le mot de passe et la méthode de connexion. Un statut HTTP positif ne suffit pas à lui seul à confirmer que la connexion a bien abouti : vérifiez que le navigateur parvient bien à accéder à la boutique.
Le bouton « PunchOut » n'apparaît pas dans le panier.
Lancez la session depuis votre ERP via /oci/catalog et ajoutez un article. Un accès direct à la boutique en ligne n'enregistre pas d'adresse de redirection PunchOut. Ne changez pas de session de navigateur.
Le panier n'est pas transféré dans l'ERP.
Confirmez la deuxième étape de transfert dans l'aperçu. Vérifiez si l'adresse de redirection accepte la requête POST du formulaire, si la session a expiré et si le navigateur limite les fenêtres intégrées. Si le panier a été vidé, vérifiez d'abord le système ERP avant de réessayer.
Un poste est refusé en raison de l'unité ou du groupe de marchandises.
Comparez les valeurs transférées « UNIT » et « MATGROUP » avec celles autorisées dans l'ERP. Vérifiez auprès de STASTO que l'affectation des unités, la version eClass et les valeurs de repli sont bien conformes.
Ce guide s'applique-t-il également au cXML ?
Ce guide décrit l'interface OCI mise en œuvre. Avant la mise en place, veuillez discuter avec STASTO des autres protocoles ou des exigences spécifiques au système.
Découvrez la boutique.Accéder au guide de la boutiqueDécouvrir la gamme