Jurisdicciones fiscales

Una jurisdicción fiscal es un lugar que grava impuestos: un país, un estado o provincia, una ciudad. Es la base de todo el motor de impuestos, porque toda pregunta tributaria empieza por “¿dónde?”: dónde está el vendedor, dónde está el comprador y, por lo tanto, qué impuestos aplican. Acierta con las jurisdicciones y las reglas que se apoyan en ellas prácticamente se escriben solas.

La parte ingeniosa — y lo que hay que entender antes que nada — es que las jurisdicciones forman una jerarquía. El Reino Unido contiene Inglaterra, Escocia, Gales e Irlanda del Norte. Brasil contiene São Paulo, Río de Janeiro y otros 25 estados. El motor usa esa estructura padre-hijo para que una regla definida una vez a nivel de país aplique automáticamente a cada lugar que contiene.

La jerarquía — y la coincidencia por ascendencia

Cada jurisdicción puede apuntar a un padre. Los registros de país no tienen padre; un estado apunta a su país; una ciudad apunta a su estado. Eso produce un árbol:

Cuando el motor evalúa una transacción, no solo mira la jurisdicción exacta — recorre el árbol hacia arriba y reúne el lugar más todos sus ancestros. Un cliente en Inglaterra produce el conjunto {GB-ENG, GB}. Una regla coincide entonces si su jurisdicción está en cualquier parte de ese conjunto. Así:

• Una regla dirigida a GB coincide con el cliente de Inglaterra (porque GB es un ancestro).
• Una regla dirigida a GB-ENG también coincide (acierto exacto).
• Una regla dirigida a GB-SCT no coincide (Escocia no está en el conjunto).

Esta “coincidencia por ascendencia” es la razón por la que una regla a nivel de país cubre toda una nación, y a la vez puedes bajar a una regla a nivel de estado cuando un solo estado difiere (exactamente como funcionan las tasas de ICMS por estado de Brasil).

Los campos — con valores del Reino Unido y Brasil

Una jurisdicción es un registro pequeño y deliberado. Aquí está cada campo, qué hace y un valor real de los paquetes de inicialización incluidos — un registro del Reino Unido (Inglaterra) junto a un registro de Brasil (São Paulo), ambos a nivel de Estado/Provincia para que puedas comparar de forma equivalente.

El Código es la clave — trátalo con cuidado

De todos estos campos, Código es el que más importa. Es la clave de coincidencia del motor, la clave de upsert de la inicialización y un ID externo — lo que significa que es estable a través de los refrescos de la organización y las actualizaciones de paquete de una forma en que los Id. de registro de Salesforce no lo son. La convención es estricta y obligatoria:

Cómo usa el motor las jurisdicciones

Cuando se contabiliza una factura, las jurisdicciones hacen cuatro trabajos. Tú no configuras nada de esto — es el motor leyendo tus registros — pero conocerlo explica por qué tus códigos y padres tienen que estar correctos.

1 · Recorre la ascendencia de ambas partes

El motor carga cada jurisdicción una sola vez y luego, para el vendedor y el comprador, construye el conjunto de lugar-más-ancestros. Vendedor en São Paulo → {BR-SP, BR} (el conjunto de origen). Comprador en Río → {BR-RJ, BR} (el conjunto de destino).

2 · Coincide las reglas contra esos conjuntos

Una regla fiscal se activa solo si sus jurisdicciones de origen y destino caen en los conjuntos coincidentes (un campo en blanco en la regla significa “cualquiera”). Este es el mecanismo de ascendencia en acción — una regla BR coincide tanto con SP como con RJ; una regla BR-RJ coincide solo con Río.

3 · Deriva la operación fiscal a partir de los códigos

El motor compara los dos códigos para clasificar la transacción — enteramente a partir del texto:

Esa operación derivada alimenta directamente las Operaciones fiscales y decide, para Brasil, si estás en el conjunto de reglas interestatales (y, por lo tanto, si aplica el DIFAL).

4 · Controla el nexo

Antes de cobrar cualquier impuesto, el motor verifica si tu entidad está inscrita para recaudar impuestos en la jurisdicción del comprador — y acepta una inscripción en cualquier ancestro. Una sola inscripción US-TX cubre a un comprador en una ciudad de Texas; una inscripción GB cubre las cuatro naciones del Reino Unido. (Consulta Inscripción fiscal de entidad.)

Datos reales: jurisdicciones del Reino Unido y Brasil

Esto es lo que crean realmente los paquetes de inicialización.

🇬🇧 Reino Unido — 5 registros

El IVA es de alcance nacional en el Reino Unido, por lo que las cuatro naciones existen principalmente por completitud y por los pocos casos que difieren (Irlanda del Norte sigue las reglas del IVA de la UE para los bienes bajo el Marco de Windsor). Todas las reglas del IVA se sitúan a nivel GB.

🇧🇷 Brasil — 28 registros (una muestra)

Brasil necesita cada estado porque las tasas de ICMS y los recargos difieren realmente por estado — SP al 18%, RJ al 20% con un recargo del 2% para el fondo de combate a la pobreza. La jerarquía permite que cada estado lleve sus propias reglas mientras que los impuestos federales compartidos (IPI, PIS, COFINS) se sitúan a nivel BR.

Ejemplo práctico: por qué São Paulo → Río es “interestatal”

Un vendedor de São Paulo factura a un cliente de Río de Janeiro. Observa cómo las jurisdicciones hacen su trabajo:

Ese único cambio — la jurisdicción del comprador — reconfigura todo el resultado fiscal. Por eso es tan importante acertar con la jurisdicción fiscal en cada Cuenta de cliente.

Medidas de protección integradas

Cuatro reglas de validación mantienen limpios los datos de las jurisdicciones — porque el motor depende de ellos:

Configuración y mantenimiento

• Normalmente no las creas a mano. El Asistente de carga inicial de impuestos crea el conjunto completo de jurisdicciones de un país — primero los países, luego sus hijos — en el orden correcto para que los padres siempre existan antes que los registros que apuntan a ellos.
• Desactiva, no elimines. Desmarcar Activo quita una jurisdicción de la coincidencia y a la vez preserva el historial de las facturas pasadas. Eliminar una de la que dependen registros históricos los dejaría huérfanos.
• Agrega un nivel solo cuando un impuesto lo necesite. La inicialización usa los niveles País y Estado/Provincia; los niveles Municipio, Distrito y Región existen para los impuestos municipales (el ISS de Brasil, los distritos especiales de EE. UU.) — agrégalos cuando una regla apunte realmente a ese nivel.

Qué sigue

1. Tipos de impuestos — los impuestos que grava una jurisdicción.
2. Reglas fiscales — reglas delimitadas a una jurisdicción.
3. Inscripción fiscal de entidad — inscribirse para recaudar en una jurisdicción.
4. Asistente de carga inicial de impuestos — cargar jurisdicciones automáticamente.

Preguntas frecuentes