Articoli e quantità
Codice articolo, descrizione, quantità e codice unità concordato.
STASTO × IL VOSTRO SISTEMA DI APPROVVIGIONAMENTO
Selezionare nello store.
Continuare a lavorare nell'ERP.
Aprite il catalogo STASTO dal vostro sistema di approvvigionamento. Individuate i componenti adatti e trasferite il carrello nel vostro processo di acquisto.
Il vostro sistema di approvvigionamentoAvvia la sessione del catalogo
OCI
STASTO STORETrova. Scegli. Aggiungi al carrello.
PneumaticaRaccordi
Trasferimento del carrello
Torna alla procedura di acquistoVerifica e modifica nell'ERP
01 / PUNCHOUT
In quattro passaggi dal catalogo all’acquisto.
- 01
Avviare l'ERP
Avviare il catalogo STASTO dal proprio sistema di approvvigionamento. L'accesso al catalogo e l'indirizzo di ritorno vengono trasmessi allo Store.
- 02
Selezionare i componenti
Cerca per codice articolo o termine, seleziona dalle immagini dei prodotti e restringi la ricerca alle varianti utilizzando i filtri tecnici.
- 03
Trasferisci il carrello
Avviare PunchOut dal carrello. Verificare il riepilogo del trasferimento e confermare quindi il ritorno al proprio ERP.
- 04
Continua lo shopping
Verificate le voci importate nel vostro sistema di approvvigionamento e proseguite con la procedura interna di approvazione e ordinazione.
Il semplice trasferimento del carrello non comporta ancora l'effettuazione di un ordine presso STASTO. Le fasi successive dell'acquisto vengono eseguite nel vostro sistema di approvvigionamento.
02 / CONFIGURAZIONE
Tutto ciò che serve al vostro team di integrazione.
Pagina iniziale del catalogo
POST
https://www.stasto.eu/oci/catalogEndpoint di produzione. Prima di eseguire il test di integrazione, configurate un ambiente di test separato con STASTO.
| Parametri | Significato |
|---|---|
HOOK_URL | Obbligatorio. L'indirizzo di ritorno fornito dal sistema di approvvigionamento per la sessione corrente. |
username | Le credenziali di accesso dell'utente configurate per il catalogo. Richieste in caso di accesso tramite parametri. |
password | La password di questo accesso al catalogo. Richiesta in caso di accesso tramite parametri. |
Esempio di richiesta · POST
Esempio con caratteri jolly. Inserite i valori codificati in formato URL nel corpo della richiesta e sostituite tutti i caratteri jolly nella configurazione dell'integrazione.
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_PASSWORDModalità alternative di registrazione e comportamento durante la seduta
È supportata anche l'autenticazione HTTP Basic. In questo caso, omettete i parametri username e password e specificate le credenziali nell'intestazione Authorization. HOOK_URL rimane obbligatorio.
GET è accettato per i sistemi compatibili. Si consiglia di utilizzare HTTPS con POST, in modo che le credenziali di accesso non compaiano nella cronologia degli URL e nei log degli URL. Dopo aver effettuato l'accesso, il browser verrà reindirizzato a /shop; mantenere la stessa sessione del browser per il trasferimento del carrello.
03 / DATI
Cosa viene registrato nel vostro ERP.
Il modulo di reso invia i dati delle voci tramite POST dal browser al tuo HOOK_URL. I campi sono numerati a partire da 1 per ogni voce del carrello. La tabella mostra l'assegnazione predefinita; le impostazioni personalizzate del cliente possono sovrascrivere singoli valori.
Prezzi e tempi di consegna
Prezzo unitario al netto dello sconto, valuta e tempi di consegna in giorni interi.
Classificazione e dati dei clienti
Categoria di prodotti, codice articolo facoltativo del cliente e immagine del prodotto.
Riferimento sul campo OCI
| Campo | Contenuto standard |
|---|---|
NEW_ITEM-VENDORMAT[1] | Codice articolo STASTO. |
NEW_ITEM-DESCRIPTION[1] | Nome del prodotto. |
NEW_ITEM-LONGTEXT_1:132[] | Descrizione del prodotto o, in alternativa, il nome del prodotto. |
NEW_ITEM-QUANTITY[1] | Quantità dell'articolo nel carrello. |
NEW_ITEM-UNIT[1] | Assegnazione dell'unità specificata dal cliente; in caso contrario, l'unità OCI definita; valore di default C62. I controlli rigorosi possono bloccare un'assegnazione non valida. |
NEW_ITEM-PRICE[1] | Prezzo unitario dal carrello dopo lo sconto. |
NEW_ITEM-PRICEUNIT[1] | 1 (prezzo unitario). |
NEW_ITEM-CURRENCY[1] | Valuta del carrello, ad esempio EUR. |
NEW_ITEM-VENDOR[1] | Nome della società STASTO venditrice. |
NEW_ITEM-LEADTIME[1] | Tempo di consegna in giorni interi, arrotondato per eccesso. |
NEW_ITEM-MATGROUP[1] | Codice eClass configurato o valore di default della categoria. Si vedano le note sulla classificazione riportate di seguito. |
NEW_ITEM_ATTACHMENT[1] | URL assoluto dell'immagine del prodotto, qualora sia stata inserita un'immagine. |
NEW_ITEM_ATTACHMENT_TITLE[1] | Titolo del prodotto corrispondente all'immagine. |
NEW_ITEM-CUST_FIELD1[1] … NEW_ITEM-CUST_FIELD4[1] | Per impostazione predefinita è vuoto; è possibile configurare valori fissi specifici per il cliente. |
NEW_ITEM-CUST_FIELD5[1] | Codice articolo cliente, se presente, oppure un valore fisso configurato. |
Il modulo di restituzione invia inoltre ~OkCode=ADDI, ~target=_top, ~ForceTarget=yes e ~caller=CTLG. Al momento dell'accettazione, concordate questi campi di controllo con il vostro destinatario.
eClass, categorie di prodotti e assegnazione delle unità
eClass 7.1 è lo standard. eClass 8.1 richiede la presenza del campo corrispondente e dei dati aggiornati. La prima categoria del sito web assegnata fornisce la classificazione; i trattini vengono rimossi dal codice.
Se il codice selezionato non è presente, viene verificata la versione di ripiego configurata; successivamente viene utilizzata la categoria interna o “Generale”. Se la classificazione è disattivata, viene inviato “Generale”. Specificate quali valori sono accettati dal vostro ERP.
I codici delle unità e i valori fissi dei campi vengono configurati per l'azienda cliente. Il campo "Fornitore" indica sempre la società venditrice. Le immagini dei prodotti vengono trasmesse sotto forma di link; il trasferimento del carrello non include alcun pacchetto di documenti.
04 / CONTROLLO
Verificare l'intero processo.
Prima di rendere il sistema disponibile ai vostri acquirenti, utilizzate un ambiente di test configurato ad hoc e un piccolo carrello di esempio.
- Aprire il catalogo dall'ERP e verificare il contesto cliente corretto e i prezzi.
- Selezionare due articoli diversi e modificare almeno una quantità.
- Verificare i codici articolo, la quantità, l'unità, la valuta, il prezzo e i tempi di consegna nella panoramica dei trasferimenti.
- Confermare la restituzione e confrontare tutte le voci importate nel sistema ERP, comprese la classificazione e i campi relativi al cliente.
Nel carrello, l'opzione di svuotamento è attivata per impostazione predefinita. Lo svuotamento avviene durante la creazione del riepilogo di trasferimento, prima che l’ERP ne confermi la ricezione. Tenetelo presente quando provate a ripetere il trasferimento.
05 / ASSISTENZA
Domande sulla connessione?
Quando inviate una richiesta di assistenza, indicate il vostro sistema di approvvigionamento, l'ora in cui si è verificato il problema e il messaggio di errore. Comunicate i dati di accesso solo tramite un canale sicuro concordato.
Discutere della connessioneManca HOOK_URL – cosa significa?
Il vostro ERP deve specificare l'indirizzo di ritorno all'apertura di /oci/catalog. Verificate l'esatta maiuscola di HOOK_URL e la codifica dell'URL.
La registrazione non va a buon fine. Cosa bisogna verificare?
Verificate il nome utente e la password concordati per l'accesso al catalogo, nonché il metodo di accesso. Un codice di stato HTTP positivo da solo non garantisce che l'accesso sia andato a buon fine: verificate che il browser riesca a collegarsi al negozio online.
Nel carrello manca il pulsante "PunchOut".
Avviare la sessione dal proprio ERP tramite /oci/catalog e aggiungere un articolo. Un accesso diretto al negozio online non memorizza alcun indirizzo di ritorno PunchOut. Non cambiare sessione del browser.
Il carrello non viene registrato nel sistema ERP.
Confermare la seconda fase di trasferimento nella panoramica. Verificare che l’indirizzo di reindirizzamento accetti il POST del modulo, che la sessione non sia scaduta e che il browser non limiti le finestre incorporate. Se il carrello è stato svuotato, prima di riprovare controllare l’ERP.
Una posizione viene rifiutata a causa dell'unità o del gruppo di merci.
Confrontate i valori trasferiti UNIT e MATGROUP con quelli consentiti nel sistema ERP. Verificate con STASTO l’assegnazione delle unità, la versione eClass e i valori di default.
Queste istruzioni valgono anche per cXML?
La presente guida descrive l'interfaccia OCI implementata. Prima della configurazione, si prega di discutere con STASTO eventuali altri protocolli o requisiti specifici del sistema.
Scopri lo store.Vai alla guida dello storeVisualizza l'assortimento