Capire le notifiche
Ogni notifica contiene uno “stato” che specifica il tipo di evento da cui ha avuto origine.
Stato
| Stato | Descrizione |
| assigned | l’ordine è stato assegnato al negozio |
| fulfilled | gli articoli sono stati prelevati e completati nel Connected Retail Tool. L’ordine è pronto per essere spedito al cliente. |
| cancelled | tutti gli articoli dell’ordine sono stati annullati dal negozio e l’ordine è stato annullato per il cliente che lo ha inviato. |
| returned | alcuni/tutti gli articoli dell’ordine sono stati resi dal cliente che ha inviato l’ordine |
Transizioni di stato
| Da | A | Quando |
| assigned | al negozio viene assegnato l’ordine da Connected Retail |
| assigned | cancelled | il negozio annulla tutti gli articoli dell’ordine, l’ordine viene annullato per il cliente che lo ha inviato oppure viene inoltrato a un altro negozio |
| assigned | fulfilled | il negozio preleva almeno alcuni articoli dell’ordine e lo evade spedendolo al cliente |
| fulfilled | returned | il cliente restituisce alcuni articoli dell'ordine al negozio o magazzino zalando |
| returned | returned | il cliente restituisce alcuni articoli dell'ordine al negozio o magazzino zalando |
Struttura delle notifiche
L’evento ordine è un oggetto JSON con lo schema seguente
| Campo | Obbligatorio | Tipo | Descrizione | Esempio |
| event_id | necessario | string | id univoco dell’evento | “782d1ec3-8441-44db-a081-76df6b2de18f” |
| order_id | necessario | string | id dell’ordine in Connected Retail | “61e2d090-0d53-451f-9031-413559d34732” |
| order_number | necessario | string | il numero dell’ordine in Connected Retail. Il numero viene visualizzato nell’app di Connected Retail Tool. | 10105000000000 |
| state | necessario | string | uno tra “assigned” o “cancelled” o “fulfilled” o “returned“ | “assigned” |
| store_id | necessario | string | id negozio fornito nel feed FCI nella colonna “negozio”, per lo stato “returned” gli articoli devono essere resi a un negozio diverso da quello che ha evaso l’ordine | “11” |
| timestamp | necessario | string | marca temporale ISO 8061 | “2020-01-28T07:41:23.384Z” oppure -”2020-01-28T07:41:31Z” |
| delivery_details | opzionale | jsonObject | Informazioni sul tracciamento della consegna e del reso | {delivery_tracking_number: "003404342888680268172", delivery_carrier_name: "DHL", return_tracking_number: "35141263178", return_carrier_name: "DHL"} |
| customer_billing_address | opzionale | jsonObject | nome del cliente e indirizzo di fatturazione | { "first_name": "Johann", "last_name": "Heinichen", "address_line_1": "Valeska-Gert-Straße 5", "zip_code": "10243", "city": "Berlin", "country_code": "DE" } |
| items | necessario | Array | articoli che sono stati interessati dalla transizione di stato - per gli ordini evasi l’elenco di articoli che sono stati spediti esclusi quelli annullati
- per gli ordini annullati l’elenco degli articoli che sono stati annullati (cioè tutti gli articoli dell’ordine)
- per gli ordini assegnati tutti gli articoli dell’ordine
- per gli ordini resi l’elenco degli articoli che sono stati resi in questo specifico momento dal cliente
| { "item_id": "15c3aa83-3f73-4ad6-a326-e1a10a89dd52", "ean": "4059701022541", "price": 99.15, "currency": "EUR", "article_number": “31.832.34-6,5”, "zalando_article_number": “DU341A00M-1020375000”, "article_location": 213 } |
| cancelled_items | opzionale | Array | articoli che sono stati annullati nell’ordine parzialmente evaso - Conterrá articoli annullati solo quando un ordine evaso ha sia articoli spediti che articoli annullati
- Se tutti gli articoli dell’ordine sono annullati e l’ordine viene annullato, questo campo sarà vuoto, mentre gli articoli annullati saranno inclusi nel campo “items”
| { "item_id": "15c3aa83-3f73-4ad6-a326-e1a10a89dd52", "ean": "4059701022541", "price": 99.15, "currency": "EUR", "article_number": “31.832.34-6,5”, "zalando_article_number": “DU341A00M-1020375000”, "article_location": 213, "cancellation_reason": "OUT_OF_STOCK" } |
Item ha lo schema seguente:
| Campo | Obbligatorio | Tipo | Descrizione | Esempio |
| item_id | necessario | string | id dell’articolo in Connected Retail | “15c3aa83-3f73-4ad6-a326-e1a10a89dd52” |
| ean | necessario | string | EAN dell’articolo | “4059701022541” |
| price | necessario | number | il prezzo dell’articolo | 99,95 or 12 |
| currency | necessario | string | codice valuta ISO-4217 | “EUR” |
| article_number | necessario | string | codice articolo (SKU) fornito nel feed FCI feed nella colonna “codice_articolo” | “31.832.34-6,5” |
| zalando_article_number | necessario | string | Identificatore articolo Zalando | “DU341A00M-1020375000” |
| article_location | opzionale | string | ubicazione dell’articolo fornita nel feed FCI feed (ad esempio, l’id del reparto “principale” dove può essere trovato l’articolo nel negozio) | “213” |
| return_reason_code | opzionale | number | Il numero del motivo associato al motivo del reso, la descrizione del codice si trova nella sezione “Descrizione codice motivo del reso” | 1 |
| return_location | opzionale | string | Il luogo di restituzione dell'articolo. Se l'articolo è stato restituito a un negozio, il valore è "STORE" e se è stato restituito a un magazzino Zalando, il valore è "ZALANDO" | STORE |
| cancellation_reason | opzionale | string | La sezione "Descrizione del motivo di annullamento" contiene il motivo di annullamento dell'articolo e una descrizione dei valori | "OUT_OF_STOCK" |
delivery_details ha lo schema seguente:
| Campo | Obbligatorio | Tipo | Descrizione | Esempio |
| delivery_tracking_number | opzionale | string | numero tracciamento consegna | “003404342888680268172” |
| delivery_carrier_name | opzionale | string | nome del corriere | “DHL” |
| return_tracking_number | opzionale | string | numero tracciamento reso | "35141263178" |
| return_carrier_name | opzionale | string | nome del corriere per il reso | “DHL” |
customer_billing_address ha lo schema seguente:
| Campo | Obbligatorio | Tipo | Descrizione | Esempio |
| first_name | necessario | string | nome del cliente | “Johann” |
| last_name | necessario | string | cognome del cliente | “Heinichen” |
| address_line_1 | necessario | string | prima riga dell'indirizzo di fatturazione | “Valeska-Gert-Straße 5“ |
| address_line_2 | opzionale | string | ulteriori informazioni sull'indirizzo di fatturazione, ad es. NIP per la Polonia, descrizione più dettagliata di indirizzo e destinatario o istruzioni aggiuntive | “NIP 1234567890“, “PL0123456789“, “Hinterhaus, 1. OG“, “At the mailboxes through the sliding door“ |
| address_line_3 | opzionale | string | ulteriori informazioni aggiuntive sull'indirizzo di fatturazione | |
| zip_code | necessario | string | codice postale dell'indirizzo di fatturazione | “10243“ |
| city | necessario | string | indirizzo di fatturazione città | “Berlin“ |
| country_code | necessario | string | codice del paese dell'indirizzo di fatturazione | “DE“ |
Descrizione codice motivo del reso
| Codice motivo del reso | Motivo |
| 1 | Non mi sta bene |
| 2 | Troppo grande |
| 3 | Troppo piccolo |
| 4 | Qualità non sufficiente |
| 5 | Arrivato troppo tardi |
| 6 | Non soddisfa le mie aspettative |
| 7 | Articolo errato |
| 8 | Difettoso |
| 9 | Nessun motivo disponibile |
| 10 | Consegna fallita |
| -1 | Motivo sconosciuto |
Descrizione del motivo della cancellazione
| Motivo di cancellazione | Description |
| "ITEM_BROKEN" | L'articolo è rotto |
| "ITEM_MISSING" | L'articolo è disponibile nel sistema di inventario, ma in realtà è mancante nel negozio |
| "OUT_OF_STOCK" | L'articolo non è disponibile nel sistema di inventario |
| "UNKNOWN_REASON" | Ragione sconosciuta |
Posizione dell'articolo restituito
| Posizione | Description |
| "STORE" | L'articolo è stato restituito al negozio |
| "ZALANDO" | L'articolo è stato restituito al magazzino di Zalando. In questo caso store_id nell'evento si riferisce al negozio che ha evaso l'ordine |