Catálogos - Guía de Ayuda

📋 ¿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 — $1,158.84 MXN (IVA incluido)

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

📦 Descarga única — $230.84 MXN (IVA incluido)

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 política de la plataforma: 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.

🗂️ Referencia de campos de los formularios

Todos los campos que te pide esta app, pantalla por pantalla. «Obligatorio» significa que el formulario no te deja guardar sin llenarlo. Las listas que dicen «de tu negocio» se llenan con lo que tú mismo diste de alta.

📝 Plan de pago

Campo	Tipo	¿Obligatorio?	Detalle
Nombre / empresa	Texto	Sí	—
Correo (recibirás tu clave)	Correo	Sí	Correo electrónico válido ([email protected]).
Correo (recibirás el enlace de descarga)	Correo	Sí	Correo electrónico válido ([email protected]).