Consultas vinculantes de la DGT (España) / Spanish DGT binding tax rulings

Obtenga las consultas vinculantes y generales de la Dirección General de Tributos (DGT, Ministerio de Hacienda) desde su buscador oficial, PETETE, con el texto completo de la contestación, la normativa citada separada por norma y artículo, y un modo monitor que entrega solo las consultas nuevas. El Actor no inicia sesión, no usa navegador y normalmente no necesita proxy.

Binding and general tax rulings issued by Spain's Dirección General de Tributos, from its official search engine, with the full answer, the cited legislation split into law and article, and a monitor mode for new rulings. English below.

Actor no oficial. No tiene relación con la Dirección General de Tributos ni con el Ministerio de Hacienda, que no participan, patrocinan ni apoyan este Actor. Origen de los datos: Ministerio de Hacienda.

---

Español

Para quién es

• Asesores fiscales y despachos que siguen la doctrina de la DGT sobre un impuesto, una norma o un tema.
• Departamentos fiscales de empresas que quieren una alerta semanal o mensual de consultas nuevas sobre IVA, IRPF, Impuesto sobre Sociedades o tributos locales.
• Editoriales jurídicas y equipos de datos que necesitan las consultas en JSON, con campos separados, en lugar de copiarlas del buscador.

Puede leer el dataset y el resumen de cada ejecución (registro OUTPUT) con la API de Apify o descargarlos en JSON, CSV o Excel.

Qué devuelve

Contenido (outputMode)	Cada resultado es	Evento
Texto completo (fullText, por defecto)	Una consulta completa: número, órgano, fecha de salida, normativa (texto y desglose por norma y artículos), descripción de hechos, cuestión planteada y contestación completa	Consulta
Solo metadatos (metadata)	Número, descripción de hechos y cuestión planteada, tal como aparecen en la lista de resultados del buscador oficial. Sin órgano, fecha, normativa ni contestación	Metadatos de consulta

Todos los resultados incluyen url (enlace que abre la consulta en el buscador oficial), fuente ("Origen de los datos: Ministerio de Hacienda…"), baseActualizadaA (fecha de actualización que indica la fuente), condicionesReutilizacion y aviso de no afiliación.

Filtros

Todos los filtros se combinan entre sí: una consulta debe cumplirlos todos.

Campo	Qué hace
keywords	Texto a buscar. Las palabras de una misma línea deben aparecer todas, en cualquier orden. Para una frase exacta, escríbala entre comillas: "vivienda habitual". keywordsMatch: all (todas las líneas) o any (alguna). keywordsField: textoLibre (toda la consulta, incluida la contestación), cuestion o hechos. Admite los operadores del buscador oficial: .Y, .O, .NO, * (cualquier terminación) y ? (un carácter).
consultaNumbers	Números Vxxxx-aa (vinculantes) o xxxx-aa (generales). También acepta V123-25 o V0123/25.
dateFrom, dateTo	Fecha de salida, inclusive (AAAA-MM-DD). Sin fechas, puede usar recentDays.
organos	Subdirección General que firma. Atajos: IRPF, IS, IVA, INTERNACIONAL/IRNR, LOCALES, PATRIMONIALES/ITP/ISD, ESPECIALES/IIEE, FINANCIERAS. También acepta el nombre, por ejemplo SG de Tributos Locales.
impuestos	Impuesto citado en la normativa. Atajos: IRPF, IVA, IS, ITP, ISD, IRNR, LOCALES, IIEE, IP, LGT. Cada atajo incluye las siglas y la ley principal, porque la normativa se escribe de forma distinta según el año de la consulta.
normativa	Norma citada: Ley 35/2006, RD 439/2007, Ley 37/1992. Con artículos: Ley 35/2006 art. 33, 34. Con texto completo, solo se entregan y cobran las consultas que citan esos artículos de esa norma.
onlyCriterioInteres	Solo consultas que la DGT marca como criterio de interés general (desde 2022).
tipo	vinculantes (por defecto), generales o ambas.

Consultas vinculantes de 2025 por órgano: Impuestos sobre la Renta de las Personas Físicas 1.204, Impuestos sobre el Consumo 524, Impuestos sobre las Personas Jurídicas 303, Impuestos Patrimoniales 142, Tributación de las Operaciones Financieras 142, Tributos Locales 75, Impuestos Especiales 66 y Fiscalidad Internacional 50.

Precio (pago por evento)

Evento	Precio	Se cobra por
Inicio	US$0,05	Una vez por ejecución, cuando la base oficial responde a la primera búsqueda. También en modo monitor, aunque no haya consultas nuevas
Consulta	US$0,008	Cada consulta con texto completo entregada en el dataset
Metadatos de consulta	US$0,002	Cada consulta entregada solo con metadatos

No se cobra una consulta que no se pudo descargar ni una que no cumple el filtro de artículos. Si la fuente no responde, tampoco se cobra el inicio. Por ejemplo, 50 consultas con texto completo cuestan US$0,05 + 50 × US$0,008 = US$0,45.

maxResults limita los resultados por ejecución (100 si lo deja vacío; el formulario propone 10; máximo 5.000). Si fija un máximo a cobrar por ejecución, el Actor descarga solo las consultas que caben en ese importe y termina con éxito al alcanzarlo, con los resultados ya entregados. El máximo debe ser de al menos US$0,06 (inicio y una consulta); si no alcanza, el Actor no consulta la fuente.

Ejemplo: búsqueda con texto completo

{
    "keywords": ["criptomonedas"],
    "dateFrom": "2026-01-01",
    "dateTo": "2026-08-31",
    "outputMode": "fullText",
    "maxResults": 3
}

Resultado real, obtenido el 4 de octubre de 2026 (aquí se recortan los hechos y la contestación; el dataset los incluye completos):

{
    "numeroConsulta": "V5346-26",
    "tipo": "vinculante",
    "textoCompleto": true,
    "organo": "SG de Impuestos sobre la Renta de las Personas Físicas",
    "fechaSalida": "2026-07-28",
    "normativa": [
        "Ley 35/2006 Impuesto sobre la Renta de las Personas Físicas IRPF - 33 - 34 - 35 - 36"
    ],
    "normas": [
        {
            "texto": "Ley 35/2006 Impuesto sobre la Renta de las Personas Físicas IRPF - 33 - 34 - 35 - 36",
            "referencia": "Ley 35/2006",
            "titulo": "Impuesto sobre la Renta de las Personas Físicas IRPF",
            "articulos": ["33", "34", "35", "36"]
        }
    ],
    "descripcionHechos": "La consultante fue víctima durante el año 2024 de una estafa financiera en la que los autores del fraude utilizaron ilícitamente sus datos personales para abrir, sin su consentimiento, una cuenta en u […]",
    "cuestionPlanteada": "Determinación del momento de imputación temporal, a efectos del IRPF, de la pérdida patrimonial derivada de la estafa sufrida.",
    "contestacion": "La determinación legal del concepto de ganancias y pérdidas patrimoniales se recoge en el artículo 33.1 de la Ley 35/2006, de 28 de noviembre, del Impuesto sobre la Renta de las Personas Físicas […]",
    "caracteresContestacion": 7613,
    "otrosCampos": null,
    "url": "https://petete.tributos.hacienda.gob.es/consultas/?num_consulta=V5346-26",
    "docId": "70215",
    "extraidoEn": "2026-10-05T01:26:41Z",
    "fuente": "Origen de los datos: Ministerio de Hacienda (Dirección General de Tributos, buscador PETETE)",
    "fuenteUrl": "https://petete.tributos.hacienda.gob.es/consultas/",
    "baseActualizadaA": "2026-08-31",
    "condicionesReutilizacion": "https://www.hacienda.gob.es/es-ES/Paginas/AvisoLegal.aspx",
    "aviso": "Actor no oficial. Sin afiliación con la Dirección General de Tributos ni con el Ministerio de Hacienda, que no participan, patrocinan ni apoyan esta reutilización. Texto reproducido sin alterar su sentido; consulte la fuente oficial."
}

La contestación conserva un párrafo por línea. normas desglosa cada norma citada y sus artículos; el texto original se mantiene en normativa y en normas[].texto.

Ejemplo: solo metadatos de un órgano y un año

{
    "organos": ["LOCALES"],
    "dateFrom": "2025-01-01",
    "dateTo": "2025-12-31",
    "outputMode": "metadata",
    "maxResults": 25
}

{
    "numeroConsulta": "V2619-25",
    "tipo": "vinculante",
    "textoCompleto": false,
    "descripcionHechos": "Terrenos clasificados urbanísticamente en el municipio donde están ubicados como suelo rústico de asentamiento irregular. Sin embargo, dichos terrenos figuran en el Catastro como terrenos de naturaleza urbana al cumplir las condiciones previstas en el artículo 7.2.d) del TRLCI.",
    "cuestionPlanteada": "Se plantea si la transmisión de los terrenos debe considerarse sujeta al Impuesto sobre el Incremento de Valor de los Terrenos de Naturaleza Urbana.",
    "url": "https://petete.tributos.hacienda.gob.es/consultas/?num_consulta=V2619-25",
    "docId": "58762",
    "fuente": "Origen de los datos: Ministerio de Hacienda (Dirección General de Tributos, buscador PETETE)",
    "baseActualizadaA": "2026-08-31"
}

Ejemplo: consultas por número

{
    "consultaNumbers": ["V5346-26", "V2539-25", "V0001-97"],
    "outputMode": "fullText"
}

Alerta de consultas nuevas (modo monitor)

{
    "impuestos": ["IVA"],
    "onlyNewSinceLastRun": true,
    "monitorStoreName": "alerta-iva",
    "outputMode": "fullText",
    "maxResults": 200
}

Programe la tarea en Apify (Schedules) de forma semanal o mensual. Cada ejecución revisa las consultas más recientes por fecha de salida, entrega y cobra solo los números que no se entregaron antes con el mismo monitorStoreName y los guarda en ese almacén. Si no indica fechas, el monitor revisa los últimos 120 días de fecha de salida (recentDays lo cambia). Una consulta que no se pudo descargar no se marca como entregada y se vuelve a intentar en la siguiente ejecución.

Tenga en cuenta que el inicio (US$0,05) se cobra en cada ejecución, aunque no haya consultas nuevas. Como la base oficial se actualiza una vez al mes, una ejecución semanal suele encontrar novedades solo una vez al mes.

Volumen

Consultas vinculantes por año de fecha de salida, contadas en el buscador oficial el 4 de octubre de 2026:

Año	2016	2017	2018	2019	2020	2021	2022	2023	2024	2025	2026 (hasta 31/08)
Vinculantes	5.485	3.322	3.293	3.548	3.703	3.238	2.677	3.361	2.660	2.646	2.192

Las consultas generales son pocas (12 en 2025 y 9 en 2026).

Limitaciones

• Actualización mensual con retraso. La base oficial se actualiza por lotes mensuales, con más de un mes de retraso. El 4 de octubre de 2026 indicaba "actualizada a 31/08/2026". Una consulta aparece en el dataset solo cuando la fuente la publica.
• Consultas lentas. La fuente puede tardar cerca de un minuto por consulta con texto completo; una búsqueda grande puede demorarse varios minutos. El modo solo metadatos es mucho más rápido. Si ve muchos avisos de la fuente, baje concurrency a 1 o 2.
• El monitor cobra el inicio en cada ejecución. En modo monitor, el inicio (US$0,05) se cobra en cada ejecución aunque no haya consultas nuevas, siempre que la fuente responda.
• Metadatos sin fecha ni órgano. El modo solo metadatos no trae órgano, fecha de salida ni normativa, porque la lista de resultados de la fuente no los muestra.
• Normativa con formatos distintos. La forma de citar la normativa cambia según el año de la consulta. El filtro por artículos se aplica con texto completo; en algún caso un formato poco habitual puede no reconocerse.
• Numeración de 2026. Los números V1690-26 a V4999-26 no existen, por un cambio de numeración que indica la propia fuente.

Fuente y condiciones de reutilización

• Fuente: PETETE, buscador de consultas de la Dirección General de Tributos, también listado en datos.gob.es.
• Condiciones: aviso legal del Ministerio de Hacienda, "Condiciones generales para la reutilización de información". Permiten la reutilización comercial y no comercial siempre que se cite la fuente ("Origen de los datos: Ministerio de Hacienda"), se indique la fecha de última actualización, no se altere el sentido de la información y no se sugiera que el Ministerio participa, patrocina o apoya la reutilización.
• Cada resultado incluye la cita, la fecha de actualización de la fuente (baseActualizadaA) y el enlace a las condiciones. Si redistribuye los datos, consérvelos.
• El texto se reproduce tal como lo publica la fuente, sin resúmenes ni cambios de redacción.
• Las consultas vinculantes obligan a la Administración en relación con quien las presentó (art. 89 de la Ley 58/2003, General Tributaria). Este Actor no presta asesoramiento fiscal; compruebe siempre la fuente oficial.

---

English

Who it is for

• Tax advisers and firms tracking DGT doctrine on a tax, a law or a topic.
• In-house tax teams that want a weekly or monthly alert of new rulings on VAT, personal income tax, corporate tax or local taxes.
• Legal publishers and data teams that need the rulings as JSON with separate fields.

What you get

• Full text (outputMode: fullText, default; event Consulta): ruling number, issuing body (organo), issue date (fechaSalida), cited legislation (normativa, plus normas split into law and articles), facts, question and the full answer (contestacion).
• Metadata only (outputMode: metadata; event Metadatos de consulta): number, facts and question from the official result list. Much faster; no issuing body, date, legislation or answer.
• Every item includes url (opens the ruling in the official search engine), the attribution fuente, baseActualizadaA, the reuse-conditions link and a no-affiliation notice.

Field names are in Spanish. Text is kept as published.

Filters (all combined)

keywords (words on one line must all appear; quotes for an exact phrase; keywordsMatch all/any; keywordsField textoLibre/cuestion/hechos), consultaNumbers (V1234-25), dateFrom/dateTo or recentDays (issue date), organos (shortcuts IRPF, IS, IVA, INTERNACIONAL, LOCALES, PATRIMONIALES, ESPECIALES, FINANCIERAS), impuestos (IRPF, IVA, IS, ITP, ISD, IRNR, LOCALES, IIEE, IP, LGT), normativa (Ley 35/2006, or Ley 35/2006 art. 33, 34 to keep only rulings citing those articles of that law), onlyCriterioInteres, tipo (vinculantes, generales, ambas).

Pricing (pay per event)

Event	Price	Charged for
Inicio (start)	US$0.05	Once per run, after the official database answers the first search. Also in monitor mode when nothing is new
Consulta (ruling)	US$0.008	Each full-text ruling delivered to the dataset
Metadatos de consulta (ruling metadata)	US$0.002	Each metadata-only ruling delivered to the dataset

Rulings that fail to download or fail the article filter are not charged. Example: 50 full-text rulings cost US$0.05 + 50 × US$0.008 = US$0.45. With a maximum charge per run, the Actor only downloads what fits and finishes successfully when it is reached. The maximum charge must be at least US$0.06.

Monitor mode

Set onlyNewSinceLastRun: true and one monitorStoreName per alert, then schedule the task. Each run delivers and charges only ruling numbers not delivered before with that store. Without dates, it checks the last 120 days of issue dates.

Limitations

• The official database is updated in monthly batches with more than a month of lag (on 4 Oct 2026 it said "updated to 31/08/2026").
• Some queries are slow: the source can take about a minute per full-text ruling, so a large search can take several minutes. Metadata mode is much faster.
• Monitor mode charges the start fee (US$0.05) on every run, even when there is nothing new.
• Metadata-only results have no issuing body, issue date or legislation.

Volume

About 2,600–3,400 binding rulings per year (2,646 in 2025; 2,192 in 2026 up to 31 Aug).

Source and reuse conditions

Source: PETETE, the official search engine of the Dirección General de Tributos. Reuse is allowed for commercial and non-commercial purposes under the Ministerio de Hacienda legal notice: cite "Origen de los datos: Ministerio de Hacienda", state the last update date, do not distort the meaning and do not suggest that the Ministry takes part in, sponsors or supports the reuse. Each item carries this attribution. This Actor is not affiliated with the DGT or the Ministerio de Hacienda and is not tax advice.