# Extractos EUM — Documentación

> Plataforma mexicana de análisis (COA), trazabilidad y marketplace para derivados de cáñamo/cannabis
> ≤1% THC amparados. Estos docs sirven a sellers, sus IAs/integradores y consumidores. Contenido
> Markdown-first (Diátaxis); el marco regulatorio es informativo y no constituye asesoría legal.

## Empieza aquí
- [Empieza aquí](empieza-aqui.md): qué es Extractos EUM (marketplace + Smart COA), recorrido por audiencia (consumidor/seller/IA), conceptos en 30s.
- [Índice y estructura de docs](README.md): audiencias, mapa de secciones, reglas de contenido.

## Vender en EUM (sellers)
- [Vender en EUM](vender-en-eum.md): recorrido completo del seller — alta/onboarding, crear producto (simple/variable), clases de producto, Smart COA (subir/existente/analizar), etiquetado, precios, inventario y transferencias, guías (propia/comprar con crédito), estados, pagos/retenciones, decomiso neutral.

## Smart COA & Trazabilidad
- [Smart COA](smart-coa.md): el certificado de análisis que se verifica solo — COA + QR (contenido/lote) + CVV (autenticidad) + AI-ready. Cómo verificar un producto e endpoints públicos de verificación por API.

## Integraciones
- [Vende EUM en tu Shopify (Collective)](vende-en-tu-shopify.md): para RETAILERS con tienda Shopify — instala la app oficial "EUM Collective" (OAuth + verificación de propiedad), activa cuenta B2B (tier Wholesale + KYC INE + CSF), sincroniza catálogo (metafields, inventario/precio por webhook) y agrega el app block "EUM · Datos del Producto" (cannabinoides/envío/COA/recogida automáticos) a la página de producto. Wallet para cobro. Distinto de la API programática.
- [API & Automatización](api.md): endpoints públicos de verificación (sin auth) + API de integración (X-EUM-Api-Key, scopes orders/samples) + webhooks firmados HMAC-SHA256 (X-EUM-Signature, skew 5min).
- Verificar Smart COA: GET /api/v1/coas/:token · preview GET /api/v1/coas/preview/:token
- Verificar autenticidad CVV: GET|POST /api/v1/verify/:cvv
- Manual profundo de laboratorios: docs/api-manual/EUM-API-Manual-Labs.pdf

## Referencia
- [Referencia](referencia.md): glosario (cannabinoides, espectros, términos legales/sistema) + tablas de estados (producto, muestra, transferencia, guía).

## Cumplimiento y etiquetado
- [Índice de cumplimiento](cumplimiento/README.md): por clase de producto.
- [Trazabilidad regulatoria](cumplimiento/trazabilidad-regulatoria.md): cadena semilla→producto, fundamento SCJN (99/2022, 96/2022) + Art. 245-V LGS, condiciones de cumplimiento (≤1% THC por lote ISO/IEC 17025, aviso DIGIPRIS, etiqueta Art. 25 RCSPS), cómo Smart COA da la cadena de custodia.
- [Importación y aduana](cumplimiento/importacion-y-aduana.md): materia prima de cáñamo ≤1% THC = preparación alimenticia/química, NO medicamento (Nota 1 Cap.30 + GIR 3(b) carácter esencial); fracciones 2106.90.99 / 3824.99.99 / 2907.29.99; COA apostillado ISO/IEC 17025; criterio COFEPRIS import libre sin permiso previo; coherencia SAT (desaduanamiento libre); qué hacer en un PAMA.
- [Anatomía de etiqueta conforme](cumplimiento/etiquetado.md): PRIMERO distingue los 3 regímenes — materia prima (etiqueta de identificación Art.25 RCSPS/NOM-018, sin sellos) vs producto terminado (etiqueta de consumidor NOM-051 completa) vs ingrediente (cannabinoide declarado en la lista + COA ligado al COA padre). Luego, del producto terminado: elementos obligatorios (denominación español, ingredientes decreciente, nutrimental, sellos, lote/SKU/caducidad, distribuidor, QR+CVV+barcode), impreso vs QR, claims prohibidos, diferencias por categoría, checklist. Spec del motor Label Studio F5 (roles_etiquetado en el SoT).
- Por clase (con fuentes oficiales): [suplementos](cumplimiento/suplementos-alimenticios.md) · [confitería](cumplimiento/confiteria.md) · [alimento/grasas](cumplimiento/alimento-grasas.md) · [cosméticos NOM-141](cumplimiento/cosmeticos.md) · [cartucho/contenedor](cumplimiento/cartucho-contenedor.md) · [materia prima (cannabinoides)](cumplimiento/materia-prima.md).
- IMPORTANTE: catálogo MULTI-CANNABINOIDE, no solo CBD — CBD (aislado/amplio/completo), CBN, CBG, Δ9-THC ≤1%, Δ8-THC, HHC (9S/9R), HHC-O (9S/9R). Un mismo producto terminado puede combinar varios. Smart COA aplica a materia prima Y a producto terminado (gomitas, suplementos, grasas, cosméticos). Ejemplo en vivo: coa.extractoseum.com/coa/84971cae · tienda: coa.extractoseum.com/tienda.
- [Sellos NOM-051](cumplimiento/sellos-nom051.md): umbrales oficiales Tercera Fase (vigente 01/10/2025) — calorías ≥275kcal/100g o ≥70kcal/100mL, azúcares ≥10% energía, grasas sat ≥10%, grasas trans ≥1%, sodio ≥1mg/kcal o ≥300mg + leyendas edulcorantes/cafeína. Fuente: Manual COFEPRIS/PROFECO.
- Marco: Art. 245 fracc. V LGS (≤1% THC), jurisprudencia SCJN 99/2022; NOM-051 (sellos), NOM-141 (cosméticos), SCIAN/COFEPRIS por clase.

## Opcional
- [Plan de docs + cumplimiento](../plans/PUBLIC_DOCS_AND_COMPLIANCE_PLAN_2026-08.md): roadmap interno (contexto).