Commencer
Où commencer ? Lisez-moi d'abord !
Avant de commencer à travailler sur cette API, vous devez lire les sections suivantes si vous ne les avez pas déjà consultées :
- Informations techniques pour des informations techniques générales sur l'API et les environnements.
- Authentification et informations d’identification pour des détails sur l'authentification et les identifiants.
Les types de transactions
Il existe trois types de transactions effectuées par un concessionnaire :
- Pièces: Ventes de pièces, accessoires et vêtements (PA&A) à un client.
- Travaux: Ordres de réparation pour la réparation et l'entretien des véhicules.
- Unités: Ventes d'un véhicule à un client.
Les trois types de transactions sont envoyés dans le Transactions ressource et de nombreuses transactions peuvent être envoyées dans le même appel.
Le concessionnaire doit consentir au partage de données avant que vous n'envoyiez la transaction du concessionnaire à BRP.
Référez-vous à la Partage de données section pour plus d'informations sur le partage de données.
Le payload de l'API des Transactions de Vente au Détail contient beaucoup d'informations. Parfois, votre DMS peut ne pas être en mesure de fournir les informations demandées.
C'est normal, et chaque cas sera discuté lors des activités de certification. Si votre DMS a des limitations techniques qui empêchent l'envoi de certaines informations, les exceptions seront documentées et convenues.
Les Scénarios
Lorsqu'un client entre dans une concession, de nombreux scénarios sont possibles. Voici quelques exemples :
- Le client achète un nouveau casque Ski-Doo (Pièces).
- Le client amène son VTT pour maintenance (Pièces et Travaux).
- Le client amène son ancien See-Doo en échange de l'achat d'un nouveau (Unités).
- Le client amène son Side-by-side pour réparation et pour ajouter un treuil (Pièces et Travaux).
- Le client entre pour acheter un nouveau Ricker avec des accessoires et un casque (Pièces, Unités et Travaux).
Ces scénarios créent différentes transactions, fournissant des informations précieuses sur le comportement des clients, les tendances du marché, l'efficacité des promotions et la fidélité à la marque.
Les informations sont utiles pour BRP afin de comprendre le marché et d'adapter les promotions, programmes et stratégies pour aider les concessionnaires à améliorer leur activité.
C'est pourquoi l'API des Transactions de Vente au Détail est très importante pour les groupes d'affaires de BRP.
La structure du payload de l'API des Transactions de Vente au Détail permet d'envoyer de nombreuses transactions client, et chaque transaction client peut utiliser un, deux ou trois types de transaction types.
En utilisant les scénarios ci-dessus, votre DMS enverra les charges utiles suivantes :
Le client achète un nouveau casque Ski-Doo.
- La charge utile contient une Pièces transaction.
Le client amène son VTT pour maintenance.
- La charge utile contient un Travaux pour les réparations et un OTC pour les pièces.
Le client amène son ancien See-Doo en échange de l'achat d'un nouveau.
- La charge utile contient une Unités transaction.
Le client amène son Side-by-side pour réparation et pour ajouter un treuil.
- La charge utile contient un Travaux pour les réparations et un Pièces pour les pièces.
Le client entre pour acheter un nouveau Ryker avec des accessoires et un casque, la charge utile contient.
- Un Travaux pour l'installation des accessoires
- Un Pièces pour le casque et les accessoires.
- Un Unités pour la vente de l'unité.
Un payload pour les envoyer tous
Toutes ces transactions pourraient être envoyées dans une charge utile puisque l'API reçoit un tableau de transactions, et chaque transaction a les trois types.
Il y a un objet d'en-tête global pour chaque transaction, et les objets Parts, Units et Repairs sont remplis au besoin.
Dans le contexte de l'API des Transactions de Vente au Détail, une transaction dans la charge utile correspond généralement à une facture dans votre DMS.
Lorsque vous voyez "transaction" dans la documentation restante, vous pouvez penser à une "facture".
L'image ci-dessous montre une charge utile pour les 5 transactions (ou factures) décrites dans les scénarios.
La transaction ci-dessous est un exemple du scénario 5, dans lequel le client achète un nouveau Ski-Doo Summit avec un porte-vélos et un nouveau costume et fait installer le porte-vélos par le concessionnaire.
Une charge utile peut contenir plusieurs transactions si elles sont toutes pour le même concessionnaire!
Dans la charge utile, les différents types de transactions sont mappés comme suit :
- Pièces : transactions.parts
- Travaux : transactions.jobs
- Unités : transactions.units