Artikelen & hoeveelheden
Artikelnummer, omschrijving, hoeveelheid en overeengekomen eenheidscode.
STASTO × UW INKOOPSYSTEEM
Selecteer in de Store.
Ga verder met werken in het ERP-systeem.
Open de STASTO-catalogus vanuit uw inkoopsysteem. Zoek de juiste onderdelen en voeg het winkelmandje toe aan uw inkoopproces.
Uw inkoopsysteemCatalogussessie starten
OCI
STASTO STOREZoeken. Kiezen. Winkelwagen vullen.
PneumatiekArmaturen
Winkelwagen overzetten
Terug naar uw aankoopprocesIn het ERP-systeem controleren en verder verwerken
01 / PUNCHOUT
In vier stappen van de catalogus naar de aankoop.
- 01
Aan de slag met het ERP-systeem
Start de STASTO-catalogus vanuit uw inkoopsysteem. De toegang tot de catalogus en het terugkeeradres worden doorgegeven aan de Store.
- 02
Componenten selecteren
Zoek op artikelnummer of trefwoord, maak een keuze aan de hand van productafbeeldingen en beperk de resultaten met technische filters.
- 03
Winkelwagen doorsturen
Start PunchOut vanuit het winkelmandje. Controleer het overdrachtsoverzicht en bevestig vervolgens de terugzending naar uw ERP-systeem.
- 04
Doorgaan met winkelen
Controleer de overgenomen posities in uw inkoopsysteem en zet uw interne goedkeurings- en bestelproces voort.
Het overdragen van het winkelmandje leidt op zich nog niet tot een bestelling bij STASTO. De verdere stappen in het aankoopproces vinden plaats in uw inkoopsysteem.
02 / INSTELLINGEN
Alles voor uw integratieteam.
Startpagina van de catalogus
POST
https://www.stasto.eu/oci/catalogProductief eindpunt. Stem vóór uw integratietest een aparte testomgeving af met STASTO.
| Parameters | Betekenis |
|---|---|
HOOK_URL | Vereist. Het terugkeeradres dat door uw inkoopsysteem voor de huidige sessie wordt verstrekt. |
gebruikersnaam | De ingestelde gebruikersnaam voor de catalogus. Vereist bij aanmelding via parameters. |
wachtwoord | Het wachtwoord voor deze catalogustoegang. Vereist bij aanmelding via parameters. |
Voorbeeld van een verzoek · POST
Voorbeeld met plaatshouders. Geef de waarden URL-gecodeerd door in de request-body en vervang alle plaatshouders in uw integratieconfiguratie.
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_PASSWORDAlternatieve aanmelding en gedrag tijdens de vergadering
HTTP Basic Authentication wordt ook ondersteund. Laat in dat geval de parameters username en password weg en geef de toegangsgegevens door in de Authorization-header. HOOK_URL blijft verplicht.
GET wordt geaccepteerd voor compatibele systemen. Geef de voorkeur aan HTTPS met POST, zodat inloggegevens niet in de URL-geschiedenis en in URL-logbestanden verschijnen. Na het inloggen wordt de browser doorgestuurd naar /shop; behoud dezelfde browsersessie voor het doorgeven van het winkelmandje.
03 / DATA
Wat er in uw ERP binnenkomt.
Het retourformulier verstuurt artikelgegevens via een POST-verzoek in de browser naar uw HOOK_URL. De velden worden per artikel in het winkelmandje genummerd vanaf 1. De tabel toont de standaardtoewijzing; aangepaste instellingen van de klant kunnen afzonderlijke waarden overschrijven.
Prijzen & levertijd
Eenheidsprijs na korting, valuta en levertijd in hele dagen.
Classificatie & klantgegevens
Productcategorie, optioneel artikelnummer van de klant en productafbeelding.
OCI-veldreferentie
| Veld | Standaardinhoud |
|---|---|
NEW_ITEM-VENDORMAT[1] | STASTO-artikelnummer. |
NEW_ITEM-DESCRIPTION[1] | Productnaam. |
NEW_ITEM-LONGTEXT_1:132[] | Productbeschrijving, of anders de productnaam. |
NEW_ITEM-QUANTITY[1] | Aantal artikelen in het winkelmandje. |
NEW_ITEM-UNIT[1] | Klantspecifieke eenheidstoewijzing, anders de onderhouden OCI-eenheid; standaardwaarde C62. Strenge controles kunnen een ongeldige toewijzing blokkeren. |
NEW_ITEM-PRICE[1] | Eenheidsprijs uit het winkelmandje na korting. |
NEW_ITEM-PRICEUNIT[1] | 1 (prijs per stuk). |
NEW_ITEM-CURRENCY[1] | Valuta van het winkelmandje, bijvoorbeeld EUR. |
NEW_ITEM-VENDOR[1] | Naam van de verkopende STASTO-onderneming. |
NEW_ITEM-LEADTIME[1] | Levertijd in hele dagen, afgerond naar boven. |
NEW_ITEM-MATGROUP[1] | Geconfigureerde eClass-code of standaardwaarde voor de categorie. Zie de opmerkingen over de classificatie hieronder. |
NEW_ITEM_ATTACHMENT[1] | Absolute URL van de productafbeelding, voor zover er een afbeelding is toegevoegd. |
NEW_ITEM_ATTACHMENT_TITLE[1] | Producttitel bij de afbeelding. |
NEW_ITEM-CUST_FIELD1[1] … NEW_ITEM-CUST_FIELD4[1] | Standaard leeg; vaste, klantspecifieke waarden kunnen worden geconfigureerd. |
NEW_ITEM-CUST_FIELD5[1] | Het artikelnummer van de klant, indien ingevoerd, of een geconfigureerde vaste waarde. |
Het retourformulier verzendt bovendien ~OkCode=ADDI, ~target=_top, ~ForceTarget=yes en ~caller=CTLG. Stem deze instellingen bij de acceptatie af met uw ontvanger.
eClass, productgroepen en eenheidstoewijzing
eClass 7.1 is de standaard. Voor eClass 8.1 is het vereist dat het betreffende veld is ingevuld en dat de gegevens zijn bijgewerkt. De eerste toegewezen websitecategorie bepaalt de classificatie; koppeltekens worden uit de code verwijderd.
Als de geselecteerde code ontbreekt, wordt de geconfigureerde alternatieve versie gecontroleerd; daarna wordt de interne categorie of ‘Algemeen’ gebruikt. Als de classificatie is uitgeschakeld, wordt ‘Algemeen’ verzonden. Geef aan welke waarden uw ERP accepteert.
Eenheidscodes en vaste veldwaarden worden voor het klantbedrijf geconfigureerd. Het leveranciersveld verwijst altijd naar het bedrijf dat de goederen verkoopt. Productafbeeldingen worden als links doorgegeven; de overdracht van het winkelmandje bevat geen documentenpakket.
04 / CHECK
Een volledig proces controleren.
Gebruik, voordat u de omgeving vrijgeeft voor uw inkopers, een afgestemde testomgeving en een klein voorbeeldwinkelmandje.
- Open de catalogus vanuit het ERP-systeem en controleer de juiste klantcontext en de prijzen.
- Kies twee verschillende artikelen en wijzig ten minste één hoeveelheid.
- Controleer de artikelnummers, hoeveelheid, eenheid, valuta, prijs en levertijd in het overdrachtsoverzicht.
- Bevestig de retourzending en vergelijk alle overgenomen posities in het ERP-systeem, inclusief classificatie en klantvelden.
In het winkelmandje is de optie om het mandje te legen standaard ingeschakeld. Het leegmaken vindt plaats bij het aanmaken van het overdrachtsoverzicht, voordat het ERP-systeem de ontvangst bevestigt. Houd hier rekening mee wanneer u een nieuwe overdrachtspoging test.
05 / ONDERSTEUNING
Vragen over de verbinding?
Vermeld bij een supportaanvraag uw inkoopsysteem, het tijdstip van de poging en de foutmelding. Deel inloggegevens uitsluitend via een vooraf afgesproken, beveiligd kanaal.
De aansluiting besprekenHOOK_URL ontbreekt – wat betekent dat?
Uw ERP-systeem moet het terugkeeradres opgeven bij het openen van /oci/catalog. Controleer de exacte hoofdlettergebruik van HOOK_URL en de URL-codering.
De aanmelding mislukt. Wat moet er worden gecontroleerd?
Controleer de afgesproken inloggegevens voor de catalogus, het wachtwoord en de inlogmethode. Een succesvolle HTTP-status op zich is geen bevestiging dat het inloggen is gelukt: controleer of de browser verbinding kan maken met de webshop.
De PunchOut-knop ontbreekt in het winkelmandje.
Start de sessie vanuit uw ERP via /oci/catalog en voeg een artikel toe. Bij een directe oproep naar de webshop wordt er geen PunchOut-terugkeeradres opgeslagen. Verander niet van browsersessie.
Het winkelmandje wordt niet in het ERP-systeem opgenomen.
Bevestig de tweede stap van de overdracht in het overzicht. Controleer of het terugkeeradres de POST-verzoek van het formulier accepteert, of de sessie is verlopen en of de browser ingebedde vensters beperkt. Als het winkelmandje is leeggemaakt, controleer dan eerst het ERP-systeem voordat u het opnieuw probeert.
Een positie wordt afgewezen vanwege de eenheid of de productgroep.
Vergelijk de overgedragen waarden UNIT en MATGROUP met de waarden die in het ERP-systeem zijn toegestaan. Stem de eenheidstoewijzing, de eClass-versie en de standaardwaarden af met STASTO.
Geldt deze handleiding ook voor cXML?
In deze handleiding wordt de geïmplementeerde OCI-interface beschreven. Neem vóór de installatie contact op met STASTO als u andere protocollen of systeemspecifieke vereisten wilt bespreken.
Maak kennis met de winkel.Naar de winkelgidsBekijk het assortiment