📣 Zalando - Notizie - 1° Maggio 2025 - Realizzazione: Aggiornamento Endpoint API

Cosa sta cambiando 

L'endpoint attuale "GET /received-items/{merchant-id}" sarà deprecato e sostituito da "GET /reports/received-items/{merchant-id}"
Lengow ha già integrato questo nuovo endpoint, e non è richiesta alcuna azione da parte tua utilizzando la soluzione di adempimento di Zalando Lengow direttamente. Consulta la documentazione API di Lengow qui.

Tuttavia, se stai utilizzando il vecchio endpoint in integrazioni personalizzate, devi aggiornare i tuoi sistemi di conseguenza.

Miglioramenti nel nuovo endpoint

Zalando ha introdotto diversi miglioramenti:

• Intervallo di tempo esteso: Recupera i dati fino a 1 anno (precedentemente limitato a 100 giorni).
• Paginazione basata su cursore: Consente un recupero dei dati più semplice utilizzando un next_page_token, senza dover regolare manualmente gli intervalli di tempo.
• Rimozione di campi inutilizzati o ridondanti: "site_id (duplicato di location_id)"; "parent"; "tour_number"; "consumed_timestamp".
• Conservazione di received_timestamp, che indica quando gli articoli sono stati fisicamente ricevuti.
• Due nuovi campi opzionali aggiunti: "merchant_item_id";  "merchant_article_id".
  (Questi campi sono inclusi solo se li hai forniti durante l'inbound.)

Controlla la documentazione API di Zalando qui.

Cosa devi fare 

Azione richiesta entro il 1 maggio 2025

Se stai utilizzando l'endpoint deprecato "GET​/received-items​/{merchant-id}" in una configurazione personalizzata, assicurati di:

• Passare al nuovo endpoint: "GET /reports/received-items/{merchant-id}"
• Adattare l'analisi dei tuoi dati per tenere conto dei nuovi campi e della paginazione
• Interrompere l'uso dei campi rimossi

L'endpoint precedente sarà completamente disabilitato il 1 maggio 2025.

Messaggio originale

[...]

Questo nuovo endpoint viene con alcuni miglioramenti:

Stiamo estendendo la limitazione dell'intervallo di tempo da 100 giorni a 1 anno.

Supporta la paginazione basata su cursore, permettendoti di recuperare senza problemi il prossimo set di dati semplicemente fornendo il token della prossima pagina, senza la necessità di regolare l'intervallo di tempo.

Le proprietà irrilevanti e duplicate sono state eliminate:

Le proprietà site_id e location_id rappresentavano lo stesso valore, quindi abbiamo rimosso site_id.

Parent e tour_number sono stati rimossi, in quanto queste proprietà non erano utilizzate.

La proprietà consumed_timestamp è stata rimossa in quanto rappresenta dati che sono rilevanti solo per l'uso interno. Nota che la proprietà received_timestamp rimane in quanto rappresenta il momento in cui un articolo è stato fisicamente ricevuto.

Abbiamo anche aggiunto due nuove proprietà:

Le proprietà merchant_item_id e merchant_article_id sono state introdotte per fornire dati specificati dal commerciante se sono stati forniti durante il processo di inbound degli articoli.

[...]