Rôles & Permissions

Chaque Freight Document associe plusieurs rôles (parties prenantes) : CONSIGNOR (expéditeur), CARRIER (transporteur), CONSIGNEE (destinataire), PLACEOFTAKINGOVER/PLACEOFDELIVERY (lieux physiques de collecte/livraison, potentiellement distincts des parties contractuelles), SUBSEQUENTCARRIER (transporteur relais), SUBCONTRACTOR.

Chaque rôle porte un ensemble de permissions par défaut (consultation, changement de statut, modification de certains champs). Votre réponse à GET /v1/freightdocuments/{id} inclut toujours un champ ownPermissions, reflétant ce que vous êtes autorisé à faire sur ce document précis, recalculé à chaque appel.

Comptes "site" et sous-comptes

Un rôle peut être porté par un compte représentant une organisation (par exemple un entrepôt), qui délègue en interne à plusieurs employés (sous-comptes) — utile quand plusieurs personnes peuvent légitimement agir pour un même rôle selon qui est de service, sans qu'il soit nécessaire de désigner une personne précise à l'avance.

Délégation vers un tiers externe

Un rôle peut aussi être délégué vers une autre organisation — le cas typique étant la sous-traitance de transport. Voir Sous-traitance avec TMS et sans TMS pour le détail des mécanismes.