## Visión general

El **catálogo nativo** es tu base de productos dentro de ConversaLabs. Es donde registras cada ítem
con nombre, descripción, imágenes, precio y disponibilidad, organizas todo en **categorías** y
mantienes los datos que se usarán para sincronizar con WhatsApp y para enviar productos durante la
atención.

Tenerlo bien organizado es el primer paso: a partir de él sincronizas con Meta, envías productos en la
conversación y cobras pedidos. Aunque también uses plataformas externas, el catálogo nativo es la
fuente de la verdad dentro de la plataforma.

## Requisitos previos

- El módulo de **Catálogo y Comercio** habilitado para tu cuenta y rol de acceso.
- Permiso para gestionar el catálogo (crear/editar productos y categorías).
- Imágenes de los productos en un formato común (por ejemplo, JPG o PNG) y accesibles.

## Paso a paso

1. Abre el área de **Catálogo** de la plataforma.
2. Crea tus **categorías** para agrupar productos (por ejemplo, "Bebidas", "Servicios", "Cursos").
3. **Registra un producto**: indica nombre, descripción, categoría y su primera variante.
4. En cada variante, define nombre, SKU, precio y **opciones** como `Color: Azul` y `Talla: M`.
5. Usa las flechas para ordenar las variantes y elige exactamente una como **predeterminada**.
6. Agrega una o más **imágenes** al producto. Después puedes asignar una imagen del producto a cada
   variante; las variantes sin imagen usan la imagen principal.
7. Define disponibilidad e inventario cuando corresponda, guarda y repite para los demás productos.

## Configuración y opciones

- **Producto**: nombre, descripción, precio, categoría, disponibilidad, imágenes e identificadores
  (como SKU y enlace externo).
- **Categorías**: agrupación de productos que facilita la búsqueda y el armado de listas.
- **Imágenes**: una o más por producto; la primera suele usarse como destacada.
- **Variantes**: cada combinación vendible tiene nombre, opciones, posición, precio, existencias e
  imagen opcional. La variante predeterminada es la selección inicial en listas y envíos.
- **Archivar una variante**: el formulario de edición solo descarta variantes que aún no se han
  guardado. Archiva una variante guardada desde el detalle del producto después de confirmarlo y
  elige antes otra variante predeterminada. Se conservan el registro archivado y su historial de
  pedidos y pagos.
- **Imagen de variante**: solo se puede elegir en la galería del mismo producto. Si se elimina, la
  variante vuelve de forma segura a la imagen principal del producto.
- **Precio**: siempre en **unidades mayores** de la moneda (consulta la sección de consejos).
- **Baja automática de existencias**: cuando una venta activa queda **pagada**, se descuenta una sola
  vez la cantidad de cada variante con control de existencias. El cobro y el pedido de la misma venta
  comparten una identidad, por lo que los webhooks repetidos o ambos eventos no descuentan dos veces.
  El saldo se detiene en cero; las variantes sin control de existencias no cambian. Las importaciones
  y adopciones históricas tampoco modifican el saldo actual. Las existencias controladas usan unidades
  enteras: una línea fraccionaria falla de forma segura, sin redondear ni descontar parcialmente la
  venta, y queda visible en el Historial. Las cantidades fraccionarias de variantes sin control no
  afectan las existencias.
- **Informes**: la vista de informes separa el presupuesto cotizado de los ítems del negocio del valor
  **realizado** de los ítems de pedidos pagados. Las dos métricas no se suman y pueden diferir por descuentos,
  envío o pedidos aún no liquidados.

## Casos de uso

- Menú de un restaurante o cafetería con categorías y fotos.
- Catálogo de servicios (consultas, planes, paquetes) con precio por ítem.
- Lista de productos físicos de una tienda que vende por WhatsApp.
- Catálogo de infoproductos o cursos para enviar directamente al cliente.

## Consejos, límites y buenas prácticas

- **Precio en unidades mayores**: escribe `4,97` para indicar **R$4,97**. La plataforma **no** divide
  por 100 — el valor que registras es el valor mostrado y cobrado.
- El **total de un pedido** es la suma de `precio × cantidad` de cada ítem — también sin dividir por 100.
- Usa imágenes nítidas y accesibles públicamente: la sincronización con WhatsApp necesita poder
  descargarlas. Las imágenes alojadas en direcciones que quedan fuera de línea no se importarán.
- Mantén nombres y descripciones claros — aparecen para el cliente cuando envías el producto.
- En el informe, interpreta **Presupuesto** como la propuesta registrada en el negocio y **Realizado** como los
  ítems de pedidos pagados. Un ítem sin pedido pagado no se incluye en el realizado.

## Solución de problemas

- **Precio mostrado incorrecto (ej.: R$0,05 en vez de R$4,97)**: confirma que escribiste el valor en
  unidades mayores; no multipliques ni dividas por 100.
- **La imagen no aparece**: verifica que el archivo sea válido y que la dirección de la imagen esté
  accesible.
- **No se puede archivar o eliminar una variante**: elige primero otra variante activa como
  predeterminada.
- **Se muestra una imagen incorrecta para la variante**: edita el producto y elige una imagen de su
  galería para esa variante, o selecciona el uso de la imagen principal.
- **El producto no desaparece de las listas**: márcalo como no disponible en lugar de mantenerlo
  visible cuando no está a la venta.
- **Una venta pagada no redujo las existencias**: confirma que la línea de venta apunta a una variante
  con control de existencias activo. Los registros solo importados o adoptados como historial se
  conservan para consulta y, de forma intencional, no reescriben el saldo actual.
- **La reducción aparece como fallida después de los reintentos automáticos**: un administrador debe
  abrir **Catálogo → Importar y sincronizar → Historial**, localizar la ejecución **Reducción
  automática de existencias**, abrir el detalle y hacer clic en **Reintentar reducción de
  existencias**. La ejecución identifica el cobro o pedido y muestra solo una referencia técnica
  saneada, sin credenciales ni payload del gateway. El reintento es seguro: el recibo único de la venta
  impide una segunda reducción si el intento anterior terminó de forma ambigua. Si la ejecución está
  Pendiente o Procesando, espera al worker en vez de volver a hacer clic. Si el motivo indica una
  cantidad fraccionaria, corrige la línea de origen a unidades enteras — o desactiva el control solo
  cuando la variante sea legítimamente fraccionaria — antes de reintentar; la plataforma nunca redondea
  esa cantidad.

## Ver también

- [Visión general de Catálogo y Comercio](/hc/ajuda/articles/catalog-commerce-overview-es)
- [Sincronización y WhatsApp Business Catalog](/hc/ajuda/articles/catalog-commerce-sync-whatsapp-business-catalog-es)
- [Enviar producto y recibir pedidos en la conversación](/hc/ajuda/articles/catalog-commerce-enviar-produto-pedido-na-conversa-es)