Passer au contenu principal
GET
Récupère un envoi unique par son identifiant de référence. La réponse provient de notre base de données et n’appelle jamais le transporteur. Une synchronisation en arrière-plan actualise chaque envoi (toutes les 10 minutes pour GO!, toutes les heures pour DHL) et synced_at t’indique quand le transporteur a été interrogé pour la dernière fois. Nécessite le scope shipments_view ou shipments_manage.

Requête

Paramètres de chemin

string
requis
ID de référence de l’envoi (par ex. P2611194821).

Réponse

En cas de succès, l’API renvoie 200 OK avec l’objet envoi.
string
requis
Identifiant de référence de l’envoi.
string
requis
Statut du cycle de vie de l’envoi. Valeur parmi pending, in_transit, delivered, fault ou cancelled.
string
requis
Prestataire logistique. L’une des valeurs go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups ou dhl_express. Un colis de kit à domicile utilise dhl_parcel, ou dhl_warenpost lorsqu’il part à l’étranger en Warenpost International.
string
Numéro de suivi externe du prestataire logistique. Peut être null.
string
Description libre du contenu du colis, telle qu’indiquée à la création (par ex. "Medizinisch freigestellte Probe", "Home test kit"). À titre informatif uniquement — pour savoir si un colis est destiné à un laboratoire, consulte destination, et pour son pendant, consulte paired_with. Peut être null.
string
requis
Qui a imprimé l’étiquette : aniva ou external. Seuls les envois aniva acceptent Mettre à jour et Annuler ; un colis external est suivi mais renvoie 501 pour les deux.
string
Référence de l’autre colis d’une expédition de deux colis — le colis qui contenait une étiquette de retour et le colis que cette étiquette renvoie. Défini sur les deux. null pour un colis aller simple.
object
Adresse d’enlèvement. Peut être null.
object
Adresse de livraison. Même structure que origin. Peut être null.
object
Créneau de collecte programmé. Peut être null.
string
Notes facultatives. Peut être null.
object[]
requis
Événements chronologiques du cycle de vie fournis par le prestataire logistique (du plus ancien au plus récent). Tableau vide si le prestataire n’a encore signalé aucun événement. Utilise ce champ pour l’affichage par événement, l’audit et les signaux fins du transporteur ; appuie-toi sur status pour l’état actuel de référence.
ShipmentAppointmentLink[]
requis
Rendez-vous liés à cet envoi, du lien le plus ancien au plus récent. Chaque entrée a la forme { id, added_at } ; recoupe chaque id avec Obtenir un rendez-vous pour obtenir l’objet complet du rendez-vous. Tableau vide lorsqu’aucun rendez-vous n’est lié. Seuls les rendez-vous de ton contexte d’accès sont listés.
ShipmentHomeKitOrderLink[]
requis
Commandes de kit à domicile liées à cet envoi, du lien le plus ancien au plus récent, au même format { id, added_at }. Recoupe chaque id avec Obtenir une commande de kit à domicile. Tableau vide pour les colis de cabinet. Seules les commandes de ton contexte d’accès sont listées. Voir Accès.
string
Moment de la dernière synchronisation de l’envoi avec son transporteur, en UTC. Les lectures n’appellent jamais le transporteur — une synchronisation en arrière-plan garde les envois à jour — ce champ indique donc l’ancienneté de la réponse. null jusqu’à la première synchronisation.
string
requis
Horodatage de création (ISO 8601).
string
Horodatage de dernière mise à jour (ISO 8601). Peut être null.

Appels répétés

Aniva stocke la réponse de ce point de terminaison pendant 60 minutes pour chaque clé API. Un appel répété durant ce délai reçoit la réponse stockée tant que l’envoi reste inchangé. Après une modification, tu reçois une réponse fraîche. Les en-têtes Cache-Status et Age indiquent que la réponse est stockée et son ancienneté. Dans une réponse stockée, synced_at et updated_at peuvent être plus anciens que dans une réponse fraîche. Pour être informé d’un changement immédiatement, abonne-toi aux événements webhook shipment.created et shipment.updated. Voir Lectures répétées.

Réponses d’erreur