Products API
Referencia completa de la API de Products.
API de Productos
Introducción a la API de Productos — por qué NO existe un envelope único de respuesta, autenticación, paginación real, `extend` y permisos con RBAC apilado.
Modelo de datos — Product y ProductVariant
Forma real y persistida de Product y ProductVariant según el schema Mongoose, con las divergencias frente al tipo TS público y los sub-shapes del dominio.
Listar y buscar productos
Consulta el catálogo con filtros, búsqueda de texto libre, conteo y existencia por SKU — con la paginación real y el sistema de proyección ?extend=.
Consultar un producto
Consulta el detalle completo de un producto por ID o SKU, productos relacionados por similitud y el resumen de variantes/opciones.
Crear, actualizar y borrar productos
Crea productos, actualízalos (incluyendo el rename implícito de SKU) y bórralos — con la advertencia de que el borrado es irreversible.
Variantes y media
Consulta y actualiza variantes existentes, sube imágenes con URL prefirmada — y conoce qué partes del producto solo se gestionan por PUT completo.
Publicación a canales y enriquecimiento T1
Publica productos en un canal de venta (Shopify, MercadoLibre, Amazon, Walmart, T1...), consulta el estado de la publicación y revisa la vinculación T1/Sears/Sanborns.
Importación y exportación masiva (CSV)
Importa y exporta tu catálogo por CSV en modo síncrono o asíncrono, con validación previa, plantillas y seguimiento de progreso por jobId.
Operaciones masivas — rollback, Flow Editor, IA y categorización
Revierte una operación masiva, valida y ejecuta reglas del Flow Editor visual, transforma productos con IA y categoriza SKUs para un canal, con soporte 207 Multi-Status.
Materiales, insumos y lista de materiales (BOM)
Administra materiales, insumos, lista de materiales (BOM) y modificadores para manufactura, costeo y consumo de inventario en la preparación de productos.
Compatibilidad de vehículo (fitment)
Administra catálogos y nodos de compatibilidad automotriz (marca, modelo, año) y verifica qué productos aplican a un vehículo específico.
Colecciones
Administra colecciones de productos — agrupaciones jerárquicas para vitrinas, categorización comercial y curaduría manual o por reglas.
Categorías
Consulta el árbol de categorías de Fenicia, clasifica productos automáticamente para SAT/CFDI y marketplaces, y administra mapeos de categoría por canal.
Catálogo de Errores
Códigos de error del dominio Productos — errores tipados de la librería, códigos inline por endpoint sin convención única, y qué garantías existen realmente.