Varer og mængder
Varenummer, beskrivelse, mængde og den aftalte enhedskode.
Individuell
Viele Komponenten, eine Artikelnummer — für Ihre Anwendung zusammengestellt, nicht aus dem Regal.
AnfragenSTASTO × DIT INDKØBSSYSTEM
Åbn STASTO-kataloget fra dit indkøbssystem. Find de relevante komponenter, og overfør indkøbskurven til din indkøbsproces.
01 / PUNCHOUT
Start STASTO-kataloget fra dit indkøbssystem. Adgang til kataloget og returadressen overføres til butikken.
Søg efter varenummer eller søgeord, vælg blandt produktbillederne, og indsnæv varianten med tekniske filtre.
Start PunchOut i indkøbskurven. Gennemgå overførselsoversigten, og bekræft derefter returneringen til dit ERP-system.
Kontroller de overførte poster i jeres indkøbssystem, og fortsæt jeres interne godkendelses- og bestillingsproces.
Det er ikke nok blot at overføre indholdet af indkøbskurven for at afgive en ordre hos STASTO. De øvrige trin i købsprocessen foregår i dit indkøbssystem.
02 / OPSÆTNING
https://www.stasto.eu/oci/catalogProduktivt slutpunkt. Aftal et separat testmiljø med STASTO inden din integrationstest.
| Parametre | Betydning |
|---|---|
HOOK_URL | Påkrævet. Den returadresse, som dit indkøbssystem har angivet for den aktuelle session. |
brugernavn | Den angivne brugerlogin til kataloget. Kræves ved login via parametre. |
password | Adgangskoden til denne katalogadgang. Kræves ved login via parametre. |
Eksempel med pladsholdere. Overfør værdierne URL-kodet i anmodningsteksten, og udskift alle pladsholdere i din integrationskonfiguration.
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_PASSWORDHTTP Basic-godkendelse understøttes ligeledes. Udelad i så fald parametrene »username« og »password«, og angiv adgangsoplysningerne i Authorization-headeren. HOOK_URL er stadig påkrævet.
GET accepteres for kompatible systemer. Brug helst HTTPS med POST, så loginoplysninger ikke vises i URL-historikken og i URL-logfiler. Efter login omdirigeres browseren til /shop; behold den samme browsersession til overførsel af indkøbskurven.
03 / DATA
Returformularen sender varelinjedata via en POST-anmodning fra browseren til din HOOK_URL. Felterne nummereres fra 1 for hver varelinje i indkøbskurven. Tabellen viser standardtildelingen; tilpassede kundeindstillinger kan overskrive enkelte værdier.
Varenummer, beskrivelse, mængde og den aftalte enhedskode.
Enhedspris efter rabat, valuta og leveringstid i hele dage.
Varegruppe, valgfrit kundevarenummer og produktbillede.
| Felt | Standardindhold |
|---|---|
NEW_ITEM-VENDORMAT[1] | STASTO-varenummer. |
NEW_ITEM-DESCRIPTION[1] | Produktnavn. |
NEW_ITEM-LONGTEXT_1:132[] | Salgsbeskrivelse eller produktnavn. |
NEW_ITEM-QUANTITY[1] | Antal af varen i indkøbskurven. |
NEW_ITEM-UNIT[1] | Kundespecifik enhedstildeling, ellers den vedligeholdte OCI-enhed; standardværdi C62. Strenge kontroller kan blokere en ugyldig tildeling. |
NEW_ITEM-PRICE[1] | Enkeltpris fra indkøbskurven efter rabat. |
NEW_ITEM-PRICEUNIT[1] | 1 (pris pr. enhed). |
NEW_ITEM-CURRENCY[1] | Valuta i indkøbskurven, f.eks. EUR. |
NEW_ITEM-VENDOR[1] | Navnet på det STASTO-selskab, der står for salget. |
NEW_ITEM-LEADTIME[1] | Leveringstid i hele dage, afrundet opad. |
NEW_ITEM-MATGROUP[1] | Konfigureret eClass-kode eller standardkategori. Se klassificeringsvejledningen nedenfor. |
NEW_ITEM_ATTACHMENT[1] | Den absolutte URL til produktbilledet, hvis der er angivet et billede. |
NEW_ITEM_ATTACHMENT_TITLE[1] | Produktnavn til billedet. |
NEW_ITEM-CUST_FIELD1[1] … NEW_ITEM-CUST_FIELD4[1] | Som standard er feltet tomt; faste kundespecifikke værdier kan konfigureres. |
NEW_ITEM-CUST_FIELD5[1] | Kundens varenummer, hvis det er oprettet, eller en konfigureret fast værdi. |
Returformularen sender desuden ~OkCode=ADDI, ~target=_top, ~ForceTarget=yes og ~caller=CTLG. Afstem disse kontrolfelter med din modtager ved godkendelsen.
eClass 7.1 er standarden. eClass 8.1 forudsætter, at det relevante felt er udfyldt, og at dataene er opdateret. Den første tildelte webstedskategori angiver klassificeringen; bindestreger fjernes fra koden.
Hvis den valgte kode mangler, kontrolleres den konfigurerede standardversion, hvorefter den interne kategori eller »General« anvendes. Hvis klassificeringen er deaktiveret, sendes »General«. Angiv, hvilke værdier dit ERP-system accepterer.
Enhedskoder og faste feltværdier konfigureres for kundevirksomheden. Leverandørfeltet angiver altid det sælgende selskab. Produktbilleder overføres som links; overførslen af indkøbskurven indeholder ikke et dokumentpakke.
04 / CHECK
Brug et afstemt testmiljø og en lille eksempelindkøbskurv, inden du giver dine indkøbere adgang.
I indkøbskurven er indstillingen til at tømme kurven aktiveret som standard. Tømningen finder sted, når overførselsoversigten oprettes, inden ERP-systemet bekræfter modtagelsen. Tag højde for dette, når du tester et nyt overførselsforsøg.
05 / SUPPORT
Når du henvender dig til supporten, skal du angive dit indkøbssystem, tidspunktet for forsøget og fejlmeddelelsen. Del kun adgangsoplysninger via en aftalt, sikker kanal.
Drøfte tilslutningenDeres ERP-system skal angive returadressen, når /oci/catalog åbnes. Kontroller den nøjagtige brug af store bogstaver i HOOK_URL og URL-kodningen.
Kontroller det aftalte kataloglogin, adgangskoden og log-in-metoden. En vellykket HTTP-status bekræfter ikke i sig selv, at log-in'et er lykkedes: Kontroller, om browseren kan få forbindelse til webshoppen.
Start sessionen fra dit ERP-system via /oci/catalog, og tilføj en vare. Ved et direkte besøg i webshoppen gemmes der ingen PunchOut-returadresse. Skift ikke browsersession.
Bekræft det andet trin i overførslen i oversigten. Kontroller, om returadressen accepterer POST-data fra formularen, om sessionen er udløbet, og om browseren begrænser indlejrede vinduer. Hvis indkøbskurven er blevet tømt, skal du først kontrollere ERP-systemet, før du prøver igen.
Sammenlign de overførte værdier UNIT og MATGROUP med de værdier, der er tilladt i ERP-systemet. Afstem enhedstildelingen, eClass-versionen og standardværdierne med STASTO.
Denne vejledning beskriver den implementerede OCI-grænseflade. Kontakt STASTO inden opsætningen, hvis der er tale om andre protokoller eller systemspecifikke krav.