Catálogos

Los catálogos oficiales de México en una sola API: CIE-10, medicamentos CUMS, productos por código de barras (EAN-13/GTIN), SAT CFDI 4.0 (ClaveProdServ / ClaveUnidad) y códigos postales SEPOMEX.

Ayuda disponible solo en español (decisión del dueño).

📋 ¿Qué hace este módulo?

La API de Catálogos sirve los datos oficiales y de referencia de México a través de un solo endpoint REST: catálogos clínicos (CIE-10, CUMS), productos de consumo por código de barras, claves y unidades del SAT CFDI 4.0, y códigos postales SEPOMEX. La búsqueda es gratis para todos (con límite por IP); la descarga completa del dataset es un beneficio de pago. Cada respuesta incluye metadatos de fuente y versión.

🩺 CIE-10 (ICD-10)

14,388 códigos en español con búsqueda tolerante (acentos, errores de tipeo, sinónimos).

💊 Medicamentos CUMS

2,113 claves oficiales del CNIS con la descripción oficial verbatim.

🏷️ Productos por código de barras

Consultas EAN-13/GTIN y por bloque de segmento (botanas, refrescos, lácteos…).

🧾 SAT CFDI 4.0

52,513 ClaveProdServ + 2,418 ClaveUnidad del Anexo 20 oficial.

📍 Códigos postales SEPOMEX

159,164 asentamientos — servicio gratuito, nunca en los planes de pago.

🔑 Claves de pago

Clave anual con límites altos y descarga completa; descargas únicas por token.

📚 Catálogos

1

CIE-10 en español

Texto oficial de la OMS, códigos normalizados (A00.0…). La búsqueda acepta acentos, errores de tipeo y sinónimos coloquiales ("diabetis" → E11, "mal de orín" → N39).

2

Medicamentos — CUMS/CCB

Compendio Nacional de Insumos del CSG. `descripcion_oficial` es la verdad; nombre/concentración/presentación son auxiliares de búsqueda.

3

Productos por código de barras

Datos abiertos (dump de OpenFoodFacts, ODbL 1.0) curados por chzr.llc: nombre, marca y segmento por EAN-13/GTIN. Las consultas por bloque (segmento/marca/categoría) son el consumo tipo CDN.

4

SAT CFDI 4.0

Archivo oficial catCFDI: claves de producto/servicio (8 dígitos) y unidades de medida (UN/CEFACT), con vigencia y palabras similares.

5

SEPOMEX

Códigos postales oficiales de Correos de México → asentamientos. Servicio gratuito; la fuente prohíbe su comercialización.

🔌 Endpoints (GET, JSON)

URL base: https://chzr.llc/saas/catalogos/api.php

r=version

Fuentes, versiones y totales de cada catálogo.

r=cie10&q=…

Búsqueda tolerante; o &code=E11.9 exacto.

r=cums&q=…

Búsqueda de medicamentos; o &code=010.000.0104.00.

r=producto&code=75007614

Un producto por código de barras.

r=productos&segmento=…

Consulta por bloque (segmento/marca/categoría/q, paginada).

r=claveprodsrv&code=…|&q=…

Clave de producto/servicio SAT, exacta o búsqueda.

r=claveunidad&code=H87|&q=…

Unidad de medida SAT, exacta o búsqueda.

r=sepomex&cp=91855

Código postal → asentamientos (gratis).

r=export&formato=csv

Descarga completa (de pago: clave o token de un solo uso).

🆓 Búsqueda gratuita

Sin registro: 120 peticiones por IP cada 10 minutos. CORS abierto, respuestas JSON con metadatos de fuente. Las consultas por bloque de r=productos requieren al menos un filtro — la descarga completa del dataset sigue siendo de pago.

💳 Planes de pago

🗓️ Plan API Anual — $999 MXN + IVA

600 peticiones/min, descarga completa CSV incluida, vigencia 1 año. La clave llega por correo al momento de pagar por PayPal.

📦 Descarga única — $199 MXN + IVA

Un enlace de un solo uso al CSV completo (CIE-10 + CUMS + Productos + SAT). Sin suscripción.

Cómo funciona: subscribe.php genera un secreto del lado del cliente; el IPN de PayPal verifica el pago y activa la clave/token — no se escribe nada antes de confirmar el pago.

📍 SEPOMEX — servicio gratuito

Los códigos postales se sirven gratis para todos (con límite por IP), por decisión del dueño: Correos de México prohíbe expresamente comercializar este catálogo, por lo que nunca forma parte de los planes de pago ni del export. Usa r=sepomex&cp=91855 para listar los asentamientos de un código postal.

📄 Licencias y atribución

CIE-10 y CUMS son datos oficiales de la OMS y del CSG (CNIS). Los productos provienen del dump de OpenFoodFacts (ODbL 1.0 / DbCL 1.0 — atribución y share-alike requeridos). Los datos SAT y SEPOMEX son oficiales (Anexo 20 / Correos de México). La API cobra por el servicio y la curación, nunca por los datos.

🔧 Solución de Problemas

r=export devuelve 403 — la descarga completa es un beneficio de pago: usa tu clave anual (&key=…) o un token de un solo uso (&token=…).
r=productos devuelve 400 — las consultas por bloque necesitan al menos un filtro (segmento, marca, categoría o q).
429 Too Many Requests — alcanzaste el límite por IP (120 peticiones / 10 min). Espera o usa una clave de pago (600 peticiones/min).
404 en un código — verifica el formato: CIE-10 con el código exacto (E11.9), SAT de 8 dígitos, CUMS con puntos, productos con el EAN-13 completo.