Juridictions fiscales

Une juridiction fiscale est un lieu qui prélève des taxes — un pays, un État ou une province, une ville. C’est le fondement de tout le moteur de taxes, car toute question fiscale commence par « où ? » : où se trouve le vendeur, où se trouve l’acheteur, et donc quelles taxes s’appliquent. Configurez correctement les juridictions, et les règles qui s’appuient sur elles s’écrivent pratiquement toutes seules.

Le point astucieux — et ce qu’il faut comprendre avant tout le reste — est que les juridictions forment une hiérarchie. Le Royaume-Uni contient l’Angleterre, l’Écosse, le pays de Galles et l’Irlande du Nord. Le Brésil contient São Paulo, Rio de Janeiro et 25 autres États. Le moteur utilise cette structure parent-enfant pour qu’une règle définie une seule fois au niveau du pays s’applique automatiquement à chaque lieu qu’il contient.

La hiérarchie — et la correspondance par ascendance

Chaque juridiction peut pointer vers un parent. Les enregistrements de pays n’ont pas de parent ; un État pointe vers son pays ; une ville pointe vers son État. On obtient ainsi une arborescence :

Lorsque le moteur évalue une transaction, il ne regarde pas seulement la juridiction exacte — il remonte l’arborescence et rassemble le lieu et tous ses ascendants. Un client situé en Angleterre produit l’ensemble {GB-ENG, GB}. Une règle correspond alors si sa juridiction se trouve n’importe où dans cet ensemble. Ainsi :

• Une règle ciblant GB correspond au client situé en Angleterre (car GB est un ascendant).
• Une règle ciblant GB-ENG correspond aussi (correspondance exacte).
• Une règle ciblant GB-SCT ne correspond pas (l’Écosse ne fait pas partie de l’ensemble).

Cette « correspondance par ascendance » explique pourquoi une seule règle au niveau du pays couvre toute une nation, tout en vous permettant de descendre à une règle au niveau de l’État lorsqu’un seul État diffère (c’est exactement ainsi que fonctionnent les taux d’ICMS par État au Brésil).

Les champs — avec des valeurs pour le Royaume-Uni et le Brésil

Une juridiction est un enregistrement réduit et volontairement simple. Voici chaque champ, son rôle et une valeur réelle tirée des packs d’initialisation livrés — un enregistrement britannique (Angleterre) à côté d’un enregistrement brésilien (São Paulo), tous deux au niveau État/province, pour comparer ce qui est comparable.

Le Code est la clé — traitez-le avec soin

De tous ces champs, le Code est celui qui compte le plus. C’est la clé de correspondance du moteur, la clé d’upsert de l’initialisation et un ID externe — ce qui signifie qu’il reste stable lors des actualisations de l’organisation et des mises à niveau du package, contrairement aux ID d’enregistrement Salesforce. La convention est stricte et imposée :

Comment le moteur utilise les juridictions

Lorsqu’une facture est comptabilisée, les juridictions remplissent quatre fonctions. Vous ne configurez rien de tout cela — c’est le moteur qui lit vos enregistrements — mais le savoir explique pourquoi vos codes et vos parents doivent être corrects.

1 · Il remonte l’ascendance des deux parties

Le moteur charge toutes les juridictions une seule fois, puis construit, pour le vendeur et pour l’acheteur, l’ensemble formé du lieu et de ses ascendants. Vendeur à São Paulo → {BR-SP, BR} (l’ensemble d’origine). Acheteur à Rio → {BR-RJ, BR} (l’ensemble de destination).

2 · Il confronte les règles à ces ensembles

Une règle de taxe ne se déclenche que si ses juridictions d’origine et de destination figurent dans les ensembles correspondants (un champ vide sur la règle signifie « n’importe laquelle »). C’est le mécanisme d’ascendance en action — une règle BR correspond à la fois à SP et à RJ ; une règle BR-RJ ne correspond qu’à Rio.

3 · Il déduit l’opération fiscale des codes

Le moteur compare les deux codes pour classer la transaction — uniquement à partir du texte :

Cette opération déduite alimente directement les Opérations fiscales et détermine, pour le Brésil, si vous relevez du jeu de règles inter-État (et donc si le DIFAL s’applique).

4 · Il conditionne le nexus

Avant de facturer la moindre taxe, le moteur vérifie que votre entité est immatriculée pour collecter la taxe dans la juridiction de l’acheteur — et il accepte une immatriculation à n’importe quel ascendant. Une seule immatriculation US-TX couvre un acheteur situé dans une ville du Texas ; une immatriculation GB couvre les quatre nations du Royaume-Uni. (Voir Immatriculation fiscale d’entité.)

Données réelles : juridictions du Royaume-Uni et du Brésil

Voici ce que créent réellement les packs d’initialisation.

🇬🇧 Royaume-Uni — 5 enregistrements

La TVA s’applique à l’ensemble du Royaume-Uni : les quatre nations existent donc surtout par souci d’exhaustivité et pour les rares cas qui diffèrent (l’Irlande du Nord suit les règles de TVA de l’UE pour les biens, en vertu du cadre de Windsor). Les règles de TVA se situent toutes au niveau GB.

🇧🇷 Brésil — 28 enregistrements (un échantillon)

Le Brésil a besoin de chaque État, car les taux et les surtaxes d’ICMS diffèrent réellement d’un État à l’autre — SP à 18 %, RJ à 20 % avec une surtaxe de 2 % au profit du fonds de lutte contre la pauvreté. La hiérarchie permet à chaque État de porter ses propres règles, tandis que les taxes fédérales communes (IPI, PIS, COFINS) se situent au niveau BR.

Exemple chiffré : pourquoi São Paulo → Rio est « inter-État »

Un vendeur de São Paulo facture un client de Rio de Janeiro. Observez le travail des juridictions :

Ce seul changement — la juridiction de l’acheteur — transforme tout le résultat fiscal. C’est pourquoi il est si important de renseigner correctement la Juridiction fiscale sur le Compte de chaque client.

Garde-fous intégrés

Quatre règles de validation maintiennent la propreté des données de juridiction — car le moteur en dépend :

Configuration et tenue à jour

• En général, vous ne les créez pas à la main. L’Assistant d’initialisation des taxes crée l’ensemble complet des juridictions d’un pays — les pays d’abord, puis leurs enfants — dans le bon ordre, afin que les parents existent toujours avant les enregistrements qui pointent vers eux.
• Désactivez, ne supprimez pas. Décocher Actif retire une juridiction de la correspondance tout en préservant l’historique des factures passées. Supprimer une juridiction sur laquelle s’appuient des enregistrements historiques rendrait ceux-ci orphelins.
• N’ajoutez un niveau que lorsqu’une taxe l’exige. L’initialisation utilise les niveaux Pays et État/province ; les niveaux Municipalité, District et Région existent pour les taxes municipales (l’ISS au Brésil, les districts spéciaux aux États-Unis) — ajoutez-les lorsqu’une règle cible réellement ce niveau.

Pour aller plus loin

1. Types de taxe — les taxes qu’une juridiction prélève.
2. Règles de taxe — les règles rattachées à une juridiction.
3. Immatriculation fiscale d’entité — s’immatriculer pour collecter la taxe dans une juridiction.
4. Assistant d’initialisation des taxes — charger les juridictions automatiquement.

Questions fréquentes