Columna

Tipo

Descripción

Unidad

cik

String

Central Index Key SEC, 10 dígitos zero-padded. Pivote para joinear con registro y filings.

—

taxonomy

String

Taxonomía XBRL: 'ifrs-full' (FPI), 'us-gaap' (Domestic), 'dei' (entity info), 'srt' (supplemental).

—

concept

String

Nombre del concepto XBRL (ej. 'Revenue', 'Equity', 'OperatingIncomeLoss'). Filtrar combinado con taxonomy para evitar duplicación.

—

period_start

Date

Inicio del período reportado (income statement). NULL para items point-in-time (balance sheet).

ISO 8601 YYYY-MM-DD

period_end

Date

Fin del período reportado. Para balance sheet items es la fecha del snapshot.

ISO 8601 YYYY-MM-DD

fiscal_year

Int32

Año fiscal del valor reportado.

—

fiscal_period

String

Período fiscal: 'FY' (full year) / 'Q1' / 'Q2' / 'Q3'. NOTA: 'Q4' no existe en SEC EDGAR — el cuarto trimestre acumulado va en 'FY'.

—

value

Float64

Valor numérico del concepto en la unidad indicada.

—

unit

String

Unidad del valor: 'USD' / 'ARS' (ISO 4217), 'shares' (conteo), 'pure' (ratio sin unidad).

—

form

String

Tipo de filing que generó el valor (20-F / 10-K / 6-K / 8-K).

—

accession_number

String

Accession number del filing fuente (joinable con sec.empresas.filings).

—

snapshot_date

Date

Fecha de captura del snapshot (operacional cross-dataset).

ISO 8601 YYYY-MM-DD

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

Mismo concepto puede aparecer en múltiples taxonomies con valores distintos

Un concepto como "Revenue" puede reportarse en ifrs-full y también en dei. Los valores pueden diferir (ej. redondeado vs. exacto). Filtrar explícitamente por taxonomy en WHERE para evitar duplicación accidental en aggregaciones.

period_start es null para items point-in-time (balance sheet)

Los ítems de balance sheet (Assets, Equity, Liabilities) son snapshots de un momento (periodo_end). period_start será null. Para income statement items, period_start != null (rango temporal). Filtrar por NULL/NOT NULL si necesitás distinguir entre tipos.

fiscal_period 'Q4' NO existe en SEC EDGAR; el año completo se reporta como 'FY'

La SEC reporta FY / Q1 / Q2 / Q3 — no existe Q4. El cuarto trimestre acumulado va dentro del reporte anual FY. Nunca usar fiscal_period = 'Q4' en filtros; retornará cero filas. Para el año completo, usar fiscal_period = 'FY'; para el tercer trimestre acumulado, usar fiscal_period = 'Q3'.

Variabilidad de conceptos entre industrias

Bioceres (empresa pequeña de agribusiness) reporta ~60 conceptos. YPF (energía, consolidada) reporta ~289. Cuando filtres por concept = 'SomeMetric', validar que la empresa específica lo reporta antes de asumir fila vacía como "no aplica".

SEC EDGAR — Financial facts XBRL

Qué incluye