HCL Commerce Enterprise

URL ContractImportApprovedVersion

Cette URL importe un contrat au format XML dans HCL Commerce.

Remarque : Pour un magasin type Aurora direct client, redémarrez le Search server après l'importation du contrat par défaut. Dans le cas contraire, le nouveau contrat pourrait ne pas entrer en vigueur sur la vitrine parce que l'ID de contrat précédent est mis en cache sur le Search server.

Structure de l'adresse URL

https://host_name/path/
Nom entièrement qualifié de votre Transaction server et du chemin de configuration.

Avant de publier cette URL, vous devez être connecté à HCL Commerce. Vous pouvez vous connecter à HCL Commerce à l'aide de la commande Logon

Valeurs des paramètres

Remarque : N'utilisez pas les caractères spéciaux suivants lorsque vous définissez le nom distinctif ou le nom du contrat, car cela peut entraîner l'échec de l'importation du contrat :

&, <, >, ', \

fileName
Obligatoire : Nom du fichier XML que vous souhaitez importer en tant que contrat approuvé ou actif. Le fichier XML doit être validé avec le DTD B2BTrading.

Le fichier XML importé doit exister dans l'emplacement spécifié dans le fichier de configuration HCL Commerce. Le fichier doit être validé avec le DTD B2BTrading ou Package.xsd.

L'emplacement du fichier XML de contrat à importer est spécifié dans l'attribut XMLPath de la balise Trading du fichier de configuration HCL Commerce. Par exemple, si le fichier de configuration HCL Commerce contient la section suivante :


<Trading
DTDFileName="B2BTrading.dtd"
DTDPath="/trading/dtd"
XMLPath="/trading/xml"
XSDPath="/trading/xsd" />

Le fichier XML du contrat à importer à l'aide de cette URL doit se trouver dans WC_eardir/xml/trading/xml.

xsd
Obligatoire : Spécifie si le XML de contrat est basé sur DTD- ou XSD-. Les valeurs correctes de ce paramètre sont true et false. Utilisez true lorsque le contrat est basé sur XSD. Utilisez false lorsque le contrat est basé sur DTD.

En l'absence de spécification de ce paramètre, une valeur false est adoptée.

targetStoreId
Si le fichier XML que vous importez indique un état de contrat "actif", vous devez spécifier le paramètre targetStoreId. TargetStoreId est l'ID de magasin de la table de base de données STORE pour le magasin dans lequel vous souhaitez importer le contrat.
validate
Spécifie si le XML de contrat doit être validé par l'analyseur XML. Les valeurs correctes de ce paramètre sont true et false. Utilisez true pour faire valider le contrat. Utilisez false pour empêcher que le contrat ne soit validé par l'analyseur XML.

En l'absence de spécification de ce paramètre, une valeur true est adoptée.

synchronousDeployment
Spécifie si le déploiement du contrat doit être exécuté en tant que tâche planifiée ou si la commande ne doit pas être renvoyée tant que le déploiement du contrat n'est pas terminé. Les valeurs correctes de ce paramètre sont true et false. Utilisez true pour que le déploiement du contrat s'exécute dans le cadre de l'importation du contrat. Utilisez false pour qu'un travail planifié déploie le contrat.

En l'absence de spécification de ce paramètre, une valeur false est adoptée.

contractList
Spécifie si le fichier spécifié dans le paramètre fileName contient une liste de fichiers XML de contrat à importer. Les valeurs correctes de ce paramètre sont true et false. Utilisez true pour spécifier que le fichier du paramètre fileName contient une liste de fichiers XML de contrat. Utilisez false pour spécifier que le fichier du paramètre fileName est un fichier XML de contrat.

En l'absence de spécification de ce paramètre, une valeur false est adoptée.

URL
Obligatoire : Adresse URL à appeler une fois que la commande a abouti.

Exemple

L'exemple suivant importe un contrat "approuvé" :


https://myhostname/webapp/wcs/stores/servlet/ContractImportApprovedVersion?fileName=myspecialcontract.xml
&xsd=true&URL=StoreCatalogDisplay?storeId=512&catalogId=512

Comportement

Cette URL importe un contrat approuvé ou actif dans la base de données HCL Commerce à partir d'un fichier XML. Avant d'importer le contrat, la commande s'assure que le contrat importé remplit les conditions suivantes :

  • Le contrat n'a pas expiré
  • Le contrat est destiné à un participant acheteur uniquement
  • Il y a au moins un participant acheteur
  • L'état du contrat est actif ou approuvé
  • Il y a au moins une modalité de tarification dans le contrat
  • Il y a au moins une modalité de frais de port dans le contrat
  • Il n'y a pas de modalité permettant le paiement par ligne de crédit
  • Il n'y a pas de modalité permettant le paiement par les bons de commande
  • Il n'y a pas plus d'une modalité de frais de retour
  • Il n'y a pas de modalité de personnalisation d'affichage
  • Il n'y a pas plus d'une modalité d'approbation de commande
  • Il n'y a pas plus d'une modalité de frais de retour
  • Il n'y a pas plus d'une modalité de droit d'achat
  • Il n'y a pas plus d'une modalité d'obligation d'achat
  • Les stratégies commerciales mentionnées par les modalités du contrat dans le fichier XML sont disponibles dans le magasin
  • Les stratégies commerciales mentionnées par les modalités du contrat dans le fichier XML n'ont pas expiré
  • Les stratégies commerciales mentionnées par les modalités du contrat dans le fichier XML n'expirent pas avant l'expiration du contrat

Conditions d'exception

Les exceptions suivantes peuvent être déclenchées par cette URL :

  • _ERR_ACCOUNT_DOES_NOT_EXIST se déclenchera si le compte professionnel ne peut pas être trouvé avec accountName et accountOwnerId.
  • _ERR_BIZ_POLICY_NOT_AVAILABLE_FOR_STORE se déclenchera si la stratégie commerciale n'est pas disponible pour le magasin dans lequel le contrat va être déployé.
  • _ERR_BIZ_POLICY_EXPIRED se déclenchera si la stratégie a expiré.
  • _ERR_BUYER_IN_CNTR_DOES_NOT_MATCH_WITH_ACCOUNTHOLDER_IN_ACNT se déclenchera si le participant acheteur au contrat n'appartient pas au titulaire du compte dans le compte professionnel référencé.
  • _ERR_BUYER_IN_TC_DOES_NOT_MATCH_WITH_BUYER_IN_ACNT se déclenchera si le participant acheteur au contrat n'appartient pas aux participants acheteurs mentionnés dans le compte professionnel.
  • _ERR_CANNOT_HAVE_DISPLAY_CUSTOMIZATION_TC_IN_CONTRACT se déclenchera s'il y a des modalités de personnalisation d'affichage dans le contrat.
  • _ERR_CANNOT_HAVE_INVOICE_TC_IN_CONTRACT se déclenchera s'il y a des modalités de facturation dans le contrat.
  • _ERR_CANNOT_HAVE_MORE_THAN_ONE_OBLIGATION_TO_BUY_BY_AMOUNT_TC se déclenchera s'il y a plus d'une modalité d'obligation d'achat dans le contrat.
  • _ERR_CANNOT_HAVE_MORE_THAN_ONE_ORDER_APPROVAL_TC se déclenchera s'il y a plus d'une modalité d'approbation de commande dans le contrat.
  • _ERR_CANNOT_HAVE_MORE_THAN_ONE_RETURN_CHARGE_TC se déclenchera s'il y a plus d'une modalité de frais de retour dans le contrat.
  • _ERR_CANNOT_HAVE_MORE_THAN_ONE_RIGHT_TO_BUY_BY_AMOUNT_TC se déclenchera s'il y a plus d'une modalité de droit d'achat dans le contrat.
  • _ERR_CANNOT_HAVE_MORE_THAN_ONE_SELLER se déclenchera si le contrat a plus d'un participant vendeur.
  • _ERR_CANNOT_HAVE_PAYMENT_TC_WITH_CREDIT_LINE_IN_CONTRACT se déclenchera s'il y a des modalités de paiement par ligne de crédit dans le contrat.
  • _ERR_CANNOT_HAVE_PURCHASE_ORDER_TC_IN_CONTRACT se déclenchera s'il y a des modalités de bon de commande dans le contrat.
  • _ERR_COLUMN_ACCESSBEANNAME_IN_PATTRIBUTE_NOT_POPULATED se déclenchera si dans OrderTCOrderItemPAttribute ou PaymentTC, l'attribut spécifié dans le fichier XML n'a pas de colonne accessbeanname pré-remplie dans la table de base de données PATTRPROD.
  • _ERR_CONTRACT_EXPIRED se déclenchera si le contrat a expiré.
  • _ERR_CONTRACT_REFERENCE_NUMBER_NOT_REQUIRED se déclenchera si l'attribut referenceNumber est fourni dans le fichier XML.
  • _ERR_DO_NOT_REFERRED_TO_ACCOUNT_WHEN_CREDIT_ALLOWED se déclenchera si creditAllowed est défini sur true mais qu'il n'y a pas d'informations de compte dans le contrat.
  • _ERR_DUPLICATED_CONTRACT_NAME se déclenchera s'il y a d'autres contrats qui ont le même nom de contrat.
  • _ERR_DUPLICATE_KEY_IN_PROCESSING_TC se déclenchera si, tout en essayant de créer une entrée dans la table TERMCOND et sa table associée, l'index unique de la nouvelle entrée est le même qu'une entrée existante.
  • _ERR_INVALID_CONTRACT_EXPIRED_DATE se déclenchera si la date d'expiration du contrat est ultérieure à la date d'expiration de toute stratégie visée par les modalités du contrat.
  • _ERR_MBRGRP_BUYER_CANNOT_REFER_ACCOUNT se déclenchera si le participant acheteur spécifié dans le contrat est un memberGroup et que le contrat se réfère à un compte.
  • _ERR_MISSING_ACCOUNT_NAME se déclenchera si l'élément AccountOwner est fourni, mais que l'attribut accountName est absent de la liste d'attributs de l'élément Contrat.
  • _ERR_MISSING_ACCOUNT_OWNER_ELEMENT se déclenchera si l'élément accountName est spécifié dans la liste des attributs de l'élément Contrat, mais que l'élément AccountOwner est manquant.
  • _ERR_MISSING_BUYER_PARTICIPANT se déclenchera s'il n'y a pas de participant acheteur dans le contrat.
  • _ERR_MISSING_CONTRACT_NAME se déclenchera si l'attribut Name de l'élément Contrat est une chaîne vide ou un espace.
  • _ERR_MISSING_PRICE_TC se déclenchera s'il n'y a pas de modalité tarifaire spécifiée dans le contrat.
  • _ERR_MISSING_SELLER_PARTICIPANT se déclenchera s'il n'y a pas de participant vendeur spécifié dans le contrat et que le contrat ne fait pas référence à un compte.
  • _ERR_MISSING_SHIPPING_CHARGE_TC se déclenchera s'il n'y a pas de modalité de frais de port spécifiée dans le contrat.
  • _ERR_NEED_PAYMENT_TC_WITH_CREDIT_IN_ACCOUNT se déclenchera si creditAllowed est défini sur true, mais qu'il n'y a pas de modalité de paiement par crédit dans le compte mentionné.
  • _ERR_PATTRIBUTE_NOT_REGISTERED_IN_TABLE_PATTRPROD_FOR_CATENTRY se déclenchera si dans OrderTCOrderItemPAttribute, l'élément CatEntry et la paire d'attributs ne sont pas enregistrés dans la table de base de données PATTRPROD.
  • _ERR_RETRIEVE_CATENTRY_ID se déclenchera si un ID CATENTRY ne peut pas être récupéré sur la base des informations fournies dans l'élément OrderTCOrderItemPAttribute.
  • _ERR_RETRIEVE_FFMCENTER_ID se déclenchera si un ID FFMCENTER ne peut pas être récupéré sur la base des informations fournies dans l'élément FulfillmentCenter.
  • _ERR_RETRIEVE_MEMBER_ID se déclenchera si un ID MEMBER ne peut pas être récupéré sur la base des informations fournies dans l'élément Membre.
  • _ERR_RETRIEVE_OPERATOR_ID se déclenchera si un ID OPERATOR ne peut pas être récupéré sur la base des informations fournies dans l'attribut Operator de l'élément AttributeValue.
  • _ERR_RETRIEVE_PATTRIBUTE_ID se déclenchera si un ID PATTRIBUTE ne peut pas être récupéré sur la base des informations fournies dans l'élément AttributeDetail.
  • _ERR_RETRIEVE_POLICY_ID se déclenchera si un ID POLICY ne peut pas être récupéré sur la base des informations fournies dans l'élément PolicyReference.
  • _ERR_SELLER_DO_NOT_MATCH_TO_SELLER_IN_ACCOUNT se déclenchera si le participant vendeur au contrat n'est pas le même que le participant vendeur du compte professionnel référencé.
  • _ERR_TERM_CONDITION_PARTICIPANT_ROLE se déclenchera si les modalités du contrat précisent un participant non acheteur.
  • _ERR_TOO_MANY_FULFILLMENT_TC se déclenchera s'il y a plus de trois modalités de centre de distribution dans le fichier XML.
  • _ERR_VERSION_NUMBER_FORMAT se déclenchera si les attributs majorVersionNumber ou minorVersionNumber de l'élément Contrat du fichier XML de contrat ne sont pas numériques.
  • _ERR_WRONG_ACCOUNT_OWNER_INFO se déclenchera si l'ID du propriétaire du compte ne peut pas être récupéré sur la base des informations fournies dans l'élément AccountOwner.
  • _ERR_WRONG_CONTRACT_OWNER_MEMBER_INFO se déclenchera si l'ID du propriétaire du contrat ne peut pas être récupéré dans la base de données sur la base des informations fournies dans l'élément ContractOwner.
  • _ERR_WRONG_CONTRACT_STATE se déclenchera si l'état du contrat n'est pas l'état Approuvé ou Actif.