Monitoreo y Abastecimiento de Combustible en Bolivia (ANH / YPFB)

Base de datos unificada sobre oferta mayorista, inventario en tanques de surtidores y logística de distribución de hidrocarburos líquidos (Gasolina Especial, Diésel Oil, Gasolina Premium, Diésel ULS) en Bolivia, integrando las fuentes oficiales de supervisión de la Agencia Nacional de Hidrocarburos (ANH) y de despacho de Yacimientos Petrolíferos Fiscales Bolivianos (YPFB).

Contexto y Fuentes Institucionales

La cadena de suministro de combustibles en Bolivia cuenta con dos niveles de supervisión digital:

1. Despacho Mayorista y Logística (YPFB - consulta.ypfb.gob.bo):

  • *data_ypfb/despachos/.csv**: Registro detallado de cisternas despachadas desde plantas de almacenaje con placa de vehículo, volumen (L), estación receptora, timestamps y estado de confirmación SIGOPER.
  • *data_ypfb/programacion/.csv**: Nominaciones y cuotas programadas por estación de servicio con bandera de cumplimiento (atendida).
  • *data_ypfb/resumen/.csv**: Métricas agregadas por distrito comercial (programado, despachado, pendiente).
  • Telemetría GPS: Enlace con dispositivos telemáticos satelitales en ruta (https://nominac.kyros-tech.com/api/gps/publico/{placa}).

2. Inventario Minorista y Disponibilidad en Surtidores (ANH - abastecimiento.prod.anh.gob.bo):

  • *dataabastecimiento/.csv**: Snapshots periódicos con volumen continuo (saldolitros), clasificación cualitativa (saldoestado), ventas activas (conventa) y cisterna en descarga (despachoencurso).
  • *data_discrete/.csv**: Registro histórico de estados discretos (semanas 33 a 39 de 2026).
  • *data/.csv**: Serie histórica volumétrica semanal (marzo 2025 a agosto 2026).
  • stations.csv: Catálogo maestro georreferenciado de estaciones de servicio activas.
Observable JS via SDK
Ejecutando...

Estructura de Datasets

  • *data_ypfb/despachos/.csv**: Despachos de cisternas con placa, volumen, destino y confirmación logística.
  • *data_ypfb/programacion/.csv**: Cuotas asignadas por estación y verificación de entrega.
  • *data_ypfb/resumen/.csv**: Balances volumétricos distritales.
  • *data_abastecimiento/.csv**: Inventario volumétrico en tanques de surtidor, estado y geolocalización.
  • *data_discrete/.csv**: Niveles cualitativos semanales.
  • *data/.csv**: Telemedición histórica continua (2025-2026).
  • stations.csv: Directorio georreferenciado de estaciones de servicio.

Líneas de Investigación y Análisis

  • Cruce Oferta vs. Inventario: Correlación entre despacho de cisternas de YPFB y recuperación de saldo_litros en la ANH.
  • Cuellos de Botella Logísticos: Tiempos de tránsito entre salida de planta y recepción efectiva en estación.
  • Detección Temprana de Desabastecimiento: Identificación de estaciones con nominaciones incumplidas (atendida: false) y saldo bajo simultáneo.
  • Monitoreo de Rutas y Flota: Trazabilidad de cisternas mediante placas de despacho y telemetría GPS.
Recurso #1 • CSV

saldos_abastecimiento

Capturas periódicas con saldo continuo en litros, estado cualitativo, despacho en curso y metadatos de ubicación por estación.

Tríada: bolivia:bo-combustible:saldos_abastecimiento
Patrón particionado: https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data_abastecimiento/*.csv • Mostrando partición más reciente
Descargar Recurso (CSV) https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data_abastecimiento/202639.csv
policy: allow_all
Campo (Columna) Tipo Descripción
fecha_actualizacion datetime Marca temporal de captura del snapshot (zona horaria Bolivia UTC-4)
id_eess integer Identificador único de la estación de servicio (EESS)
fecha_actualizacion_sistema datetime Fecha y hora de actualización reportada por el sistema central de la ANH
id_producto_abs integer Código del producto (0: Gasolina Especial, 1: Diésel Oil, 2: Gasolina Premium, 3: Diésel ULS)
saldo_litros number Volumen disponible de combustible en tanques de la estación en litros
saldo_estado string Categoría de disponibilidad reportada (bajo, medio, alto)
con_venta boolean Indica si la estación registra transacciones de venta activas
fecha_ultima_venta datetime Marca temporal de la última venta registrada en surtidor
despacho_en_curso boolean Indica si existe una cisterna en ruta o descargando combustible
fecha_hora_despacho datetime Fecha y hora programada o registrada para el despacho
seguimiento_id string Código identificador de rastreo logístico del despacho
nombre string Razón social o nombre comercial de la estación de servicio
direccion string Dirección física de la estación de servicio
zona string Zona o barrio donde opera la estación
departamento_id integer Código departamental INE (1: Chuquisaca, 2: La Paz, 3: Cochabamba, 4: Oruro, 5: Potosí, 6: Tarija, 7: Santa Cruz, 8: Beni, 9: Pando)
lat number Latitud geográfica en coordenadas WGS84
lng number Longitud geográfica en coordenadas WGS84
Descargar
WHERE
GROUP BY MÉTRICA ORDEN

Exploración Interactiva en Cliente

Recurso: saldos_abastecimiento (CSV) • Motor DuckDB y proxy CORS automático

Tríada: bolivia:bo-combustible:saldos_abastecimiento
CLI (datamesh sql)
datamesh sql "SELECT * FROM 'bolivia:bo-combustible:saldos_abastecimiento' LIMIT 25"
Python SDK (DuckDB In-Memory)
import datamesh as dm

# Consulta unificada en 1 línea con DuckDB
res = dm.sql("""
SELECT *
FROM 'bolivia:bo-combustible:saldos_abastecimiento'
LIMIT 25
""")
print(res)
TypeScript SDK (Browser / Node)
import { datamesh } from '@datosbolivia/datamesh-client';

// Breve filtro
const res = await datamesh.query({
  resource_uri: 'bolivia:bo-combustible:saldos_abastecimiento',
  limit: 25
});
console.log(res);
Recurso #2 • CSV

ypfb_despachos

Despachos mayoristas de cisternas desde plantas de almacenaje de YPFB hacia estaciones de servicio y clientes directos.

Tríada: bolivia:bo-combustible:ypfb_despachos
Patrón particionado: https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data_ypfb/despachos/*.csv • Mostrando partición más reciente
Descargar Recurso (CSV) https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data_ypfb/despachos/202639.csv
policy: allow_all
Campo (Columna) Tipo Descripción
fecha_captura datetime Marca temporal de captura del snapshot (UTC-4)
fecha_datos date Fecha operativa a la que corresponden los despachos (YYYY-MM-DD)
distrito_id integer Identificador numérico del distrito comercial YPFB
distrito_codigo string Sigla o código del distrito comercial (ej. AMZ, LPZ, SCZ)
distrito_nombre string Nombre descriptivo del distrito comercial
producto_general string Familia general del combustible (Diesel o Gasolina)
producto_despachado string Denominación comercial exacta del producto despachado
familia string Subtipo o familia técnica del carburante
familia_codigo string Identificador codificado de familia
cliente string Nombre de la estación de servicio o cliente destinatario
estacion string Nombre estandarizado de la estación receptora
placa_despacho string Placa de control del camión cisterna
cantidad_despachada number Volumen despachado efectivamente en litros
unidad string Unidad de medida de volumen (L)
fecha_despacho_programado date Fecha programada inicialmente para el despacho
fecha_despacho_efectivo date Fecha en que se ejecutó el despacho en planta
fecha_despacho_efectivo_hora datetime Fecha y hora exacta con zona horaria del despacho en planta
despacho_confirmado boolean Confirmación oficial de salida de planta por sistema SIGOPER / ESTIGIA
fecha_despacho_difiere_de_programado boolean Indicador de reprogramación o desfase temporal
ambito string Clasificación de destino (Ciudad o Provincia)
grupo string Agrupación geográfica u operativa secundaria
gps boolean Indica si la cisterna cuenta con dispositivo telemático de posicionamiento GPS
Descargar
WHERE
GROUP BY MÉTRICA ORDEN

Exploración Interactiva en Cliente

Recurso: ypfb_despachos (CSV) • Motor DuckDB y proxy CORS automático

Tríada: bolivia:bo-combustible:ypfb_despachos
CLI (datamesh sql)
datamesh sql "SELECT * FROM 'bolivia:bo-combustible:ypfb_despachos' LIMIT 25"
Python SDK (DuckDB In-Memory)
import datamesh as dm

# Consulta unificada en 1 línea con DuckDB
res = dm.sql("""
SELECT *
FROM 'bolivia:bo-combustible:ypfb_despachos'
LIMIT 25
""")
print(res)
TypeScript SDK (Browser / Node)
import { datamesh } from '@datosbolivia/datamesh-client';

// Breve filtro
const res = await datamesh.query({
  resource_uri: 'bolivia:bo-combustible:ypfb_despachos',
  limit: 25
});
console.log(res);
Recurso #3 • CSV

ypfb_programacion

Cuotas y volúmenes nominados programados para entrega por estación de servicio y estado de cumplimiento.

Tríada: bolivia:bo-combustible:ypfb_programacion
Patrón particionado: https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data_ypfb/programacion/*.csv • Mostrando partición más reciente
Descargar Recurso (CSV) https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data_ypfb/programacion/202639.csv
policy: allow_all
Campo (Columna) Tipo Descripción
fecha_captura datetime Marca temporal de captura del snapshot (UTC-4)
fecha_datos date Fecha operativa de la programación (YYYY-MM-DD)
distrito_id integer ID del distrito comercial YPFB
distrito_codigo string Código del distrito comercial
distrito_nombre string Nombre del distrito comercial
producto_general string Familia de producto (Diesel o Gasolina)
producto string Nombre del producto programado
familia string Familia técnica del combustible
familia_codigo string Código de familia
cliente string Estación de servicio nominada
volumen_programado number Volumen asignado en litros
canal string Canal de distribución (ej. VENTAS)
grupo string Grupo o subregión
atendida boolean Indicador de cumplimiento (true si la estación ya recibió el volumen asignado)
Descargar
WHERE
GROUP BY MÉTRICA ORDEN

Exploración Interactiva en Cliente

Recurso: ypfb_programacion (CSV) • Motor DuckDB y proxy CORS automático

Tríada: bolivia:bo-combustible:ypfb_programacion
CLI (datamesh sql)
datamesh sql "SELECT * FROM 'bolivia:bo-combustible:ypfb_programacion' LIMIT 25"
Python SDK (DuckDB In-Memory)
import datamesh as dm

# Consulta unificada en 1 línea con DuckDB
res = dm.sql("""
SELECT *
FROM 'bolivia:bo-combustible:ypfb_programacion'
LIMIT 25
""")
print(res)
TypeScript SDK (Browser / Node)
import { datamesh } from '@datosbolivia/datamesh-client';

// Breve filtro
const res = await datamesh.query({
  resource_uri: 'bolivia:bo-combustible:ypfb_programacion',
  limit: 25
});
console.log(res);
Recurso #4 • CSV

ypfb_resumen

Consolidado agregado por distrito comercial de volúmenes programados, despachados y pendientes.

Tríada: bolivia:bo-combustible:ypfb_resumen
Patrón particionado: https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data_ypfb/resumen/*.csv • Mostrando partición más reciente
Descargar Recurso (CSV) https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data_ypfb/resumen/202639.csv
policy: allow_all
Campo (Columna) Tipo Descripción
fecha_captura datetime Marca temporal de captura del snapshot (UTC-4)
fecha_datos date Fecha operativa (YYYY-MM-DD)
distrito_id integer ID del distrito comercial YPFB
distrito_codigo string Código del distrito comercial
distrito_nombre string Nombre del distrito comercial
producto_general string Familia de combustible (Diesel o Gasolina)
litros_programados number Total de litros programados para entrega en el distrito
litros_despachados number Total de litros despachados en cisternas en el distrito
litros_pendientes_confirmacion number Volumen en tránsito o pendiente de confirmación física
Descargar
WHERE
GROUP BY MÉTRICA ORDEN

Exploración Interactiva en Cliente

Recurso: ypfb_resumen (CSV) • Motor DuckDB y proxy CORS automático

Tríada: bolivia:bo-combustible:ypfb_resumen
CLI (datamesh sql)
datamesh sql "SELECT * FROM 'bolivia:bo-combustible:ypfb_resumen' LIMIT 25"
Python SDK (DuckDB In-Memory)
import datamesh as dm

# Consulta unificada en 1 línea con DuckDB
res = dm.sql("""
SELECT *
FROM 'bolivia:bo-combustible:ypfb_resumen'
LIMIT 25
""")
print(res)
TypeScript SDK (Browser / Node)
import { datamesh } from '@datosbolivia/datamesh-client';

// Breve filtro
const res = await datamesh.query({
  resource_uri: 'bolivia:bo-combustible:ypfb_resumen',
  limit: 25
});
console.log(res);
Recurso #5 • CSV

saldos_discretos

Registro histórico semanal con estados cualitativos de combustible y eventos de venta (semanas 33 a 39 de 2026).

Tríada: bolivia:bo-combustible:saldos_discretos
Patrón particionado: https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data_discrete/*.csv • Mostrando partición más reciente
Descargar Recurso (CSV) https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data_discrete/202639.csv
policy: allow_all
Campo (Columna) Tipo Descripción
fecha_actualizacion datetime Marca temporal de captura del snapshot (UTC-4)
id_eess integer Identificador de la estación de servicio
fecha_actualizacion_sistema datetime Fecha de reporte en el sistema de la ANH
id_producto_abs integer Código de producto (0: Gasolina, 1: Diésel, 2: Gasolina Premium, 3: Diésel ULS)
fecha_ultima_venta datetime Fecha y hora de última venta registrada
despacho_en_curso boolean Indica si hay despacho de cisterna activo
fecha_hora_despacho datetime Fecha y hora estimada del despacho
saldo_estado string Nivel de combustible reportado (bajo, medio, alto)
con_venta boolean Estado de venta activa en surtidor
Descargar
WHERE
GROUP BY MÉTRICA ORDEN

Exploración Interactiva en Cliente

Recurso: saldos_discretos (CSV) • Motor DuckDB y proxy CORS automático

Tríada: bolivia:bo-combustible:saldos_discretos
CLI (datamesh sql)
datamesh sql "SELECT * FROM 'bolivia:bo-combustible:saldos_discretos' LIMIT 25"
Python SDK (DuckDB In-Memory)
import datamesh as dm

# Consulta unificada en 1 línea con DuckDB
res = dm.sql("""
SELECT *
FROM 'bolivia:bo-combustible:saldos_discretos'
LIMIT 25
""")
print(res)
TypeScript SDK (Browser / Node)
import { datamesh } from '@datosbolivia/datamesh-client';

// Breve filtro
const res = await datamesh.query({
  resource_uri: 'bolivia:bo-combustible:saldos_discretos',
  limit: 25
});
console.log(res);
Recurso #6 • CSV

saldos_historicos

Serie histórica semanal continua de volúmenes en litros (2025 semana 11 a 2026 semana 31).

Tríada: bolivia:bo-combustible:saldos_historicos
Patrón particionado: https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data/*.csv • Mostrando partición más reciente
Descargar Recurso (CSV) https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/data/202631.csv
policy: allow_all
Campo (Columna) Tipo Descripción
fecha_actualizacion datetime Marca temporal de captura del snapshot (UTC-4)
id_eess integer Identificador de la estación de servicio
id_producto_bsa integer Código del producto en sistema BSA
saldo_octano number Volumen medido en litros por telemedición / sistema Octano
saldo_bsa number Volumen registrado en litros según el sistema B-SISA/BSA
saldo_planta number Volumen en planta o asignado en litros
Descargar
WHERE
GROUP BY MÉTRICA ORDEN

Exploración Interactiva en Cliente

Recurso: saldos_historicos (CSV) • Motor DuckDB y proxy CORS automático

Tríada: bolivia:bo-combustible:saldos_historicos
CLI (datamesh sql)
datamesh sql "SELECT * FROM 'bolivia:bo-combustible:saldos_historicos' LIMIT 25"
Python SDK (DuckDB In-Memory)
import datamesh as dm

# Consulta unificada en 1 línea con DuckDB
res = dm.sql("""
SELECT *
FROM 'bolivia:bo-combustible:saldos_historicos'
LIMIT 25
""")
print(res)
TypeScript SDK (Browser / Node)
import { datamesh } from '@datosbolivia/datamesh-client';

// Breve filtro
const res = await datamesh.query({
  resource_uri: 'bolivia:bo-combustible:saldos_historicos',
  limit: 25
});
console.log(res);
Recurso #7 • CSV

estaciones

Directorio georreferenciado de estaciones de servicio activas en Bolivia.

Tríada: bolivia:bo-combustible:estaciones
Descargar Recurso (CSV) https://raw.githubusercontent.com/sociedatos/bo-combustible/refs/heads/main/stations.csv
policy: allow_all
Campo (Columna) Tipo Descripción
id_eess_saldo integer ID de estación compatible con identificador de saldos
id_entidad integer Código de entidad regulada asignado por la ANH
latitud number Latitud geográfica WGS84
longitud number Longitud geográfica WGS84
nombreEstacion string Nombre comercial de la estación de servicio
direccion string Dirección o carretera de emplazamiento
id_departamento integer Código del departamento según codificación geográfica nacional
Descargar
WHERE
GROUP BY MÉTRICA ORDEN

Exploración Interactiva en Cliente

Recurso: estaciones (CSV) • Motor DuckDB y proxy CORS automático

Tríada: bolivia:bo-combustible:estaciones
CLI (datamesh sql)
datamesh sql "SELECT * FROM 'bolivia:bo-combustible:estaciones' LIMIT 25"
Python SDK (DuckDB In-Memory)
import datamesh as dm

# Consulta unificada en 1 línea con DuckDB
res = dm.sql("""
SELECT *
FROM 'bolivia:bo-combustible:estaciones'
LIMIT 25
""")
print(res)
TypeScript SDK (Browser / Node)
import { datamesh } from '@datosbolivia/datamesh-client';

// Breve filtro
const res = await datamesh.query({
  resource_uri: 'bolivia:bo-combustible:estaciones',
  limit: 25
});
console.log(res);