Vai al contenuto

Versione

Versione attuale: [1.0.8] - 11.07.2022

Retrocompatibilità

Saranno evitate modifiche sostanziali, ma in futuro le API potranno evolversi in un modo che garantisca la retrocompatibilità.

Esempi di modifiche sostanziali che saranno evitate

  • Rinominare un attributo
  • Cambiare il tipo di un 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 sistemi del cliente che utilizzano le API dovrebbero essere preparati per i cambiamenti retrocompatibili elencati e gestire agevolmente l’aggiunta di nuovi attributi e tipi di evento: un’implementazione sensata potrebbe comportare il fatto di ignorare detti attributi e tipi di evento aggiuntivi senza essere troppo rigorosi nell’asserire quale preciso set di attributi è incluso in un evento.

Filtrare gli eventi

Il sistema del cliente che si collega all’API degli eventi ordine ha la responsabilità di filtrare certi tipi di evento.

ChangeLog

  • [2.0.0] - 23.09.2024 - routed events have been replaced by a pair of canceled and assigned. routed events might still be produced for some existing older integrations.
  • [1.0.9] - 19.08.2022 - extended "state" attribute with new values "zalando_warehouse_fulfilled" and "zalando_warehouse_returned"
  • [1.0.8] - 11.07.2022 - added "cancelled_items" attribute in "fullfilled" events for cancelled items
  • [1.0.7] - 07.01.2022 - added "return_location" attribute in "item" object only for "returned" events
  • [1.0.6] - 27.10.2021 - added "cancellation_reason" attribute in "item" object only for "cancelled" events.
  • [1.0.5] - 14.06.2021 - added "customer_billing_address" attribute for "fulfilled" and "returned" events
  • [1.0.4] - 11.02.2021 - fix "article_number" bug when it contained "zalando_article_number" rather than the value of the "article_number" column provided in the FCI feed, add a new "zalando_article_number" attribute
  • [1.0.3] - 04.01.2021 - added "Delivery failed" return reason for "returned" events as return code 10
  • [1.0.2] - 07.10.2020 - added "return_reason_code" attribute in "item" object for "returned" events
  • [1.0.1] - 05.10.2020 - added "delivery_details" attribute for "fulfilled" and "returned" events
  • [1.0.0] - 10.06.2020