Installation et configuration de l'interface d'intégration fiscale

About this task

Pour installer et configurer l'interface d'intégration fiscale, vous devez enregistrer les nouvelles commandes fournies par le kit d'intégration fiscale dans la base de données. Si vous utilisez un logiciel fiscal tiers, la taxe de vente et la taxe d'expédition sont maintenant séparées en commandes individuelles pour le kit d'intégration fiscale. Si vous devez séparer la taxe de vente et la taxe d'expédition pour permettre l'audit séparé de la taxe de vente et d'expédition, vous devez suivre ces étapes à la place.

Pour qu'un magasin utilise la nouvelle commande fournie par le kit d'intégration fiscale pour le calcul des taxes, vous devez inscrire les nouvelles commandes, ApplyCalculationUsageCmd et TaxCalculationUsageTIKCmd, dans la base de données HCL Commerce, en mettant à jour les tables CALMETHOD et STENCALUSG comme suit :

Procedure

Insérez une nouvelle entrée pour ApplyCalculationUsageCmd dans la table CALMETHOD.


Colonne	Valeurs
CALMETHOD_ID	La clé, un ID unique qui est affecté à l'entrée.
STOREENT_ID	-1 ou le `store_ID`
CALUSAGE_ID	-3
TASKNAME	com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageTIKCmd
DESCRIPTION	Il s'agit d'une description de la méthode de la taxe de vente de l'ISV.
SOUS-CLASSE	12
NAME	ApplyCalculationUsageTIK

Aidez-vous de l'exemple d'instructions SQL suivant :

 DELETE FROM calmethod WHERE TASKNAME = 'com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageTIKCmd' AND STOREENT_ID = store_ID AND CALUSAGE_ID = -3 INSERT INTO CALMETHOD (CALMETHOD_ID, STOREENT_ID, CALUSAGE_ID, TASKNAME, DESCRIPTION, SUBCLASS, NAME) VALUES ((select coalesce((min(calmethod_id)-1),1) from calmethod), store_ID , -3, 'com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageTIKCmd', 'default method for calculation taxes using Taxcompany', 12, 'ApplyCalculationUsageTIK')

Insérez une nouvelle entrée pour TaxCalculationUsageTIKCmd dans la table CALMETHOD.


Colonne	Valeurs
CALMETHOD_ID	La clé, un ID unique qui est affecté à l'entrée.
STOREENT_ID	-1 ou le `store_ID`
CALUSAGE_ID	-3
TASKNAME	com.ibm.commerce.isv.kit.tax.TaxCalculationUsageTIKCmd
DESCRIPTION	Il s'agit d'une description de la méthode de la taxe de vente de l'ISV.
SOUS-CLASSE	12
NAME	TaxCalculationUsageTIK

Aidez-vous de l'exemple d'instructions SQL suivant :

 DELETE FROM calmethod WHERE TASKNAME = 'com.ibm.commerce.isv.kit.tax.TaxCalculationUsageTIKCmd' AND STOREENT_ID = store_ID AND CALUSAGE_ID = -3 INSERT INTO CALMETHOD (CALMETHOD_ID, STOREENT_ID, CALUSAGE_ID, TASKNAME, DESCRIPTION, SUBCLASS, NAME) VALUES ((select coalesce((min(calmethod_id)-1),1) from calmethod), store_ID, -3, 'com.ibm.commerce.isv.kit.tax.TaxCalculationUsageTIKCmd', 'default method for setting audit flag using Taxcompany', 14, 'TaxCalculationUsageTIK')

Mettez à jour la table STENCALUSG avec le nouveau CALMETHOD ID (obtenu ci-dessus) pour le magasin : update STENCALUSG set CALMETHOD_ID_APP =CALMETHOD_ID where CALUSAGE_ID = -3 and STOREENT_ID =store_ID

Aidez-vous de l'exemple d'instructions SQL suivant :

 UPDATE STENCALUSG SET (CALMETHOD_ID_APP, CALMETHOD_ID_FIN) = ((SELECT CALMETHOD_ID FROM CALMETHOD WHERE TASKNAME = 'com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageTIKCmd' AND STOREENT_ID = store_ID AND CALUSAGE_ID = -3), (SELECT CALMETHOD_ID FROM CALMETHOD WHERE TASKNAME = 'com.ibm.commerce.isv.kit.tax.TaxCalculationUsageTIKCmd' AND STOREENT_ID = store_ID AND CALUSAGE_ID = -3)) WHERE CALUSAGE_ID = -3 and STOREENT_ID = store_ID

Si CMDREG contient une entrée avec ce nom d'interface, supprimez l'entrée : com.ibm.commerce.taxation.commands.ApplyOrderTaxesCmd

Results

Le fournisseur du logiciel fiscal vous demandera également d'inscrire les commandes TaxIntegrationOrdercmd et TaxIntegrationOrderItemCmd dans la table CMDREG. Reportez-vous à la documentation du fournisseur de logiciels fiscaux pour plus de détails.

Aidez-vous de l'exemple d'instructions SQL suivant :

 DELETE FROM cmdreg WHERE storeent_id = store_ID AND interfacename = 'com.ibm.commerce.isv.kit.tax.TaxIntegrationOrderCmd' AND classname = 'com.taxcompany.utl.TaxcompanyOrderCmdImpl' INSERT INTO cmdreg (storeent_id, interfacename, description, classname, properties, target) VALUES (store_ID, 'com.ibm.commerce.isv.kit.tax.TaxIntegrationOrderCmd', 'Taxcompany Tax Integration Kit implementation', 'com.taxcompany.utl.TaxcompanyOrderCmdImpl', null, 'Local') DELETE FROM cmdreg WHERE storeent_id = store_ID AND interfacename = 'com.ibm.commerce.isv.kit.tax.TaxIntegrationOrderItemCmd' AND classname = 'com.taxcompany.utl.TaxcompanyOrderItemCmdImpl' INSERT INTO cmdreg (storeent_id, interfacename, description, classname, properties, target) VALUES (store_ID, 'com.ibm.commerce.isv.kit.tax.TaxIntegrationOrderItemCmd', 'Taxaware Tax Integration Kit implementation', 'com.taxcompany.utl.TaxcompanyOrderItemCmdImpl', null, 'Local')

Note: Utilisez 0 (site) ou store_ID.

Steps for separate sales tax and shipping tax when using third-party tax software

La taxe de vente et la taxe d'expédition peuvent être séparées en commandes individuelles pour le kit d'intégration fiscale (logiciel fiscal tiers). Cette séparation permet l'audit individuel de la taxe de vente et de la taxe d'expédition.

Effectuez les étapes suivantes pour vérifier la taxe de vente et d'expédition séparément :

Ajoutez l'instruction SQL suivante pour mettre à jour la table CMDREG :

 db2 insert into CMDREG (STOREENT_ID, INTERFACENAME, DESCRIPTION, CLASSNAME, PROPERTIES, LASTUPDATE, TARGET) values (0,'com.ibm.commerce.isv.kit.tax.TaxCalculationUsageSalesTaxTIKCmd','Sales Tax calculation usage for third-party tax providers','com.ibm.commerce.isv.kit.tax.TaxCalculationUsageSalesTaxTIKCmdImpl',null,null,'Local') db2 insert into CMDREG (STOREENT_ID, INTERFACENAME, DESCRIPTION, CLASSNAME, PROPERTIES, LASTUPDATE, TARGET) values (0,'com.ibm.commerce.isv.kit.tax.TaxCalculationUsageShippingTaxTIKCmd','Shipping Tax calculation usage for third-party tax providers','com.ibm.commerce.isv.kit.tax.TaxCalculationUsageShippingTaxTIKCmdImpl',null,null,'Local')

 db2 insert into CMDREG (STOREENT_ID, INTERFACENAME, DESCRIPTION, CLASSNAME, PROPERTIES, LASTUPDATE, TARGET) values (0,'com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageSalesTaxTIKCmd','Apply Sales Tax calculation usage for third-party tax providers','com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageSalesTaxTIKCmdImpl',null,null,'Local'); db2 insert into CMDREG (STOREENT_ID, INTERFACENAME, DESCRIPTION, CLASSNAME, PROPERTIES, LASTUPDATE, TARGET) values (0,'com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageShippingTaxTIKCmd','Apply Shipping Tax calculation usage for third-party tax providers','com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageShippingTaxTIKCmdImpl',null,null,'Local');

Ajoutez l'instruction SQL suivante pour mettre à jour la table CALMETHOD :

 db2 insert into CALMETHOD (CALMETHOD_ID, STOREENT_ID, CALUSAGE_ID, TASKNAME, DESCRIPTION, SUBCLASS, NAME) VALUES ((select coalesce((min(calmethod_id)-1),1) from calmethod), store_ID, -3, 'com.ibm.commerce.isv.kit.tax.TaxCalculationUsageSalesTaxTIKCmd', 'default method for setting audit flag for sales tax using third-party tax software', 12, 'TaxCalculationUsageSalesTaxTIK') db2 insert into CALMETHOD (CALMETHOD_ID, STOREENT_ID, CALUSAGE_ID, TASKNAME, DESCRIPTION, SUBCLASS, NAME) VALUES ((select coalesce((min(calmethod_id)-1),1) from calmethod), store_ID, -4, 'com.ibm.commerce.isv.kit.tax.TaxCalculationUsageShippingTaxTIKCmd', 'default method for setting audit flag for shipping using third-party tax software', 12, 'TaxCalculationUsageShippingTaxTIK') insert into CALMETHOD (CALMETHOD_ID, STOREENT_ID, CALUSAGE_ID, TASKNAME, DESCRIPTION, SUBCLASS, NAME) VALUES ((select coalesce((min(calmethod_id)-1),1) from calmethod), store_ID, -3, 'com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageSalesTaxTIKCmd', 'applies calculation usage sales tax', 12, 'ApplyCalculationUsageSalesTaxTIK') insert into CALMETHOD (CALMETHOD_ID, STOREENT_ID, CALUSAGE_ID, TASKNAME, DESCRIPTION, SUBCLASS, NAME) VALUES ((select coalesce((min(calmethod_id)-1),1) from calmethod), store_ID, -4, 'com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageShippingTaxTIKCmd', 'applies calculation usage shipping tax', 12, 'ApplyCalculationUsageShippingTaxTIK')

où store_ID est l'ID du magasin ou du groupe de magasins.

Actualisez le registre Calcul et le registre Commande à partir de la console d'administration.
Définissez la colonne STENCALUSG.CALMETHOD_ID_FIN. La table STENCALUSG doit être mise à jour afin que TaxCalculationUsageSalesTaxTIKCmd et TaxCalculationUsageShippingTaxTIKCmd soient appelés pour votre magasin.
Interrogez la table CALMETHOD pour trouver les valeurs CALMETHOD_ID pour com.ibm.commerce.isv.kit.tax.TaxCalculationUsageSalesTaxTIKCmd et com.ibm.commerce.isv.kit.tax.TaxCalculationUsageShippingTaxTIKCmd. À l'aide de ces valeurs, mettez à jour le tableau STENCALUSG afin que CALMETHOD_ID_FIN pour l'expédition et les ventes soit appelé. Utilisez les instructions SQL suivantes pour mettre à jour la table STENCALUSG :
Également lors de la mise à jour de STENCALUSG, la zone CALMETHOD_ID_APP doit être mise à jour et PAS la colonne CALMETHOD_ID_FIN
Pour mettre à jour STENCALUSG
```
 set CALMETHOD_ID_FIN=calmethod_ID_1 where STOREENT_ID=store_ID and CALUSAGE_ID=calusage_ID_1 
```
Pour mettre à jour STENCALUSG
```
 set CALMETHOD_ID_FIN=calmethod_ID_2 where STOREENT_ID=store_ID and CALUSAGE_ID=calusage_ID_2, where calmethod_ID_1 is the CALMETHOD_ID for TaxCalculationUsageSalesTaxTIKCmd, calmethod_ID_2 is the CALMETHOD_ID for TaxCalculationUsageShippingTaxTIKCmd, store_ID is the store or store group ID, calusage_ID_1 is the calculation usage ID for sales tax (-3), and calusage_ID_2 is the calculation usage value for shipping tax (-4). 
```

Définissez la colonne STENCALUSG.CALMETHOD_ID_APP. La table STENCALUSG doit être mise à jour de sorte que ApplyCalculationUsageSalesTaxTIKCmd et ApplyCalculationUsageShippingTaxTIKCmd soient appelés pour votre magasin.
Interrogez la table CALMETHOD pour trouver les valeurs CALMETHOD_ID pour com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageSalesTaxTIKCmd et com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageShippingTaxTIKCmd. À l'aide de ces valeurs, mettez à jour le tableau STENCALUSG afin que CALMETHOD_ID_FIN pour l'expédition et les ventes soit appelé. Utilisez les instructions SQL suivantes pour mettre à jour le tableau STENCALUSG :

Pour mettre à jour STENCALUSG pour la taxe de vente :

set CALMETHOD_ID_FIN=calmethod_ID_3 where STOREENT_ID=store_ID and CALUSAGE_ID=calusage_ID_3

Pour mettre à jour STENCALUSG pour la taxe d'expédition

set CALMETHOD_ID_FIN=calmethod_ID_4 where STOREENT_ID=store_ID and CALUSAGE_ID=calusage_ID_4, calmethod_ID_3 is the CALMETHOD_ID for ApplyCalculationUsageSalesTaxTIKCmd, calmethod_ID_4 is the CALMETHOD_ID for ApplyCalculationUsageShippingTaxTIKCmd,

Où :

ID_magasin: est l'ID du magasin ou du groupe de magasins,
calusage_ID_3: Est l'ID d'utilisation de calcul pour la taxe de vente (-3),
calusage_ID_4: Est la valeur d'utilisation de calcul pour la taxe d'expédition (-4).

Le fournisseur du logiciel fiscal vous demande également d'inscrire les commandes TaxIntegrationOrderCmd et TaxIntegrationOrderItemCmd dans la table CMDREG. Reportez-vous à la documentation du fournisseur de logiciels fiscaux pour plus de détails.