Quoi de neuf ?

Dans l’API d’authentification des concessionnaires, ajout d’un mode de simulation disponible dans les environnements QA. Mise à jour de l’étape 1 pour utiliser un appel API au lieu de créer manuellement l’URL pour ouvrir la page de connexion BOSSWeb.

Dans le journal d’activité CRM, clarification du mappage des statuts des opportunités de vente vers le statut CRM interne.

La documentation de l’API du journal d’activité CRM a été créée et retirée de la documentation de l’API d’information DSP. Avoir la fonction du journal d’activité CRM dans la documentation de l’API d’information DSP portait à confusion.

Mise à jour de la section « Quoi de neuf ? » pour retirer l’API des opportunités de vente et ajouter l’API d’inventaire des unités des concessionnaires.

Dans la section Catalogue API, ajout de la liste des API utilisables par un CRM.

Dans l’API d’information DSP, finalisation du payload du journal d’activité CRM.

Dans l’API des opportunités de vente, finalisation du payload et des tests de certification.

Dans l’API des concessionnaires, suppression de la méthode d’expédition S0 Standard Ground.

Dans l’API des commandes de pièces, suppression de la méthode d’expédition S0 Standard Ground.

Dans l’API d’information DSP, ajout du service du journal d’activité CRM.

Dans l’API des pièces, mise à jour des numéros de pièces à utiliser pour certains tests.

Finalisation de la documentation pour la nouvelle API des opportunités de vente.

Dans l’API des pièces, ajout de plus d’informations sur les pièces de kit et les pièces BOM de vente. Amélioration également de la documentation sur les successions et de l’utilisation de la date valid_from.

Dans l’API d’inventaire des pièces, ajout d’une description des codes d’état de disponibilité.

Dans l’API des transactions de vente au détail, ajout de la liste et de la description des cas de test effectués durant les phases de test et de pilote concessionnaire.

Dans l’API des unités, l’objet remorque pour les produits Switch a été ajouté à la réponse. L’objet remorque inclut la description et les prix de la remorque. Les prix de la remorque sont ajoutés aux prix du Switch.

Dans l’API des factures, ajout du paramètre de requête delivery_nos pour récupérer les factures à l’aide d’un ou plusieurs numéros de livraison. Correction également du champ supercharge_value, qui incluait parfois le champ handling_fee_value.

Dans l’API de commande de pièces, ajout de la mention qu’une commande de pièces ne peut pas être modifiée une fois créée.

Dans l’API des transactions de vente au détail, ajout de plus d’informations sur la manière de gérer les travaux sous garantie. Ajout également d’informations sur les numéros de transaction.

Dans l’API Trail Balance, les points de terminaison pour l’authentification et pour l’envoi de données ont changé. Le fournisseur, Jackson Dawson, a remplacé "BRP RISE" par "TrueTrack".

Dans l’API Units, correction de la description des codes d’état des ventes U8 et UI. Correction également du problème qui faisait que certaines données étaient manquantes.

Dans l’API Units, ajout des champs package_label et model_description.

Dans l’API Dealer Parts Inventory, ajout d’une limitation indiquant qu’un numéro de pièce contenant un '-' ne peut pas être utilisé pour appeler le service Find Part (Part Locator).

Dans l’API Dealer Authentication, correction des charges utiles de réponse.

Dans l’API Invoices, retrait de la propriété cost_value puisque la valeur n’est jamais correcte.

Dans l’API Parts, ajout de la propriété is_bom pour indiquer si un numéro de pièce est un kit (BOM).

Dans l’API Parts Order, la propriété du numéro de commande du concessionnaire accepte désormais seulement les lettres, chiffres et espaces. Les caractères spéciaux ne sont pas autorisés.

Dans l’API Parts Order, ajout du point de terminaison backorder pour récupérer les commandes contenant des pièces en rupture de stock.

Dans l’API Units, ajout de la marque dans la charge utile et dans les paramètres de requête.

Dans l'API d'authentification des concessionnaires, ajout d'informations sur le paramètre de requête "state" qui peut être utilisé pour envoyer des informations au callback.

Dans l'API des pièces, ajout du type de produit 80 pour les manuels. Précisé que le paramètre de requête "last change date" doit être au moins un jour avant la date actuelle.

Dans la réponse de commande de pièces, suppression de l'objet trackings puisqu'il est toujours vide.

Dans l'API des transactions de vente au détail, l'utilisation du champ additional_costs a été clarifiée. Précisé que les propriétés optionnelles du payload doivent être envoyées si elles sont disponibles dans votre DMS. La transaction doit inclure les coûts supplémentaires si le prix total client diffère du MSRP. Correction du calcul du taux de main-d'œuvre avec un exemple de coût fixe. Clarification du calcul de la taxe lorsque seule la valeur totale de la facture est connue.

L'API Units qui renvoie le catalogue des unités avec description, caractéristiques, prix et liens vers des images et des documents techniques.

L'API Units Order qui renvoie la liste des commandes d'unités pour un concessionnaire.

Dans la section Commande, Facture et Livraison, correction de l'exemple pour "Livraisons multiples à partir de plusieurs commandes". Modification des exemples pour la nouvelle API de commande de pièces sans l'objet tracking. Mise à jour de la section "Suivi de l'expédition" pour utiliser les informations de livraison provenant de l'API Deliveries.

Dans l’API Dealers, ajout du niveau de qualification des véhicules électriques (EV), des heures d’ouverture commerciales et de service, ainsi que des informations sur la zone de vente. Mise à jour des exigences pour indiquer que l’API Dealers peut être appelée au besoin pour récupérer les informations du concessionnaire, par exemple lors de l’ouverture de l’écran de commande de pièces.

Dans l’Inventaire des pièces du concessionnaire, clarification de l’exigence fonctionnelle ID 1 pour indiquer que l’inventaire des pièces doit être envoyé automatiquement sans action manuelle du concessionnaire. Ajout de l’exigence fonctionnelle ID 8 pour indiquer que l’API doit être appelée avec l’inventaire complet des pièces du concessionnaire et non pièce par pièce.

Dans l’API Deliveries, suppression de l’heure dans les paramètres last_change_date_from et last_change_date_to. Indication que l’API Deliveries NE PEUT PAS être utilisée pour récupérer les livraisons d’unités. Ajout d’informations sur la conduite à tenir lorsque les quantités commandées et livrées sont à zéro.

Dans l’API DSP Information, ajout de documentation concernant le statut 404 Not Found.

Dans l’API Invoices, la valeur maximale pour le paramètre limit est de 200. Ajout des paramètres invoice_type et invoice_types à l’endpoint Get Invoices. Suppression de l’heure dans les paramètres invoice_date_from et invoice_date_to.

Dans l’API Parts, modification des exemples pour utiliser la version V4. Comme demandé par de nombreux concessionnaires, ajout de l’objet units_of_measure qui contient toutes les mesures de la pièce, telles que le poids et la longueur. IMPORTANT : uniquement disponible dans la version V4. Ajout dans l’exigence fonctionnelle ID 1 qu’aucune action manuelle du concessionnaire n’est requise pour mettre à jour le catalogue des pièces. Ajout de l’exigence fonctionnelle obligatoire 7 pour afficher les mesures de la pièce au concessionnaire. Ajout d’une recommandation pour appeler l’API Parts mensuellement afin d’obtenir les changements des 30 derniers jours pour éviter de manquer des mises à jour. Ajout d’explications sur la différence entre la date de dernière mise à jour et la date de validité.

Dans l’API Parts Order, ajout du type de commande "expedited". Ajout du paramètre "summary" à l’endpoint Get Orders pour récupérer un résumé de la commande de pièces. Ajout de l’endpoint Get Order pour récupérer une commande de pièces basée sur le numéro de commande client. Ajout d’explications et d’exemples pour récupérer une commande de pièces en utilisant le paramètre "summary" afin d’éviter les expirations. Correction du type pour les champs de quantité dans les payloads de requête et de réponse : la quantité est un entier et non un nombre. Ajout de l’exigence fonctionnelle 18 (optionnelle) : le concessionnaire doit pouvoir récupérer une seule commande de pièces à l’aide du numéro de commande client. Ajout de l’exigence fonctionnelle 19 (optionnelle) : le concessionnaire doit pouvoir récupérer des résumés des commandes de pièces.

Dans l’API Promotions, ajout de la section "Comprendre les promotions" afin de fournir plus d’exemples sur les bulletins cumulables et davantage d’exemples d’écrans BOSSWeb.

Dans l’API Retail Transactions, clarification de l’exigence concernant la transmission des données : aucune action manuelle du concessionnaire ne doit être requise. Ajout d’informations supplémentaires sur les taxes pour les transactions de pièces et sur la manière de gérer les reprises dans la vente d’une unité. Modification du champ "rate" dans les coûts additionnels pour permettre une valeur négative.

In the section Order, Invoice, and Delivery: The Complete Story, added an example of parts receiving using the invoice as the entry point.

In the Parts Order API, added the section Order Status to explain the global order status vs the item status. Also clarified DSP Requirements 10 and 11.

In the "Authentication and Credentials" and "Application Authentication API", added that if you worked on the DMS Information or Sales Opportunity V2 APIs, you already have your Application Authentication credentials.

The section Start Here With Mandatory Reading! that provides important information on DCP and the BRP dealers.

Add the section Important: BRP Dealer Operation Standards and Certification that you have to read!

In the Certification Process and Getting Support sections, added information on making sure to use the DCP Certification and Support portal.

In the Parts Order API, added the status on_hold in the header_statuses field of the response. Simplified the delay between calls to the Check service. Added information on the dealer authentication token that must match the dealer number. Also added information and requirements (requirement 17) on displaying the shipping_lines field instead of the ordered_lines field.

In the Retail Transactions API pages, removed mention of V5, the API is V3/V4. Clarified that additional costs that are not included in the total customer price must bot be included in the payload.

In the Warranty Claim API, added missing description for the work_order field.

At the start of each API Catalog section, add the section "Where to Start? Read Me First!" to list the general sections that must be read before started developmen tof an API.

In the Certification Process section, added that the Jira certification ticket must be created only when you start work on an API. Do not use the DCP Jira as a backlog of the work to be done.

In the Trial Balance API, change the field format for the amounts to ±99999999.99 (one less number) since the maximum amounts supported is +/- 99,999,999.99$. Also added that the account nume rand description can't be empty.

In the Technical Information page, in the Error Handling Overview, added information for the status 400 handling: do not send back the payload until the error is corrected.

In the Parts API, clarified the requirements to indicate that the complete parts catalogue must be loaded in the DMS and made available to the dealer.

In the Retail Transactions API, indicates that the total customer cost includes all the additional costs. Also, must use a new UUID if the payload is resent after an error and added information on some error 400. Add information on how the payload exceptions will be managed if a DMS can't send all the requested information.

The Trial Balance API documentation.

In the Unit Warranty Coverage, remove the coverage_status field since the value is always "active".

In the Certification Process, added a warning to not disable the email notification in your Jira account! Added information on how to change a certification ticket state.

In the Deliveries API, the customer_po_no property has been renamed to dealer_po_no to be aligned with the other APIs. Also returns a status 400 if the dealer number is invalid. Added an optional requirement to get the list of deliveries daily.

In the Parts Order API, added information that the sales_order_no property is empty in the Validate response and the Check response for a Validate request. The response returned by the Check service doesn't contain the list of partners. Added information that a timeout can occur with less than 25 items.

In the Parts Order API, added a requirement on the BRP-specific information to be displayed.

The Invoices API now returns a status 400 if the dealer number is invalid.

In the Retail Transactions API, added tests in the DSP Requirements section to send production data to the test environment. To help the transition between the V2 and V4 backend processing, added the requirement to keep the V2 API alive until asked by BRP to shut it down. Add tests to compare invoices in the DMS versus the received data.

In the Retail Transactions API, the transactions.jobs.time_cards.labour_rate property is now optional. Added information on add to handle fix price jobs. The property transactions.units.additional_costs is now mandatory.

In the Parts Inventory API, updated the examples and the parts used for the tests.

The Promotions API used to retrieve unit promotions.

The Unit Warranty Coverage API allows the dealer to retrieve a unit warranty coverage status.

In the Welcome section, removed the notion of V5 APIs. V3 APIs are for International and V4 APIs are for North America.

In the Technical Information section, updated the string information in the Response Payload Format section: if the information is not available for a string, an empty string is returned ("") and NOT as "NA".

In the Certification Process section, the description of the DCP JIRA used to request certification activities was added.

In the Getting Support section, the description of the DCP JIRA used to request support and ask questions was added.

In the Certification Process, added precisions on the quality assurance and dealer pilot phases: automation must be active and production level code must be used.

In the API Catalogue, aligned all the error message payloads to the standard described in the Technical Information section.

In the Campaigns API, added a requirement that a message must be shown to the user when the unit has no active campaign.

In the Dealer Parts Inventory API, section Dealer Parts Inventory Payload Size, information on the 30,000 items payload limit and the related requirements and tests. Also clarified when to send the dealer's parts inventory data updates every day, even if the dealer is closed.

The Delivery API is now available to retrieve unit and PA&A delivery documents for a dealer.

In the DSP Information API, added requirement for dealer management.

The Invoices API is now available to retrieve unit and PA&A invoices for a dealer.

In the Parts API, added information on when to call to update the catalogue. Clarified the requirement that the daily update must be automated. Added information on the "in package" quantity. Added information on prices when a part is obsolete. Added requirement to find a parts order using a delivery number or an invoice numner.

In the Parts Inventory API, corrected the JSON example to have the prices as number and not string.

In the Parts Order API, add the missing language table. Add the Dealer-Number header parameter for the Check Order call. Add information on the Check service that can be used after a Validate and that the validation must be done for all orders, even those with more than 30 items. Also added requirements to retrieve the parts orders using Get to have all of them in the DMS database.

In the Retail Transactions API, added missing job codes definition.

In the Unit Specifications API, added that the last_status_date property may be null if the date when the status was last changed is not available. Added that a dealer can ask for information on any VIN, even if they don't have it in their inventory.

new fields in the Unit Specifications API response.

the Parts Order API documentation is finished.

the Dealer Authentication information and API to add information on the redirect URL.

information on the paging mechanism used by some APIs.

the Warranty API documentation.

the Parts Inventory API documentation is finished.

the Retail Transactions API document is finished.

the Dealer Parts Inventory API requirements.

the list of international shipping methods.

the name mapping between the DCP APIs V2 and V3/V4/V5 on the API Catalogue page.

section "What Changed From V2" for all APIs that are changed from the DCP APIs V2.

section "What's Coming?" on the Welcome page to list the upcoming DCP APIs.

in the section Data Sharing a precision on the data sharing consent.

in many API sections that all the number fields with decimals use the dot(.) as the decimal separator. The coma (,) is NOT supported as a decimal separator.

in the Parts API documentation: . A part may be in more than one supersession chain. . Added the sales organization and currencies for V4. . Added validation tests for an invalid part number, a part with missing prices, a vintage part, and an obsolete part.

Section "Naviguer sur le site"

API d'informations DSP : ajout d'une clarification pour n'envoyer que les concessionnaires PowerSports. Mise à jour des exigences et des tests de validation.

Documentation de l'API Campagnes.

Documentation de l'API Articles.

Documentation de l'API Transactions de détail non terminée.

Documentation de l'API Commande de pièces non terminée.

Les API Opportunité de vente, Commande automatique et Réclamation de garantie ne sont pas encore documentées.

Première version du portail DCP.