Metodología del Observatorio Orbe de negocios de terruño

Versión obs-1.1. Qué cuenta cada cifra, de dónde sale, cuándo se corta y cómo se protege a los negocios.

Observatorio independiente de Orbe. No es el Observatorio de Negocios Verdes del Ministerio de Ambiente ni un dato oficial. MinAmbiente no respalda ni está asociado a Orbe.

Qué es

Un observatorio independiente de Orbe, la red de negocios de terruño de Colombia (una iniciativa de Cúspide). Publica cifras de la oferta en dos partes que se leen por separado:

• Listado oficial. Los registros del Listado de Negocios Verdes de MinAmbiente (2014 a 2022, filas actualizadas el 22-jun-2023), normalizados por Orbe: cuántos hay por departamento, municipio, sector y autoridad, y qué tan fresco es el dato de cada autoridad.
• Uso de Orbe. Cuántas fichas reclamó su dueño, cuántos negocios se inscribieron desde cero, cuántos usan Orbe y cuántos productos publican. Mide el uso de Orbe, que es distinto del número de negocios verdes del país.

El Plan Nacional de Negocios Verdes asigna el Observatorio de Negocios Verdes al Ministerio de Ambiente con el DANE; este no es ese observatorio ni reemplaza sus cifras.

Fuentes

• Listado de Negocios Verdes, Ministerio de Ambiente y Desarrollo Sostenible, datos.gov.co (v29b-znjj), CC BY-SA 4.0. Registros de 2014 a 2022; filas actualizadas el 22-jun-2023. Exportación CSV descargada el 6-oct-2026: 4.199 filas, 3.337.821 bytes, sha256 0bad12ed9ba9796f8c36724d3a3741fc83ade21989def5c2dc6842094c68b863. Quien la descargue de datos.gov.co comprueba con ese sha256 que parte de la misma fuente.
• DIVIPOLA del DANE (datos.gov.co gdxc-w37w): códigos y cabeceras de municipios.
• Orbe: reclamos aprobados, inscripciones publicadas, acciones de los dueños y productos activos, leídos de la base de datos de Orbe en la fecha de corte.

Cómo se compara con otras cifras publicadas

La portada de negociosverdes.gov.co anunciaba 5.973 negocios verdes al consultarla el 5-oct-2026. El listado abierto v29b-znjj trae 4.199 filas. El portal publica la cifra sin la lista que la respalda, así que con los datos abiertos solo se puede contar el listado: esa es la cifra de este observatorio, con su fecha y su fuente. La tarjeta «Negocios en el listado oficial» de cada corte da esas 4.199 filas y dice aparte cuántos negocios se retiraron de Orbe a pedido propio.

Definiciones

Negocios en el listado oficial negocios_listado_fuente Listado oficial

Filas del Listado de Negocios Verdes de MinAmbiente (datos.gov.co v29b-znjj, registros 2014-2022, filas actualizadas el 22-jun-2023) que Orbe importó: un registro por negocio. Es un dato fijo de la fuente y queda igual en todos los cortes mientras el listado no cambie.

Se publica por: país. Protección: Ninguno: es un conteo de un dato público abierto.

Fichas del listado publicadas en Orbe negocios_listado Listado oficial

Fichas de Orbe que vienen del Listado de Negocios Verdes de MinAmbiente (datos.gov.co v29b-znjj, registros 2014-2022, filas actualizadas el 22-jun-2023) y que siguen publicadas al generar el corte (sin las retiradas u ocultas a pedido del negocio). Cuenta registros del listado: describe lo que registró cada autoridad entre 2014 y 2022. Es la cifra que da el CSV de negocios del corte al agruparlo.

Se publica por: país, departamento, municipio, autoridad ambiental, sector, categoría. Protección: Ninguno: es un conteo de un dato público abierto.

Fichas reclamadas en Orbe fichas_reclamadas Uso de Orbe

Fichas del listado cuyo reclamo aprobó Orbe hasta la fecha de corte y que siguen reclamadas al generar el corte. Cada ficha reclamada ya lo dice en su página. Mide el uso de Orbe.

Se publica por: país, departamento, municipio, autoridad ambiental, sector. Protección: Ninguno: cada ficha reclamada ya lo dice en su página.

Negocios «en camino» en Orbe negocios_en_camino Uso de Orbe

Negocios que se inscribieron desde cero en Orbe, sin un registro de una autoridad ambiental, y cuya inscripción publicó Orbe hasta la fecha de corte. Mide el uso de Orbe.

Se publica por: país, departamento, municipio. Protección: Ninguno: cada uno tiene su ficha pública.

Negocios activos en Orbe (90 días) negocios_activos_90d Uso de Orbe

Fichas reclamadas o «en camino» con al menos una acción de su dueño en Orbe en los 90 días que terminan en la fecha de corte: editar la ficha, subir una foto, publicar un producto, una acción registrada en su cuenta, o un pedido que quedó pagado o enviado. Mide el uso de Orbe.

Se publica por: país, departamento. Protección: Protegida (ver «Protección de los negocios»). Se publica para el país; por departamento, cuando Orbe tenga al menos 100 dueños y cada celda pase la auditoría.

Negocios con productos en Orbe negocios_con_productos Uso de Orbe

Fichas reclamadas o «en camino» con al menos un producto activo en pesos colombianos creado en Orbe hasta la fecha de corte. Mide el uso de Orbe.

Se publica por: país, departamento. Protección: Reservada con la misma regla que los activos. Cada ficha pública muestra sus productos, así que esta cifra también se puede contar recorriendo las fichas; la reserva protege la actividad de cada negocio en lo que publica el observatorio.

Productos publicados en Orbe productos_publicados Uso de Orbe

Número de productos activos en pesos colombianos de esos negocios. Cada ficha pública muestra sus productos y precios; el nombre y el precio de cada producto entran además a los datos abiertos del observatorio si su dueño lo autorizó (archivo orbe_productos, CC BY 4.0).

Se publica por: país, departamento. Protección: Reservada junto con la celda de negocios con productos, y además si la auditoría lo pide. Como los productos están en cada ficha pública, la reserva protege la actividad de cada negocio en lo que publica el observatorio.

Negocios con un registro cargado por su autoridad en Orbe negocios_con_carga_autoridad Uso de Orbe

Negocios con al menos un registro que una autoridad ambiental cargó directamente en Orbe, aparte del listado nacional, con fecha de corte hasta la del corte.

Se publica por: país, departamento, autoridad ambiental. Protección: Ninguno.

Frescura del dato por autoridad dias_desde_ultimo_corte Listado oficial

Días entre la fecha de corte del observatorio y el corte más reciente de cualquier fuente con negocios de esa autoridad. Hoy la única fuente es el listado nacional del 22-jun-2023.

Se publica por: autoridad ambiental. Protección: Ninguno.

Protección de los negocios

Las fichas reclamadas y las «en camino» son públicas, así que cualquiera sabe cuántos dueños hay en cada departamento. Las cifras de actividad y productos se protegen contando con eso:

• Regla de cada cifra. Una cifra de actividad o productos sale solo si en su celda hay al menos 5 negocios que cumplen la condición y al menos 5 que no la cumplen. Así «todos» y «ninguno» quedan siempre reservados. Ejemplo: si las fichas reclamadas de un departamento estuvieron todas activas, esa cifra se reserva.
• Pocos dueños, solo el país. Mientras Orbe tenga menos de 100 dueños (fichas reclamadas más «en camino»), estas cifras salen solo para el país. Desde 100, también por departamento. Por sector, municipio o autoridad no salen: cruzadas con las de departamento permitirían acotar celdas.
• Auditoría de restas y cotas. Para cada celda reservada, Orbe calcula el mínimo y el máximo que cualquiera puede deducir con lo que publica el observatorio: el total, las demás celdas, el número de dueños de cada celda y el archivo de productos abiertos. Ese rango tiene que dejar la celda a 5 o más de su valor por ambos lados; si la acerca más, se reserva otra celda (o el total) hasta lograrlo.
• Productos. Cada ficha reclamada muestra sus productos y precios, así que «con productos» y «productos» también se pueden contar recorriendo las fichas. Su reserva protege la actividad de cada negocio en lo que publica el observatorio; la protección propia del observatorio es la de los negocios activos.
• Solo «reservada». Una celda reservada dice «reservada», sin motivo y nunca como cero: el motivo también daría pistas del valor.
• Los conteos del listado, de las fichas reclamadas y de los negocios «en camino» no llevan umbral: cada uno de esos hechos ya está a la vista en la ficha pública del negocio.
• Las ventas no se publican en esta fase. Cuando entren, tendrán además la regla de dominancia (el mayor aporta como máximo la mitad de la celda) y el control de diferencias entre cortes.

Cortes trimestrales y reproducibilidad

El observatorio se corta el último día de cada trimestre (31-mar, 30-jun, 30-sep y 31-dic), cuando ese día ya terminó en Colombia. La página y la API leen solo cortes publicados, así que una cifra citada no cambia.

• Integridad. Cada archivo publica su sha256: con él compruebas que el archivo que tienes es el que publicó Orbe.
• Lo que cualquiera recalcula. Las cifras de fichas del listado publicadas en Orbe y de fichas reclamadas salen del CSV de negocios del corte: agrupando por cod_dpto, cod_mpio, autoridad_slug y sector se obtienen las mismas. Si un negocio se retira después del corte, la versión reemitida del CSV sale sin su fila y la cifra del corte se mantiene: la diferencia es el número de retiros que anotan la tabla de descargas y el registro de cambios. La columna fila_fuente enlaza cada fila con su fila en v29b-znjj, para cotejar lo que Orbe cambió.
• Lo que solo Orbe recalcula. Las cifras de actividad y productos salen de la base de datos de Orbe. Orbe guarda el insumo de cada corte y lo vuelve a calcular para comprobar que da los mismos archivos, byte por byte.
• Después de un retiro o una corrección. Orbe borra del insumo guardado los textos que ya no se publican (nombre, descripción, dirección de la ficha, productos) y conserva los campos con que se calculan las cifras. La comprobación sigue rehaciendo byte por byte las cifras, el GeoJSON y cada archivo vigente; la tabla original de negocios (o de productos) y su LEEME quedan como suprimidos. Los archivos reemitidos llevan versión y sha256 nuevos y una nota en el registro de cambios.

Las fechas de reclamo, inscripción y actividad se cortan a la medianoche de la fecha de corte. El estado de cada ficha (por ejemplo, si se retiró) es el que tiene cuando se genera el corte, pocos días después.

Cortes publicados: 30-sep-2026 (huella d4ce3c9897afe900…).

Datos abiertos

• orbe_cifras_AAAA-MM-DD.csv: todas las celdas del corte; las reservadas dicen «reservada».
• orbe_negocios_AAAA-MM-DD.csv: la tabla derivada del listado oficial, con las mismas reglas de las fichas: título neutro en los negocios de personas naturales, descripciones recortadas (y vacías en las fichas en revisión humana), código DIVIPOLA, autoridad normalizada, la clave de su fila en la fuente, si la ficha está reclamada y qué cambió Orbe en cada fila. Va sin el nombre del representante ni datos de contacto.
• orbe_productos_AAAA-MM-DD.csv: los productos y precios de los dueños que marcaron en su panel la casilla «Permito publicar mis productos y precios como datos abiertos (CC BY 4.0)». Producto y precio van con CC BY 4.0; la atribución es la ficha del negocio.
• orbe_municipios_AAAA-MM-DD.geojson: un punto por municipio en su cabecera DIVIPOLA, con los conteos.
• LEEME_AAAA-MM-DD.md: atribución, cambios, licencias, diccionario de columnas y sha256 de cada archivo.

Licencias. Lo que viene del listado y lo que calcula Orbe va con CC BY-SA 4.0, la licencia del listado. Lo que autoriza cada dueño va con CC BY 4.0, que permite incluirlo en un archivo CC BY-SA 4.0; por eso el archivo de productos en conjunto va con CC BY-SA 4.0, y quien use solo el producto y el precio puede hacerlo con CC BY 4.0. El diccionario dice la licencia de cada campo.

Lo demás que agrega cada dueño (fotos, presentación, contacto, nombre comercial) es suyo y queda fuera de los datos abiertos.

Los CSV van en UTF-8 con BOM, separados por comas; una celda que empieza con «=», «+», «-» o «@» lleva un apóstrofo delante para que ninguna hoja de cálculo la ejecute como fórmula.

Columnas de orbe_negocios

Columnas de orbe_productos

Columnas de orbe_cifras

Retiros y correcciones después de un corte

• Si un negocio pide su retiro, o se corrige un dato personal de su descripción, su nombre o la dirección de su ficha, la tabla de negocios de los cortes que lo traen deja de servirse en ese momento y se reemite con la versión nueva de la fila (o sin la fila). La API lo aplica de inmediato.
• Si un dueño quita la casilla de datos abiertos o retira su ficha, la tabla de productos se reemite sin sus productos; si su ficha cambia de dirección, con la dirección nueva.
• En los dos casos, Orbe borra también esos textos del insumo interno con que comprueba el corte.
• Cada reemisión lleva versión y sha256 nuevos y queda en el registro de cambios. Las cifras agregadas del corte se mantienen.

API sin clave

Solo lectura, JSON, CORS abierto, 60 solicitudes por minuto por IP. Para volumen, descarga el corte. Cada respuesta lleva la licencia y la fuente.

• GET /api/red/v1/cortes: cortes publicados con sus archivos, licencias y sha256.
• GET /api/red/v1/cifras?corte=&dimension=&clave=&metrica= (y &formato=csv).
• GET /api/red/v1/departamentos, /municipios?dep=, /autoridades: catálogos con sus conteos.
• GET /api/red/v1/negocios?dep=&mun=&aut=&sector=&cat=&reclamada=si|no&p=: la tabla derivada del listado, 100 por página (y &formato=csv).
• GET /api/red/v1/oportunidades?dep=: procesos de compra pública de alimentos abiertos (SECOP II).

Ejemplo: curl "https://orbe.top/api/red/v1/cifras?dimension=departamento&metrica=negocios_listado"

Lo que estas cifras describen

• El listado oficial describe los registros de 2014 a 2022 con corte del 22-jun-2023, hasta que cada autoridad cargue el suyo. El estado actual de cada negocio lo confirma su autoridad ambiental.
• Las cifras de uso de Orbe describen a los negocios que usan Orbe y se leen como tales, sin expandirlas al sector.
• «Activo» es una señal de uso de Orbe. Un pedido cuenta como acción si quedó pagado o enviado, con la fecha en que se creó el pedido.
• Las ventas, la demanda y los compradores llegan en una fase posterior, cuando haya dos cortes con volumen suficiente para pasar los umbrales.

Registro de cambios

• 7-oct-2026 · Publicación (corte del 30-sep-2026): Se publicó el corte del 30-sep-2026 (metodología obs-1.1).

Contacto y correcciones

Un dato mal de un negocio se corrige desde su ficha («Corregir o retirar»). Para el método, los archivos o la API, escribe a info@cuspide.com.co.