Hacienda — Doctrina Administrativa y Consultas DGT

Actor de Apify que automatiza la búsqueda en tres fuentes de doctrina administrativa tributaria del Ministerio de Hacienda:

• DYCTEA — criterios vinculantes y no vinculantes del TEAC y los TEAR autonómicos en serviciostelematicosext.hacienda.gob.es/TEAC/DYCTEA/. Cubre el TEAC central y todos los Tribunales Económico-Administrativos Regionales.
• DGT — Consultas Vinculantes de la Dirección General de Tributos en petete.tributos.hacienda.gob.es/consultas. Únicamente consultas vinculantes (V-XXXX-YY).
• TEAC Histórica — buscador clásico en serviciostelematicosext.hacienda.gob.es/TEAC/DoctrinaHistoricaTEAC/. Contiene resoluciones históricas clasificadas por concepto tributario y Vocalía.

⚠️ TEAC Histórica no disponible actualmente. El portal serviciostelematicosext.hacienda.gob.es/TEAC/DoctrinaHistoricaTEAC/resumen.asp está deshabilitado. Usa source: "DYCTEA_DGT" (valor por defecto) para búsquedas fiables. Evita "TEAC_HISTORICA" y "AMBOS" hasta que el portal esté operativo.

Características

• Búsqueda por texto libre, rango de fechas y número de reclamación en todas las fuentes activas desde una sola ejecución.
• Filtros específicos por concepto tributario y Vocalía para TEAC Histórica (cuando esté disponible).
• Filtros por unidad resolutoria, tipo de criterio y norma jurídica para DYCTEA.
• Filtros por número de consulta, normativa, cuestión planteada y descripción de hechos para DGT.
• Extracción de texto íntegro bajo demanda: detecta HTML y PDF, sigue los enlaces a PDF embebidos.
• Estrategia HTTP-first con fallback a Playwright en cada fuente.

Entrada (Input)

Campo principal

Campo	Tipo	Descripción
source	string	Sistema(s) en los que buscar. Ver valores más abajo. Por defecto "DYCTEA_DGT".

Valores de source

Valor	Fuentes activas	Notas
"DYCTEA_DGT"	DYCTEA + DGT	Recomendado. Valor por defecto.
"DYCTEA"	Solo DYCTEA	TEAC + TEAR autonómicos
"DGT"	Solo DGT	Solo consultas vinculantes DGT
"AMBOS"	TEAC Histórica + DYCTEA + DGT	⚠️ Incluye TEAC Histórica (actualmente no disponible)
"TEAC_HISTORICA"	Solo TEAC Histórica	⚠️ Portal actualmente no disponible

Campos comunes

Campo	Tipo	Descripción
searchText	string	Texto libre. En DYCTEA se usa como parámetro p; en DGT como FreeText; en TEAC Histórica como Texto1.
fechaInicio	string	Fecha de inicio en formato DD/MM/YYYY. En DGT filtra por "Fecha salida desde".
fechaFin	string	Fecha de fin en formato DD/MM/YYYY. Solo aplica a TEAC Histórica y DYCTEA.
numRecla	string	Número de reclamación (p. ej. "4976"). Aplica a TEAC Histórica y DYCTEA.
anoRecla	string	Año de la reclamación (p. ej. "2023"). Aplica a TEAC Histórica y DYCTEA.
fetchDetails	boolean	Si true, accede al detalle de cada resultado para obtener el texto íntegro (HTML o PDF). Por defecto false.

Campos exclusivos de TEAC Histórica

⚠️ Portal actualmente no disponible. Estos campos se ignoran con "DYCTEA_DGT" y "DYCTEA".

Campo	Tipo	Descripción
nivel1	string	Concepto nivel 1. "XX" = todos. Ver tabla de conceptos.
nivel2	string	Concepto nivel 2. "XX" = todos.
nivel3	string	Concepto nivel 3. "XX" = todos.
sede	string	Código de sede. "00" = todas.
uniResol	string	Código de Vocalía. "XX" = todas.

Campos exclusivos de DYCTEA

Campo	Tipo	Descripción
dycteaUnidad	string	Código de unidad resolutoria. Vacío = todas. Ver tabla de unidades.
dycteaCriterio	string	Tipo de criterio: "0" = Vinculantes, "1" = No vinculantes, "2" = Todos (por defecto).
dycteaNorma	string	Código de norma jurídica (p. ej. "08:02:00:00:00" para el Código Civil).
dycteaSede	string	Código de sede de la reclamación. Vacío = no filtrar.
dycteaConcepto1	string	Código de concepto nivel 1. Vacío = todos.
dycteaConcepto2	string	Código de concepto nivel 2. Vacío = todos.
dycteaConcepto3	string	Código de concepto nivel 3. Vacío = todos.
dycteaMaxPages	integer	Máximo de páginas de resultados (10 criterios/página). Por defecto 5, máximo 100.

Campos exclusivos de DGT

Campo	Tipo	Descripción
dgtNumConsulta	string	Número de consulta DGT (p. ej. "V0001-24" o "0237-05"). Vacío = no filtrar.
dgtNormativa	string	Palabras clave de normativa. Vacío = no filtrar.
dgtCuestionPlanteada	string	Palabras clave en la cuestión planteada. Vacío = no filtrar.
dgtDescripcionHechos	string	Palabras clave en la descripción de hechos. Vacío = no filtrar.
dgtCriterioInteres	boolean	Solo consultas marcadas como criterio de interés (a partir de 01/01/2022). Por defecto false.
dgtOrderBy	string	Campo de ordenación: "NUM-CONSULTA" (por defecto), "ORGANO", "FECHA-SALIDA".
dgtOrderDir	string	Dirección: "0" = Ascendente (por defecto), "1" = Descendente.
dgtMaxPages	integer	Máximo de páginas de resultados (20 consultas/página). Por defecto 5, máximo 200.

Ejemplos de input

Buscar criterios sobre clases pasivas en DYCTEA (vinculantes únicamente):

{
  "source": "DYCTEA",
  "searchText": "clases pasivas",
  "dycteaCriterio": "0",
  "dycteaMaxPages": 3
}

Buscar consultas DGT sobre IRPF con texto libre:

{
  "source": "DGT",
  "searchText": "irpf",
  "dgtMaxPages": 5
}

Búsqueda combinada DYCTEA + DGT sobre IVA (recomendado):

{
  "source": "DYCTEA_DGT",
  "searchText": "iva",
  "dycteaCriterio": "0",
  "dycteaUnidad": "00",
  "dycteaMaxPages": 3,
  "dgtMaxPages": 3
}

Buscar criterios vinculantes del TEAR de Madrid:

{
  "source": "DYCTEA",
  "searchText": "IVA",
  "dycteaUnidad": "28",
  "dycteaCriterio": "0",
  "dycteaMaxPages": 3
}

Buscar una consulta DGT concreta por número:

{
  "source": "DGT",
  "dgtNumConsulta": "V0001-24"
}

Búsqueda por rango de fechas en DYCTEA:

{
  "source": "DYCTEA",
  "searchText": "regularización",
  "fechaInicio": "01/01/2023",
  "fechaFin": "31/12/2024",
  "dycteaUnidad": "00",
  "dycteaMaxPages": 2
}

Salida (Output)

DYCTEA

{
  "source": "DYCTEA",
  "criterioNum": 1,
  "numeroResolucion": "28/00123/2023/00/00",
  "fecha": "20/03/2024",
  "unidad": "TEAR de Madrid",
  "asunto": "IVA. Tipo impositivo reducido. Servicios de hostelería.",
  "criterioBrief": "El servicio de catering prestado en locales del cliente...",
  "descripcionBreve": "IVA. Tipo impositivo reducido. - El servicio de catering...",
  "detailUrl": "https://serviciostelematicosext.hacienda.gob.es/TEAC/DYCTEA/criterio.aspx?id=...",
  "textoCompleto": "TRIBUNAL ECONÓMICO-ADMINISTRATIVO REGIONAL DE MADRID\n..."
}

DGT (Consultas Vinculantes)

{
  "source": "DGT",
  "numConsulta": "V0001-24",
  "descripcionHechos": "La entidad consultante es una asociación de instituciones de inversión colectiva...",
  "cuestionPlanteada": "Si los importes correspondientes a estos activos sobrevenidos quedan fuera...",
  "docId": 71136,
  "detailUrl": "https://petete.tributos.hacienda.gob.es/consultas/do/document?docId=71136&tab=2",
  "textoCompleto": "DIRECCIÓN GENERAL DE TRIBUTOS\n..."
}

TEAC Histórica (cuando esté disponible)

{
  "source": "TEAC_HISTORICA",
  "numeroResolucion": "00/04976/2023/00/00",
  "fecha": "15/06/2024",
  "vocalia": "Vocalía 1ª",
  "unificacionCriterio": false,
  "asunto": "IRPF. Rendimientos del capital inmobiliario.",
  "criterio": "Los gastos de reparación y conservación del inmueble arrendado...",
  "referenciasNormativas": "Ley 35/2006, art. 23",
  "conceptos": ["IRPF", "Capital inmobiliario"],
  "textoCompleto": "TRIBUNAL ECONÓMICO-ADMINISTRATIVO CENTRAL\n..."
}

El campo textoCompleto solo se incluye cuando fetchDetails: true.

Flujo recomendado en dos fases

Fase 1 — Búsqueda rápida: metadatos y resumen.

{
  "source": "DYCTEA_DGT",
  "searchText": "operaciones vinculadas",
  "dycteaUnidad": "00",
  "dycteaMaxPages": 5,
  "dgtMaxPages": 5,
  "fetchDetails": false
}

Fase 2 — Texto íntegro: activa fetchDetails filtrando por la fuente concreta.

{
  "source": "DYCTEA",
  "searchText": "operaciones vinculadas",
  "dycteaUnidad": "00",
  "fetchDetails": true
}

Conceptos tributarios — TEAC Histórica (nivel 1)

⚠️ Solo relevante cuando TEAC Histórica esté disponible.

Código	Concepto
01	Impuesto sobre la Renta de las Personas Físicas (IRPF)
02	Impuesto sobre Sociedades (IS)
03	Impuesto sobre el Valor Añadido (IVA)
04	Impuestos Patrimoniales (IP, ISD, ITP y AJD)
05	Tráfico Exterior (Aduanas e importaciones)
06	Impuestos Especiales (IIEE: hidrocarburos, alcohol, tabaco…)
07	Otros Tributos y Exacciones
08	Procedimientos de Gestión
09	Procedimiento Económico-Administrativo
10	Ley General Tributaria (LGT)
11	Clases Pasivas
XX	Todos los conceptos (por defecto)

Unidades resolutorias — DYCTEA

Código	Unidad
00	TEAC — Tribunal Económico-Administrativo Central
12	TEAR Andalucía
24	TEAR Cataluña
28	TEAR Madrid
32	TEAR Comunidad Valenciana
48	TEAR País Vasco
(vacío)	Todas las unidades

Ecosistema legaltech — actores relacionados

Actor	Fuente	Tipo de documentos
legaltech/hacienda ← este actor	DYCTEA + DGT (+ TEAC Histórica cuando disponible)	Doctrina administrativa tributaria, criterios vinculantes, consultas DGT
legaltech/aepd	AEPD	Resoluciones y guías de protección de datos
legaltech/cendoj	CENDOJ (CGPJ)	Sentencias y autos del sistema judicial español
legaltech/tribunal-constitucional	Tribunal Constitucional	Sentencias del TC, recursos de amparo
legaltech/tjue	Tribunal de Justicia de la UE (CURIA)	Sentencias, autos y conclusiones del TJUE

Guía de derivación

• Doctrina tributaria del TEAC/TEAR, criterios DYCTEA, IVA, IRPF, IS, procedimientos tributarios → legaltech/hacienda con source: "DYCTEA"
• Consultas vinculantes de la DGT (V-XXXX-YY) → legaltech/hacienda con source: "DGT"
• Ambas fuentes combinadas → legaltech/hacienda con source: "DYCTEA_DGT" (por defecto)
• Protección de datos, RGPD, LOPDGDD, sanciones de la AEPD → legaltech/aepd
• Jurisprudencia civil, penal, laboral, contencioso-administrativa española → legaltech/cendoj
• Derechos fundamentales, inconstitucionalidad, recursos de amparo → legaltech/tribunal-constitucional
• Derecho europeo, directivas, reglamentos UE, cuestiones prejudiciales → legaltech/tjue
• Intersección tributario + derecho europeo (e.g. IVA, ayudas de estado) → combinar legaltech/hacienda y legaltech/tjue