Risque de surestaries
Des frais de surestaries sont facturés quand un conteneur reste au port plus longtemps que le temps libre accordé par le transporteur ou l'autorité portuaire. Détecter le risque tôt permet au propriétaire de l'expédition d'adapter le planning et de payer moins de frais. Un seul appel à l'endpoint GET /shipment de la Container Tracking API renvoie les events de conteneur dont cette détection a besoin.
Quand les frais de surestaries sont facturés
Des frais de surestaries peuvent être facturés dans deux situations :
- au port de chargement (POL), quand le conteneur est arrivé au terminal et n'a pas encore été chargé sur un navire ;
- au port de déchargement (POD), quand le conteneur a été déchargé du navire et n'a pas encore quitté le port.
Logique de détection
Un risque de surestaries se détecte en mesurant, à chaque port, le délai entre deux events du conteneur, et en levant une alerte quand ce délai dépasse un seuil que vous choisissez.
| Port | Début du délai | Fin du délai | Repli quand un event manque |
|---|---|---|---|
| POL | Arrivée du conteneur au terminal : statut CGI (gate in) | Chargement du conteneur sur le navire : statut CLL (chargé) | Départ du navire du POL (VDL) à la place du chargement |
| POD | Déchargement du conteneur du navire : statut CDD (déchargé) | Départ du conteneur du port : statut CGO (gate out) | Arrivée du navire au POD (VAD) à la place du déchargement |
Appliquez-la aux events de chaque conteneur, dans containers[].events de la réponse :
- Au POL, trouvez l'event de statut
CGIet l'event de statutCLL. Quand l'eventCLLmanque, utilisez à la place la date de départ du navire. - Au POD, trouvez l'event de statut
CDDet l'event de statutCGO. Quand l'eventCDDmanque, utilisez à la place la date d'arrivée du navire. - Calculez le délai entre les deux dates de chaque port.
- Comparez chaque délai à votre seuil, et levez une alerte quand il est dépassé.
- Quand l'event qui clôt le délai manque encore — le conteneur n'a pas été chargé, ou n'a pas quitté le port — le délai ne peut pas encore être calculé. Continuez à mettre à jour l'expédition : les compagnies maritimes ajoutent régulièrement des events.
Exemple
La réponse ci-dessous, réduite aux events du conteneur, suit un conteneur chargé à Melbourne (AUMEL) et à destination de Colombo (LKCMB) :
{
"containers": [
{
"status": "IN_TRANSIT",
"events": [
{
"location": { "name": "MELBOURNE", "locode": "AUMEL" },
"description": "Gate in at Port terminal",
"eventType": "EQUIPMENT",
"eventCode": "GTIN",
"status": "CGI",
"date": "2024-05-29T07:34:00Z",
"isActual": true
},
{
"location": { "name": "MELBOURNE", "locode": "AUMEL" },
"description": "Loaded on board",
"eventType": "EQUIPMENT",
"eventCode": "LOAD",
"status": "CLL",
"date": "2024-06-02T03:51:00Z",
"isActual": true
},
{
"location": { "name": "COLOMBO", "locode": "LKCMB" },
"description": "Vessel Arrival",
"eventType": "TRANSPORT",
"eventCode": "ARRI",
"status": "VAD",
"date": "2024-07-06T13:30:00Z",
"isActual": false
}
]
}
]
}
Détection au port de chargement
- Le conteneur a à la fois un event
CGI(gate in) et un eventCLL(chargé) à Melbourne. - La date du
CGIest2024-05-29T07:34:00Z, celle duCLLest2024-06-02T03:51:00Z. - Le temps passé au port de chargement est de 3 jours, 20 heures et 17 minutes.
Comparez ce temps à votre seuil pour décider d'envoyer ou non une alerte.
Détection au port de déchargement
- Le conteneur n'a qu'un event
VAD(arrivée du navire) à Colombo, estimé, et aucun eventCGO(gate out). - Le risque de surestaries ne peut pas encore être calculé au port de déchargement.
Continuez à mettre à jour les données de cette expédition : la compagnie maritime ajoute des events au fil du voyage.