# Intégration UPS

> Réservez des envois UPS à partir de vos envois avec étiquettes, numéros de suivi et factures commerciales — et suivez tout numéro de suivi UPS, les livraisons clôturant les arrêts.

**Category:** Transporteurs colis et express

## Qu’est-ce que UPS ?

UPS (United Parcel Service) est l’un des plus grands groupes de livraison de colis au monde, avec des services terrestres, express aériens et internationaux. Les logiciels se connectent via les API UPS sur developer.ups.com : Transportial utilise la Shipping API pour réserver et annuler les expéditions et la Tracking API pour les suivre.

## Ce qui est synchronisé entre UPS et Transportial

- **Envois → expéditions UPS** (Vers UPS): Lorsqu’un trajet sous-traité dans le cadre d’un contrat de capacité qui utilise l’intégration UPS est confirmé, chaque envoi est réservé comme expédition UPS sur votre numéro d’expéditeur. Chaque colis des marchandises devient un package UPS avec son poids et ses dimensions, et le numéro d’envoi sert de référence.
- **Étiquettes et numéros de suivi** (Vers Transportial): Une étiquette par colis est enregistrée sur l’envoi — en PDF 4×6 pouces, ou en ZPL pour les imprimantes thermiques — avec les numéros de suivi de l’expédition.
- **Facture commerciale pour les expéditions internationales** (Vers UPS): Les expéditions internationales portent des données douanières issues des marchandises : description, quantité, valeur, poids, code SH et origine. La facture commerciale d’UPS est enregistrée sur l’envoi, et avec l’incoterm DDP, droits et taxes sont facturés sur votre propre compte UPS.
- **Annulation avant enlèvement** (Vers UPS): L’annulation du trajet annule (void) ses expéditions UPS qui n’ont pas encore été enlevées ; les planificateurs peuvent aussi annuler une expédition isolée depuis l’envoi.
- **Suivi, ETA et clôture des arrêts** (Vers Transportial): Statut, activité, livraison prévue et nom du signataire reviennent sur l’envoi. Le premier scan d’enlèvement clôture l’arrêt de chargement et la livraison clôture l’arrêt de déchargement.
- **Numéros UPS réservés ailleurs** (Vers Transportial): Ajoutez n’importe quel numéro de suivi UPS à un envoi — par exemple celui d’une expédition créée dans le portail UPS — et Transportial le suit de la même façon.

## Comment connecter UPS

1. Les transporteurs de colis s’activent par plateforme : demandez-nous de les activer pour votre compte Transportial.
2. Créez sur le UPS Developer Portal (developer.ups.com) une app avec les API Shipping et Tracking, liée à votre compte UPS, et notez son client ID et son client secret.
3. Ajoutez l’intégration UPS dans Transportial : client ID et secret, votre numéro d’expéditeur UPS, le service par défaut et le format d’étiquette (PDF ou ZPL). Vous pouvez commencer dans l’environnement de test UPS.
4. Définissez cette intégration comme mode de communication d’un contrat de capacité. Les trajets sous-traités dans le cadre de ce contrat sont réservés chez UPS dès que vous les confirmez.

## Fréquence de synchronisation et limites

- Les expéditions sont réservées à la confirmation du trajet ; les envois ajoutés ensuite sont réservés lors de la mise à jour suivante du trajet, jamais deux fois avec la même intégration.
- Les numéros de suivi ouverts sont vérifiés toutes les 60 minutes par défaut — paramétrable par intégration — jusqu’à ce que l’expédition soit livrée, retournée ou annulée.
- La UPS Tracking API accepte un numéro par appel.
- UPS renvoie les étiquettes sous forme d’images ; Transportial convertit chacune en page PDF 4×6 pouces, ou enregistre le ZPL tel quel.
- Une expédition ne peut être annulée qu’avant son enlèvement par UPS.

## Cas d’usage type

Un grossiste de Venlo expédie des pièces détachées à des garages dans toute l’Europe et à quelques clients aux États-Unis. Les commandes palettes partent sur ses propres camions ; les colis sont planifiés sur un trajet dans le cadre d’un contrat de capacité UPS, avec UPS Standard par défaut et Express Saver pour les commandes urgentes. La confirmation du trajet réserve chaque envoi, et l’entrepôt imprime étiquettes et factures commerciales depuis l’envoi. Le scan d’enlèvement clôture l’arrêt de chargement, le service client voit la livraison prévue, et l’arrêt de livraison se clôture dès qu’UPS signale le colis livré.


## Questions fréquentes

### Quels services UPS puis-je réserver ?

UPS Standard, Express Saver, Express, Express Plus, Express 12:00, Expedited, Worldwide Economy, Worldwide Express Freight et Access Point Economy, ainsi que des services nationaux américains comme UPS Ground, 3 Day Select, 2nd Day Air et Next Day Air. Définissez un service par défaut sur l’intégration ou choisissez-le par envoi.

### Puis-je annuler une expédition UPS depuis Transportial ?

Oui, tant qu’UPS ne l’a pas enlevée. L’annulation du trajet annule ses expéditions UPS ouvertes, et un planificateur peut annuler une expédition isolée depuis l’envoi.

### Transportial planifie-t-il les enlèvements UPS ?

Non. Remettez les colis lors de votre enlèvement UPS habituel ou dans un UPS Access Point. L’intégration réserve, étiquette, annule et suit ; elle ne réserve pas d’enlèvements, ne compare pas les tarifs et ne crée pas d’étiquettes retour.

### Puis-je suivre des colis UPS que je n’ai pas réservés via Transportial ?

Oui. Ajoutez le numéro de suivi dans l’onglet Colis transporteur de l’envoi et Transportial le suit comme ses propres réservations, y compris la clôture des arrêts.


---
Canonical page: https://transportial.com/fr/integration/ups