Columna

Tipo

Descripción

Unidad

fecha

Date

Primer dia del mes de produccion (YYYY-MM-01). Formato ISO 8601. Rango: 2009-01-01 a presente (con rezago de ~3 meses).

ISO 8601 YYYY-MM-DD

idconcepto

Int64

Codigo numerico estable del producto elaborado, segun la Secretaria de Energia. Verbatim de la fuente.

—

concepto

String

Nombre del producto elaborado, verbatim de la fuente (ej. 'Nafta Grado 2 (Super)', 'Gasoil Grado 3 (Ultra)', 'Fueloil'). Cuando la fuente publica concepto vacio (idconcepto 55/56/57), se sintetiza 'Concepto {idconcepto}'.

—

cantidad_m3

Float64

Volumen producido en el mes, agregado a nivel NACIONAL (SUM de todas las refinerias/empresas), en metros cubicos (m3). Solo valores > 0.

m3 (metros cubicos)

tipo_serie

String

'original' (fila granular por producto), 'desestacionalizada' o 'tendencia_ciclo' (series X-13ARIMA-SEATS, computadas de forma independiente por idconcepto). Para totales/agregados usar siempre tipo_serie='original'.

—

cantidad_m3_sa

Float64

Valor desestacionalizado en m3. NULL en filas 'original'. Solo presente para productos con >= 36 observaciones mensuales continuas.

m3 (metros cubicos)

var_mensual_sa_pct

Float64

Variacion mensual de la serie desestacionalizada, en decimal fraction (0.023 = 2,3%). Solo en filas tipo_serie='desestacionalizada'.

decimal fraction

var_interanual_sa_pct

Float64

Variacion interanual de la serie desestacionalizada, en decimal fraction (0.023 = 2,3%). Solo en filas tipo_serie='desestacionalizada'.

decimal fraction

snapshot_date

Date

Fecha del scrape de Almanac en que se capturo el snapshot. Campo operacional cross-dataset (ISO 8601 YYYY-MM-DD).

ISO 8601 YYYY-MM-DD

Pueden invalidar un análisis ingenuo. Documentadas como parte del control de calidad.

BOM UTF-8 en el CSV fuente

El archivo CSV publicado por datos.energia.gob.ar tiene un BOM UTF-8 (\xef\xbb\xbf) al inicio. El scraper lo elimina con _strip_bom() antes del parseo.

Concepto vacio para algunos idconcepto (55, 56, 57)

La fuente publica concepto vacio para los codigos 55, 56 y 57 (no documentados con nombre por la Secretaria de Energia al momento del scrape). El scraper sintetiza "Concepto {idconcepto}" para no perder la fila. Si la fuente publica el nombre real en el futuro, el scraper lo usaria verbatim (la sintesis solo aplica cuando concepto viene vacio).

Empresa ficticia de prueba incluida verbatim

La fuente incluye una empresa ("SOU" — "Petrolera SouthPole (Empresa ficticia de prueba)") con volumenes menores en varios periodos. Es un registro de prueba del propio sistema SESCO de la Secretaria de Energia, publicado igual que el resto de los datos oficiales. El scraper la incluye verbatim en el agregado nacional (no la excluye): su contribucion es marginal frente al total, y excluirla introduciria un criterio no documentado por la fuente.

Volumen agregado a nivel nacional, no por refineria/empresa

El CSV fuente reporta por refineria y empresa; este dataset SOLO persiste el agregado nacional por producto (SUM sobre todas las refinerias/empresas). No hay columna refineria ni empresa en el snapshot. Para el desglose por refineria, habria que ingestar el CSV fuente directamente (no cubierto por este dataset).

Total nacional: sumar solo tipo_serie='original'

Igual que en gas.produccion y petroleo.produccion-crudo, sumar TODAS las filas sin filtrar tipo_serie duplica el total (las filas 'desestacionalizada'/'tendencia_ciclo' son series alternativas del MISMO valor, no datos adicionales). Filtrar siempre por tipo_serie = 'original' para totales/agregados por concepto.

SA por producto, no un unico total nacional SA

A diferencia de los otros datasets de energia con SA (que tienen una sola fila SA nacional por fecha, con cuenca/tipo='TOTAL'), aca CADA idconcepto tiene su propia serie SA independiente. No existe una fila SA agregada de "todos los combustibles". Para una serie SA del total, el consumidor deberia sumar cantidad_m3 originales de todos los conceptos y desestacionalizar esa serie por su cuenta.

Rezago de publicacion de ~3 meses (T-3)

La Secretaria de Energia publica con un rezago tipico de ~3 meses. El cron corre mensualmente (dia 15) y el ultimo mes disponible suele ser 2-3 meses anterior a la fecha de scrape.

Producción de Combustibles Elaborados

Qué incluye