FAQ¶

1. Fornite uno modulo di prova per collaudare OEA?¶

Connected Retail non fornisce un modulo di prova per collaudare OEA. Per questo motivo vi consigliamo di testare le notifiche per un periodo di 2 giorni prima di abilitare la vostra espressione logica di business.

2. Come faccio a sapere se una nuova configurazione API è disponibile?¶

Quando nuove funzionalità vengono aggiunte a una API vi invieremo un’email. Saranno evitate modifiche critiche, ma in futuro le API potranno evolversi in un modo che garantisca la retrocompatibilità.

Esempi di modifiche critiche che saranno evitate:

Rinominare un attributo
Cambiare il tipo di attributo
Rimuovere un attributo
Rimuovere un tipo di evento (ad esempio ‘zalando_warehouse_returned’)

Esempi di cambiamenti retrocompatibili che potrebbero essere introdotti:

Aggiungere un nuovo tipo di evento con un nuovo set di attributi
Aggiungere nuovi attributi ai tipi evento esistenti

I vostri sistemi IT che utilizzano l’API dovrebbero essere preparati per i cambiamenti retrocompatibili elencati e gestire agevolmente l’aggiunta di nuovi attributi e tipi di evento, senza essere troppo rigorosi nell’asserire quale preciso set di attributi è incluso in un evento.

Il vostro sistema che si collega all’API degli eventi ordine ha la responsabilità di filtrare determinati tipi di eventi.

3. Posso inviare una risposta diversa da [200]?¶

Gli stati HTTP restituiti dal webhook sono interpretati in base alla definizione di RFC 7231. Per esempio, 200 significa che un evento è stato ricevuto correttamente, 500 che si è verificato un errore interno del server, ecc.

4. Non vedo i dati del cliente nell’API. È possibile riceverli per abilitare il processo di prelievo?¶

L’API non fornisce i dati del cliente per il processo di prelievo.

5. Che cosa succede se un ordine ha due (o più) articoli identici, come saranno riportati nel payload del webhook?¶

Ogni articolo sarà riportato come una singola voce nella lista.

6. Che cosa succede se un ordine ha due articoli, uno contrassegnato come non disponibile, l’altro prelevato; quale evento viene inviato quando l’articolo viene completato nel tool?¶

Per l’ordine evaso, l’elenco degli articoli che sono stati completati, esclusi quelli annullati.

7. Che cosa succede se il mio server non accetta le notifiche per più di 3 giorni?¶

Non forniamo le notifiche in massa dopo 3 giorni. Non offriamo una funzionalità pull per il recupero delle notifiche.

8. Che aspetto hanno le notifiche relative a un ordine diviso?¶

Si parla di ordine diviso quando due ordini sono identificati dallo stesso numero. In caso di un ordine diviso, l’unica differenza è che più ordini condividono lo stesso numero d'ordine. Hanno comunque articoli, id evento e id ordine diversi.

9. Che aspetto hanno le notifiche di ordini parzialmente annullati?¶

Annullamento parziale significa che il negozio riceve prima un evento “assegnato” dove può vedere tutti gli articoli di uno specifico ordine. Supponiamo che il negozio riceva un ordine di 2 articoli. Quando l’ordine è parzialmente evaso, inviamo solo gli articoli che sono stati “evasi”. L’evento “evaso” contiene solo gli articoli che sono stati evasi. Non mandiamo altri eventi per gli articoli che sono stati annullati dal negozio.

10. Posso utilizzare il Simple Queue Service (SQS) di Amazon come URL del webhook?¶

Sì. Siccome è già stato impostato SQS, è possibile esporre la coda tramite un gateway AWS API creando una semplice API e utilizzando la funzione di servizio proxy del gateway API. Il gateway può anche essere messo in sicurezza all’origine con una chiave API. Qui di seguito forniamo alcune risorse che contengono la documentazione utile per iniziare.

11. In che modo i partner di Zalando Return Solution Plus (ZRS+) possono utilizzare gli eventi OEA per determinare dove si trovano gli articoli da restituire?¶

L'attributo "return_location" degli eventi "returned" può essere utilizzato per fornire informazioni ai tuoi sistemi IT sul luogo degli articoli restituiti.

Sono disponibili due valori per il campo "return_location" sugli eventi "returned": - “STORE” -> quando l'articolo viene restituito al negozio. - “ZALANDO” -> quando l'articolo viene restituito a Zalando.

Puoi vedere un esempio di un evento di ritorno qui.

Documentazione ufficiale su AWS API Gateway + S3
Impostazione delle chiavi API utilizzando la console API Gateway