Informations techniques

31 min

Caractéristiques

Type d'API	Type DSP	Version DCP	Complexité
Obtenez des données du BRP	DMS	V3 - International	Faible
Envoyer des données au BRP	GRC	V4 - Amérique du Nord	Un peu plus
Transaction avec BRP			Un peu plus

Authentification

L'API utilise Authentification du Revendeur et Authentification de l'Application.

Authentification de l'Application

Vous avez besoin d'un jeton d'accès valide avant d'appeler cette API, ou vous devez appeler le API d'authentification d'application pour en obtenir un.

Le jeton d'accès est valide pendant 30 minutes ! (1799 secondes)

Authentification du concessionnaire

Vous avez besoin d'un jeton d'accès valide avant d'appeler cette API, ou vous devez appeler le API d'authentification du concessionnaire pour en obtenir un.

Le access_token est valide pendant 2 heures.

Vous devez utiliser le refresh_token pour obtenir un access_token avant que le précédent n'expire.

❗❗ Le access_token obtenu par le biais de l'API d'authentification du concessionnaire doit être pour le concessionnaire dont le numéro de concessionnaire est utilisé dans le dealer_no champ de la charge utile ou de l'en-tête ❗❗

Voir la section Connexion du concessionnaire pour plus d'informations.

Référez-vous au Authentification du Revendeur et API d'authentification du concessionnaire sections pour plus d'informations.

URL de base

Test	https://qa-.cloud-api.brp.com/dcp/<v3 ou v4>
Production	https://cloud-api.brp.com/dcp/<v3 ou v4>

Ressource : Commande de Pièces

La Commande de Pièces ressource est utilisée lors de l'appel de l'API pour valider, vérifier et créer une commande.

Représentation JSON

{
  "pac_order_id": "62e9969d-ee6b-44af-a70f-acc3400df20c",
  "dealer_po_no": "PO0001234",
  "dealer_no": "0000697938",
  "shipping_carrier": {
    "shipping_condition": "30"
  },
  "partner": {
    "bill_to_no": "0000697938",
    "ship_to_no": "0000697938"
  },
  "header_texts": [
    {
      "code": "shipping_instruction",
      "descr": "Delivery at door 245"    }
  ],
  "items": [
    {
      "item_id": "460f166e-b0dd-4f74-8c61-4112a1ec2aab",
      "dealer_po_item_no": "A-0010",
      "dealer_product_code": "409209700-DMS",
      "product_code": "409209700",
      "order_qty": 1,
      "texts": [
        {
          "code": "memo_field",
          "descr": "For customer ABC"
        }
      ]
    },  
    {
      "item_id": "e3afa79f-2953-caf5-858d-842b2b523deb",
      "dealer_po_item_no": "A-0020",
      "dealer_product_code": "0460540-DMS",
      "product_code": "0460540",
      "order_qty": 1,
      "texts": [
        {
          "code": "memo_field",
          "descr": "For customer ABC"
        }
      ]
    }
  ]
}

Propriétés

Propriété	Type	Définition	Remarques
identifiant_de_commande_pac *	chaîne	Code qui identifie de manière unique le bon de commande, représenté par un GUID.	Longueur max : 36
date_de_creation*	date et heure	Date et heure auxquelles le bon de commande a été créé dans votre DMS, en ISO 8601 format.	Format : AAAA-MM-JJTHH:MM:SSZ
numéro_de_commande_du_concessionnaire*	chaîne	Le numéro de commande que le client utilise pour identifier de manière unique un bon de commande.	Longueur max : 35
numéro_de_concessionnaire*	chaîne	Code qui identifie de manière unique un concessionnaire. Il doit comporter 10 caractères. Si moins de 10 caractères, ajoutez '0' au début.	Longueur:10
transporteur*	objet	L'objet Transporteur d'expédition est utilisé pour sélectionner la méthode d'expédition
transporteur .condition_d'expédition*	chaîne	Code personnalisé BRP qui identifie de manière unique la méthode d'expédition par laquelle la commande est livrée. Une valeur de la Méthode d'expédition table.
partenaire	objet	Liste des partenaires utilisés dans la commande de vente client.
partenaire.facturer_à_no	chaîne	Code qui identifie de manière unique le concessionnaire qui est facturé pour la commande. Il doit comporter 10 caractères. Si moins de 10 caractères, ajoutez '0' au début.	Longueur:10
partenaire.livrer_à_no	chaîne	Code qui identifie de manière unique le concessionnaire qui recevra la commande. Il doit comporter 10 caractères. Si moins de 10 caractères, ajoutez '0' au début.	Longueur:10
textes_de_tête	liste d'objets	Liste des lignes de texte d'en-tête pour le bon de commande.
texte_en_tête.code	chaîne	Code identifiant le type de texte. Doit être instruction_d'expédition
texte_en_tête.descr	chaîne	Texte appliqué au code texte	Longueur maximale : 132
articles*	liste d'objets	La liste des articles commandés.
articles.commandés*	objet	La description de l'article.
articles.commandés_ligne .identifiant_article*	chaîne	Code qui identifie de manière unique le numéro d'article, représenté par un GUID.	Longueur max : 36
articles.commande_ligne .code_produit*	chaîne	Code qui identifie de manière unique un produit BRP.	Longueur maximale : 18
articles.commande_ligne .quantité_commande*	integer	La quantité totale de commande pour cet article.
articles.commande_ligne .numéro_article_dealer*	chaîne	Le numéro de ligne fourni par le demandeur est utilisé comme référence à l'article de la commande d'achat.	Max Length:6
articles.commandés_ligne .code_produit_concessionnaire	chaîne	Code produit client fourni par le demandeur et utilisé comme référence au code produit BRP.	Longueur maximale : 35
articles.ligne_commandée .textes	liste d'objets	Liste des lignes de texte pour le document de vente d'articles.
articles.commandés_ligne .textes.code	chaîne	Code identifiant le type de texte. Doit être champ_mémo.
articles.commandés_ligne .texts.descr	chaîne	Texte appliqué au code texte.	Longueur maximale : 120

* Ces champs sont obligatoires.

Tables de référence

Méthodes d'expédition - Amérique du Nord

Code V3	Code V4	Description	Utilisation
01	S1	Transport terrestre accéléré	Mise à niveau de premier niveau depuis le standard domestique : Service de livraison : Livraison standard par voie terrestre. Généralement, les colis d'expédition terrestre/LTL. Freight handling charges are billed to customers.
02	S2	Véhicule en panne	Fastest shipping available. This is commonly used when shipping delays are critical (broken vehicle scenarios): Shipping service: as fast as possible, often called Express (Purolator) or Next Day Air (UPS). Upgrade option from shipping method 01/S1. The freight handling charges are billed to customers.
03	S3	Vehicle breakdown Saturday	Identical to the broken down vehicle with the possibility of being received on a Saturday.

Méthodes d'expédition - International

Organisation de vente	Code V3	Description
6030 - Scandinavie	50	itella
6030 - Scandinavie	51	logistique_postale
6030 - Scandinavie	52	sol
6030 - Scandinavie	53	air
6030 - Scandinavie	54	sol
6030 - Scandinavie	55	air
6030 - Scandinavie	59	sol
6030 - Scandinavie	60	air
6050 - Europe (emea)	30	regular
6050 - Europe (emea)	33	rush
7080 - Asie-Pacifique (apac)	38	regular
7080 - Asie-Pacifique (apac)	39	rush
7080 - Asie-Pacifique (apac)	40	regular
7080 - Asie-Pacifique (apac)	82	action
7080 - Asie-Pacifique (apac)	90	action
8070 - Mexico	92	regular
8070 - Mexique	93	air
8070 - Mexique	94	rush
8075 - Brésil	63	cargo_aérien_bleu
8075 - Brésil	77	sedex_correios
8075 - Brésil	78	standard_routier

Ressource : Réponse de commande de pièces

Tous les appels API renvoient la ressource Réponse de commande de pièces, qui contient des informations sur la commande de pièces.

Représentation JSON

{
    "pac_order_id": "iRlurO0n7j{Wddjpe1FYwG",
    "sales_order_no": "1031037894",
    "creation_date": "2024-10-02T19:23:52Z",
    "dealer_po_no": "PO TC02 TCS1",
    "dealer_no": "0000690012",
    "order_type": "regular",
    "shipping_carrier": {
        "shipping_condition": "S0",
        "shipping_condition_descr": "Standard Ground"
    },
    "payment_terms": "F030",
    "payment_terms_descr": "Fin. (PA&A) - Due in 30 days",
    "partners": [],
    "pricings": [
        {
            "condition_type": "gross_amt",
            "total_amount": 34.48,
            "currency": "USD"
        },
        {
            "condition_type": "tax_amt",
            "total_amount": 3,
            "currency": "USD"
        },
        {
            "condition_type": "handling_fee",
            "total_amount": 20,
            "currency": "USD"
        },
        {
            "condition_type": "subtotal_amt",
            "total_amount": 54.48,
            "currency": "USD"
        }
    ],
    "header_texts": [
        {
            "code": "shipping_instruction",
            "descr": "Delivery at door 245"
        }
    ],
    "header_statuses": [
        {
            "type": "success",
            "code": "",
            "descr": "Your order has been created successfully"
        },
        {
            "type": "warning",
            "code": "",
            "descr": "Pay special attention to the status of certain part"
        },
        {
            "type": "warning",
            "code": "",
            "descr": "Your PAA order is less than 250.00$, handling fee of 20.00$ will be applied to the invoice."
        }
    ],
    "items": [
        {
            "ordered_line": {
                "item_id": "B1BBF8D580311EDFA09E7B73A01422E9",
                "item_no": "000100",
                "parent_item_no": "000000",
                "product_code": "715004887",
                "product_descr": "SUPPORT KIT",
                "order_qty": 1,
                "dealer_po_item_no": "A-0010",
                "dealer_product_code": "",
                "sales_uom": "PC",
                "min_order_qty": 1,
                "is_sales_bom": false,
                "product_line": "SSV",
                "product_type": "40",
                "texts": [
                    {
                        "code": "memo_field",
                        "descr": "For customer ABC"
                    }
                ]
            },
            "shipping_lines": [
                {
                    "item_no": "000101",
                    "parent_item_no": "000100",
                    "product_code": "715004887",
                    "product_descr": "SUPPORT KIT",
                    "ship_qty": 1,
                    "sales_uom": "PC",
                    "price_uom": "PC",
                    "package_uom": "PC",
                    "in_package": {
                        "qty": 1,
                        "uom": "PC"
                    },
                    "package_count": 1,
                    "msrp_unit_price": 57.99,
                    "wholesale_unit_price": 34.48,
                    "net_unit_price": 54.48,
                    "currency": "USD",
                    "is_substitute_product": false,
                    "substituted_product_code": null,
                    "product_line": "SSV",
                    "product_type": "40",
                    "plant": {
                        "name": "BRP - SAINT-JEAN-SUR-RICHELIEU",
                        "city": "ST-JEAN-SUR-RICHELIEU",
                        "state": "QC",
                        "country": "CA"
                    },
                    "pricings": [
                        {
                            "condition_type": "gross_amt",
                            "total_amount": 34.48,
                            "currency": "USD"
                        },
                        {
                            "condition_type": "tax_amt",
                            "total_amount": 3,
                            "currency": "USD"
                        },
                        {
                            "condition_type": "subtotal_amt",
                            "total_amount": 54.48,
                            "currency": "USD"
                        },
                        {
                            "condition_type": "handling_fee",
                            "total_amount": 20,
                            "currency": "USD"
                        }
                    ],
                    "deliveries": [
                        {
                            "status_code": "backorder",
                            "status_date": "2024-10-02T15:23:53Z",
                            "status_descr": "",
                            "qty": 1,
                            "availability_date": "2025-01-10",
                            "no": "",
                            "item_no": "",
                            "delivery_qty": 0,
                            "creation_date": "",
                            "carrier_name": "",
                            "split_delivery_no": "",
                            "split_delivery_item_no": "",
                             "billings": []
                        }
                    ],
                    "statuses": [
                        {
                            "type": "success",
                            "code": "",
                            "descr": "Your part has been created successfully"
                        }
                    ]
                }
            ]
        }
    ]
}

Propriétés

Tous les champs numériques avec des décimales utilisent le point (.) comme séparateur décimal. La virgule (,) n'est PAS prise en charge comme séparateur décimal.

Propriété	Type	Définition	Remarques
id_de_commande_pac	chaîne	Code qui identifie de manière unique le numéro de commande d'achat, représenté par un GUID. V3 : le GUID que vous avez envoyé pour valider et créer. V4 : un nouveau GUID attribué par SAP.	Longueur max : 36
numéro_de_commande	chaîne	V4 uniquement Code qui identifie de manière unique le document de vente. ❗❗ La propriété est vide dans la réponse renvoyée par le Valider service.	Longueur maximale:10
date_de_création	date et heure	Date et heure auxquelles le bon de commande a été créé.	Format : AAAA-MM-JJTHH:MM:SSZ
numéro_de_commande_du_concessionnaire	chaîne	Le numéro que le client utilise pour identifier de manière unique le bon de commande. Seules les lettres, les chiffres et les espaces sont autorisés.	Longueur max : 35 Seules les lettres, les chiffres et les espaces sont autorisés.
numéro_de_concessionnaire	chaîne	Code qui identifie de manière unique le concessionnaire créant le bon de commande.	Longueur:10
type_de_commande	chaîne	Une classification qui distingue entre différents types de bons de commande. L'un des : régulier commande_de_stock accéléré jante
transporteur	objet	L'objet Transporteur d'expédition est utilisé pour décrire comment l'expédition sera effectuée.
transporteur .condition_d'expédition	chaîne	Une des valeurs de la Méthodes d'expédition tableau ci-dessous.
transporteur .description_des_conditions_d'expédition	chaîne	Description de la condition d'expédition.
conditions_de_paiement	chaîne	Code pour indiquer le terme de paiement.
description_des_conditions_de_paiement †	chaîne	Description du terme de paiement.
partenaires*	Liste des objets	Liste des partenaires utilisés dans le bon de commande pour expédier et facturer la commande.
partenaires.type	chaîne	Un de : SP = Vendu à SH = Expédier à BP = Facturer à	Longueur max : 2
partenaires.non	chaîne	Numéro de client partenaire.	Longueur:10
nom des partenaires	chaîne	Nom du partenaire commercial.	Longueur max : 80
partenaires.adresse	objet	Adresse du partenaire.
partenaires.adresse.rue	chaîne	Adresse de la rue (1ère ligne)	Longueur max : 60
partenaires.adresse.ville	chaîne	Nom de la ville.	Longueur max : 40
partenaires.adresse.état	chaîne	Code qui identifie de manière unique une province/état/région dans un pays, en ISO 3166-2 (2ème partie) format.	Longueur max : 3
partenaires.adresse.pays	chaîne	Code qui identifie de manière unique un pays, dans ISO 3166-1 format.	Longueur max : 2
partenaires.adresse .code_postal	chaîne	Code postal du partenaire.	Longueur max : 10
tarifications	liste d'objets	Liste des différents montants liés à la commande d'achat.
type_de_tarification	Chaîne	Type de montant. Un des : montant_brut montant_fret montant_de_remise montant_impôt frais_de_consigne frais_de_traitement sous-total_montant montant_de_surcharge autre_frais
montant_total	nombre	Montant total appliqué au type de montant.	Précision:0,01
tarification.devise	chaîne	Une des devises de la Devise table ci-dessous, dans laquelle le montant est fourni.	Longueur max : 5
textes_de_en_tête	liste d'objets	Liste des textes d'en-tête liés au bon de commande.
texte_en_tête.code	chaîne	Code identifiant le type de texte. Doit être instruction_d'expédition.
texte_en_tête.descr	chaîne	Texte appliqué au code texte	Longueur max : 132
en-têtes_statuts	liste d'objets	Informations sur l'état liées à la commande.
en-tête_statuts.type	chaîne	Le type de statut indique la gravité du message pour le bon de commande. Un des : succès avertissement
en-tête_statuts.code	chaîne	Code d'état lié au document de vente. Un des : en_cours terminé en attente en attente
en-tête_statuts.descr †	chaîne	Texte de statut lié au code de statut.	Longueur max : 132
articles	liste d'objets	La liste des articles commandés.
articles.commandés_ligne	objet	Une description de ligne d'article.
articles.commandés_ligne .identifiant_article	chaîne	Code qui identifie de manière unique le numéro d'article, représenté par un GUID. V3 : le GUID que vous avez envoyé pour valider et créer. V4 : un nouveau GUID attribué par SAP.	Longueur max : 36
articles.commandés_ligne .numéro_de_commande	chaîne	V3 uniquement Le numéro qui identifie de manière unique le document de vente.	Longueur max : 10
articles.commandés_ligne .numéro_article	chaîne	Le numéro identifie de manière unique l'article dans le document de vente.	Longueur max : 6
🆕 articles.commandés_ligne .élément_parent_non	chaîne	V4 Seulement Le numéro identifie de manière unique l'article dans le document de vente qui est le parent de cet article.	Longueur max : 6
articles.commandés_ligne .code_produit	chaîne	Code qui identifie de manière unique un produit BRP.	Longueur max : 18
articles.commandés_ligne .description_produit †	chaîne	Description du produit.	Longueur max : 40
articles.commandés_ligne .quantité_commande	entier	La quantité totale de commande pour cet article.
articles.commandés_ligne .numéro_de_l'article_de_commande_du_concessionnaire	chaîne	La chaîne de numéro de ligne fournie par le demandeur est utilisée comme référence à l'article de commande d'achat.	Longueur max : 6
articles.commandés_ligne .code_produit_concessionnaire	chaîne	Code produit client fourni par le demandeur et utilisé comme référence au code produit BRP.	Longueur max : 35
articles.commandés_ligne .unité_de_vente	chaîne	Une des unités de mesure de vente de la Unités de Mesure table.	Longueur max : 3
articles.commandés_ligne .quantité_min_commande	entier	La quantité minimale de commande pour le produit, en unités de mesure de vente.
articles.commandés_ligne .est_bom_de_vente	Booléen	Indiquez si la pièce demandée est une nomenclature (BOM). Une pièce BOM contient de nombreuses sous-pièces.
articles.commandés_ligne .ligne_de_produit	Chaîne	Ligne de produits à laquelle ce produit est associé. L'une des valeurs de la Lignes de produits table.
articles.commandés_ligne .type_de_produit	chaîne	Une valeur de la Type de produit ci-dessous.
articles.commandés_ligne .textes	liste d'objets	Texte lié à l'élément de ligne.
articles.commandés_ligne .textes.code	chaîne	Code identifiant le type de texte. Doit être champ_mémo.
articles.commandés_ligne .texts.descr †	chaîne	Texte appliqué au code texte.	Longueur max : 120
lignes_de_livraison.des_articles	liste de objet	Lignes avec des informations d'expédition pour le concessionnaire.
lignes_de_livraison_des_articles .numéro_de_commande_de_vente	chaîne	Un numéro qui identifie de manière unique un document de vente.
lignes_de_livraison .num_article	chaîne	Le numéro identifie de manière unique l'article dans le document de vente.	Longueur max : 6
lignes_de_livraison .élément_parent_non	chaîne	V4 uniquement Le numéro identifie de manière unique l'article dans le document de vente qui est le parent de cet article.	Longueur max : 6
lignes_de_livraison .code_produit	chaîne	Code qui identifie de manière unique un produit BRP.	Longueur max : 18
lignes_de_livraison .description_produit †	chaîne	Description du produit.	Longueur max : 40
lignes_de_livraison .quantité_navire	entier	La quantité totale de commande pour cet article.
lignes_de_livraison .unité_de_vente	chaîne	Une des unités de mesure de vente de la Unités de mesure table.	Longueur max : 3
lignes_de_livraison .prix_uom	chaîne	Une des unités de mesure de vente de la Unités de mesure table.	Longueur max : 3
lignes_de_livraison .unité_de_mesure	chaîne	Unité de mesure dans laquelle le produit est emballé. Une des unités de mesure de vente de la Unités de mesure table.	Longueur maximale : 3
lignes_de_livraison.des_articles .dans_le_paquet	objet	Contenu du paquet de vente.
lignes_de_livraison .dans_le_paquet.qty	nombre	Nombre d'article(s) contenu(s) dans le paquet en fonction de l'unité de mesure dans le paquet	Précision : 1,000
lignes_de_livraison .dans_le_paquet.uom	chaîne	Unité de mesure pour l'article contenu dans le paquet. Une des unités de mesure de vente de la Unités de mesure table.	Longueur max : 3
lignes_de_livraison .nombre_de_colis	nombre	Nombre de colis expédiés	Précision:1
lignes_de_livraison .prix_unitaire_srp	nombre	Le prix de vente conseillé par le fabricant.	Précision:0.01
lignes_de_livraison .prix_unitaire_de_gros	nombre	Prix unitaire de gros.	Précision:0.01
lignes_de_livraison .net_prix_unitaire	Nombre	Prix net de l'article.	Précision:0.01
lignes_de_livraison .devise	Chaîne	La monnaie utilisée pour exprimer le montant sur l'article. Une valeur de la Monnaie table.	Longueur max : 5
lignes_de_livraison .est_produit_substitut	Booléen	Indiquez si la pièce remplace une autre pièce
lignes_de_livraison .code_de_produit_substitué	Booléen	Code de produit substitué.	Longueur max : 18
lignes_de_livraison .ligne_de_produit	Chaîne	Ligne de produit à laquelle ce produit est associé. Une valeur de la Ligne de produit table.
lignes_de_livraison .type_de_produit	chaîne	Une valeur du Ptype de produit tableau.
lignes d'expédition des articles. plante*	objet	Informations sur l'expédition des plantes
Lignes d'expédition des articles. nom.plante	Chaîne	Nom de la plante.	Longueur max : 40
Lignes d'expédition des articles. plante.ville	Chaîne	Adresse de l'usine / Ville.	Longueur max : 35
Lignes d'expédition des articles. état.plante	Chaîne	Adresse de l'usine / État.	Longueur max : 6
Lignes d'expédition des articles. plante.pays	Chaîne	Adresse de l'usine / Comté.	Longueur max : 2
lignes_de_livraison.des_articles .tarifications	liste d'objets	Liste des différents montants liés au document de vente d'articles.
articles.lignes_de_livraison .tarification.type_de_condition	Chaîne	Type de montant. Un des : montant_brut montant_fret montant_de_remise montant_de_surcharge montant_impôt frais_de_consigne frais_de_traitement montant_soustrait autre_frais
lignes_de_livraison .tarification.montant_total	Nombre	Le montant total est basé sur la quantité de commande appliquée au type de montant.	Précision:0.01
lignes_de_livraison .tarification.devise	Chaîne	Une valeur de la Monnaie table.	Longueur max : 5
lignes_de_livraison.des_articles .livraisons	liste d'objets	Informations détaillées sur la progression de la livraison par quantité dans le temps.
lignes_de_livraison .livraisons .code_statut	Chaîne	Code d'état pour indiquer l'état de la quantité. Un des : attribué non_attribué bloqué commande en attente rejeté expédié
lignes_de_livraison .livraisons.date_statut	date et heure	Date et heure pour indiquer quand le statut a été attribué.	Format : AAAA-MM-JJTHH:MM:SSZ
lignes_de_livraison .livraisons.description_statut †	chaîne	Informations supplémentaires liées au code d'état pour être plus précis lorsque cela est nécessaire.	Longueur maximale : 50
lignes_de_livraison .livraisons.qté	nombre	Quantité liée au code d'état.	Précision:1.00
lignes_de_livraison.des_articles .livraisons .date_de_disponibilité	date	Date de disponibilité de l'article.	Format : AAAA-MM-JJ
lignes_de_livraison .livraisons.non	chaîne	Le numéro qui identifie de manière unique la livraison.	Longueur max : 10
lignes_de_livraison .livraisons.num_article	chaîne	Le numéro qui identifie de manière unique l'article dans une livraison.	Longueur max : 6
lignes_de_livraison .livraisons.quantité_de_livraison	entier	La quantité de l'article à livrer.
lignes_de_livraison .livraisons.date_de_création	date et heure	Date de création pour la livraison.	Format : AAAA-MM-JJTHH:MM:SSZ
lignes_de_livraison.des_articles .livraisons.nom_du_transporteur	chaîne	Nom du transporteur pour la livraison.	Longueur:40
lignes_de_livraison .livraisons.split_delivery_no	chaîne	Le numéro qui identifie de manière unique la livraison fractionnée. Référez-vous aux Commande, Facture et Livraison : L'Histoire Complète pages pour une explication des livraisons fractionnées.	Longueur : 10
lignes_de_livraison .livraisons. article_de_livraison_divisé_no	chaîne	Le numéro qui identifie de manière unique l'article dans une livraison fractionnée.	Longueur : 6
lignes_de_livraison.des_articles .livraisons.facturations	Liste des objets	Lien du document de facturation vers la livraison
lignes_de_livraison .livraisons.facturations .numéro_de_facturation	chaîne	Le numéro identifie de manière unique le document de facturation.	Longueur max : 10
lignes_de_livraison .livraisons.facturations .article_de_facturation_no	chaîne	Le numéro identifie de manière unique l'article dans le document de facturation.	Longueur maximale : 6
lignes_de_livraison .livraisons.facturations .date_de_creation_de_facturation	date et heure	Date de création du document de facturation.	Format : AAAA-MM-JJTHH:MM:SSZ
lignes_de_livraison .livraisons.facturations .quantité_de_facturation	entier	La quantité de l'article pour le document de facturation.
lignes_de_livraison.des_articles .livraisons.facturations .est_annulé	booléen	Indiquez si le document de facturation a été annulé.
lignes_de_livraison .livraisons.facturations .annulation_de_facturation_non	chaîne	Le document de facturation a été créé pour annuler le document de facturation initial.	Longueur max : 10
statuts.des.objets	liste d'objets	Informations sur l'état liées au document de vente d'articles.
État des articles .type	chaîne	Le type de statut indique la gravité du message pour le document de vente de l'article. Un de : succès avertissement
statuts.des.objets .code	chaîne	Code d'état lié au document de vente d'articles. Un des : en_cours terminé
éléments.statuts.descr †	chaîne	Texte de statut lié au code de statut.	Longueur max : 132

🛑 Différences entre V3 et V4.

Tables de référence

Monnaie

Organisation de vente	Currency	Version 3	Version 4
1010	CAD		X
3020	USD		X
6030	EUR	X
6030	NOK	X
6050	SEK	X
6050	EUR	X
6050	GBP	X
8070	MXN	X
8075	BRL	X
7080	AUD	X
7080	NZD	X

Lignes de produits

Clé	Value	Marque
2WV	Véhicules à deux roues	Can-Am Sur Route
3WV	Three-wheeled vehicles	Can-Am Sur Route
VTT	All-terrain vehicles	Can-Am Tout Terrain
OE	Outboard motors	Sea-Doo
PTN	Pontoon boats	Sea-Doo
PWC	Water recreational vehicles	Sea-Doo
SNO	Snowmobiles	Ski-Doo
SSV	Vehicles side by side	Can-Am Tout Terrain

Types de produits

Clé	Valeur
10	Vehicle
20	Engine
30	Parts
40	Accessoires
50	Clothing
60	Licences et jeu
80	Manuels
90	Trailer
100	Reconstruit
110	Oil and chemical products
NA	When no match above (Undefined)

Méthodes d'expédition - Amérique du Nord

Code V3	Code V4	Description	Utilisation
01	S1	Transport terrestre accéléré	Mise à niveau de premier niveau depuis le standard domestique : Service de livraison : Livraison standard par voie terrestre. Généralement, les colis d'expédition terrestre/LTL. Freight handling charges are billed to customers.
02	S2	Véhicule en panne	Fastest shipping available. This is commonly used when shipping delays are critical (broken vehicle scenarios): Shipping service: as fast as possible, often called Express (Purolator) or Next Day Air (UPS). Upgrade option from shipping method 01/S1. The freight handling charges are billed to customers.
03	S3	Vehicle breakdown Saturday	Identical to the broken down vehicle with the possibility of being received on a Saturday.

Méthodes d'expédition - International

Organisation de vente	Code V3	Description
6030 - Scandinavie	50	itella
6030 - Scandinavie	51	logistique_postale
6030 - Scandinavie	52	sol
6030 - Scandinavie	53	air
6030 - Scandinavie	54	sol
6030 - Scandinavie	55	air
6030 - Scandinavie	59	sol
6030 - Scandinavie	60	air
6050 - Europe (emea)	30	regular
6050 - Europe (emea)	33	rush
7080 - Asie-Pacifique (apac)	38	regular
7080 - Asie-Pacifique (apac)	39	rush
7080 - Asie-Pacifique (apac)	40	regular
7080 - Asie-Pacifique (apac)	82	action
7080 - Asie-Pacifique (apac)	90	action
8070 - Mexico	92	regular
8070 - Mexique	93	air
8070 - Mexique	94	rush
8075 - Brésil	63	cargo_aérien_bleu
8075 - Brésil	77	sedex_correios
8075 - Brésil	78	standard_routier

Unité de Mesures

Code	Description	Dimension
"	Pouce	Longueur
BOÎTE	Boîte	Quantité
BR	Fût	Quantité
BT	Bouteille	Quantité
BU	Seau	Quantité
PEUT	Conteneur	Quantité
CC	Centimètre cube	Volume
MCC	Décimètre cube	Volume
CG	Centigrammes	Poids
CL	Centilitres	Volume
CM	Centimètre	Longueur
CS	Caisse	Quantité
FT	Pieds	Longueur
G	Gram	Poids
GA	Gallons	Volume
GU	Gallon américain	Volume
H	Heure	Temps
KG	Kilogramme	Poids
L	Litre	Volume
LB	Livre	Poids
LT	Terrain	Quantité
M	Mètre	Longueur
M2	Mètre carré	Zone
MG	Milligramme	Poids
ML	Millilitre	Volume
MM	Millimètre	Longueur
OZ	Onces	Poids
P	Points	Quantité
PAC	Paquet	Quantité
PC	Pièce	Quantité
PR	Paire	Quantité
PT	Pintes	Volume
QT	Quarts	Volume
ROL	Rouler	Quantité
RÉGLER	Définir	Quantité
SF	Pieds carrés	Zone
SH	Feuilles	Quantité
SI	Pouce carré	Zone
SY	Mètre carré	Zone
TB	Tube	Quantité
YD	Cour	Longueur
HL	Hectolitre	Volume
M3	Mètre cube	Volume
P3	Pieds cubes	Volume
LM	Mètre linéaire	longueur
CM2	Centimètre carré	Surface
PO3	Pouce cube	Volume
DZ	Douzaine	Quantité

Ressource : Annulation de commande de pièces

La ressource d'annulation de commande de pièces est utilisée pour appeler le service d'annulation.

Représentation JSON

{
   "pac_order_id": "62e9969d-ee6b-44af-a70f-acc3400df20c",
   “dealer_no” : “0000691756”,
   "items": [
      {
         "item_id": "e3afa79f-2953-caf5-858d-842b2b523deb"
     }
   ]
}

Propriétés

Propriété	Type	Définition	Remarques
identifiant_de_commande_pac *	chaîne	Code qui identifie de manière unique le numéro de bon de commande, représenté par un GUID	Longueur max : 36
n°_du_concessionnaire*	Chaîne	Code qui identifie de manière unique un concessionnaire. Il doit comporter 10 caractères. S'il y a moins de 10 caractères, ajoutez '0' au début.	Longueurh:10
éléments *	liste d'objets	Structure qui contient les détails des articles liés au document de vente.
éléments.item_id *	chaîne	Code qui identifie de manière unique le numéro d'article, représenté par un GUID.	Longueur maximale : 36

* Ces champs sont obligatoires.

Ressource : Commande de pièces en attente

V4 uniquement

Le Obtenir les commandes en attente service renvoie le Ressource de commande en attente de pièces.

Représentation JSON

{
    "items": [
        {
            "sales_order_no": "1030895371",
            "dealer_po_no": "ORV ACC 2024 SSU 2",
            "order_type": "stocking_order",
            "creation_date": "2024-03-14T22:02:41Z",
            "items": [
                {
                    "item_no": "008300",
                    "product_code": "715006112",
                    "product_descr": "SEAT_HEATED KIT",
                    "product_type": "40",
                    "order_qty": 2,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": true,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "008301",
                    "product_code": "715006112",
                    "product_descr": "SEAT_HEATED KIT",
                    "product_type": "40",
                    "order_qty": 2,
                    "parent_item_no": "008300",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "",
                            "qty": 2,
                            "availability_date": "2025-01-01"
                        }
                    ]
                }
            ]
        },
        {
            "sales_order_no": "1030895667",
            "dealer_po_no": "ORV PARTS COM 2024 SSU 2",
            "order_type": "stocking_order",
            "creation_date": "2024-03-14T22:59:03Z",
            "items": [
                {
                    "item_no": "042200",
                    "product_code": "706001678",
                    "product_descr": "SWAY BAR",
                    "product_type": "30",
                    "order_qty": 1,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": true,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "042201",
                    "product_code": "706005447",
                    "product_descr": "BAR_STABILIZER",
                    "product_type": "30",
                    "order_qty": 1,
                    "parent_item_no": "042200",
                    "is_sales_bom": false,
                    "is_substituded_part": true,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "",
                            "qty": 1,
                            "availability_date": "2025-01-01"
                        }
                    ]
                },
                {
                    "item_no": "042800",
                    "product_code": "706003033",
                    "product_descr": "REAR SHOCK",
                    "product_type": "30",
                    "order_qty": 2,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": true,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "042801",
                    "product_code": "706003033",
                    "product_descr": "REAR SHOCK",
                    "product_type": "30",
                    "order_qty": 2,
                    "parent_item_no": "042800",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "Contact PAA Support",
                            "qty": 2,
                            "availability_date": null
                        }
                    ]
                },
                {
                    "item_no": "045600",
                    "product_code": "706202764",
                    "product_descr": "LINK STABILIZER BAR LH",
                    "product_type": "30",
                    "order_qty": 4,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": true,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "045601",
                    "product_code": "706202764",
                    "product_descr": "LINK STABILIZER BAR LH",
                    "product_type": "30",
                    "order_qty": 4,
                    "parent_item_no": "045600",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "",
                            "qty": 4,
                            "availability_date": "2025-01-01"
                        }
                    ]
                },
                {
                    "item_no": "049100",
                    "product_code": "707001348",
                    "product_descr": "SHIFTING CABLE",
                    "product_type": "30",
                    "order_qty": 2,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": true,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "049101",
                    "product_code": "707001348",
                    "product_descr": "SHIFTING CABLE",
                    "product_type": "30",
                    "order_qty": 2,
                    "parent_item_no": "049100",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "",
                            "qty": 2,
                            "availability_date": "2025-01-01"
                        }
                    ]
                },
                {
                    "item_no": "050200",
                    "product_code": "707003185",
                    "product_descr": "HAND LEVER_ACCELERATOR",
                    "product_type": "30",
                    "order_qty": 4,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "050202",
                    "product_code": "707003185",
                    "product_descr": "HAND LEVER_ACCELERATOR",
                    "product_type": "30",
                    "order_qty": 4,
                    "parent_item_no": "050200",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "",
                            "qty": 4,
                            "availability_date": "2025-01-01"
                        }
                    ]
                },
                {
                    "item_no": "051600",
                    "product_code": "707800264",
                    "product_descr": "AIR FILTER",
                    "product_type": "30",
                    "order_qty": 3,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": true,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "051601",
                    "product_code": "707800264",
                    "product_descr": "AIR FILTER",
                    "product_type": "30",
                    "order_qty": 3,
                    "parent_item_no": "051600",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "",
                            "qty": 3,
                            "availability_date": "2025-01-01"
                        }
                    ]
                },
                {
                    "item_no": "058400",
                    "product_code": "710006134",
                    "product_descr": "HANDLE SWITCH",
                    "product_type": "30",
                    "order_qty": 12,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "058403",
                    "product_code": "710006134",
                    "product_descr": "HANDLE SWITCH",
                    "product_type": "30",
                    "order_qty": 2,
                    "parent_item_no": "058400",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "",
                            "qty": 2,
                            "availability_date": "2025-01-01"
                        }
                    ]
                },
                {
                    "item_no": "061800",
                    "product_code": "715900499",
                    "product_descr": "YOKE",
                    "product_type": "30",
                    "order_qty": 8,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "061802",
                    "product_code": "715900499",
                    "product_descr": "YOKE",
                    "product_type": "30",
                    "order_qty": 2,
                    "parent_item_no": "061800",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "",
                            "qty": 2,
                            "availability_date": "2025-01-01"
                        }
                    ]
                },
                {
                    "item_no": "062600",
                    "product_code": "715900653",
                    "product_descr": "HALOGEN BULB H8 12V 35W BLUE",
                    "product_type": "30",
                    "order_qty": 6,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": true,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "062601",
                    "product_code": "715900653",
                    "product_descr": "HALOGEN BULB H8 12V 35W BLUE",
                    "product_type": "30",
                    "order_qty": 6,
                    "parent_item_no": "062600",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "",
                            "qty": 6,
                            "availability_date": "2025-01-01"
                        }
                    ]
                },
                {
                    "item_no": "065500",
                    "product_code": "709400439",
                    "product_descr": "BALL BEARING",
                    "product_type": "30",
                    "order_qty": 4,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": true,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "065501",
                    "product_code": "709400439",
                    "product_descr": "BALL BEARING",
                    "product_type": "30",
                    "order_qty": 4,
                    "parent_item_no": "065500",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "",
                            "qty": 4,
                            "availability_date": "2025-01-01"
                        }
                    ]
                }
            ]
        },
        {
            "sales_order_no": "1030900320",
            "dealer_po_no": "ODN030211",
            "order_type": "expedited",
            "creation_date": "2024-03-18T13:23:15Z",
            "items": [
                {
                    "item_no": "001300",
                    "product_code": "4546631290",
                    "product_descr": "SEA-DOO SIGNATURE T-SHIRT MEN XL",
                    "product_type": "50",
                    "order_qty": 1,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": true,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "001301",
                    "product_code": "4546631290",
                    "product_descr": "SEA-DOO SIGNATURE T-SHIRT MEN XL",
                    "product_type": "50",
                    "order_qty": 1,
                    "parent_item_no": "001300",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "Contact PAA Support",
                            "qty": 1,
                            "availability_date": null
                        }
                    ]
                }
            ]
        },
        {
            "sales_order_no": "1030900350",
            "dealer_po_no": "ODN030211",
            "order_type": "expedited",
            "creation_date": "2024-03-18T13:40:57Z",
            "items": [
                {
                    "item_no": "008100",
                    "product_code": "715007727",
                    "product_descr": "SMART LED CHASE LIGHT",
                    "product_type": "40",
                    "order_qty": 3,
                    "parent_item_no": "000000",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": true,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": []
                },
                {
                    "item_no": "008101",
                    "product_code": "715007727",
                    "product_descr": "SMART LED CHASE LIGHT",
                    "product_type": "40",
                    "order_qty": 3,
                    "parent_item_no": "008100",
                    "is_sales_bom": false,
                    "is_substituded_part": false,
                    "is_cancellable": false,
                    "bo_cancel_status": "",
                    "bo_cancel_message": "",
                    "item_texts": [],
                    "delivery_progress": [
                        {
                            "status_code": "backorder",
                            "status_descr": "Contact PAA Support",
                            "qty": 3,
                            "availability_date": null
                        }
                    ]
                }
            ]
        }
    ]
}

Propriétés

Propriété	Type	Définition	Remarques
numéro_de_commande_de_vente	chaîne	Le numéro qui identifie de manière unique le document de vente.	Longueur max : 10
numéro_de_commande_du_concessionnaire	chaîne	Le numéro que le concessionnaire utilise pour identifier de manière unique la commande de pièces.	Longueur max : 35
type_de_commande	chaîne	Une classification qui distingue entre différents types de documents de vente. L'un des : régulier commande_de_stock jante accéléré véhicule_bas promotion
date_de_création	chaîne	Date et heure auxquelles la commande de vente a été créée.	Format : AAAA-MM-JJTHH:MM:SSZ
articles	tableau d'objets	L'objet de détail de l'article est utilisé pour montrer les détails de chaque article lié à la commande de pièces.
articles.num_article	chaîne	Le numéro qui identifie de manière unique l'article dans le document de vente.	Longueur max:6
articles.code_produit	chaîne	Code qui identifie de manière unique un produit BRP.	Longueur max : 18
description du produit	chaîne	Description du produit.	Longueur max : 40
articles.type_de_produit	chaîne	Type de produit
articles.quantité_commande	nombre	La quantité totale commandée pour cet article.	Précision:1.00
numéro_de_l'article_parent	chaîne	L'élément parent si la pièce est incluse dans un kit.
articles.est_bom_de_vente	booléen	Indiquez si la pièce demandée est un kit (BOM).
articles.est_partie_substituée	booléen	Indiquez si une autre partie remplace la partie.
articles.est_annulable	booléen	Indique si vous êtes autorisé à annuler l'article.
articles.bo_annuler_statut	chaîne	Annuler le statut. Un des : en_cours erreur
articles.bo_annuler_message	chaîne	Message renvoyé s'il y a une erreur lors de l'annulation de la pièce.	Longueur max : 120
progrès de livraison des articles	Liste des objets	Informations détaillées sur la progression de la livraison par quantité.
éléments.progression_de_livraison .code_statut	Chaîne	Code d'état pour indiquer l'état de la quantité. Toujours commande en attente.
progrès de livraison des articles .description_de_statut	Chaîne	Informations supplémentaires liées au code d'état pour être plus précis lorsque cela est nécessaire.	Longueur maximale : 50
progrès_de_livraison_des_articles .qté	Numéro	Quantité liée au code d'état	Précision:1.00
progrès de livraison des articles .qté	Nombre	Quantité liée au code d'état	Précision:1.00
progrès de livraison des articles .date_de_disponibilité	date	Date de disponibilité de l'article.	Format : 2017-11-07
progrès_de_livraison.des_articles .description_de_statut†	Chaîne	Informations supplémentaires liées au code d'état pour être plus précis lorsque cela est nécessaire.	Longueur maximale : 50
éléments.texte_des_éléments	Liste des objets
éléments.texte_des_éléments .code_texte	Chaîne	Code identifiant le type de texte. Toujours champ_mémo.
éléments.texte_des_éléments .description_texte†	Chaîne	Texte appliqué au code texte.	Longueur maximale : 120

Limitations et Contraintes

Format de Nombre

Tous les champs numériques avec des décimales utilisent un point (.) comme séparateur décimal. La virgule (,) n'est PAS supportée comme séparateur décimal.

Nombre d'Articles et Délai d'Attente

Une commande peut contenir plus de 25 articles ; cependant, un délai d'attente se produira si la commande dépasse cette limite. La limitation est causée par le système backend prenant environ 2 secondes par article pour créer la commande. L'API elle-même a un délai d'attente de 55 secondes qui ne peut pas être changé dans le contexte de BRP.

Cela signifie que si la commande comprend plus de 25 lignes d'articles, l'API de commande de pièces renvoie un statut 504 Gateway Timeout.

Votre DMS doit gérer le délai d'attente, comme expliqué dans le Vérifier et délais d'attente section.

Le Valider service est un peu plus rapide et accepte des commandes allant jusqu'à 30 lignes d'articles.

🛑 Si vous appelez le Créer service avec la même charge utile de 30 lignes d'articles, vous recevrez un délai d'attente, que vous devez gérer. Voir la Vérifier et délais d'attente section.

❗❗ Un délai d'attente peut se produire même s'il y a moins de 25 articles dans le Créer demande ❗❗

Le délai d'attente est causé par le temps de traitement SAP, qui dépasse 55 secondes. Dans certaines situations, par exemple, si certaines pièces ont une longue chaîne de supersession, le traitement peut prendre plus de 55 secondes avec moins de 25 articles.

👉Votre DMS doit gérer les délais d'attente dans toutes les situations !

Valider et créer la taille de la charge utile

L'API de commande de pièces fonctionne sur APIGee, qui a une taille maximale de charge utile de 10 Mo.

Voir la section413 Entité de demande trop grande pour plus d'informations sur la gestion du code d'état 413.

Délai d'attente lors de l'appel pour obtenir une commande

L'API de commande de pièces fournit le Obtenir une commande service pour récupérer les commandes de pièces en fonction de critères spécifiques, tels qu'une plage de dates.

❗ Dans certains cas, les critères utilisés pour le Obtenir une commande l'appel de service peut sélectionner trop de commandes de pièces, et l'API renvoie un délai d'attente ❗

👉 Votre DMS doit gérer le délai d'attente et afficher un message d'erreur demandant au concessionnaire de modifier les critères.

Partenaires dans la réponse du service Check

La réponse renvoyée par le Check service ne contient pas la liste des partenaires.

Modification de la commande de pièces

❗ Une fois qu'une commande de pièces a été créée avec un appel au Créer une commande service, il ne peut pas être modifié ❗

Vous ne pouvez pas ajouter ou supprimer des articles de la commande de pièces créée.

La seule action est d'annuler un article en appelant le Annuler la ligne de commande service.

Seul un article de ligne dans le retard ou bloqué peut être annulé si la commande est complétée !

Si l'état de la commande est en cours ou en attente, tout article peut être annulé.