Catégories: Guide complet

Cet article explique ce que sont les Catégories, leur rôle, et comment elles peuvent aider différents utilisateurs sur Urbantz.

Contenu:

• Que sont les Catégories ?
• Configuration
• Affichage et utilisation
• Cas d’usage fréquents
• Référence API
• Dépannage
• Bonnes pratiques
• Intégration avec d’autres fonctionnalités

Que sont les Catégories ?

Les Catégories sont des étiquettes attribuées aux tâches dans Urbantz. Elles servent de propriétés structurées pour transmettre des informations importantes sur la livraison. Elles agissent comme des tags qui aident les livreurs, les dispatcheurs et les destinataires à comprendre les exigences ou caractéristiques spécifiques d’une tâche.

Configuration

Création de Catégories

• Allez dans Plateforme > Général > Catégories
• Ajoutez un nom et une description
• Sélectionnez une icône pour représenter visuellement la catégorie

Propriétés d’une Catégorie

• Nom : identifiant utilisé dans les appels API et affiché aux utilisateurs
• Description : contexte additionnel concernant la catégorie
• Icône : représentation visuelle affichée dans l’application mobile

Affichage et utilisation

Application mobile

Les catégories apparaissent sous forme d’icônes ou de texte lorsque les livreurs ouvrent une tâche

Permettent une identification visuelle immédiate des exigences spéciales

Page de suivi

Peut être configurée pour afficher des options de service supplémentaires

Interface plateforme

Utilisées pour le filtrage et la recherche de tâches

Cas d’usage fréquents

Exigences de livraison :

• Articles fragiles nécessitant une manipulation spéciale
• Articles lourds nécessitant plusieurs personnes
• Services de montage
• Demandes de retrait d’emballage

Classification client :

• Clients VIP nécessitant une attention particulière
• Préférences de livraison sans contact

Besoins opérationnels :

• Gestion d’actifs (laisser la cage vs. déchargement) Retours requis

Référence API

Structure de données

Les catégories sont stockées sous deux formats :

categories : tableau de noms de catégories (recommandé) 

categoriesDetails : tableau d’objets contenant le nom, la description et l’icône

Dépannage

Problèmes fréquents

Erreurs d’annonce de tâche :

• Vérifiez que la catégorie existe bien sur la plateforme
• Vérifiez l’orthographe et la casse des noms de catégorie
• Vérifiez le format du payload API

Catégories non affichées :

• Confirmez qu’une icône est bien assignée
• Vérifiez la compatibilité avec la version de l’application mobile
• Vérifiez que la tâche est bien assignée au livreur.

Bonnes pratiques

Convention de nommage : utilisez des noms clairs et descriptifs. Attention : les noms sont sensibles à la casse ! 

Choix des icônes : privilégiez des représentations visuelles intuitives 

Documentation : documentez en interne les significations des catégories et renseignez leur description 

Tests : validez les catégories dans vos tests avant de les utiliser en production 

Formation : assurez-vous que les livreurs comprennent les icônes et les significations des catégories

Intégration avec d’autres fonctionnalités

Les Catégories fonctionnent de manière fluide avec :

Scripts conditionnels : filtrer les tâches selon la présence d’une catégorie 

Page de suivi : afficher comme options de service 

Application mobile : indicateurs visuels pour les livreurs 

Webhooks : inclure les informations de catégorie dans les payloads d’événements 

Reporting : filtrer et analyser les tâches par catégorie

Les Catégories offrent un moyen puissant de structurer et de transmettre les exigences de livraison tout au long du processus opérationnel, de l’annonce initiale de la tâche à la livraison finale.