# Autenticación Source: https://docs.riqra.com/desarrolladores/api/authentication Cómo obtener y usar tu API key para autenticar requests. La API pública usa **API keys** como método de autenticación. Cada request debe enviar la key en el header `Authorization` con el esquema `Bearer`. ``` Authorization: Bearer rq_live_tu_api_key ``` ## Entornos El prefijo de la key indica el entorno con el que opera: | Prefijo | Entorno | Datos | | - | - | - | | `rq_live_` | Producción (`LIVE`) | Datos reales de tu organización | | `rq_test_` | Pruebas (`SANDBOX`) | Datos de prueba | Usa una key `rq_test_` mientras integras y cambia a `rq_live_` al pasar a producción. ## Verificar la key `GET /whoami` devuelve la organización, el entorno y los scopes de la key. Úsalo para confirmar que la key es válida antes de integrar el resto. ```bash theme={null} curl https://api-v2.riqra.com/public/v1/whoami \ -H "Authorization: Bearer rq_live_tu_api_key" ``` ## Errores de autenticación | Código | `code` | Causa | | - | - | - | | `401` | `UNAUTHENTICATED` | Falta el header `Authorization`. | | `401` | `INVALID_API_KEY` | La key no existe o tiene un prefijo inválido. | | `401` | `KEY_EXPIRED` | La key venció. | > [!WARNING] > > Trata la API key como una credencial secreta. Úsala solo desde tu backend, nunca en código de > cliente (web o móvil) donde quede expuesta. ## Permisos Cada key tiene un conjunto de **scopes** que define qué puede hacer. Revisa [Permisos](/desarrolladores/api/scopes). # Errores Source: https://docs.riqra.com/desarrolladores/api/errors El formato de error de la API y los códigos más comunes. Cuando una request falla, la API responde con un código HTTP de error y un cuerpo JSON con esta forma: ```json theme={null} { "error": { "code": "INSUFFICIENT_SCOPE", "message": "Missing required scope.", "requestId": "req_01J8..." } } ``` | Campo | Descripción | | - | - | | `code` | Código estable, legible por máquina. Úsalo para ramificar tu lógica. | | `message` | Descripción legible del problema. | | `requestId` | Identificador de la request. Inclúyelo al reportar un problema a soporte. | ## Códigos comunes | HTTP | `code` | Causa | | - | - | - | | `400` | `INVALID_REQUEST` | Parámetro, cuerpo o cursor inválido. | | `401` | `UNAUTHENTICATED` | Falta el header `Authorization`. | | `401` | `INVALID_API_KEY` | Key inexistente o con prefijo inválido. | | `401` | `KEY_EXPIRED` | La key venció. | | `403` | `INSUFFICIENT_SCOPE` | La key no tiene el scope requerido. | | `404` | `RESOURCE_MISSING` | El recurso no existe en esta organización. | | `404` | `NOT_FOUND` | La ruta no existe. | | `409` | `ORDER_ALREADY_INVOICED` | El pedido ya tiene una factura registrada. | | `409` | `ORDER_AWAITING_REVIEW` | El pedido está en `AWAITING_REVIEW`: el comercio debe aprobarlo antes de prepararlo, despacharlo o entregarlo. | | `422` | `INVALID_FULFILLMENT_TRANSITION` | El avance de preparación no es válido desde el estado actual. | | `422` | `ORDER_NOT_PLACED` | La operación requiere un pedido en `PLACED` (ni cancelado ni en `AWAITING_REVIEW`). | | `422` | `ORDER_NOT_SHIPPABLE` | Se intentó registrar guía en un pedido que no es de envío. | | `422` | `ORDER_CANCELLED` | El pedido está cancelado. | | `422` | `CANNOT_CANCEL_DISPATCHED_ORDER` | No se puede cancelar un pedido ya despachado. | | `501` | `NOT_IMPLEMENTED` | La capacidad existe pero todavía no está disponible. | | `500` | `INTERNAL_ERROR` | Error inesperado del servidor. | > [!NOTE] > > Maneja los errores por su `code`, no por el texto de `message`, que puede cambiar. # Introducción Source: https://docs.riqra.com/desarrolladores/api/introduction La API pública de Riqra para integrar pedidos, preparación y stock. La API pública permite a tus sistemas leer y actualizar datos de comercio de tu organización de forma programática: consultar pedidos, avanzar su preparación y entrega, y sincronizar stock. Es una API **REST** sobre HTTPS. Las respuestas son JSON. Cada llamada se autentica con una **API key** y opera siempre dentro de una sola organización. ## URL base Todas las rutas cuelgan de: ``` https://api-v2.riqra.com/public/v1 ``` ## Qué puedes hacer hoy * **Pedidos**: listar y consultar pedidos. * **Preparación**: avanzar la preparación, marcar como despachado o entregado, registrar guía de seguimiento y cancelar pedidos. * **Stock**: listar ubicaciones activas y fijar el stock disponible por SKU y ubicación. * **Precios**: listar listas de precios activas y fijar el precio de cada SKU por lista, con precio plano o tramos por cantidad. > [!NOTE] > > La API está en crecimiento. Algunas capacidades (productos, promociones, envíos) todavía no > están disponibles y responden con un código `501`. ## Por dónde empezar > **[Inicio rápido](/desarrolladores/api/quickstart)** > > Tu primera llamada autenticada en minutos. > **[Autenticación](/desarrolladores/api/authentication)** > > Cómo obtener y usar tu API key. > **[Permisos](/desarrolladores/api/scopes)** > > Los scopes que controlan qué puede hacer cada key. # Montos y moneda Source: https://docs.riqra.com/desarrolladores/api/money Cómo se representan los importes en la API. Los importes se representan como un **string decimal**, no como un número. Cada importe va acompañado de `currencyCode`, el código de moneda en formato **ISO 4217**. ```json theme={null} { "currencyCode": "PEN", "subtotal": "100.00", "taxTotal": "18.00", "total": "118.00" } ``` ## Por qué string Un string decimal evita los errores de redondeo de los números de punto flotante. Parsea el valor con una librería de decimales, no con `float`. > [!WARNING] > > La escala no está normalizada: el mismo importe puede llegar como `"12"`, `"12.0"` o `"12.00"`. > No compares importes como texto ni asumas una cantidad fija de decimales. Conviértelos a decimal > antes de comparar u operar. ## Campos de monto En el pedido: `subtotal`, `taxTotal`, `total`, `shippingTotal`, `discountTotal`, `amountPaid`. La identidad que siempre se cumple es: ``` subtotal + taxTotal = total ``` * `subtotal` es la base neta de **todo** (productos + envío), después de descuentos. Equivale a `total − taxTotal`. * `taxTotal` es el **total de impuestos** del pedido. * `total` es el monto pagado. > [!WARNING] > > `shippingTotal` y `discountTotal` son **informativos**: reflejan el costo de envío y el descuento > tal como los vio el comprador, y **ya están incluidos** en `subtotal`/`total`. No los sumes para > reconstruir el total — la única identidad es `subtotal + taxTotal = total`. `shippingTotal` es el costo de envío tal como lo vio el comprador (con o sin impuesto, según cómo tu tienda muestre los precios). `discountTotal` es el descuento de productos y de pedido tal como lo vio el comprador. Los descuentos de **envío** no van aquí: se reflejan como un `shippingTotal` menor y aparecen en `promotions`. `promotions` lista las promociones aplicadas: `id`, `code`, `title`, `class` (`GOODS` / `ORDER` / `SHIPPING`) y `amount`. El `id` es la clave con la que cada línea referencia la promoción. En cada línea: `price`, `listPrice`, `discountTotal`, `discountAllocations`, `subtotal`, `taxTotal`, `total`. En cada línea se cumple `subtotal + taxTotal = total`. `price` es el precio unitario cobrado, **antes de promociones**. `listPrice` es el precio de lista de la variante al momento del pedido. Es `null` cuando la variante no tiene precio de lista. `discountTotal` es el descuento por **promociones** de la línea (la diferencia entre `listPrice` y `price` es una negociación aparte, no va aquí). `taxTotal` es el impuesto de **productos** de la línea; la suma de `taxTotal` de las líneas no equivale al `taxTotal` del pedido cuando el envío tiene impuesto (el del pedido también incluye el impuesto del envío). `discountAllocations` desglosa el `discountTotal` de la línea por promoción: cada entrada tiene `promotionId` (referencia a `promotions[].id`) y `amount`. Las asignaciones de una misma promoción suman exactamente su `amount`. Todos comparten la misma `currencyCode` del pedido. # Paginación Source: https://docs.riqra.com/desarrolladores/api/pagination Cómo recorrer listas largas con cursores. Los endpoints que devuelven listas usan **paginación por cursor**. En lugar de números de página, pides una cantidad de elementos y un cursor que apunta al final de la página anterior. ## Parámetros | Parámetro | Tipo | Descripción | | - | - | - | | `limit` | entero | Elementos por página. Entre `1` y `100`. Por defecto `20`. | | `startingAfter` | string | Cursor de la página anterior. Omítelo en la primera página. | ## Respuesta ```json theme={null} { "data": [ /* ... */ ], "hasMore": true, "nextCursor": "b3JkXzAx..." } ``` | Campo | Descripción | | - | - | | `data` | Los elementos de esta página. | | `hasMore` | `true` si quedan más elementos por recorrer. | | `nextCursor` | Cursor para la siguiente página, o `null` si no hay más. | ## Recorrer todas las páginas Repite la llamada pasando `nextCursor` en `startingAfter` mientras `hasMore` sea `true`. ```bash theme={null} # Primera página curl "https://api-v2.riqra.com/public/v1/orders?limit=50" \ -H "Authorization: Bearer rq_live_tu_api_key" # Siguiente página curl "https://api-v2.riqra.com/public/v1/orders?limit=50&startingAfter=b3JkXzAx..." \ -H "Authorization: Bearer rq_live_tu_api_key" ``` > [!NOTE] > > El cursor es opaco y está ligado a los filtros y el orden de la consulta. No cambies los demás > parámetros entre páginas y no construyas el cursor a mano. Un cursor inválido responde `400`. # Inicio rápido Source: https://docs.riqra.com/desarrolladores/api/quickstart Haz tu primera llamada autenticada a la API pública. En esta guía obtienes una API key, verificas tu identidad y consultas tus pedidos. **1. Obtén una API key** Genera una key desde el panel de administración. Revisa [Autenticación](/desarrolladores/api/authentication) para el detalle. Una key de producción empieza con `rq_live_`; una de prueba con `rq_test_`. **2. Verifica tu identidad** Llama a `GET /whoami` para confirmar que la key funciona y ver sus permisos. ```bash theme={null} curl https://api-v2.riqra.com/public/v1/whoami \ -H "Authorization: Bearer rq_live_tu_api_key" ``` Respuesta: ```json theme={null} { "organizationId": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b", "environment": "LIVE", "apiKeyPrefix": "rq_live_abcd", "scopes": ["orders:read", "fulfillment:write"] } ``` **3. Lista tus pedidos** Con el scope `orders:read`, consulta los pedidos más recientes. ```bash theme={null} curl "https://api-v2.riqra.com/public/v1/orders?limit=5" \ -H "Authorization: Bearer rq_live_tu_api_key" ``` La respuesta trae `data`, más `hasMore` y `nextCursor` para paginar. Revisa [Paginación](/desarrolladores/api/pagination). ## Si algo falla * `401`: falta el header `Authorization` o la key es inválida o expiró. * `403`: la key no tiene el scope requerido. Revisa [Permisos](/desarrolladores/api/scopes). Cada error trae un cuerpo con `code`, `message` y `requestId`. Revisa [Errores](/desarrolladores/api/errors). # Permisos Source: https://docs.riqra.com/desarrolladores/api/scopes Los scopes que controlan qué puede hacer cada API key. Cada API key tiene un conjunto de **scopes**. Un scope tiene la forma `{capacidad}:{acción}` (por ejemplo `orders:read`) y habilita un grupo de endpoints. Si la key no tiene el scope que un endpoint requiere, la respuesta es `403` con `code` `INSUFFICIENT_SCOPE`. ## Scopes disponibles | Scope | Permite | Endpoints | | - | - | - | | `orders:read` | Leer pedidos | `GET /orders`, `GET /orders/{id}` | | `orders:write` | Cancelar pedidos | `POST /orders/{id}/cancel` | | `fulfillment:write` | Avanzar preparación y entrega, registrar guía | `POST /orders/{id}/fulfillment/*`, `PATCH /orders/{id}/fulfillment/tracking` | | `invoices:write` | Registrar la factura de un pedido | `POST /orders/{id}/invoice` | | `stock:read` | Leer ubicaciones activas | `GET /stock/locations` | | `stock:write` | Fijar stock disponible | `POST /stock/levels/set` | | `prices:read` | Leer listas de precios activas | `GET /prices/lists` | | `prices:write` | Fijar precios por SKU y lista | `POST /prices/set` | Asigna a cada key solo los scopes que necesita. Una integración que únicamente sincroniza stock no debería tener scopes de pedidos. ## Verificar los scopes de una key `GET /whoami` devuelve el arreglo `scopes` de la key en uso. ```json theme={null} { "scopes": ["orders:read", "fulfillment:write"] } ``` ## Próximamente Otras capacidades (productos, promociones, envíos) todavía no están disponibles. Sus scopes no se pueden asignar aún y sus rutas responden con `501`. # Desarrolla sobre Riqra Source: https://docs.riqra.com/desarrolladores/introduccion Dos formas de integrarte con Riqra: la API para leer y actualizar datos de tu organización y los temas para construir la tienda online. Riqra expone dos superficies para desarrolladores y agencias. Resuelven problemas distintos y no dependen una de la otra. | Superficie | Sirve para | Quién la usa | | - | - | - | | **API** | Leer y actualizar datos de tu organización desde tus sistemas: pedidos, preparación, stock. | Integradores de ERP, sistemas de facturación y logística. | | **Temas** | Construir la cara de la tienda online con Liquid y JSON, subirla con el CLI y dejar que el comerciante la personalice desde el panel. | Agencias y desarrolladores front-end. | ## Elige por dónde empezar > **[API](/desarrolladores/api/introduction)** > > REST sobre HTTPS, respuestas JSON, autenticación con API key. Empieza por el inicio rápido. > **[Temas](/desarrolladores/temas/introduccion)** > > Secciones con `{% schema %}`, plantillas JSON y un CLI para validar y subir. Familiar si vienes de Shopify. ## Credenciales * La **API** se autentica con una API key generada en el panel. El prefijo indica el entorno: `rq_live_` opera con datos reales y `rq_test_` con datos de prueba. Cada key opera dentro de una sola organización y con los permisos que le asignes. * Los **temas** usan un token de acceso de tema (empieza con `riqthm_`) que emite Riqra ligado a una tienda de desarrollo. Es independiente de las API keys. Subir un tema nunca cambia lo que ven los compradores: la agencia sube con el CLI y el comerciante publica desde el panel. # Documentación de Riqra Source: https://docs.riqra.com/index Guías y referencias para comerciantes, integradores y agencias. Riqra tiene dos plataformas en funcionamiento. Usa el selector de versión de la barra superior para cambiar entre ellas. * **Nueva plataforma** es la versión actual. Aquí se documentan el panel administrador, la tienda online, WhatsApp, PedidosIA, la API y los temas de tienda. * **Legacy** es la plataforma anterior. Conserva su API, sus webhooks y sus guías del panel administrador. Si no sabes cuál usas, revisa **[Migrar desde Riqra Legacy](/plataforma/migracion/cambios-nueva-plataforma)**. ## Administra tu negocio > **[Productos](/plataforma/productos/introduccion)** > > Crea productos y variantes, y organízalos en categorías, colecciones y catálogos. > **[Precios](/plataforma/precios/introduccion)** > > Crea listas de precios, deriva listas con ajustes y cobra por cantidad. > **[Inventario](/plataforma/inventario/introduccion)** > > Lleva el stock por ubicación y decide qué variantes limitan sus ventas al disponible. > **[Políticas comerciales](/plataforma/politicas-comerciales/introduccion)** > > Define qué catálogo, precios y condiciones de compra recibe cada cliente. > **[Envíos](/plataforma/envios/introduccion)** > > Ofrece delivery, recojo en local y couriers, con zonas, tarifas y fechas de entrega. > **[Clientes](/plataforma/clientes/introduccion)** > > Administra personas, empresas y segmentos, y da acceso a tu tienda. > **[Promociones](/plataforma/promociones/introduccion)** > > Rebaja productos, el pedido o el envío, de forma automática o con un código. > **[Conversaciones](/plataforma/conversaciones/responder-mensajes)** > > Atiende los mensajes de WhatsApp y del chat de tu tienda desde una sola bandeja. > **[Flujos](/plataforma/flujos/introduccion)** > > Automatiza respuestas y seguimientos sin escribir código. > **[Transferencia de datos](/plataforma/transferencia-de-datos/introduccion)** > > Importa y exporta productos, clientes, precios e inventario con Excel. > **[Migración](/plataforma/migracion/cambios-nueva-plataforma)** > > Qué cambia al pasar de Riqra Legacy y cómo prepararte. ## Canales de venta > **[Tienda online](/tienda-online/introduccion)** > > Publica tu catálogo en un sitio web con tu marca y tu propio dominio. > **[WhatsApp](/whatsapp/introduccion)** > > Conecta tu número, crea plantillas y envía campañas. > **[PedidosIA](/pedidos-ia/introduccion)** > > Convierte las órdenes de compra de tus clientes en pedidos con IA. ## Para desarrolladores y agencias > **[API](/desarrolladores/api/introduction)** > > Autentica, lee pedidos y actualiza tu catálogo desde tu ERP. > **[Temas](/desarrolladores/temas/introduccion)** > > Desarrolla y publica el tema de una tienda. ¿Necesitas ayuda? Escribe a [soporte@riqra.com](mailto:soporte@riqra.com). # Cómo se asignan productos y clientes Source: https://docs.riqra.com/pedidos-ia/como-funciona-el-matching El orden en que cada línea se asigna a un producto, cómo se deducen la empresa compradora y la sucursal de entrega, y cómo se aprende de tus correcciones. ## Asignación de productos Por cada línea de la orden, los códigos impresos se prueban en este orden hasta la primera coincidencia: 1. **SKU**: el código coincide exactamente con el `sku` de una de tus variantes. 2. **Código de barras**: el código coincide con el `codigo_barras` de una variante. Si un mismo código de barras está repetido en dos o más variantes, se omite. No se adivina entre ambas. 3. **Código del cliente**: el código —o la descripción— coincide con la homologación de esa empresa, ya sea [importada](/plataforma/transferencia-de-datos/importar-codigos) o aprendida de órdenes anteriores. Si ningún código coincide, la línea queda **Sin asignar** y la resuelves a mano en la revisión. > [!NOTE] > > Nunca se asigna por similitud de nombre. Una coincidencia es exacta o no existe, así una OC no se confirma con el producto equivocado. Cada línea muestra cómo se asignó: por SKU, por código de barras, **Aprendido** (código del cliente) o **Manual**. ### Precios Se usa el precio unitario impreso en el documento. Si una línea no trae precio, toma el de la lista de precios que corresponde a ese cliente según su política comercial. Si tampoco existe ahí, completas el precio a mano antes de confirmar. ## Detección de la empresa compradora * Si el documento imprime el documento fiscal del comprador, la empresa se busca por su RUC. * Algunas cadenas no imprimen su RUC en la orden. En ese caso, la empresa se deduce por sus códigos: si los códigos del archivo pertenecen a la homologación de una sola empresa, y al menos dos códigos distintos lo confirman, se asigna y aparece la insignia **Empresa inferida**. Ante cualquier ambigüedad —dos empresas posibles, o evidencia insuficiente— no se asigna ninguna y la eliges tú. > [!TIP] > > La deducción por códigos solo funciona si importaste la homologación de esa empresa. Es una razón más para [cargar los códigos](/plataforma/transferencia-de-datos/importar-codigos) antes de la primera OC. Puedes cambiar la empresa en la revisión, o crearla ahí mismo con los datos extraídos del documento. ## Detección de la sucursal de entrega La dirección de entrega extraída se compara con las sucursales de la empresa: * Si ya confirmaste antes una orden con esa dirección, la sucursal se asigna sola. * Si no, las sucursales se ordenan por similitud con la dirección y la mejor aparece con la insignia **Sugerida**. Cuando la coincidencia es clara, queda preseleccionada; si hay empate, la eliges tú. También puedes crear la sucursal durante la revisión, con la dirección extraída ya completada. ## Aprendizaje con cada confirmación Al confirmar una orden: * Cada línea que asignaste a mano guarda sus códigos y su descripción como homologación de esa empresa. La próxima OC con esos códigos se asigna sola. * La sucursal que elegiste queda asociada a la dirección de entrega del documento. Los códigos aprendidos aparecen en la pestaña **Códigos** de la empresa con origen **Aprendido**. El esfuerzo de revisión baja con cada orden: las primeras OC de un cliente nuevo pueden requerir varias asignaciones manuales; las siguientes llegan completas. # Configura PedidosIA Source: https://docs.riqra.com/pedidos-ia/configuracion Prepara tu catálogo, tus clientes, los códigos de homologación y la recepción por correo antes de procesar tu primera orden de compra. Sigue estos pasos en orden. Cada uno mejora la asignación automática del siguiente: primero los productos, luego los clientes, luego los códigos con los que cada cliente nombra tus productos. ## 1. Carga tu catálogo de productos La asignación automática busca primero por `sku` y luego por `codigo_barras`. Completa ambas columnas al [importar productos](/plataforma/transferencia-de-datos/importar-productos). > [!TIP] > > El código de barras (EAN) funciona para todos tus clientes a la vez: si la cadena imprime el EAN en su orden de compra, la línea se asigna sin ninguna configuración adicional. ## 2. Importa empresas y sucursales Cada orden de compra pertenece a una empresa (el comprador) y, normalmente, se entrega en una de sus sucursales. Impórtalas con la plantilla de **Empresas**: [Importa clientes desde Excel](/plataforma/transferencia-de-datos/importar-clientes). Puedes crear empresas y sucursales también durante la revisión de una OC, pero importarlas antes hace que la primera orden llegue ya asignada. ## 3. Importa los códigos de tus clientes Muchas cadenas usan códigos internos propios para tus productos, distintos del EAN y distintos entre cadenas. Impórtalos para que las líneas se asignen solas desde la primera OC: [Importa códigos de cliente](/plataforma/transferencia-de-datos/importar-codigos). Este paso también permite deducir al comprador cuando el documento no imprime su RUC. Revisa [cómo funciona la asignación](/pedidos-ia/como-funciona-el-matching). ## 4. Activa la recepción por correo Puedes subir archivos a mano, pero lo más cómodo es que las OC lleguen solas desde tu correo. **1. Genera la dirección** En **Órdenes de compra**, haz clic en **Recibir por correo**. Riqra genera una dirección única para tu organización, por ejemplo `tuempresa-x7k2mp@inbox.riqra.com`. **2. Configura el reenvío** Reenvía manualmente los correos con OC adjuntas, o crea una regla de reenvío automático en Gmail u Outlook. El diálogo muestra las instrucciones para cada proveedor. La dirección se reconoce aunque llegue en copia (CC) o copia oculta (BCC), como ocurre con los reenvíos automáticos. **3. Haz una prueba** Envía un correo de prueba con un archivo adjunto. El diálogo muestra **Último correo recibido** cuando llega. Cada correo acepta hasta 10 adjuntos en PDF, `.xlsx` o `.xls`, de hasta 10 MB cada uno. Los demás adjuntos se ignoran. La pestaña **Correos** de la página registra cada correo recibido, con su remitente, asunto y el resultado por adjunto: **Recibido**, **Duplicado**, **Sin adjuntos** o **Error**. Desde cada adjunto recibido puedes abrir las órdenes que produjo. > [!NOTE] > > Si un archivo con el mismo contenido ya fue procesado, el adjunto se marca como **Duplicado** y no se procesa de nuevo. Descarta todas las órdenes del archivo original si necesitas volver a procesarlo. Puedes pausar la recepción en cualquier momento con el interruptor **Activa / Pausada**. Mientras está pausada, los correos que llegan se descartan. ## Permisos por rol | Acción | Propietario y Administrador | Supervisor | Vendedor | | - | - | - | - | | Subir y ver órdenes de compra | Sí | Sí | Sí | | Revisar y confirmar | Sí | Sí | No | | Ver códigos de cliente | Sí | Sí | No | | Importar empresas y códigos | Sí | No | No | # Procesa órdenes de compra con IA Source: https://docs.riqra.com/pedidos-ia/introduccion PedidosIA lee las órdenes de compra que envían tus clientes en PDF o Excel y las convierte en pedidos dentro de Riqra. PedidosIA convierte las órdenes de compra (OC) que emiten tus clientes —cadenas de retail, distribuidores, mayoristas— en pedidos de Riqra. Subes el archivo original o lo reenvías por correo, la inteligencia artificial extrae los datos, Riqra asigna los productos y el cliente, y tú solo revisas y confirmas. Encuentras la bandeja en **[Pedidos → Órdenes de compra](https://app.riqra.com/orders/purchase-orders)**. > [!NOTE] > > PedidosIA se contrata por separado. Si no ves **Órdenes de compra** en el menú, contacta a tu ejecutivo de Riqra para activarlo. ## Cómo funciona **1. Recibe el archivo** Sube archivos con **Procesar OCs** o reenvíalos a la dirección de correo de tu organización. Se aceptan PDF, `.xlsx` y `.xls`. **2. Extracción con IA** La inteligencia artificial lee el documento y extrae el número de OC, el comprador, las fechas, la dirección de entrega y cada línea con sus códigos, cantidad y precio. **3. Asignación automática** Cada línea se asigna a un producto de tu catálogo por SKU, código de barras o los códigos aprendidos de ese cliente. La empresa compradora y la sucursal de entrega también se detectan. **4. Revisión** La orden queda **Por revisar**. Completas lo que falte: asignas productos sin coincidencia, ajustas cantidades o eliges la sucursal. **5. Confirmación** Al confirmar, se crea un pedido y tus integraciones reciben un webhook. Lo que corregiste queda aprendido para la próxima OC de ese cliente. ## Archivos y órdenes El archivo y la orden son cosas distintas: un archivo puede contener varias OC. Mientras un archivo se procesa aparece en una franja sobre la lista; sus órdenes entran a la lista solo cuando la extracción termina, una por cada OC del documento. Estados del archivo (en la franja): | Estado | Significado | | - | - | | **Procesando** | El archivo se está leyendo y extrayendo. | | **Falló** | No contenía una orden de compra o hubo un error; puedes descartarlo de la franja. | Estados de una orden: | Estado | Significado | | - | - | | **Por revisar** | La extracción terminó y espera tu revisión. | | **Confirmada** | Ya generó un pedido en Riqra. | | **Descartada** | La descartaste; puedes registrar el motivo. | La lista se filtra por estado y se busca por número de OC, nombre del comprador o nombre del archivo. ## Lo que necesitas antes de empezar * Tu catálogo de productos cargado, con `sku` y `codigo_barras` completos. * Tus clientes importados: empresas y sucursales. * Los códigos con los que cada cliente identifica tus productos. La guía de [configuración](/pedidos-ia/configuracion) te lleva por cada paso en orden. # Qué archivos procesa PedidosIA Source: https://docs.riqra.com/pedidos-ia/procesamiento-de-archivos Formatos admitidos, límites y cómo se extraen los datos de un PDF o un Excel. ## Formatos y límites | Límite | Valor | | - | - | | Formatos | PDF, `.xlsx` y `.xls` | | Tamaño por archivo | Hasta 10 MB | | Archivos por carga manual | Hasta 10 | | Adjuntos por correo | Hasta 10 | | Páginas por PDF | Hasta 100 | | Filas de datos por Excel | Hasta 5 000 | No se admiten imágenes, fotos ni archivos CSV. Sube siempre el archivo original que emite tu cliente: un PDF escaneado de baja calidad extrae peor que el PDF generado por el sistema de la cadena. ## Qué se extrae De cada orden de compra se extrae: * Número de orden de compra y fecha de emisión. * Comprador: razón social y documento fiscal (RUC), tal como están impresos. * Fecha y dirección de entrega, y condiciones de pago. * Cada línea: los códigos impresos, la descripción, la cantidad, el precio unitario y el total. * Moneda y totales del documento. Después de la extracción, el resultado se valida: se cuadran los totales contra las líneas, se verifican los documentos fiscales y los códigos de barras, y se marcan cantidades o precios sospechosos. Las advertencias aparecen en la pantalla de revisión; las críticas se destacan para que las resuelvas antes de confirmar. Si el documento no contiene ninguna orden de compra —por ejemplo, una factura o una guía—, el archivo queda en estado **Falló** en la franja de procesamiento, con la explicación, y no se crea ninguna orden. ## Cómo se procesa un PDF La inteligencia artificial lee el documento completo, incluidas tablas con formatos distintos por cadena, y devuelve los datos estructurados. No necesitas ninguna plantilla ni configuración por cliente: el mismo motor procesa los formatos de todas las cadenas. ## Cómo se procesa un Excel Con archivos de Excel, la IA solo detecta la estructura: qué columna contiene el código, cuál la cantidad, cuál el precio. Los valores los lee y los suma Riqra directamente de las celdas, de forma exacta. Las cantidades y los totales nunca dependen de la interpretación del modelo. Se reconocen, entre otras, estas columnas: | Dato | Ejemplos de encabezado | | - | - | | Código de barras | `EAN`, `Cód. Barras` | | Código del artículo de la cadena | `Cód. Artículo`, `SAP` | | Tu propio código | `Cód. Proveedor` | | Descripción | `Descripción`, `Producto` | | Cantidad | `Cantidad`, `Unidades` | | Precio unitario | `Precio`, `Costo Unit.` | | Total de la línea | `Importe`, `Total` | | Tienda o local de entrega | `Local`, `Tienda`, `Sucursal` | | Número de OC | `N° OC`, `Orden` | | Fechas y dirección de entrega | `F. Entrega`, `Dirección` | Los formatos de número latinoamericanos (`1.182,60`) y las fechas día/mes/año se leen correctamente. > [!WARNING] > > Si el libro tiene varias hojas con datos, solo se procesa la hoja con más filas y aparece una advertencia. Si tu cliente envía una OC por hoja, divide el libro en un archivo por hoja antes de subirlo. > [!NOTE] > > Si el archivo no tiene columna de cantidad o de precio, la orden igual se crea, con una advertencia. Completa los valores a mano durante la revisión. Un mismo archivo de Excel puede contener varias órdenes de compra —por número de OC o distribuidas por tienda—. Revisa [varias órdenes en un archivo](/pedidos-ia/varias-ordenes-en-un-archivo). # Revisa y confirma una orden Source: https://docs.riqra.com/pedidos-ia/revisar-y-confirmar Qué revisar en una orden de compra extraída y qué ocurre al confirmarla. Abre una orden en estado **Por revisar** desde **[Órdenes de compra](https://app.riqra.com/orders/purchase-orders)**. La pantalla muestra el documento original a la izquierda —el PDF o la vista del Excel— y los datos extraídos a la derecha, para compararlos celda por celda. Las advertencias de la extracción aparecen arriba y en cada línea afectada: totales que no cuadran, cantidades en cero, precios faltantes. ## Qué puedes corregir * **Cliente**: cambia la empresa compradora con el buscador, o créala con **Crear empresa**; el formulario llega completado con la razón social, el RUC y la dirección extraídos. * **Sucursal de entrega**: elige entre las sucursales de la empresa —la más parecida a la dirección extraída aparece como **Sugerida**— o crea una nueva. La sucursal es opcional. * **Líneas**: ajusta la **Cantidad** y el **Precio unit.** de cada línea; el valor extraído queda visible como referencia. Asigna las líneas **Sin asignar** con **Asignar producto**, buscando por nombre o SKU. También puedes cambiar una asignación o eliminar una línea. Guarda los cambios antes de confirmar. Si intentas salir con cambios sin guardar, verás una advertencia. > [!TIP] > > Si un cliente repite líneas sin asignar en cada OC, carga su homologación completa de una vez desde su pestaña **Códigos**: [Importa códigos de cliente](/plataforma/transferencia-de-datos/importar-codigos). ## Confirmar **Confirmar pedido** se habilita cuando la orden tiene empresa asignada y todas las líneas tienen producto, precio y una cantidad mayor a cero. Al confirmar: * Se crea un pedido en **Pedidos**, con los datos fiscales de la empresa, la sucursal como dirección de entrega y el número de OC como referencia. El pedido usa la moneda de tu organización. * Tus integraciones reciben el webhook de pedido creado, igual que con un pedido de la tienda. * Las asignaciones manuales de esa empresa [quedan aprendidas](/pedidos-ia/como-funciona-el-matching): la próxima OC de ese cliente llega mejor asignada. Después de confirmar, se abre automáticamente la siguiente orden por revisar: primero las que quedan del mismo archivo y luego el resto de la bandeja. ## Descartar **Descartar** retira la orden de la bandeja sin crear un pedido; puedes registrar el motivo. Sirve para duplicados subidos a mano, cotizaciones o documentos que no correspondía procesar. Los archivos que fallaron se descartan desde la franja de procesamiento. > [!NOTE] > > Descartar libera el archivo: cuando todas las órdenes de un documento están descartadas (o descartaste el archivo fallido), el mismo documento puede volver a llegar por correo y se procesa de nuevo en lugar de marcarse como **Duplicado**. # Varias órdenes en un archivo Source: https://docs.riqra.com/pedidos-ia/varias-ordenes-en-un-archivo Los archivos consolidados de las cadenas se separan en una orden de compra por cada OC, y las órdenes predistribuidas por tienda se suman. Las cadenas suelen consolidar sus compras en un solo archivo: un PDF con una OC por sucursal, un Excel con varias OC en la misma hoja, o una orden repartida tienda por tienda. Cada caso se separa en órdenes independientes, cada una con su propia revisión y su propio pedido. ## PDF con varias órdenes Un PDF puede contener varias órdenes de compra, por ejemplo una por sucursal de entrega. En la bandeja aparece una orden por cada OC del documento, cada una con su número, su sucursal y sus líneas. ## Excel con varias órdenes Cuando la hoja tiene una columna de número de OC y el número cambia entre filas, las filas se agrupan por ese número y se crea una orden por cada uno. La fecha, la dirección de entrega y la tienda de cada orden se leen de sus propias filas. | `N° OC` | `Cód. Artículo` | `Cantidad` | | - | - | - | | `4501122` | `718803` | `10` | | `4501122` | `718804` | `6` | | `4501123` | `718803` | `4` | Este archivo crea dos órdenes: la `4501122` con dos líneas y la `4501123` con una. ## Órdenes predistribuidas por tienda Algunas cadenas emiten una sola OC repartida local por local: el mismo producto aparece en varias filas, una por tienda. Se detecta la columna de tienda, las filas se agrupan por producto y se suman las cantidades y los importes. | `Cód. Artículo` | `Local` | `Cantidad` | | - | - | - | | `718803` | `T01` | `5` | | `718803` | `T02` | `3` | | `718803` | `T05` | `8` | Resultado: una sola línea con `718803` por 16 unidades. Si el precio unitario no coincide entre las filas de un mismo producto, la orden muestra una advertencia con el precio que se usó. ## Cada orden se revisa por separado Mientras el archivo se procesa aparece en la franja sobre la lista; al terminar, sus órdenes entran juntas a la bandeja. Cada fila muestra el archivo del que salió y, si el archivo produjo varias, una etiqueta **1 de 3** — haz clic en ella para ver solo las órdenes de ese archivo. Las órdenes son independientes: cada una tiene su propio estado, su propia revisión y genera su propio pedido al confirmarla. En la página de revisión, una barra muestra todas las órdenes del mismo archivo para saltar entre ellas, y después de confirmar o descartar una, se abre la siguiente del mismo archivo antes de pasar al resto de la bandeja. > [!NOTE] > > Un archivo con más de 20 órdenes se procesa completo, pero se marca con una advertencia para que lo revises con más cuidado. > [!WARNING] > > La separación funciona dentro de una misma hoja. Si el libro de Excel trae una OC por hoja, solo se procesa la hoja con más datos. Divide el libro en un archivo por hoja. # Trabaja con el Agente IA en Conversaciones Source: https://docs.riqra.com/plataforma/agente-ia/agente-en-conversaciones Ve lo que responde el agente, toma la conversación cuando quieras y atiende los pedidos que te pasa. ## Qué ves en Conversaciones * Las respuestas del agente aparecen en verde azulado con la etiqueta **Agente IA**. Debajo de cada una ves lo que consultó para escribirla, por ejemplo el producto que buscó. * En la lista, una conversación que atiende el agente dice **Agente IA** en lugar de **Sin asignar**: no está esperando a tu equipo. * En el contexto de la conversación, la sección **Agente IA** muestra quién atiende y lo que puedes hacer. * Mientras el agente atiende, no se envía el mensaje fuera de horario ni la notificación de mensaje nuevo: el agente ya respondió. ## Cuando el agente transfiere El agente pasa la conversación a tu equipo con un aviso **El Agente IA transfirió la conversación al equipo** y una nota con lo que necesita el cliente. La conversación vuelve a **Sin asignar** y tu equipo recibe la notificación. El agente no responde ahí hasta que se la devuelvan. ## Toma la conversación y devuélvela * **Responde**: cuando alguien de tu equipo escribe en una conversación que atiende el agente, el agente se pausa ahí. Verás el aviso **Agente IA pausado**. * **Pausar en esta conversación**: pausa el agente sin escribir. * **Devolver al agente**: el agente vuelve a responder desde el siguiente mensaje del cliente, con todo el historial. ## Cuando un cliente quiere comprar El agente es un asesor: ayuda al cliente a elegir y le muestra cómo comprar, pero no toma ni confirma pedidos. * Confirma lo que el cliente quiere: el producto, la presentación, el precio, el stock y la cantidad mínima. Si algo no está disponible, le ofrece una alternativa. * Si el cliente le dicta un pedido, primero revisa cada producto y le dice lo que hay y lo que no. * Si tienes tienda en línea, le comparte el enlace de cada producto para que compre ahí. * Si el cliente prefiere que tu equipo tome el pedido, el agente le pasa la conversación con una nota de los productos y las cantidades que pidió. Tu vendedor toma el pedido en la misma conversación. * Si pide "lo mismo de la última vez", le muestra lo que tenía su último pedido con el precio y el stock de hoy, y le ofrece las mismas dos formas de comprar. El agente nunca dice que un pedido quedó registrado o confirmado, ni promete una fecha de entrega. ## Mide cómo le va En **[Estadísticas → Agente IA](https://app.riqra.com/analytics/agent)** ves cuántas conversaciones resolvió el agente, cuántas le pasó a tu equipo y por qué. Más en [Estadísticas del Agente IA](/plataforma/agente-ia/estadisticas). # Configura tu Agente IA Source: https://docs.riqra.com/plataforma/agente-ia/configurar-el-agente Ponle nombre, elige qué puede hacer, enséñale tu negocio y actívalo. Todo lo que guardas se aplica al instante: si el agente está activo, la siguiente respuesta ya usa tus cambios. ## Ponle nombre y elige qué puede hacer **1. Abre el agente** Ve a **[Automatización → Agente IA](https://app.riqra.com/automations/agent)**. Estás en **Configuración**. **2. Escribe su nombre** En **Nombre**, escribe el nombre que verán tus clientes, por ejemplo **Sofía**. Se muestra en el chat en tienda. **3. Elige las herramientas** En **Herramientas**, activa lo que el agente puede hacer: | Herramienta | Qué hace | | - | - | | **Buscar productos** | Busca en el catálogo de cada cliente, con sus precios, su stock y las cantidades mínimas. | | **Consultar pedidos** | Responde por el estado, el pago y la entrega de los pedidos del cliente. | | **Transferir a una persona** | Pasa la conversación a tu equipo. Siempre activa. | **4. Guarda** Haz clic en **Guardar**. ## Elige los canales En **Canales** ves los canales de Riqra Inbox. El agente responde en todos, salvo en los que apagues. Si apagas un canal, lo que llega por ahí lo atiende tu equipo, como siempre. Un canal apagado en Riqra Inbox aparece con **Configurar**, que te lleva a activarlo. ## Escribe tus instrucciones Las instrucciones dicen cómo atiende el agente: su trato, qué ofrece y cuándo pasa la conversación a tu equipo. Escríbelas como se las explicarías a alguien nuevo en tu equipo. > [!TIP] > > Si dice qué hacer (*"si piden crédito, pasa la conversación al equipo"*), es una instrucción. Si es información que el agente le daría al cliente (*"hacemos envíos en Lima de lunes a sábado"*), va en **Conocimiento**. El agente lee las dos en cada respuesta. **1. Abre Instrucciones** Haz clic en **Instrucciones** y luego en **Nueva instrucción**. **2. Escribe la regla** Dale un título y escribe la instrucción, por ejemplo: *"Si piden más de 100 unidades de un producto o un precio especial, pasa la conversación al equipo comercial."* **3. Guarda** Haz clic en **Guardar**. Arrastra las instrucciones para cambiar su orden. Con el menú **⋯** de cada una la editas o la eliminas. El interruptor la apaga sin borrarla. ## Enséñale tu negocio En **Conocimiento** cargas lo que el agente debe saber: envíos, pagos, cambios y devoluciones, preguntas frecuentes. * Con **Escribir** creas un documento en Riqra. * Con **Subir archivo** subes un PDF, un Word, un TXT, un MD o un CSV de hasta 10 MB. El agente lo lee (verás **Leyendo…** unos segundos) y puedes ver el texto que lee con **Ver texto**. * El interruptor de cada documento lo apaga sin borrarlo. Arriba ves cuánto ocupan tus documentos activos del límite de 200 000 caracteres. * El agente lee todos tus documentos activos completos en cada respuesta. Los precios, el stock y las descripciones de tus productos no hace falta cargarlos: los consulta en tu catálogo, siempre al día. ## Actívalo **1. Pruébalo** Antes de activarlo, [pruébalo](/plataforma/agente-ia/probar-el-agente) con **Probar**. **2. Actívalo** En **Estado**, activa **Responder a los clientes**. Desde ahora responde en tus canales. Después, cada cambio que guardes llega a tus clientes en la siguiente respuesta. Si quieres revisar un cambio antes, pruébalo con **Probar** apenas lo guardes. # Estadísticas del Agente IA Source: https://docs.riqra.com/plataforma/agente-ia/estadisticas Mide cuántas conversaciones resuelve el agente, cuántas le pasa a tu equipo y por qué. En **[Estadísticas → Agente IA](https://app.riqra.com/analytics/agent)** ves cómo le va al agente en el período que elijas (7, 28 o 90 días, o un rango de fechas), comparado con el período anterior de la misma duración. ## Qué mide | Dato | Qué cuenta | | - | - | | **Conversaciones** | Cada día que un cliente le escribe al agente cuenta como una conversación. | | **Resueltas por el agente** | Las que atendió sin transferir y sin que nadie de tu equipo tuviera que escribir en las 24 horas siguientes. | | **Tasa de resolución** | El porcentaje de conversaciones que resolvió el agente. | | **Transferidas a tu equipo** | Las que pasó a tu equipo. | | **Tiempo de respuesta** | La mitad de las respuestas llegó en menos de este tiempo, contado desde el mensaje del cliente. | Toca un dato para verlo día por día en el gráfico, junto al período anterior. En **Transferidas a tu equipo** y **Tiempo de respuesta**, bajar es bueno: el cambio se ve en verde. ## Por qué transfiere Cada vez que el agente le pasa una conversación a tu equipo, dice por qué: | Motivo | Cuándo | | - | - | | **Quiere comprar** | El cliente quiere que tu equipo tome su pedido. | | **Reclamo o problema** | Un pedido que no llegó o llegó mal, un cobro, una devolución o un cambio. | | **Solo tu equipo puede hacerlo** | Modificar o cancelar un pedido, emitir o corregir una factura, dar crédito, un precio especial o una cotización. | | **No tenía la respuesta** | El cliente necesitaba un dato que no está en tus instrucciones ni en tus documentos. | | **Pidió una persona** | El cliente pidió hablar con alguien de tu equipo. | | **Tus instrucciones** | Una de tus instrucciones le pide transferir. | | **Error o límite** | El agente no pudo responder, o llegó al límite de respuestas en una conversación. | > [!TIP] > > Si muchas conversaciones se transfieren porque el agente **No tenía la respuesta**, agrega esa información en [Conocimiento](/plataforma/agente-ia/configurar-el-agente): la próxima vez responderá él. ## Por canal y últimas transferencias * **Por canal**: las conversaciones, las resueltas y las transferidas de cada canal. * **Últimas transferencias**: el cliente, el motivo y la nota que el agente le dejó a tu equipo. Toca el cliente para abrir la conversación. # Qué es el Agente IA Source: https://docs.riqra.com/plataforma/agente-ia/introduccion Un asistente virtual que responde a tus clientes en Riqra Inbox, con tus precios, tu stock y tus pedidos. El **Agente IA** responde a tus clientes en los canales de Riqra Inbox: WhatsApp y el [chat en tienda](/plataforma/conversaciones/chat-en-tienda). Contesta con lo que tú le enseñas (instrucciones y documentos), busca productos con los precios y el stock de cada cliente, consulta sus pedidos y ayuda a tus clientes a elegir qué comprar. Cuando no puede ayudar, o el cliente pide una persona, pasa la conversación a tu equipo. Lo configuras en **[Automatización → Agente IA](https://app.riqra.com/automations/agent)**. Las conversaciones que atiende están en **[Conversaciones](https://app.riqra.com/conversations)**, como siempre. > [!NOTE] > > El Agente IA es un producto que se contrata por separado y necesita **Riqra Inbox**. Si no ves **Agente IA** en **Automatización**, contacta a tu ejecutivo de Riqra. ## Qué hace * **Responde en segundos**: espera unos segundos por si el cliente escribe en varios mensajes, y responde a todos juntos. * **Usa los datos de cada cliente**: sus precios, su catálogo, su stock y sus pedidos. Un visitante sin cuenta ve lo que ve en tu tienda. * **Recuerda la conversación**: lee los últimos 40 mensajes, cada uno con su fecha. Si un precio o el estado de un pedido es de otro día, lo vuelve a consultar en vez de repetirlo. * **Asesora la compra**: ayuda a elegir el producto y la presentación, con su precio, su stock y su cantidad mínima. Para comprar, comparte el enlace de tu tienda o pasa la conversación a tu equipo con los productos y las cantidades que pidió el cliente. No toma ni confirma pedidos. * **Pasa la conversación a tu equipo** cuando hace falta: reclamos, consultas que no puede responder o lo que tus instrucciones digan, con una nota de lo que necesita el cliente. * **Nunca dice que es una persona**, no inventa precios ni promociones, y solo comparte enlaces de tu tienda. ## Cómo trabaja con tu equipo * Responde hasta que alguien de tu equipo escribe en la conversación. Desde ese momento se pausa ahí, para que nunca respondan los dos a la vez. * Tu equipo le devuelve la conversación con **Devolver al agente**. * Mientras el agente atiende, no se envía el mensaje fuera de horario ni la notificación de mensaje nuevo: el agente ya respondió. ## Cómo empiezas 1. [Configura tu agente](/plataforma/agente-ia/configurar-el-agente): nombre, herramientas, instrucciones y documentos. 2. [Pruébalo](/plataforma/agente-ia/probar-el-agente) como uno de tus clientes. 3. Actívalo. Desde ese momento responde en tus canales, y cada cambio que guardes llega en la siguiente respuesta. 4. [Trabaja con él en Conversaciones](/plataforma/agente-ia/agente-en-conversaciones): revisa lo que responde y lo que te transfiere. 5. [Mide cómo le va](/plataforma/agente-ia/estadisticas) en Estadísticas: lo que resolvió, lo que te pasó y por qué. # Prueba tu Agente IA Source: https://docs.riqra.com/plataforma/agente-ia/probar-el-agente Conversa con tu agente como uno de tus clientes antes de que lo vean ellos. ## Conversa con el agente **1. Abre Probar** En **[Agente IA](https://app.riqra.com/automations/agent)**, haz clic en **Probar**. Se abre un chat al costado. **2. Elige quién escribe, si quieres** Al empezar escribes como un visitante sin cuenta. Para probar como uno de tus clientes, haz clic en **Visitante sin cuenta** y elígelo: el agente usa sus precios, su catálogo y sus pedidos. **3. Escribe como el cliente** Escribe un mensaje y presiona **Enter**. Debajo de cada respuesta ves lo que el agente consultó, y si pasaría la conversación a tu equipo. Nada de lo que pasa en **Probar** llega a tus clientes ni queda guardado. Con el ícono de flecha circular empiezas de nuevo. # Da acceso a la tienda Source: https://docs.riqra.com/plataforma/clientes/acceso-a-la-tienda Invita a tus personas a crear su contraseña, entrega enlaces de acceso, pausa cuentas y entiende cada estado de la lista. Una persona entra a tu tienda con su correo y una contraseña que solo ella conoce. Tú decides quién puede entrar: invitas a quien todavía no tiene contraseña y pausas a quien no debe comprar. La tienda nunca genera ni muestra contraseñas; cada persona elige la suya desde un enlace. ## Los cuatro estados La columna **Estado** de la lista de personas y el panel **Estado** de cada ficha responden una sola pregunta: ¿puede entrar? | Estado | Qué significa | | - | - | | **Sin acceso** | Existe como persona, pero no tiene contraseña. No puede iniciar sesión. | | **Invitada** | Tiene un enlace de acceso vigente que todavía no usó. | | **Con acceso** | Ya creó su contraseña y puede iniciar sesión. | | **Pausada** | Tú la pausaste. No puede iniciar sesión ni hacer pedidos, tenga o no contraseña. | Una persona pasa a **Con acceso** de dos formas: acepta un enlace que le enviaste o se registra sola en la tienda con el mismo correo. En el segundo caso, su registro se une a la ficha que ya tenías, con el historial de pedidos que hubiera acumulado. ## Antes de empezar * La persona necesita un correo para recibir la invitación. Si no lo tiene, agrégalo en su ficha. La otra salida es copiar un enlace, algo que solo está disponible con acceso por código. * Invitar, copiar y revocar enlaces está reservado a los roles de propietario y administrador. ## Envía una invitación **1. Abre la persona** Ve a **[Clientes → Personas](https://app.riqra.com/clients/individuals)** y haz clic en la persona. Su estado debe ser **Sin acceso** o **Invitada**. **2. Envía el enlace** En el panel **Estado**, haz clic en **Enviar invitación**. La persona recibe un correo con un enlace válido por 7 días. **3. Espera la aceptación** El panel muestra **Invitación por correo** con su fecha de vencimiento. Cuando la persona abre el enlace, crea su contraseña, inicia sesión y su estado cambia a **Con acceso**. Su correo queda verificado. Si el enlace vence, haz clic en **Reenviar invitación**. Cada envío reemplaza al anterior: solo el último enlace funciona. ## Revoca un enlace Mientras un enlace esté vigente, **Revocar enlace** lo anula. Sirve si enviaste la invitación a un correo equivocado. Un enlace revocado, vencido o ya usado muestra un error genérico a quien lo abra. ## Recupera una contraseña Una persona **Con acceso** que olvidó su contraseña la recupera sola desde **Olvidé mi contraseña** en la tienda. Recibe un enlace por correo que vence en 1 hora. No necesitas intervenir, y el panel no ofrece invitaciones para personas que ya tienen contraseña. ## Correo sin verificar Cuando editas el correo de una persona **Con acceso**, junto al campo **Correo electrónico** aparece la insignia **Sin verificar** y su correo anterior recibe un aviso del cambio. En su siguiente inicio de sesión, la persona ingresa su contraseña y luego un código que llega al nuevo correo. Con eso el correo queda verificado y la insignia desaparece. ## Pausa una persona En el panel **Estado**, **Pausar** cambia la persona a **Pausada**. Mientras dure la pausa: * No puede iniciar sesión, ni con correo ni con código. * No puede hacer pedidos. * No puede registrarse en la tienda ni recuperar su contraseña. * Los enlaces de acceso vigentes dejan de funcionar y el panel no ofrece invitaciones. La pausa no cierra una sesión ya abierta, pero esa sesión tampoco puede hacer pedidos. Un pedido hecho antes de la pausa se puede pagar con normalidad. **Activar** revierte la pausa y los enlaces que no vencieron vuelven a funcionar. Las campañas de WhatsApp dependen del [consentimiento](/plataforma/clientes/personas) de la persona, no de la pausa. ## Acceso con código Algunas tiendas identifican a sus clientes con un código propio, por ejemplo el código de cliente de su sistema de facturación, y le entregan a cada uno su enlace de acceso en mano, sin pasar por el correo. Si es tu caso, escríbenos para activar el acceso por código en tu organización. Con el acceso por código activo: * La pantalla de inicio de sesión de la tienda pide **Correo o código** y la contraseña. La persona entra con cualquiera de los dos. * El campo **Código** aparece en la ficha y es obligatorio al crear una persona. Un código no contiene `@`, no distingue mayúsculas de minúsculas y es único en tu organización. Una vez asignado, no se puede dejar vacío. * La lista de personas muestra la columna **Código** y busca también por código. * La plantilla, la importación y la exportación de personas llevan la columna `codigo`, para asignar códigos en bloque. Lee [Importa personas desde Excel](/plataforma/transferencia-de-datos/importar-personas). * El panel **Estado** ofrece **Copiar enlace**. ### Copia un enlace de acceso Para una persona sin correo, el enlace copiado es la única forma de darle acceso y de recuperar su contraseña. **1. Genera el enlace** En el panel **Estado** de la persona, haz clic en **Copiar enlace**. Si había una invitación por correo vigente, el sistema te avisa que la anula. **2. Cópialo ahora** El enlace se muestra una sola vez. Cópialo y entrégaselo a la persona por el canal que uses con ella, por ejemplo WhatsApp. Si lo pierdes, genera uno nuevo. **3. La persona crea su contraseña** El enlace vence en 7 días. Al abrirlo, la persona ve su código, crea su contraseña e inicia sesión. Un enlace copiado no verifica el correo, porque no prueba que la persona lo haya recibido en su bandeja. Los enlaces copiados se generan de a uno, igual que las invitaciones por correo: cada una sale desde la ficha de la persona. # Administra empresas y sucursales Source: https://docs.riqra.com/plataforma/clientes/empresas-y-sucursales Registra a las empresas que te compran por orden de compra, sus sucursales de entrega y las personas que compran en su nombre. > [!NOTE] > > Las empresas existen solo con [PedidosIA](/pedidos-ia/introduccion). Sin ese producto, **Clientes** no muestra **Empresas** y las fichas de las personas no tienen la pestaña **Empresas y sucursales**. Una empresa es la entidad legal que emite una orden de compra: tiene razón social, identificación fiscal y domicilio fiscal. Sus **sucursales** son los puntos donde entrega esa empresa, cada uno con su dirección. Cada orden de compra se asigna a una empresa y, normalmente, a una de sus sucursales; lee [Cómo funciona el matching](/pedidos-ia/como-funciona-el-matching). Las **personas** de una empresa son quienes compran en su nombre. Una persona pertenece a una empresa como máximo y puede estar asignada a una o varias de sus sucursales. ## Crea una empresa **1. Abre el formulario** Ve a **[Clientes → Empresas](https://app.riqra.com/clients/companies)** y haz clic en **Nueva empresa**. **2. Completa los datos legales** Ingresa la **Razón social**, el **Tipo de identificación fiscal**, el **Número de identificación fiscal** y el **Domicilio fiscal**. En Chile también se piden la **Actividad comercial** y la **Comuna del domicilio fiscal**. El número se valida según el país de tu organización y no puede repetirse entre empresas. **3. Agrega el contacto** El **Correo de contacto**, el **Teléfono** y el **Sitio web** son opcionales. **4. Guarda** Haz clic en **Guardar**. Se abre la ficha de la empresa. Para cargar muchas empresas a la vez, usa [Importa clientes desde Excel](/plataforma/transferencia-de-datos/importar-clientes). En **Empresas**, **Exportar → Empresas y sucursales** descarga el archivo con el mismo formato. Para asignar personas a sus empresas y sucursales en bloque, usa [Importa personas de empresas](/plataforma/transferencia-de-datos/importar-personas-de-empresas). ## La ficha de una empresa La pestaña **Resumen** reúne los datos legales y las secciones **Sucursales** y **Personas**. A la derecha hay un panel por cada ajuste de la empresa. | Panel | Qué hace | | - | - | | **Estado** | **Activa**, **En pausa**, **Bloqueada** o **Inactiva**. Marca cómo está la relación con la empresa; cámbialo con **Poner en pausa**, **Bloquear**, **Desactivar** o **Reactivar**. | | **Vendedor asignado** | El miembro de tu equipo que gestiona la empresa y sus sucursales. Lee [Asignación y carteras](/plataforma/conversaciones/asignacion-y-carteras). | | **Política comercial** | Las condiciones de compra de la empresa. Sin política propia, usa la de su segmento o la predeterminada. Lee [Asigna políticas a tus clientes](/plataforma/politicas-comerciales/asignar-a-clientes). | | **Línea de crédito** | El crédito con el que la empresa puede pagar. Lee [Asigna una línea de crédito](/plataforma/clientes/linea-de-credito). | La pestaña **Códigos** guarda la homologación de la empresa: qué código de producto del cliente corresponde a cada SKU tuyo. Lee [Importa códigos de cliente](/plataforma/transferencia-de-datos/importar-codigos). ## Agrega una sucursal **1. Abre el formulario** En la sección **Sucursales** de la empresa, haz clic en **Sucursal**. **2. Completa la sucursal** Ingresa el **Nombre** (por ejemplo «Tienda Centro» o «Almacén Norte») y la **Dirección de envío**. La ubicación, el código postal, las coordenadas GPS, el **Teléfono** y el **Correo de contacto** son opcionales. Si tu ERP identifica esta sede con un código, escríbelo en **ID externo (ERP)**. **3. Guarda** Haz clic en **Crear sucursal**. ### Datos legales distintos Por defecto, una sucursal factura con los datos legales de su empresa. Si una sucursal es otra entidad legal, marca **Usar datos legales distintos a los de la empresa** y completa su **Razón social**, identificación fiscal y **Domicilio fiscal**. Los campos que dejes vacíos siguen tomando el valor de la empresa. ### Estado de una sucursal Desde la ficha de la sucursal, **Desactivar** la marca como **Inactiva** y **Activar** la devuelve a **Activa**. El estado le indica a tu equipo si la sede sigue operativa; una sucursal inactiva conserva su historial y sigue disponible al asignar órdenes de compra. Cada sucursal puede tener su propio **Vendedor asignado** y su propia **Política comercial**; sin ellos, hereda los de la empresa. ## Agrega personas a la empresa En la sección **Personas** de la empresa: * **Persona** crea una persona nueva ya vinculada a la empresa. Pide **Nombre**, **Apellido** y un **Correo electrónico** o **Teléfono**. * **Vincular existente** busca una persona que ya está en tu lista y la vincula a la empresa. Para asignar a una persona a sucursales concretas, abre la ficha de la sucursal y usa **Persona** en la sección **Personas asignadas**, o abre la pestaña **Empresas y sucursales** de la persona y usa **Sucursal**. Quitar a una persona de una sucursal no la desvincula de la empresa. ## Elimina una empresa Eliminar una empresa la borra para siempre. Sirve para registros creados por error, de prueba o duplicados. Para una empresa con la que ya trabajaste, cambia su **Estado** a **Inactiva**. Solo los propietarios y administradores pueden eliminar empresas. No se puede eliminar una empresa que tenga órdenes de compra o movimientos en su línea de crédito, ni una cuyas personas tengan pedidos, cotizaciones o borradores de pedido. En la ficha de la empresa, ve a **Zona peligrosa** y elige **Eliminar**. Si algo lo impide, la zona indica qué. Con la empresa se borran sus sucursales, su línea de crédito y sus códigos. Sus personas no se eliminan: quedan sin empresa. # Qué son los clientes Source: https://docs.riqra.com/plataforma/clientes/introduccion Los clientes son las personas que te compran, las empresas a las que pertenecen y los segmentos que las agrupan para aplicar condiciones comerciales. Un cliente es siempre una **persona**: alguien con nombre, correo o teléfono, que compra en tu tienda, te escribe por WhatsApp o aparece como comprador en una orden de compra. Las personas se administran en **[Clientes → Personas](https://app.riqra.com/clients/individuals)**. Los **segmentos** agrupan personas y empresas que comparten condiciones comerciales, por ejemplo mayoristas o farmacias. Cada cliente pertenece a un segmento como máximo, y ese segmento define la [política comercial](/plataforma/politicas-comerciales/introduccion) con la que compra. > [!NOTE] > > Las **empresas** y sus **sucursales** aparecen en **Clientes** solo si usas [PedidosIA](/pedidos-ia/introduccion). Representan a la empresa compradora de cada orden de compra y sus puntos de entrega. Si vendes por tu tienda online, tus clientes son personas y se agrupan en segmentos. ## Qué guarda una persona | Datos | Para qué sirven | | - | - | | Nombre, apellido y documento | Identifican a la persona en pedidos y cotizaciones. | | Correo electrónico | Con él inicia sesión en la tienda y en él recibe invitaciones y notificaciones. | | Teléfono | Vincula sus conversaciones de WhatsApp y las campañas. No sirve para iniciar sesión. | | Código | Un identificador que tú asignas. Sirve para iniciar sesión cuando tu tienda usa [acceso por código](/plataforma/clientes/acceso-a-la-tienda). | | Datos de facturación | Documento fiscal, razón social y domicilio fiscal para emitir factura. | | Direcciones de entrega | Las direcciones que la persona elige en el checkout. | | Consentimientos | Por qué canales acepta recibir comunicaciones de marketing. | El correo y el teléfono son únicos dentro de tu organización: ninguna otra persona puede repetirlos. Toda persona necesita al menos uno de los dos, o un código. ## El estado de una persona Si vendes por tienda online, la columna **Estado** de la lista indica si la persona puede entrar a tu tienda: **Sin acceso**, **Invitada**, **Con acceso** o **Pausada**. Lee [Da acceso a la tienda](/plataforma/clientes/acceso-a-la-tienda). ## Siguientes pasos * [Administra tus personas](/plataforma/clientes/personas) * [Da acceso a la tienda](/plataforma/clientes/acceso-a-la-tienda) * [Agrupa clientes en segmentos](/plataforma/clientes/segmentos) * [Administra empresas y sucursales](/plataforma/clientes/empresas-y-sucursales) * [Asigna una línea de crédito](/plataforma/clientes/linea-de-credito) * [Importa personas desde Excel](/plataforma/transferencia-de-datos/importar-personas) # Asigna una línea de crédito Source: https://docs.riqra.com/plataforma/clientes/linea-de-credito Define cuánto puede comprar a crédito una empresa, permite o no el sobregiro y sigue cada consumo y liberación en su historial. > [!NOTE] > > La línea de crédito se asigna a una empresa, así que requiere [PedidosIA](/pedidos-ia/introduccion). Se usa en el checkout de tu tienda online: quienes compran en nombre de la empresa pueden pagar con su crédito. Una línea de crédito tiene un **límite**, un monto **utilizado** y una línea **disponible**, que es la diferencia entre los dos. Cada pedido que se confirma con línea de crédito suma al utilizado; cuando registras su pago o lo cancelas, el monto vuelve a la línea. ## Antes de empezar * Crea el método de pago **Línea de crédito** en **[Configuración → Pagos](https://app.riqra.com/settings/payments)**. Sin ese método activo, el checkout no ofrece pagar a crédito aunque la empresa tenga línea. * Vincula a la empresa las personas que comprarán en su nombre. Lee [Administra empresas y sucursales](/plataforma/clientes/empresas-y-sucursales). ## Asigna la línea **1. Abre la empresa** Ve a **[Clientes → Empresas](https://app.riqra.com/clients/companies)** y haz clic en la empresa. **2. Define el crédito** En el panel **Línea de crédito**, haz clic en **Asignar línea de crédito** y completa: * **Límite de crédito**: el monto máximo que la empresa puede tener pendiente de pago. * **Crédito habilitado**: desmárcalo para suspender el crédito sin borrar la línea ni su historial. * **Permitir sobregiro**: márcalo para que la empresa siga comprando a crédito después de agotar su límite. Cada pedido que supere la línea disponible queda **Por confirmar** hasta que lo revises. **3. Guarda** Haz clic en **Guardar**. El panel muestra la **Línea disponible** y el monto **Utilizado**. Puedes cambiar el límite en cualquier momento. Si lo bajas por debajo de la deuda actual, la línea disponible queda en negativo y el panel avisa **Deuda sobre el límite**: la empresa no compra a crédito hasta reducir su deuda, salvo que tenga sobregiro: en ese caso cada pedido queda por confirmar. Para asignar o cambiar las líneas de muchas empresas a la vez, incluido el monto utilizado, [importa líneas de crédito desde Excel](/plataforma/transferencia-de-datos/importar-lineas-de-credito). ## Encuentra las empresas con crédito En **[Clientes → Empresas](https://app.riqra.com/clients/companies)**, la columna **Crédito disponible** muestra la línea disponible de cada empresa, con una barra debajo que se llena según la parte del límite que sigue disponible: una línea nueva aparece llena y una agotada, vacía. Pasa el cursor sobre el monto para ver el utilizado y el límite. Cuando la deuda supera el límite, el monto y la barra vacía aparecen en ámbar. Cuando el crédito está deshabilitado, aparecen en gris con un ícono de pausa. Para ver solo las empresas que tienen línea, elige **Con crédito** en el filtro de crédito; **Sin crédito** muestra las que no tienen. Una línea deshabilitada cuenta como línea. ## Qué pasa en el checkout Cuando una persona vinculada a la empresa llega al checkout, el método **Línea de crédito** aparece solo si la empresa tiene una línea habilitada, junto con el monto disponible. * Si el total cabe en la línea disponible, la persona confirma el pedido y el total pasa al utilizado. * Si no cabe y la empresa tiene sobregiro, el pedido se crea igual y el total pasa al utilizado, pero queda **Por confirmar** hasta que lo revises. Lee [Pedidos por confirmar](#pedidos-por-confirmar). * Si no cabe y la empresa no tiene sobregiro, el método se muestra deshabilitado con el aviso «Tu línea de crédito no alcanza para este pedido. Elige otro método de pago.» El monto vuelve a la línea cuando registras el pago del pedido o cuando el pedido se cancela. ## Pedidos por confirmar Un pedido que supera la línea disponible de una empresa con sobregiro no se rechaza: se crea con el estado **Por confirmar** y espera tu decisión. Siempre pasa por tu revisión, sin importar el monto; no hay un ajuste para aprobarlo automáticamente. Solo quedan por confirmar los pedidos que el comprador hace en tu tienda online. Los que tu equipo crea o confirma desde el panel, incluidas las órdenes de compra de PedidosIA, nunca quedan por confirmar: quien los confirma ya es quien decide. Mientras el pedido está por confirmar: * Su total ya cuenta en el utilizado de la línea y su stock ya está reservado. * El comprador ve «¡Gracias por tu compra!» con el aviso de que el pedido quedó pendiente de confirmación, y recibe un correo con el mismo aviso. En **Mi cuenta** lo ve como **Por confirmar**. * Tu equipo recibe el correo «Pedido por confirmar» y, si tiene activadas las notificaciones del navegador, una notificación que indica que supera la línea de crédito. * No puedes iniciar su preparación, despacharlo ni marcarlo entregado, registrar un pago ni registrar su factura. El comprador tampoco puede pagarlo ni subir un comprobante de pago. * Suma a los totales de la lista de pedidos igual que cualquier otro estado: cuenta cuando no filtras la lista o cuando filtras por **Por confirmar**, y queda fuera si filtras por otro estado. Para encontrarlos, filtra la lista de pedidos por el estado **Por confirmar**. En el detalle, un aviso indica que el pedido supera la línea de crédito del cliente. Desde ahí tienes dos opciones: * Para confirmarlo, haz clic en **Confirmar pedido**. El pedido pasa a activo y sigue como cualquier otro, y el comprador recibe el correo «Confirmamos tu pedido». * Para rechazarlo, haz clic en **Rechazar pedido**. El motivo viene seleccionado como *Supera la línea de crédito*, y eliges si el stock vuelve al inventario y si se avisa al comprador, como en cualquier cancelación. El monto vuelve a la línea. ## Movimientos de crédito La sección **Movimientos de crédito** de la empresa lista cada cambio en los montos de la línea, con fecha, tipo, el pedido o el miembro del equipo que lo originó y el monto. | Tipo | Cuándo aparece | | - | - | | **Consumo** | Un pedido se pagó a crédito. Resta de la línea. | | **Liberación** | El pedido se pagó o se canceló. Suma a la línea. | | **Ajuste de límite** | Cambió el límite: alguien de tu equipo, desde el panel o con una importación, o la sincronización con tu ERP. | | **Ajuste de saldo** | Alguien de tu equipo reemplazó el monto utilizado con una importación. | | **Sincronización** | Tu ERP informó un monto utilizado distinto y la línea se actualizó a ese monto. | | **Saldo inicial** | La deuda que la empresa traía al migrar desde Riqra Legacy. | # Administra tus personas Source: https://docs.riqra.com/plataforma/clientes/personas Crea personas, edita sus datos de contacto y facturación, registra sus direcciones de entrega y revisa sus pedidos y consentimientos. La lista de **[Clientes → Personas](https://app.riqra.com/clients/individuals)** muestra a todas las personas de tu organización. Busca por nombre, correo, teléfono y, si los usas, código o empresa. Si vendes por tienda online, el filtro **Estado** muestra quién puede entrar a la tienda. Desde aquí también [importas](/plataforma/transferencia-de-datos/importar-personas) y exportas personas con Excel. Una persona puede llegar a tu lista por cuatro caminos: la creas tú, la importas, se registra en tu tienda o compra como invitada. ## Crea una persona **1. Abre el formulario** En **Personas**, haz clic en **Nueva persona**. **2. Completa los datos** **Nombre** y **Apellido** son obligatorios. Ingresa un **Correo electrónico**, un **Teléfono** o ambos. Si tu tienda usa [acceso por código](/plataforma/clientes/acceso-a-la-tienda), el **Código** también es obligatorio. Con [PedidosIA](/pedidos-ia/introduccion), puedes elegir la **Empresa** a la que pertenece. **3. Guarda** Haz clic en **Agregar**. Se abre la ficha de la persona. Si el correo o el teléfono ya pertenecen a otra persona, el formulario lo indica y no crea el registro. Corrige el dato o abre la persona existente. ## La ficha de una persona La ficha se divide en pestañas. | Pestaña | Qué contiene | | - | - | | **Resumen** | Datos de contacto, datos de facturación, el panel **Estado** y, si la persona tiene un ID en tu ERP, el panel **Integraciones**. | | **Empresas y sucursales** | La empresa a la que pertenece y las sucursales que tiene asignadas. Solo con [PedidosIA](/pedidos-ia/introduccion). Para asignar muchas personas a la vez, [importa personas de empresas](/plataforma/transferencia-de-datos/importar-personas-de-empresas). | | **Pedidos** | El historial de pedidos de la persona. | | **Direcciones de entrega** | Las direcciones guardadas para el checkout. | | **Comunicaciones** | Los consentimientos de marketing por canal y, si aplica, la exclusión de envíos. | Si la persona tiene teléfono, el botón **Enviar WhatsApp** abre una conversación con ella desde la bandeja de [Conversaciones](/plataforma/conversaciones/responder-mensajes). ## Edita los datos de contacto En **Resumen**, edita los campos y haz clic en **Guardar**. Dos reglas protegen la identidad de la persona: * **No puedes quitar su única identidad.** Sin correo, sin teléfono y sin código no habría forma de identificarla, así que el cambio se rechaza. * **No puedes usar un correo o un teléfono que ya sea de otra persona.** Primero libéralo desde la otra ficha. Cuando cambias el correo de una persona **Con acceso**, su correo anterior recibe un aviso y el nuevo correo queda **Sin verificar**. La persona lo verifica sola con un código en su siguiente inicio de sesión. Lee [Da acceso a la tienda](/plataforma/clientes/acceso-a-la-tienda). ## Datos de facturación En la sección **Datos de facturación**, haz clic en **Agregar datos de facturación** para registrar el **Documento fiscal**, la **Razón social** y el **Domicilio fiscal** de la persona. En Chile también se piden la **Actividad comercial (giro)** y la **Comuna del domicilio fiscal**. Estos datos se usan para emitir factura; sin ellos se emite boleta. **Quitar** borra el bloque completo. ## Bloquea la edición de los datos del comprador Si administras a tus clientes desde tu sistema de facturación o tu ERP, cada pedido debe llevar el mismo documento con el que están registrados ahí. Si un comprador escribe otro DNI, RUC o RUT en el checkout, en tu ERP termina como un cliente nuevo o como el cliente equivocado. Para evitarlo, en **[Configuración → Checkout](https://app.riqra.com/settings/checkout)**, sección **Campos de contacto**, activa **La tienda administra los datos del comprador**. Con la opción activada: * Si la ficha ya tiene nombre, apellido, documento personal o datos de facturación, esos datos se muestran en el checkout y en **Mis datos**, pero la persona no puede editarlos. El pedido siempre usa los datos de la ficha. * El documento fiscal (RUC o RUT) de la ficha identifica a quién se factura, y solo tú lo registras. Si la ficha no lo tiene, la persona no puede pedir factura: en el checkout ve **Necesito factura** desactivado y, tanto ahí como en **Mis datos**, el aviso «Para facturar, contacta a la tienda para completar tus datos de facturación». Agrega el documento fiscal en la ficha para habilitarlo; lo demás que la ficha ya guarde, por ejemplo una razón social, no se modifica. * Lo que falta alrededor del documento fiscal lo completa la persona una vez, en el checkout o en **Mis datos**, campo por campo. Si sus datos de facturación llegaron de una migración y solo les falta la comuna, ve el resto bloqueado y elige únicamente la comuna. Después de guardarlo, tampoco puede cambiarlo. * Con el documento fiscal en la ficha, **Necesito factura** está disponible. Al marcarlo, la persona ve los datos de facturación de la ficha bloqueados y completa los que falten: el pedido se emite con factura y la ficha queda completa para la próxima compra. * Cuando la factura está disponible, la persona sigue eligiendo entre boleta y factura, y siempre sigue administrando sus consentimientos. Cualquier corrección la haces tú desde la ficha de la persona. Activar el interruptor no modifica los datos ya guardados ni los pedidos anteriores. ## Direcciones de entrega En **Direcciones de entrega**, haz clic en **Nueva**. Cada dirección tiene un **Nombre** (por ejemplo «Casa» u «Oficina»), la **Dirección**, una **Referencia / interior**, la ubicación, el código postal, las coordenadas GPS, los datos de quien recibe y las **Instrucciones de entrega**. La primera dirección queda como principal. Con varias, elige otra con **Marcar como principal** desde el menú de la dirección. Una dirección que ya no se usa se quita con **Archivar**. La principal no se puede archivar: primero marca otra como principal. La persona también crea y elige direcciones desde el checkout de la tienda. Todas aparecen en esta pestaña. ## Comunicaciones La pestaña **Comunicaciones** muestra un interruptor por canal: **Correo**, **SMS** y **WhatsApp**. Debajo de cada uno se lee cómo y cuándo se dio el consentimiento: al registrarse, en el checkout, desde su cuenta, por WhatsApp, por importación o activado por tu equipo. La [importación de personas](/plataforma/transferencia-de-datos/importar-personas) desde Excel no registra ni cambia consentimientos. Los cambios que haces aquí quedan registrados como activados por el equipo de la tienda, no como consentimiento dado por el cliente. Las [campañas](/whatsapp/crear-campana) solo llegan a las personas con el canal activado. Si el número de la persona está en la lista de exclusión, la sección **Exclusión de envíos** muestra el motivo: un error de entrega de WhatsApp o una exclusión hecha por alguien de tu equipo. **Reactivar** lo saca de la lista. Una persona excluida no recibe campañas ni plantillas, pero sí puede seguir conversando en una conversación abierta. ## Pausa una persona En el panel **Estado** de la pestaña **Resumen**, con **Pausar** la persona deja de poder iniciar sesión y hacer pedidos; **Activar** devuelve todo a la normalidad. Lee [Da acceso a la tienda](/plataforma/clientes/acceso-a-la-tienda) para el detalle de lo que bloquea una pausa. ## Elimina una persona Eliminar una persona la borra para siempre. Sirve para registros creados por error, de prueba o duplicados. Para dejar de venderle a alguien que ya te compró, [páusala](#pausa-una-persona). Solo los propietarios y administradores pueden eliminar personas. No se puede eliminar una persona que tenga pedidos, cotizaciones, borradores de pedido, conversaciones o mensajes de campañas. En la pestaña **Resumen** de la persona, ve a **Zona peligrosa** y elige **Eliminar**. Si algo lo impide, la zona indica qué. Con la persona se borran su acceso a la tienda, sus direcciones de entrega, sus favoritos, sus consentimientos, sus asignaciones a sucursales y su ID en tu ERP. # Agrupa clientes en segmentos Source: https://docs.riqra.com/plataforma/clientes/segmentos Crea segmentos, asígnales una política comercial y agrega o quita personas y empresas. Un segmento agrupa clientes que comparten condiciones comerciales: mayoristas, farmacias, clientes VIP. Cada persona y cada empresa pertenece a un segmento como máximo. El segmento agrupa a los clientes; su [política comercial](/plataforma/politicas-comerciales/introduccion) define el catálogo, los precios y las condiciones con las que compran. Un cliente sin segmento, o un segmento sin política, usa la política predeterminada de tu organización. No existe un segmento predeterminado. ## Crea un segmento **1. Abre el formulario** Ve a **[Clientes → Segmentos](https://app.riqra.com/clients/segments)** y haz clic en **Crear segmento**. **2. Ponle nombre** Escribe un **Nombre** único en tu organización y, si quieres, una **Descripción**. Ambos son solo para tu equipo; los clientes no ven su segmento. **3. Elige la política** En el panel **Política comercial**, selecciona la política que recibirán los miembros. Puedes dejarlo en **Sin política asignada** y elegirla después. **4. Guarda** Haz clic en **Guardar**. Se abre el segmento con sus listas de miembros vacías. ## Agrega miembros En el segmento, la sección **Personas** lista a sus miembros. Con [PedidosIA](/pedidos-ia/introduccion), la sección se llama **Empresas y personas** y tiene una pestaña por tipo. **1. Abre el selector** En la pestaña que corresponda, haz clic en **Agregar**. **2. Selecciona** Busca y marca a las personas o empresas. Las que ya están en el segmento aparecen como **Asignado**; las que pertenecen a otro segmento muestran su nombre. **3. Confirma** Haz clic en **Agregar**. Si seleccionaste clientes de otro segmento, se mueven a este: un cliente no puede estar en dos segmentos. Los cambios aplican de inmediato. La tienda recalcula el carrito de cada persona con su nueva política en su siguiente visita. También puedes asignar el segmento al [importar personas](/plataforma/transferencia-de-datos/importar-personas): la columna `segmento` recibe el nombre y, si el segmento no existe, se crea. ## Quita miembros En la lista de miembros, pasa el cursor sobre una fila y haz clic en **Quitar**, o marca varias filas y quítalas en bloque. El cliente sigue existiendo; solo deja de tener segmento y vuelve a la política predeterminada. ## Elimina un segmento Al final de la página, **Eliminar segmento** lo borra de forma permanente. Sus miembros quedan sin segmento; ni las personas ni las empresas ni la política comercial se eliminan. # Asignación y carteras de venta Source: https://docs.riqra.com/plataforma/conversaciones/asignacion-y-carteras Reparte conversaciones entre tu equipo y define qué empresas gestiona cada vendedor. Cada conversación se atiende por **una sola persona** a la vez. Este artículo explica los roles del equipo, cómo se asignan las conversaciones y cómo las **carteras de venta** definen qué empresas gestiona cada vendedor. ## Roles del equipo Configuras los roles en **[Configuración → Equipo](https://app.riqra.com/settings/team)**. | Rol | Qué puede hacer | | - | - | | **Propietario** | Acceso total. | | **Administrador** | Gestiona el equipo y asigna conversaciones. | | **Supervisor** | Supervisa a un grupo de vendedores y puede asignar conversaciones sin asignar. | | **Vendedor** | Atiende las conversaciones que reclama o que le asignan. | ## Carteras de venta (portafolio) Cada vendedor tiene un **Portafolio**: las empresas y sucursales que gestiona. Lo defines en el perfil del miembro, en **[Configuración → Equipo](https://app.riqra.com/settings/team)** → sección **Portafolio** → **Asignar portafolio**. * Al asignar una empresa a un vendedor (**Vendedor asignado**), el vendedor gestiona esa empresa y todas sus sucursales. * Una sucursal puede usar un **vendedor distinto** al de la empresa; si no, **hereda de empresa**. ## Supervisores Un supervisor supervisa a un grupo de vendedores. En el perfil del supervisor, la sección **Vendedores en el equipo** define a quiénes supervisa. ## Cómo se asignan las conversaciones La asignación es **manual**: * **Vendedor**: en una conversación **Sin asignar**, hace clic en **Reclamar** para asignársela. * **Propietario, Administrador o Supervisor**: usa **Asignar conversación** para elegir a un miembro en **Asignar a** y, si quiere, dejar una **Nota para el equipo (opcional)**. Solo la persona asignada puede responder. ## Asignación automática con flujos Un [flujo](/plataforma/flujos/introduccion) puede asignar la conversación por ti con un nodo de **Acción**: * **Asignar a vendedor** — la deriva al vendedor según la cartera del cliente. * **Asignar a miembro** — la asigna a un miembro específico. * **Asignar a cola** — la deja en la cola para que alguien la reclame. > [!NOTE] > > No existe un reparto automático por turnos (round-robin). Las conversaciones se asignan a mano (**Reclamar** / **Asignar**) o mediante un **flujo**. # Conversa con tus clientes desde tu tienda Source: https://docs.riqra.com/plataforma/conversaciones/chat-en-tienda Tus clientes te escriben desde la tienda y les respondes desde Conversaciones. El chat en tienda es un canal de Riqra Inbox. Tus clientes con sesión iniciada te escriben mientras navegan tu tienda y tú les respondes desde **[Conversaciones](https://app.riqra.com/conversations)**, en la misma conversación donde ves los mensajes de su número de WhatsApp. Si un cliente te escribe desde otro número, ese número tiene su propia conversación. Si quieres, también te escriben los visitantes que no tienen cuenta o no iniciaron sesión (ver [Visitantes sin cuenta](#visitantes-sin-cuenta)). Cada canal se activa por separado: puedes usar solo el chat en tienda, solo WhatsApp o ambos. Si usas solo el chat en tienda, Conversaciones no muestra lo que es de WhatsApp: iniciar una conversación nueva, los flujos y la ventana de 24 horas. > [!NOTE] > > El chat en tienda necesita dos productos: **Riqra Inbox**, que incluye **Conversaciones** y **Configuración → Riqra Inbox**, y la [Tienda online](/tienda-online/introduccion). Sin Riqra Inbox no ves ninguna de las dos páginas; sin la Tienda online, no aparece el canal **Chat en tienda**. Si te falta alguno, contacta a tu ejecutivo de Riqra. ## Activa el chat **1. Abre la configuración** Ve a **Configuración → Riqra Inbox** y, en **Canales**, haz clic en **Configurar** junto a **Chat en tienda**. **2. Activa el chat** Activa **Mostrar el chat en la tienda**. **3. Escribe la bienvenida** Escribe un **Mensaje de bienvenida**. Es lo primero que ve tu cliente al abrir el chat. **4. Guarda** Haz clic en **Guardar**. El botón del chat aparece en las páginas de tu tienda para los clientes con sesión iniciada. El checkout no lo muestra. ## Qué ve tu cliente * Un botón de chat en la esquina inferior de la tienda. * Tus respuestas al instante mientras navega. Si cierra el chat, el botón le avisa que tiene mensajes nuevos. * Los archivos que le envías: ve las imágenes, mira los videos y escucha los audios en el chat, y abre los documentos con un clic. * Un clip para adjuntar fotos y documentos (PDF, Word, Excel, PowerPoint o TXT) de hasta 4 MB, con un comentario opcional. Si una foto pesa más, la tienda la reduce antes de enviarla. * Su historial en cualquier dispositivo, porque queda en su cuenta. Si no está en la tienda cuando respondes, ve tu respuesta la próxima vez que entre. * Solo lo que se habló por la tienda. Lo que hablan por WhatsApp sigue en su WhatsApp. * Tu [mensaje fuera de horario](/plataforma/conversaciones/horario-de-atencion), si te escribe cuando no atiendes y lo tienes activado. ## Responde desde Conversaciones Los mensajes del chat llegan a la persona asignada al cliente, igual que los de WhatsApp. Si no tiene a nadie asignado, la conversación queda en **Sin asignar**. Cada mensaje indica su canal (**Tienda** o **WhatsApp**) y el de la tienda muestra la página desde la que te escribió. Si puedes responderle por los dos canales, elige cuál en **Responder por**. Por defecto es el canal por el que el cliente escribió por última vez. El chat en tienda no tiene la ventana de 24 horas de WhatsApp. Por él envías los mismos archivos que por WhatsApp (documentos, imágenes, videos y audios), pero no plantillas. Al resolver la conversación no se pierde nada: si el cliente vuelve a escribir, por la tienda o desde el mismo número de WhatsApp, sigue en la misma conversación. ## Visitantes sin cuenta Activa **Visitantes sin cuenta** en **Configuración → Riqra Inbox → Chat en tienda** para que cualquier visitante te escriba sin iniciar sesión. Viene desactivado: hasta que lo actives, solo te escriben los clientes con sesión iniciada. Las tiendas cerradas no muestran el chat a los visitantes, porque solo ven la página para iniciar sesión. * **Qué ve el visitante:** el mismo chat que tus clientes, con tu mensaje fuera de horario si te escribe cuando no atiendes. Su conversación queda guardada en ese navegador, así que la ve si vuelve a la tienda desde el mismo dispositivo y navegador. * **Su correo:** después de su primer mensaje, el chat le pide un correo opcional para que puedas contactarlo si se va. Lo ves debajo del nombre en Conversaciones. Riqra no le envía correos: si quieres escribirle, hazlo tú. * **Dónde llega:** como un visitante no tiene vendedor asignado, su conversación llega a **Sin asignar**, con el nombre **Visitante**. Cualquiera del equipo puede reclamarla. Le respondes por el chat en tienda: lo ve al instante si sigue en la tienda, o la próxima vez que vuelva desde ese navegador. * **Cuando inicia sesión:** si el visitante inicia sesión en tu tienda, su conversación se une a la de su cuenta, con todo lo que escribió antes. En la conversación ves el aviso **El visitante inició sesión como** y su nombre. Un correo escrito en el chat no vincula al visitante con ningún cliente: solo iniciar sesión lo hace, porque cualquiera puede escribir cualquier correo. # Organiza conversaciones con etiquetas Source: https://docs.riqra.com/plataforma/conversaciones/etiquetas Clasifica tus conversaciones con etiquetas de colores. Las etiquetas te ayudan a clasificar conversaciones (por ejemplo, **Cotización**, **Reclamo** o **Mayorista**) y a encontrarlas más rápido. Cada conversación admite hasta **10 etiquetas**. ## Agrega una etiqueta **1. Abre la conversación** Entra a **[Conversaciones](https://app.riqra.com/conversations)** y selecciona la conversación que quieres etiquetar. **2. Abre el selector de etiquetas** En el panel lateral, busca la sección **Etiquetas**. Si no tiene ninguna, verás **Sin etiquetas**; haz clic en **Agregar etiqueta**. Si ya tiene etiquetas, haz clic en **Editar**. **3. Elige o crea una etiqueta** En el buscador **Buscar o crear etiqueta...**, selecciona una etiqueta existente o escribe un nombre nuevo (hasta 50 caracteres) y haz clic en **Crear etiqueta "…"**. ## Quita una etiqueta En la sección **Etiquetas** de la conversación, haz clic en la **✕** de la etiqueta que quieres quitar. > [!NOTE] > > Si una conversación ya tiene 10 etiquetas, verás el aviso **Máximo 10 etiquetas por conversación.** y deberás quitar una antes de agregar otra. ## Cómo se ven en la lista En la lista de conversaciones, cada fila muestra sus etiquetas como chips de color. Cuando hay más de dos, aparece un indicador **+N** con la cantidad restante. # Responde fuera de tu horario de atención Source: https://docs.riqra.com/plataforma/conversaciones/horario-de-atencion Define cuándo atiende tu equipo y deja que Riqra Inbox responda por ti el resto del tiempo, en todos tus canales. Tu horario de atención vale para todos los canales de Riqra Inbox. Fuera de ese horario, Riqra Inbox contesta con tu **mensaje fuera de horario** cualquier mensaje que llegue, por WhatsApp o por el [chat en tienda](/plataforma/conversaciones/chat-en-tienda), sin palabras clave. ## Define tu horario **1. Abre la configuración** Ve a **Configuración → Riqra Inbox**. **Horario de atención** es la primera sección. **2. Activa el horario** Activa **Definir un horario**. Empieza con lunes a viernes de 9:00 a 18:00. **3. Ajusta los días** Apaga los días en que no atiendes y cambia las horas de los demás. Con **+** agregas otro horario al mismo día, por ejemplo para cerrar a la hora de almuerzo. Con el ícono de copiar pasas el horario de un día a todos los días abiertos. **4. Revisa la zona horaria** Debajo de los días eliges la zona horaria del horario. Por defecto es la de tu organización. ## Activa el mensaje fuera de horario **1. Activa el mensaje** En la misma sección, activa **Mensaje fuera de horario**. Solo se puede activar con un horario definido. **2. Escribe el mensaje** Por ejemplo: *"¡Gracias por escribirnos! Atendemos de lunes a viernes de 9:00 a 18:00. Te responderemos apenas regresemos."* **3. Guarda** Haz clic en **Guardar**. ## Cuándo se envía * **A cualquier mensaje.** No depende de palabras clave: basta con que el cliente te escriba fuera de tu horario. * **Por el canal donde te escribieron.** Si te escribe por WhatsApp, la respuesta sale por WhatsApp; si te escribe desde la tienda, la ve en el chat de la tienda. * **Una vez cada vez que cierras.** Si el cliente escribe varias veces la misma noche o el mismo fin de semana, la recibe solo la primera vez en cada canal. La próxima vez que cierres, vuelve a enviarse. * **Sin interrumpir a tu equipo.** Si alguien de tu equipo le escribió en los últimos 30 minutos, por ejemplo a la hora de cierre, no se envía. * **Aparte de los flujos.** Se envía aunque un [flujo](/plataforma/flujos/introduccion) también responda. Si antes respondías fuera de horario con un flujo, despublícalo para que tu cliente no reciba dos avisos. > [!NOTE] > > Cada horario incluye su hora de apertura pero no la de cierre: con **9:00 – 18:00**, un mensaje de las 18:00 en punto ya está fuera de horario. ## En Conversaciones El mensaje aparece en la conversación con la etiqueta **Fuera de horario**. La lista sigue mostrando lo que escribió el cliente, y la conversación queda pendiente de respuesta para que tu equipo la atienda al volver. # Responde mensajes desde la bandeja Source: https://docs.riqra.com/plataforma/conversaciones/responder-mensajes Atiende en un solo lugar los mensajes que tus clientes te envían por WhatsApp y por el chat de tu tienda. La sección **[Conversaciones](https://app.riqra.com/conversations)** reúne en un solo lugar los mensajes de tus clientes por WhatsApp y por el [chat en tienda](/plataforma/conversaciones/chat-en-tienda). Lo que un cliente te escribe desde la tienda y desde su número de WhatsApp queda en la misma conversación; si te escribe desde otro número, ese número tiene la suya. Desde ahí lees y respondes. Para recibir mensajes de WhatsApp necesitas [conectar tu número](/whatsapp/elegir-conexion). ## Encuentra una conversación En la parte superior de la lista puedes filtrar por: * **Todas**, **Mías**, **Sin asignar** y **Sin cliente**. * Estado: **Abierta**, **Pendiente** o **Resuelta**. También puedes usar el buscador (**Buscar conversación...**) para encontrar a un cliente por nombre o teléfono. ## Responde un mensaje Haz clic en una conversación para abrirla. En el cuadro inferior, escribe en **Escribe un mensaje...** y envía tu respuesta. Si puedes responderle por los dos canales, elige cuál en **Responder por**. Por defecto es el último por el que te escribió. WhatsApp necesita el número del cliente y la tienda, que la conversación esté vinculada a una persona. Por la tienda, tu respuesta le llega cuando entra con su sesión iniciada. El botón **Adjuntar archivo** te permite enviar, por cualquiera de los dos canales: * **Documento** * **Imagen** * **Video** * **Audio** En WhatsApp también te permite enviar una **Plantilla**. ## Asignación de conversaciones Solo la persona asignada puede responder una conversación. * Si la conversación está **Sin asignar**, verás el aviso **Conversación sin asignar** y un botón **Reclamar**. Al reclamarla, queda asignada a ti y puedes responder. * Si está asignada a otra persona, verás **Solo la persona asignada puede responder en esta conversación.** Para repartir conversaciones en tu equipo, revisa [Asignación y carteras de venta](/plataforma/conversaciones/asignacion-y-carteras). > [!NOTE] > > En WhatsApp solo puedes responder con texto libre dentro de la **ventana de 24 horas**. Si la ventana se cerró, deberás enviar una plantilla. Lee [Qué es la ventana de 24 horas](/whatsapp/ventana-de-24-horas). El [chat en tienda](/plataforma/conversaciones/chat-en-tienda) no tiene esta restricción. ## Organiza tu trabajo Usa [etiquetas](/plataforma/conversaciones/etiquetas) para clasificar las conversaciones y encontrarlas más rápido. # Dibuja áreas de reparto Source: https://docs.riqra.com/plataforma/envios/areas Dibuja en un mapa los polígonos donde repartes, o impórtalos desde un archivo KMZ o KML. Un área de reparto es un polígono dibujado sobre un mapa. Sirve para ver y compartir dónde repartes, con la precisión de calles que una división geográfica no tiene. Las administras en **[Configuración → Envío → Áreas](https://app.riqra.com/settings/shipping/areas)**. Las áreas son un mapa de referencia. La cobertura que ofrece y cobra el delivery en el checkout se define con [zonas](/plataforma/envios/zonas) por división geográfica. ## Crea un área **1. Abre el formulario** En **Configuración → Envío → Áreas**, haz clic en **Crear área**. **2. Escribe el nombre y elige un color** El **Nombre** es único en tu organización. El **Color en el mapa** distingue el área de las demás. **3. Dibuja o importa el polígono** Usa la herramienta de polígono o de rectángulo del mapa para dibujar el área. Puedes dibujar varios polígonos en la misma área, editar sus vértices y moverlos. Si ya tienes el área en otra herramienta, como Google My Maps, exporta un archivo KMZ o KML y haz clic en **Importar KMZ/KML**. Un área admite hasta 20 000 vértices. **4. Guarda** Haz clic en **Crear área**. ## Exporta un área Abre el área y haz clic en **Exportar KML** o **Exportar KMZ**. El archivo sirve como respaldo o para editar el área en otra herramienta y volver a importarla. ## Elimina un área Al final del detalle, haz clic en **Eliminar área** y confirma. # Entrega y recoge con couriers Source: https://docs.riqra.com/plataforma/envios/couriers Registra las empresas de transporte con las que trabajas y sus agencias, y ofrécelas para recojo en agencia o entrega a domicilio. Un courier es una empresa de transporte a la que entregas tus paquetes, como Olva, Shalom o Starken. Sus agencias son sus oficinas. El comprador puede recoger su pedido en una agencia, o la agencia puede hacer la entrega hasta su puerta. Los registras en **[Configuración → Envío → Couriers](https://app.riqra.com/settings/shipping/couriers)** y los usas desde dos tipos de método. | Método | Qué hace el courier | | - | - | | **Recojo en agencia** | Lleva el pedido a una de sus agencias y el comprador lo recoge ahí. | | **Delivery** con **Entrega a través de courier** | Lleva el pedido hasta la dirección del comprador. | ## Registra un courier **1. Crea el courier** En **Configuración → Envío → Couriers**, haz clic en **Nuevo courier**. Escribe el **Nombre** y sube un **Logo** si quieres. En **Plantilla de seguimiento**, pega la URL de rastreo del courier con `{trackingNumber}` donde va el número de guía, por ejemplo `https://courier.com/rastreo?guia={trackingNumber}`. Al despachar un pedido, la URL de rastreo se completa sola con la guía. Haz clic en **Crear courier**. **2. Agrega las agencias** En **Agencias**, haz clic en **Agregar agencia**. Completa el **Nombre**, la **Dirección**, la división geográfica, el **Teléfono** y el **Horario de atención** si lo tienes. Activa lo que la agencia ofrece: * **Entrega a domicilio**. La agencia lleva pedidos hasta la puerta del comprador. * **Permite recojo**. El comprador puede recoger su pedido en la agencia. * **Recibe tus envíos**. Es la agencia donde tú entregas los paquetes al courier. Solo una por courier. Una agencia activa debe tener al menos una de las tres opciones. **3. Guarda** Haz clic en **Agregar agencia** en el diálogo y luego en **Guardar** en el courier. Las agencias se guardan junto con el courier. La división geográfica de la agencia importa. Con **Prepagado**, el costo del recojo en agencia se calcula con la zona donde cae la agencia, igual que con una dirección. Una agencia fuera de todas las zonas del método no se ofrece. ## Ofrece recojo en agencia **1. Crea el método** Ve a **[Configuración → Envío → Métodos](https://app.riqra.com/settings/shipping/methods)**, haz clic en **Crear método**, escribe el **Nombre** y elige el tipo **Recojo en agencia**. **2. Elige los couriers** En **Courier**, marca los couriers que ofrece el método. El comprador verá las agencias con **Permite recojo** de todos ellos. **3. Define quién paga el envío** En **Cobro del envío**, elige una opción. La sección [Cobro del envío](#cobro-del-envio) las explica. **4. Elige el origen y las zonas** En **Cobertura**, elige la ubicación de origen. Con **Prepagado**, agrega las [zonas](/plataforma/envios/zonas) que cubren las agencias y define su tarifa. Con **Flete por pagar**, las zonas son opcionales. **5. Guarda y activa** Haz clic en **Guardar** y luego en **Activar**. El método necesita al menos un courier activo con una agencia activa que permita recojo. En el checkout, el comprador elige **Recojo en agencia**, luego el método y luego una agencia. Las agencias se agrupan por courier y por región, y con más de doce aparece un buscador. Cada agencia muestra su dirección, su división y su horario. El teléfono del comprador es obligatorio, porque la agencia lo llama cuando el pedido llega. ## Entrega a domicilio con courier En un método de **Delivery**, activa **Entrega a través de courier** en la sección **Courier** y marca los couriers. Elige el **Cobro del envío**. Con **El cliente elige la agencia de destino**, el comprador elige en el checkout la agencia con **Entrega a domicilio** que lleva el pedido a su dirección. Sin esa opción, el comprador solo ve el método y el pedido registra el courier cuando el método tiene uno solo. La dirección del comprador sigue definiendo la zona, el costo y el plazo. ## Cobro del envío | Opción | Qué paga el comprador en el checkout | Qué ve | | - | - | - | | **Prepagado** | El costo de la zona donde cae su dirección o la agencia elegida. | El costo o **Gratis**. | | **Flete por pagar** | Nada. Paga el envío al courier al recibir o al recoger. | **Por pagar al courier** en el método y **Flete por pagar** en el resumen. | Con **Flete por pagar**, el pedido registra un costo de envío de 0 y muestra la etiqueta **Flete por pagar** en el panel. En un método de Delivery, esta opción necesita al menos un courier. ## Qué registra el pedido El pedido guarda el courier, la agencia elegida y su dirección, y la agencia que recibe tus envíos si el courier tiene una. El panel de pedidos muestra un panel **Recojo en agencia** con courier, agencia y dirección, o las líneas **Courier** y **Agencia de destino** en una entrega a domicilio. Al despachar un pedido con courier, el diálogo **Despachar pedido** trae el courier elegido por el comprador, que no se puede cambiar, y completa la **URL de rastreo** con la plantilla del courier al escribir el **Número de guía**. En un pedido sin courier elegido, puedes seleccionar uno al despachar. Un pedido de recojo en agencia pasa por **Por preparar**, **En preparación**, **Despachado a agencia** y **Recogido**. ## Archiva o elimina un courier Abre el courier y haz clic en **Archivar**. Un courier archivado no se ofrece en los métodos ni en el despacho. Si era el último courier activo de un método, el método pasa a inactivo y muestra el motivo. Puedes restaurarlo cuando quieras. Una agencia se archiva desde su menú en la lista de agencias. Las agencias no se eliminan. Para eliminar un courier, quítalo de todos los métodos que lo ofrecen. Los pedidos existentes conservan su información de envío. # Configura un método de Delivery Source: https://docs.riqra.com/plataforma/envios/delivery Crea un método que reparte a la dirección del comprador, con una ubicación de origen y una tarifa y un plazo por zona. Un método de **Delivery** lleva el pedido a la dirección del comprador. Despacha desde una [ubicación](/plataforma/inventario/ubicaciones) de origen y cubre una o más [zonas](/plataforma/envios/zonas). Cada zona define cuánto cuesta el envío y en cuántas horas llega. ## Antes de empezar * Crea las [zonas](/plataforma/envios/zonas) que va a cubrir el método. * Confirma que la ubicación desde la que despachas está activa en **Configuración → Ubicaciones**. * Si vas a cobrar por peso, completa el peso de tus [variantes](/plataforma/productos/variantes). ## Crea el método **1. Crea el método** Ve a **[Configuración → Envío → Métodos](https://app.riqra.com/settings/shipping/methods)** y haz clic en **Crear método**. Escribe el **Nombre**, elige el tipo **Delivery** y haz clic en **Crear método**. El tipo no se puede cambiar después. **2. Describe el método** En **Información básica**, escribe una **Descripción** si quieres, por ejemplo «Recibe tu pedido en 24 a 72 horas, no incluye feriados». El comprador la ve junto al método en el checkout. **3. Elige el origen** En **Cobertura**, haz clic en **Elegir origen** y selecciona la ubicación activa desde la que despachas. El stock de los pedidos de este método sale de esa ubicación, salvo que la política comercial del comprador use **Ubicaciones seleccionadas**. En ese caso el stock sale de la ubicación de compra que fija la política. Lee [Controla el stock en la tienda](/plataforma/inventario/control-de-stock). **4. Agrega las zonas** Haz clic en **Agregar zona** y marca las zonas que cubre el método. Cada zona aparece como una fila con su **Tarifa**, su **Costo** y, si activas la programación de entrega, su **Plazo**. **5. Define la tarifa de cada zona** Elige **Fijo**, **Por kg** o **Por tramo de peso** y completa el costo o los tramos. La sección [Tarifas](#tarifas) explica cada opción. **6. Guarda y activa** Haz clic en **Guardar** y luego en **Activar**. Un método nuevo nace inactivo y solo aparece en el checkout cuando lo activas. ## Tarifas Cada zona del método tiene una de tres tarifas. La misma zona puede tener otra tarifa en otro método. ### Fijo Un monto único por pedido. Deja el **Costo** vacío o en 0 para que el envío a esa zona sea gratis. El checkout muestra **Gratis**. ### Por kg Una escala de tramos de peso, cada uno con una tarifa por kilo. Haz clic en **Editar tramos** para definirla. * Cada tramo cubre **Hasta (kg)** un peso máximo, con hasta tres decimales. Los pesos van en orden creciente y el último tramo queda abierto, **En adelante**. * El tramo se elige con el peso exacto del pedido. La tarifa del tramo se multiplica por el peso redondeado a kilos enteros. Un pedido de 7.5 kg cae en el tramo de hasta 10 kg y paga 8 kilos. Un pedido menor a 0.5 kg paga 0. * Cada tarifa es mayor a cero. Para una zona gratis usa la tarifa **Fijo** sin costo. ### Por tramo de peso La misma escala de tramos, pero cada tramo tiene un monto único. El pedido paga el monto del tramo donde cae su peso. ### El peso del pedido El peso del pedido es la suma de cantidad por peso de cada variante del carrito. Si alguna variante del carrito no tiene peso, el método con tarifa por peso no se ofrece para ese carrito. Los métodos con tarifa **Fijo** y los de recojo no se ven afectados. ## Plazo de entrega El **Plazo** de una zona es el tiempo, en horas, entre el pedido y la entrega para las direcciones de esa zona. Un plazo de 0 promete entrega el mismo día. El plazo depende de la dirección, no del método, así que cada zona tiene el suyo. La columna **Plazo** aparece solo cuando activas la **Programación de entrega** del método. Con la programación activa, el comprador elige una fecha de entrega en el checkout y el plazo de su zona define desde qué fecha puede elegir. Lee [Programa las fechas de entrega](/plataforma/envios/programacion-de-entrega). Sin programación, el pedido no pide fecha y el plazo no se muestra. Usa la **Descripción** del método para informar el tiempo de entrega. ## Qué ve el comprador En el checkout, el comprador elige **Envío**, escribe su dirección y busca su distrito, o la división equivalente en tu país. Con el distrito elegido, ve los métodos de Delivery activos cuya cobertura incluye ese distrito, en el orden de la lista de métodos. Cada método muestra su nombre, su descripción y el costo de la zona, o **Gratis**. Si el distrito no cae en ninguna zona de ningún método, el comprador ve «No hay envío disponible para esta zona» y solo puede elegir recojo, si tienes alguno activo. El costo de envío se suma al total del pedido y lleva el impuesto predeterminado de tu organización. Una promoción de tipo Envío gratis lo deja en cero y el comprador ve el costo original tachado. > [!NOTE] > > El comprador solo ve los métodos que permite su [política comercial](/plataforma/politicas-comerciales/crear-una-politica). Una política con **Métodos seleccionados** oculta los demás aunque estén activos. ## Entrega con courier Si un courier con agencias hace la entrega, activa **Entrega a través de courier** en la sección **Courier** del método. Puedes pedir al comprador que elija la agencia de destino y cobrar el envío en el checkout o dejar que lo pague al courier. Lee [Entrega y recojo con couriers](/plataforma/envios/couriers). # Captura direcciones con Google Maps Source: https://docs.riqra.com/plataforma/envios/geolocalizacion Conecta tu propia clave de Google Maps para que el checkout sugiera direcciones y guarde las coordenadas exactas de entrega. Con una clave de Google Maps, el campo **Dirección** del checkout sugiere direcciones mientras el comprador escribe y muestra un mapa donde confirma el punto exacto de entrega. Las coordenadas se guardan en el pedido y en las direcciones de la cuenta del comprador. Sin clave, el checkout usa el formulario manual. El comprador escribe su dirección y busca su distrito. La configuras en **[Configuración → Envío → Geolocalización](https://app.riqra.com/settings/shipping/geolocation)**. La clave es tuya y el consumo se factura a tu cuenta de Google. ## Obtén la clave **1. Crea un proyecto en Google Cloud** Crea un proyecto en [Google Cloud](https://console.cloud.google.com/), o reutiliza uno, y activa la facturación. **2. Habilita tres APIs** Habilita exactamente **Maps JavaScript API**, **Places API (New)** y **Geocoding API**. **3. Crea una clave de API y restríngela** * **Restricción de aplicación**: sitios web con referentes HTTP. Agrega los dominios de tu tienda. La página de **Geolocalización** los lista con el formato `https://tu-tienda.com/*`, listos para copiar. * **Restricción de API**: solo las tres APIs del paso anterior. * **Cuotas diarias**: pon un límite diario a cada API. Acota el costo si alguien abusa de tu clave. **4. Pega la clave y guarda** En **Clave de API de Google Maps**, pega la clave y haz clic en **Guardar**. La sección muestra **Activa**. La clave es pública por diseño. Viaja en el código de tu tienda y su protección son las restricciones que configuras en Google Cloud. ## Modo de captura | Modo | Qué ve el comprador | | - | - | | **Mapa con pin y autocompletado** | Sugerencias de Google al escribir la dirección y un mapa con un pin fijo. Mueve el mapa para dejar el pin en el punto exacto. | | **Automático, sin mapa** | Un campo de texto simple, sin sugerencias ni mapa. Al confirmar el pedido, la dirección escrita se geocodifica y se guardan las coordenadas que Google devuelve, sin confirmación del comprador. | ## Qué ve el comprador con el mapa * Al escribir tres letras, ve sugerencias de Google limitadas a tu país. Al elegir una, la dirección se completa, el distrito se completa cuando hay una coincidencia clara y aparece el mapa con el pin. * **Usar mi ubicación** usa la ubicación del navegador para centrar el mapa y completar la dirección. * **Ubicar en el mapa** aparece cuando escribió una dirección que no está en las sugerencias. Ubica el texto en el mapa para que ajuste el pin. * Mover el mapa cambia solo las coordenadas. Nunca reescribe lo que el comprador escribió. El comprador siempre puede completar el pedido sin pin. La dirección escrita y el distrito son suficientes, y el distrito sigue definiendo la zona y el costo de envío. Si Google no responde, el checkout muestra el formulario manual. ## En el pedido Cuando el pedido tiene coordenadas, el panel **Entrega** del pedido muestra el enlace **Ver en Google Maps**. ## Desactiva la geolocalización Borra la clave y haz clic en **Guardar**. El checkout vuelve al formulario manual. Las coordenadas ya guardadas se conservan. # Qué es un método de envío Source: https://docs.riqra.com/plataforma/envios/introduccion Un método de envío define cómo recibe su pedido el comprador y a qué costo, ya sea a domicilio, en una de tus tiendas o en una agencia de courier. Un método de envío es una forma de entregar el pedido que el comprador elige en el checkout. Cada método tiene un tipo, y el tipo decide qué configuras. | Tipo | Cómo llega el pedido | Costo | | - | - | - | | **Delivery** | Se reparte a la dirección del comprador desde una ubicación de origen. | Por zona. Fijo, gratis o por peso. | | **Recojo en local** | El comprador lo recoge en una de tus tiendas o almacenes. | Gratis. | | **Recojo en agencia** | Un courier lo lleva a una de sus agencias y el comprador lo recoge ahí. | Por zona, o lo paga al courier. | Los administras en **[Configuración → Envío](https://app.riqra.com/settings/shipping/methods)**. La sección tiene seis pestañas. | Pestaña | Qué contiene | | - | - | | **Métodos** | Los métodos de envío, su estado y el orden en que los ve el comprador. | | **Zonas** | Grupos de divisiones geográficas con nombre, reutilizables en varios métodos. | | **Áreas** | Polígonos en un mapa que muestran dónde repartes. | | **Couriers** | Las empresas de transporte con las que trabajas y sus agencias. | | **Días bloqueados** | Feriados y cierres, para toda la organización. | | **Geolocalización** | Tu clave de Google Maps para sugerir direcciones y capturar coordenadas. | ## Qué define un método * **Nombre y descripción.** El comprador ve ambos junto al método en el checkout. Usa la descripción para informar tiempos o condiciones, por ejemplo «Recibe tu pedido en 24 a 72 horas, no incluye feriados». * **Cobertura y tarifa.** Un método de Delivery o de Recojo en agencia despacha desde una [ubicación](/plataforma/inventario/ubicaciones) de origen y cubre [zonas](/plataforma/envios/zonas). Cada zona tiene su tarifa y su plazo dentro del método. * **Puntos de recojo.** Un método de Recojo en local ofrece una o más ubicaciones activas. * **Couriers.** Un método de Recojo en agencia ofrece uno o más [couriers](/plataforma/envios/couriers). Un método de Delivery puede entregar a través de ellos. * **Programación de entrega.** Opcional. Con ella, el comprador elige la [fecha y el horario](/plataforma/envios/programacion-de-entrega) de entrega o de recojo. ## Estado de un método Un método nace **Inactivo** y aparece en el checkout solo cuando lo activas desde su detalle. Para activarlo debe estar completo. Un Delivery necesita un origen activo y al menos una zona con divisiones. Un Recojo en local necesita al menos un punto de recojo en una ubicación activa. Un Recojo en agencia necesita al menos un courier activo con una agencia activa. Si falta algo, el detalle muestra qué. Si desactivas la ubicación de origen, todas las ubicaciones de recojo o archivas el último courier de un método, el método pasa a inactivo por sí solo y muestra el motivo. Corrígelo y vuelve a activarlo. **Desactivar** oculta el método en el checkout y conserva su configuración. Puedes reactivarlo cuando quieras. ## Orden de los métodos El comprador ve los métodos en el orden de la lista de **Métodos**. Arrastra las filas para cambiarlo. El arrastre se desactiva mientras hay una búsqueda, un filtro o un orden por otra columna. ## Qué métodos ve cada comprador El comprador ve los métodos activos que permite su [política comercial](/plataforma/politicas-comerciales/crear-una-politica). Una política acepta todos los métodos activos o solo los que selecciones. Un método seleccionado por una política no se puede eliminar hasta que la política deje de seleccionarlo. En el checkout, el comprador elige entre **Envío**, **Recojo** y **Recojo en agencia**, según los tipos que tengas activos. Para el envío a domicilio escribe su dirección y busca su distrito, o la división equivalente en tu país, y ve los métodos de Delivery cuya cobertura lo incluye, cada uno con su costo o **Gratis**. Si ningún método cubre su distrito, ve «No hay envío disponible para esta zona». ## En el pedido El pedido guarda el método, el costo de envío, la fecha y el horario elegidos, y la dirección o el punto de recojo. Los ves en el panel **Entrega**, **Recojo** o **Recojo en agencia** del pedido. Cambiar o eliminar el método después no modifica los pedidos existentes. ## Elimina un método Al final del detalle, haz clic en **Eliminar método** y confirma. La acción es permanente. No puedes eliminar un método seleccionado por una política comercial. ## Siguientes pasos * [Crea zonas de cobertura](/plataforma/envios/zonas) * [Configura un método de Delivery](/plataforma/envios/delivery) * [Ofrece recojo en local](/plataforma/envios/recojo-en-local) * [Entrega y recoge con couriers](/plataforma/envios/couriers) * [Programa las fechas de entrega](/plataforma/envios/programacion-de-entrega) # Programa las fechas de entrega Source: https://docs.riqra.com/plataforma/envios/programacion-de-entrega Haz que el comprador elija la fecha y el horario de entrega o de recojo, según tus días de reparto, tu hora de corte y tus días bloqueados. La **Programación de entrega** es una sección de cada método de envío. Con ella activa, el comprador elige una fecha de entrega o de recojo en el checkout, y opcionalmente un horario. Las fechas que ve se calculan con las reglas del método y los días bloqueados de tu organización. Sin programación, el pedido no pide fecha. ## Activa la programación **1. Abre el método** En **[Configuración → Envío → Métodos](https://app.riqra.com/settings/shipping/methods)**, abre el método y activa el interruptor de **Programación de entrega**. **2. Marca los días de entrega** En **Días de entrega**, o **Días de recojo** en un método de recojo, marca los días de la semana en que entregas. **3. Define la hora de corte** En **Pedidos hasta las**, elige la hora hasta la que un pedido cuenta como del día. Un pedido después de esa hora cuenta desde el día siguiente. **4. Define la anticipación** En un método de **Recojo en local**, elige **Recojo desde**. En un método de **Delivery**, la anticipación es el **Plazo** de cada zona, en la sección **Cobertura**. **5. Guarda** Haz clic en **Guardar**. El resumen al pie de la sección describe la regla completa, por ejemplo «Pedidos hasta las 16:00 se atienden según el plazo de cada zona, con entrega de lun a sáb, hasta 14 días hacia adelante». ## Cómo se calculan las fechas 1. El pedido cuenta desde hoy si hoy recibe pedidos y la hora local no pasó la hora de corte. Si no, cuenta desde el siguiente día que recibe pedidos. 2. A ese día se suma la anticipación, que es el plazo de la zona en Delivery o **Recojo desde** en recojo. 3. Cada día sin entrega entre el inicio y esa fecha la corre un día más. La anticipación se cuenta en días con entrega. 4. El comprador ve las fechas con entrega desde ahí hasta el límite de **Días a mostrar**, sin los días bloqueados. Por ejemplo, un pedido el viernes con un plazo de 48 horas y entrega de lunes a viernes recibe el martes, no el lunes. El fin de semana no cuenta como plazo. Las horas se calculan con la zona horaria de tu organización. ## Horarios En **Horarios de entrega**, agrega franjas con un nombre y una hora de inicio y fin, por ejemplo **Mañana** de 09:00 a 13:00. El comprador elige una franja además de la fecha. Marca **El cliente debe elegir un horario** para que la franja sea obligatoria. Sin la marca, el horario es opcional y el comprador puede elegir solo la fecha. Puedes definir hasta 30 horarios por método. ## Configuración avanzada | Campo | Qué controla | | - | - | | **Días que reciben pedidos** | Días en que tu operación procesa pedidos. Un pedido fuera de esos días cuenta desde el siguiente día que recibe pedidos. Por defecto, todos los días. | | **Hora de corte por día** | Una hora de corte distinta a la general para ciertos días. | | **Días a mostrar** | Hasta cuántos días hacia adelante se ofrecen fechas, de 1 a 60. Por defecto 14. | | **Máx. de fechas** | Cuántas fechas ve el comprador. Vacío muestra todas. Con 1, el comprador solo ve la primera fecha disponible. | Los días que reciben pedidos y los días de entrega son distintos a propósito. Una operación que atiende de lunes a sábado y entrega martes y viernes empieza a contar un pedido del sábado desde el sábado, no desde el martes. El plazo de una zona no puede superar los **Días a mostrar**. Con 14 días a mostrar, una zona con un plazo de 336 horas se guarda y una con 360 horas necesita que amplíes ese valor. ## Días bloqueados Los feriados y cierres se administran una sola vez para toda la organización, en **[Configuración → Envío → Días bloqueados](https://app.riqra.com/settings/shipping/blackouts)**. Haz clic en una fecha del calendario y elige el tipo de bloqueo. | Tipo | Qué hace | | - | - | | **Sin reparto** | Ese día no se entrega, pero sí recibe pedidos. La fecha desaparece del checkout. | | **Cerrado** | Ese día no se procesan pedidos ni se entrega. Un pedido que entra ese día cuenta desde el siguiente día que recibe pedidos. | Haz clic en **Guardar**. Los bloqueos aplican a todos los métodos con programación. ## Qué ve el comprador Bajo el método elegido, el comprador ve **Fecha de entrega** con las fechas disponibles como opciones, por ejemplo «mié 8 oct». Si el método tiene horarios, ve **Horario de entrega** con cada franja. Cuando ninguna fecha está disponible, ve «No hay fechas de entrega disponibles por ahora». Si cambia de dirección o de método, la fecha se limpia y vuelve a elegirla. Si confirma el pedido después de la hora de corte con una fecha que ya no está disponible, el checkout le pide elegir otra. El pedido guarda la fecha y el horario elegidos. Los ves en el panel **Entrega** o **Recojo** del pedido, y el comprador los ve en su confirmación. > [!NOTE] > > En un método de **Recojo en agencia**, las fechas se calculan con un día de anticipación para todas las agencias. # Ofrece recojo en local Source: https://docs.riqra.com/plataforma/envios/recojo-en-local Crea un método para que el comprador recoja su pedido en una de tus tiendas o almacenes, sin costo de envío. Un método de **Recojo en local** deja que el comprador retire su pedido en una de tus [ubicaciones](/plataforma/inventario/ubicaciones). El recojo siempre es gratis y no necesita dirección ni zonas. ## Antes de empezar * Crea en **Configuración → Ubicaciones** las tiendas o almacenes donde se recoge, con su dirección. El comprador ve la dirección de la ubicación en el checkout. * Confirma que esas ubicaciones están activas. ## Crea el método **1. Crea el método** Ve a **[Configuración → Envío → Métodos](https://app.riqra.com/settings/shipping/methods)** y haz clic en **Crear método**. Escribe el **Nombre**, elige el tipo **Recojo en local** y haz clic en **Crear método**. **2. Describe el método** En **Información básica**, escribe una **Descripción** si quieres, por ejemplo el horario de atención de tus tiendas. El comprador la ve junto a cada punto de recojo. **3. Agrega los puntos de recojo** En **Puntos de recojo**, haz clic en **Agregar punto** y marca las ubicaciones activas donde se puede retirar el pedido. Necesitas al menos una. **4. Define el tiempo de preparación** Si quieres que el comprador elija la fecha de recojo, activa la **Programación de entrega** y completa **Recojo desde**. La sección siguiente explica cómo. **5. Guarda y activa** Haz clic en **Guardar** y luego en **Activar**. ## Tiempo de preparación El tiempo de preparación se define en la **Programación de entrega** del método, en el campo **Recojo desde**. Es el tiempo mínimo entre el pedido y el recojo, y aplica a todos los puntos del método. * **El mismo día**. El pedido se puede recoger el mismo día, si entra antes de la hora de corte. * **El día siguiente**. * **Personalizado**. Un número de horas, de 0 a 720. Con la programación activa, el comprador elige la fecha de recojo entre los días de recojo que marques. Lee [Programa las fechas de entrega](/plataforma/envios/programacion-de-entrega). Sin programación, el pedido no pide fecha. Usa la **Descripción** para informar cuándo estará listo. Si tus tiendas tienen tiempos de preparación distintos, crea un método de recojo por cada grupo de tiendas que coincida. ## Qué ve el comprador En el checkout, el comprador elige **Recojo** y ve una fila por cada punto de recojo, con el nombre del método, el nombre de la ubicación, su dirección y **Gratis**. Los puntos aparecen en el orden de la lista de métodos. El stock del pedido sale de la ubicación elegida, salvo que la política comercial del comprador use **Ubicaciones seleccionadas**. En ese caso el stock sale de la ubicación de compra que fija la política. Lee [Controla el stock en la tienda](/plataforma/inventario/control-de-stock). ## Ubicaciones inactivas Un punto de recojo en una ubicación inactiva deja de ofrecerse sin que edites el método. Si todas las ubicaciones del método quedan inactivas, el método pasa a inactivo por sí solo y muestra el motivo en su detalle. Reactiva una ubicación o agrega otro punto, y vuelve a activar el método. # Crea zonas de cobertura Source: https://docs.riqra.com/plataforma/envios/zonas Agrupa las divisiones geográficas que atiendes en zonas con nombre y reutilízalas en tus métodos de envío. Una zona es un grupo de divisiones geográficas con nombre, por ejemplo **Lima Metropolitana** o **Regiones**. Las zonas se crean una vez y se agregan a los métodos de envío. Dentro de cada método, la zona recibe su propia tarifa y su propio plazo, así que la misma zona puede costar distinto en dos métodos. Las administras en **[Configuración → Envío → Zonas](https://app.riqra.com/settings/shipping/zones)**. La lista muestra la cobertura de cada zona, en cuántos métodos se usa y su última actualización. ## Divisiones geográficas Las divisiones son la organización territorial del país de tu tienda. En Perú son departamentos, provincias y distritos. En Chile, regiones y comunas. Puedes seleccionar una división de cualquier nivel. * Seleccionar una división cubre todas las que contiene. Elegir el departamento de Lima cubre todas sus provincias y distritos. * Puedes excluir una división dentro de otra seleccionada. Selecciona la provincia de Lima y desmarca un distrito para dejarlo fuera. * El resumen sobre la lista indica cuántas selecciones hiciste, cuántas divisiones del último nivel quedan cubiertas y cuántas excluiste. Una dirección pertenece a una zona cuando su distrito, o la división equivalente, está cubierto por la zona. ## Crea una zona **1. Abre el formulario** En **Configuración → Envío → Zonas**, haz clic en **Crear zona**. **2. Escribe el nombre** El **Nombre** es único en tu organización. Los compradores no lo ven. **3. Selecciona las divisiones** En **Divisiones geográficas**, expande el árbol y marca las divisiones que cubre la zona. Necesitas al menos una. **4. Guarda** Haz clic en **Crear zona**. La zona queda disponible para agregarla a un método en [Configura un método de Delivery](/plataforma/envios/delivery). ## Cómo agrupar Agrupa en una zona las divisiones que comparten tarifa y plazo. Un método típico tiene dos o tres zonas, por ejemplo la ciudad de despacho con envío el día siguiente y el resto del país con envío en una semana. Dentro de un mismo método, dos zonas no pueden cubrir la misma división. Si agregas al método una zona con el departamento de Lima y otra con el distrito de Miraflores, el guardado se rechaza y el panel indica qué divisiones se repiten. Excluye el distrito de la zona grande o quítalo de la pequeña. No hay una zona comodín. Una dirección fuera de todas las zonas de un método no recibe ese método. Para cubrir el resto del país, crea una zona con las regiones o departamentos que faltan. ## Edita una zona Los cambios en las divisiones de una zona aplican de inmediato a todos los métodos que la usan. Los pedidos ya confirmados no cambian. La regla de no repetir divisiones se comprueba al guardar un método, no al editar una zona. Si agregas a una zona una división que otra zona del mismo método ya cubre, el método sigue activo con las dos y el comprador de esa división recibe la tarifa más barata. El detalle de la zona lista los métodos que la usan. Revísalos después de ampliar una zona. ## Elimina una zona Al final del detalle, haz clic en **Eliminar zona** y confirma. No puedes eliminar una zona mientras un método la use. El detalle muestra en qué métodos está y enlaza a cada uno. Quítala de esos métodos y vuelve a intentarlo. # Crea tu primer flujo Source: https://docs.riqra.com/plataforma/flujos/crear-un-flujo Arma un flujo con un disparador y publícalo para que responda solo. Los flujos se construyen en un editor visual: un **nodo de inicio** con su disparador, conectado a los nodos que se ejecutan en orden. Empieza en **[Automatización → Flujos](https://app.riqra.com/automations/flows)** y haz clic en **Nuevo flujo**. ## Construye el flujo **1. Crea el flujo** Haz clic en **Nuevo flujo** y dale un nombre. **2. Configura el disparador** Selecciona el nodo **Inicio** y elige un **Disparador**: * **Contacto conocido** — un cliente que ya existe en tu tienda te escribe. * **Contacto desconocido** — escribe alguien que aún no es cliente. * **Palabra clave** — el mensaje coincide con palabras que tú defines. Elige el **Modo de coincidencia** (**Mensaje exacto** o **Contiene la frase**) y escribe las **Palabras clave**. **3. Agrega nodos** Conecta nodos desde el inicio. Los tipos son **Mensaje**, **Acción**, **Espera** y **Filtro**. Consulta el detalle en [Disparadores y nodos](/plataforma/flujos/disparadores-y-nodos). **4. Guarda** Haz clic en **Guardar** para conservar los cambios como borrador. **5. Publica** Haz clic en **Publicar** para activarlo. El estado cambia a **Publicado** y el flujo empieza a ejecutarse con los mensajes nuevos. ## Desactivar un flujo Para detenerlo, abre el flujo y usa **Despublicar**. Vuelve a **Borrador** y deja de ejecutarse. > [!NOTE] > > Solo puedes **Publicar** cuando no quedan cambios sin guardar. Si editas un flujo publicado, verás **Cambios sin publicar** hasta que vuelvas a publicar. # Disparadores y nodos Source: https://docs.riqra.com/plataforma/flujos/disparadores-y-nodos Referencia de los disparadores y tipos de nodo disponibles en un flujo. ## Disparadores El disparador define **cuándo empieza** un flujo. | Disparador | Se activa cuando… | | - | - | | **Contacto conocido** | Te escribe un cliente que ya existe en tu tienda. | | **Contacto desconocido** | Te escribe alguien que aún no es cliente. | | **Palabra clave** | El mensaje coincide con tus palabras clave. | Para **Palabra clave**, eliges el **Modo de coincidencia**: * **Mensaje exacto** — el mensaje es idéntico a la palabra clave. * **Contiene la frase** — el mensaje incluye la palabra clave. ## Nodos ### Mensaje Envía un mensaje al contacto. Puede incluir una **Interacción**: * **Ninguna** — solo texto. * **Botones (máx. 3)** — botones de respuesta rápida. * **Lista (máx. 10)** — un menú de opciones. * **Botón con URL** — un botón que abre un enlace. Activa **Esperar respuesta del suscriptor** para pausar el flujo hasta que el contacto responda. Eliges qué esperar: * **Texto**, **Archivo o media** (Imagen, Video, Documento, Audio) o **Cualquier mensaje**. * Un **tiempo de espera** (de 5 minutos hasta 24 horas). ### Acción Ejecuta una acción sobre la conversación: * **Asignar a vendedor**, **Asignar a miembro** o **Asignar a cola**. * **Cerrar conversación**. * **Agregar etiqueta** o **Quitar etiqueta**. ### Espera Pausa el flujo: * **Retardo** — espera una **Duración** en minutos. * **Día de semana** — espera hasta ciertos **Días** y una **Hora**. Con **Continuar** defines si sigue **Si está inactivo** (solo si el contacto no respondió) o **Siempre**. ### Filtro Ramifica el flujo según condiciones. Puedes filtrar por **Día**, **Hora** o **Etiqueta**, y elegir si se ejecuta cuando se cumplen **todas** las condiciones o **alguna**. # Flujos automáticos Source: https://docs.riqra.com/plataforma/flujos/introduccion Automatiza respuestas y deriva conversaciones con flujos. Un **flujo** es una automatización que responde sola a tus clientes. Se activa cuando llega un mensaje que coincide con un **disparador**, y desde ahí puede enviar mensajes, esperar, ramificar según condiciones y ejecutar acciones (como asignar la conversación a un vendedor). Los administras en **[Automatización → Flujos](https://app.riqra.com/automations/flows)**. > [!NOTE] > > Hoy los flujos se activan con mensajes de **WhatsApp**. Necesitas [conectar tu número](/whatsapp/elegir-conexion) antes de publicar uno. ## Para qué sirven * Dar una **respuesta inmediata** cuando un cliente escribe, aunque tu equipo no esté disponible. * **Guiar** al contacto (menús, preguntas) antes de conectarlo con un vendedor. * **Derivar** automáticamente la conversación al vendedor o equipo correcto. * **Etiquetar** y organizar conversaciones sin intervención manual. ## Un ejemplo Cuando un cliente escribe la palabra **catálogo**, el flujo le responde con un mensaje y un **botón con URL** hacia tu tienda. Si pide hablar con alguien, una **Acción** lo asigna a un vendedor. ## Estados de un flujo | Estado | Qué significa | | - | - | | **Borrador** | Aún no se ha publicado; no se ejecuta. | | **Cambios sin publicar** | Está publicado, pero editaste algo que todavía no publicas. | | **Publicado** | Activo: se ejecuta cuando llega un mensaje que coincide con su disparador. | ## Siguiente paso Aprende a [crear tu primer flujo](/plataforma/flujos/crear-un-flujo) y revisa la referencia de [disparadores y nodos](/plataforma/flujos/disparadores-y-nodos). # Ajusta el stock de tus variantes Source: https://docs.riqra.com/plataforma/inventario/ajustar-stock Usa la cuadrícula de inventario para corregir las existencias de muchas variantes en una ubicación, o la ficha de la variante para decidir dónde se vende y cuánto hay en cada lugar. Las existencias se editan en **[Productos → Inventario](https://app.riqra.com/inventory)**, una cuadrícula con una fila por variante para la ubicación que elijas, o desde la sección **Inventario** de la ficha de cada variante. La cuadrícula solo lista las variantes con **Controlar stock** activado que están en la ubicación elegida. Las variantes sin control no tienen cantidades que vigilar y se administran desde su ficha. ## Edita en la cuadrícula **1. Elige la ubicación** Con el selector de ubicación, elige dónde vas a ajustar. Solo aparecen las ubicaciones activas, y la predeterminada viene preseleccionada. **2. Encuentra las variantes** Usa el buscador para filtrar por nombre de producto, SKU u opciones de la variante. El filtro de estado muestra **Todos los estados**, **Activas** o **Descontinuadas**; una variante descontinuada conserva su stock y se sigue editando. La cuadrícula se pagina con **Anterior** y **Siguiente**. **3. Ajusta las existencias** Haz clic en la celda **En mano** de la fila. Con **Ajustar** escribes una diferencia, por ejemplo `-5` o `12`, que se suma a la cantidad actual. Con **Establecer** escribes la cantidad final. Confirma con Enter o con el botón (**Confirmar**). La celda muestra el valor anterior tachado junto al nuevo, y **Disponible** se recalcula al instante. **4. Guarda** Haz clic en **Guardar**. Todos los cambios de la página se guardan juntos. Mientras tengas cambios sin guardar no puedes cambiar de ubicación, buscar, filtrar, paginar, importar ni exportar. **Descartar** vuelve a los valores guardados. ## Columnas | Columna | Qué muestra | | - | - | | **Variante** | El nombre del producto, las opciones de la variante y su SKU. | | **En mano** | Las unidades físicas en la ubicación. Es la única columna editable. | | **Comprometido** | Las unidades reservadas por pedidos confirmados. El candado (**Gestionado por pedidos**) indica que la administran los pedidos y no se edita. | | **Disponible** | **En mano** menos **Comprometido**. | No puedes dejar **En mano** por debajo del comprometido. Si lo intentas, la celda se marca en rojo y, al hacer clic en **Guardar**, aparece un error hasta que lo corrijas. Las cantidades tampoco pueden ser negativas. ## Edita desde la ficha de la variante Abre el producto, haz clic en la variante y ve a la sección **Inventario**. Con **Controlar stock** activado ves una tabla con una fila por cada ubicación donde está la variante, con **En mano**, **Comprometido** y **Disponible**. La celda **En mano** se ajusta igual que en la cuadrícula. Los cambios se guardan con el botón **Guardar** de la ficha. Si tu organización tiene una sola ubicación, también puedes ajustar las existencias en la columna **Stock** de la tabla de variantes del producto. Con varias ubicaciones, esa columna muestra la suma de lo disponible en todas las ubicaciones y, al hacer clic, abre la ficha de la variante. En una variante sin control, la columna dice **Sin control**. ## Elige desde qué ubicaciones se vende Una variante solo se vende desde las ubicaciones donde está. Desde la ficha de la variante decides cuáles son: * Con **Controlar stock** activado, haz clic en el botón (**Editar ubicaciones**) junto al encabezado **Ubicación** y marca o desmarca ubicaciones. Una ubicación marcada aparece en la tabla con cero existencias. No puedes desmarcar una ubicación con unidades en mano o comprometidas: primero deja **En mano** en cero y espera a que los pedidos pendientes se despachen o se cancelen. * Con **Controlar stock** desactivado, la sección muestra la lista de ubicaciones activas con un interruptor por cada una. Encendido significa que la variante se vende desde ahí. No hay cantidades que ajustar. Cuando quitas una ubicación, la variante deja de venderse desde ahí en ese momento y desaparece de la cuadrícula de inventario para esa ubicación. Una variante que no está en ninguna ubicación aparece como **Agotado** en la tienda. ## Existencias en bloque Para actualizar muchas existencias a la vez, usa **Exportar** e **Importar** en la misma página. La exportación incluye todas las ubicaciones, no solo la elegida. Igual que la cuadrícula, el archivo solo tiene las variantes con **Controlar stock** activado. Lee [Importa inventario desde Excel](/plataforma/transferencia-de-datos/importar-inventario). Un ERP u otro sistema externo puede fijar existencias con la [API](/desarrolladores/api/introduction). > [!NOTE] > > Los ajustes no dejan historial de movimientos. Cada cambio reemplaza la cantidad anterior, y si dos personas editan la misma fila, gana quien guarda último. # Controla el stock en la tienda Source: https://docs.riqra.com/plataforma/inventario/control-de-stock Decide por variante si la tienda limita las compras al stock disponible, qué ve el comprador y cómo los pedidos reservan, descuentan y liberan unidades. Cada variante tiene la opción **Controlar stock** en la sección **Inventario** de su ficha. Viene activada en las variantes nuevas. | | Con **Controlar stock** | Sin **Controlar stock** | | - | - | - | | Cantidad que puede pedir el comprador | Hasta el disponible. | Sin límite. | | Al confirmar un pedido | Las unidades pasan a **Comprometido**. | No cambia nada. | | Al despachar | Se descuentan de **En mano**. | No cambia nada. | | Aparece en la cuadrícula de inventario | Sí. | No. | | Úsala para | Mercadería física. | Servicios, productos bajo pedido o stock que administras en otro sistema. | En ambos casos la variante solo se vende desde las ubicaciones donde está. Una variante que no está en ninguna ubicación aparece como **Agotado**. ## Activa o desactiva el control Cambia el interruptor **Controlar stock** en la ficha de la variante y guarda. Para cambiarlo en muchas variantes a la vez, usa la columna `controlar_stock` de la [importación de productos](/plataforma/transferencia-de-datos/importar-productos). Al activarlo, el comprometido de la variante vuelve a cero en todas sus ubicaciones, porque desde ese momento lo administran los pedidos. Las existencias en mano se conservan. Si la variante tiene cero en mano, aparece como **Agotado** hasta que cargues stock. Al desactivarlo, la tienda deja de validar cantidades de inmediato. Las existencias y el comprometido se conservan, aunque dejan de mostrarse hasta que vuelvas a activarlo. Los pedidos confirmados mientras la variante tenía control se siguen descontando y liberando con normalidad. ## Qué ve el comprador La tienda nunca muestra cuántas unidades quedan. Solo avisa cuando no alcanza: * En las tarjetas de producto y en la página del producto, una variante sin unidades disponibles aparece como **Agotado** y no se puede agregar al carrito. * Al agregar al carrito o subir la cantidad más allá del disponible, la tienda avisa **Solo hay N disponibles**. En el carrito, el botón de sumar se desactiva al llegar al disponible. * En el carrito y en el checkout, una línea que superó el disponible muestra el mismo mensaje y bloquea la confirmación hasta que el comprador la ajuste. * En el checkout, una línea que no se vende desde la ubicación de la que saldrá el pedido muestra **No disponible para este método de entrega**. El comprador tiene que quitarla o cambiar la forma de entrega. Si su política no limita las **Ubicaciones de compra**, antes de elegir la forma de entrega el comprador ve el mayor disponible entre tus ubicaciones activas, no la suma. Un pedido sale de una sola ubicación, así que sumar prometería cantidades que ninguna podría entregar. ## De qué ubicación sale el pedido El stock de un pedido se reserva y se descuenta en una sola ubicación, que se decide en este orden: 1. La ubicación que eligió el comprador, si su política comercial limita las ubicaciones de compra. 2. La ubicación del punto de recojo, si el comprador eligió **Recojo en local**. 3. El **Origen** del método de envío, si eligió **Delivery**. Esa ubicación queda registrada en el pedido. Si después cambias el origen de un método de envío, solo afecta a los pedidos siguientes. ## Reserva, descuento y liberación | Momento | En mano | Comprometido | | - | - | - | | El comprador confirma el pedido | Igual | Sube | | El pedido pasa a **Despachado** o **Listo para recoger** | Baja | Baja | | El pedido se cancela o se rechaza el pago | Igual | Baja | | El pedido pasa a **En proceso** o **Entregado** | Igual | Igual | La confirmación es todo o nada. Si una sola línea no alcanza, el pedido no se confirma y el comprador vuelve al carrito con las líneas marcadas. Si dos compradores compiten por las últimas unidades, solo uno consigue confirmar. ## Packs El disponible de un [pack](/plataforma/productos/packs) en una ubicación es el menor de sus componentes, dividiendo el disponible de cada uno entre la cantidad que el pack necesita. Solo cuentan los componentes con **Controlar stock**; un pack cuyos componentes no tienen control se vende sin límite. Al confirmar y al despachar, las unidades se mueven en cada componente, y todos los componentes tienen que estar en la ubicación de la que sale el pedido. ## El comprador elige la ubicación Si vendes desde varias tiendas y quieres que cada comprador vea el stock de la suya, limita las **Ubicaciones de compra** en su [política comercial](/plataforma/politicas-comerciales/crear-una-politica). Con **Ubicaciones seleccionadas**, la tienda muestra un selector en la cabecera, **Comprar desde**, con el nombre y la dirección de cada una. Al entrar por primera vez, el comprador tiene seleccionada la ubicación predeterminada si está en la lista, o la primera por orden alfabético. Desde ese momento todo lo que ve ese comprador se calcula con el stock de la ubicación elegida: el **Agotado** de las tarjetas y de la página del producto, los límites del carrito y del checkout, y la ubicación de la que sale el pedido. Si cambia de ubicación, las líneas del carrito que la nueva ubicación no vende se marcan **No disponible en esta ubicación**, sin quitarlas. Para **Recojo en local** solo se ofrecen los puntos de esa ubicación. Si desactivas una ubicación que una política ofrece, los compradores que la tenían elegida pasan a la siguiente disponible. Si todas las ubicaciones de la política quedan inactivas, esos compradores ven todo agotado y no pueden confirmar pedidos hasta que reactives una o cambies la política. > [!NOTE] > > El filtro de disponibilidad de la búsqueda considera todas tus ubicaciones. Un producto agotado en la ubicación del comprador puede pasar el filtro y aparecer de todos modos como **Agotado** en su tarjeta. # Qué es el inventario Source: https://docs.riqra.com/plataforma/inventario/introduccion El inventario registra cuántas unidades de cada variante tienes en cada ubicación, desde dónde se vende cada una y si la tienda limita las compras al stock disponible. El inventario se lleva por variante y por ubicación. Cada [variante](/plataforma/productos/variantes) tiene una fila de stock en cada ubicación donde se vende, con las unidades que tienes y las que ya reservaron los pedidos confirmados. En las variantes con control de stock activo, la tienda muestra la variante como agotada cuando el disponible llega a cero, no deja comprar más del inventario disponible y descuenta las unidades cuando despachas. Las existencias se editan en **[Productos → Inventario](https://app.riqra.com/inventory)**, una cuadrícula con una fila por variante para la ubicación que elijas, o desde la ficha de cada variante. Las ubicaciones se administran en **[Configuración → Ubicaciones](https://app.riqra.com/settings/locations)**. ## Las tres cantidades | Cantidad | Qué es | Quién la cambia | | - | - | - | | **En mano** | Las unidades que tienes físicamente en la ubicación. | Tú, desde la cuadrícula, la ficha de la variante, la importación o la API. | | **Comprometido** | Las unidades de pedidos confirmados que todavía no despachaste. | Los pedidos: sube al confirmar y baja al despachar o cancelar. | | **Disponible** | **En mano** menos **Comprometido**. Lo que un comprador todavía puede pedir. | Nadie. Se calcula a partir de las otras dos. | El comprometido nunca supera lo que hay en mano, así que el disponible nunca es negativo. Si intentas dejar **En mano** por debajo del comprometido, el cambio se rechaza. ## Ubicaciones Una ubicación es un almacén o una tienda desde donde vendes. Al activar tu cuenta se crea la primera, **Principal**, marcada como predeterminada. Puedes crear más y elegir cuál es la predeterminada. Lee [Administra tus ubicaciones](/plataforma/inventario/ubicaciones). ## Dónde se vende cada variante Una variante solo se vende desde las ubicaciones donde está. Al crear una variante, se vende desde todas las ubicaciones activas con cero unidades. Al crear una ubicación, todas las variantes se venden desde ella, también con cero unidades. Desde la ficha de la variante quitas las ubicaciones donde no la vendes. Una variante que no está en ninguna ubicación aparece como **Agotado** y no se puede comprar. ## Controlar stock Cada variante decide si la tienda lleva control de sus cantidades. Con **Controlar stock** activado, la tienda no deja comprar más del inventario disponible, reserva las unidades al confirmar el pedido y las descuenta al despacharlo. Con la opción desactivada, la variante se vende sin límite de cantidad desde las ubicaciones donde está, lo que sirve para servicios o para productos que fabricas bajo pedido. Lee [Controla el stock en la tienda](/plataforma/inventario/control-de-stock). ## Packs Un [pack](/plataforma/productos/packs) no tiene stock propio. Su disponible en cada ubicación sale del stock de sus componentes, y al confirmar o despachar un pedido con un pack, las unidades se mueven en cada componente. ## Siguientes pasos * [Administra tus ubicaciones](/plataforma/inventario/ubicaciones) * [Ajusta el stock de tus variantes](/plataforma/inventario/ajustar-stock) * [Controla el stock en la tienda](/plataforma/inventario/control-de-stock) * [Importa inventario desde Excel](/plataforma/transferencia-de-datos/importar-inventario) # Administra tus ubicaciones Source: https://docs.riqra.com/plataforma/inventario/ubicaciones Crea los almacenes y tiendas desde donde vendes, elige la ubicación predeterminada y desactiva las que dejes de usar. Una ubicación es un almacén o una tienda de tu organización. El stock se lleva por ubicación, cada método de **Delivery** despacha desde una ubicación y cada punto de recojo es una ubicación. Las administras en **[Configuración → Ubicaciones](https://app.riqra.com/settings/locations)**. La lista muestra el nombre y la dirección de cada ubicación, su distrito o la división equivalente en tu país, su estado y su última actualización. La ubicación predeterminada lleva una estrella junto al nombre. Al activar tu cuenta se crea la primera ubicación, **Principal**, activa y predeterminada. Puedes renombrarla y completar sus datos como cualquier otra. ## Crea una ubicación **1. Abre el formulario** En **Configuración → Ubicaciones**, haz clic en **Nueva ubicación**. **2. Escribe el nombre** El **Nombre** es obligatorio y único en tu organización, incluidas las ubicaciones inactivas. Es el nombre que verás en la cuadrícula de inventario, en los métodos de envío y en la importación de inventario. **3. Completa la dirección y el contacto** La **Dirección**, la división geográfica, el código postal, las coordenadas GPS, el **Teléfono** y el **Correo de contacto** son opcionales. El teléfono y el correo son datos internos; los compradores no los ven. **4. Guarda** Haz clic en **Guardar**. La ubicación nace activa y no reemplaza a la predeterminada. > [!NOTE] > > Una ubicación nueva recibe todas tus variantes con cero existencias. Las variantes con **Controlar stock** aparecen agotadas ahí hasta que cargues stock, y las variantes sin control se venden desde la nueva ubicación de inmediato. Si algo no se vende desde ahí, quítalo desde la ficha de la variante. Lee [Ajusta el stock de tus variantes](/plataforma/inventario/ajustar-stock). ## La ubicación predeterminada Siempre hay exactamente una ubicación predeterminada, y siempre está activa. Es la que: * Aparece preseleccionada en **Productos → Inventario**. * Recibe las existencias de la columna `inventario` al [importar productos](/plataforma/transferencia-de-datos/importar-productos), en las variantes que controlan stock. * Viene preseleccionada para el comprador que [elige desde qué ubicación compra](/plataforma/inventario/control-de-stock), si su política la incluye. Para cambiarla, abre la ubicación que quieres usar y haz clic en **Establecer como predeterminada** en el panel lateral. La anterior deja de serlo en ese momento. Solo una ubicación activa puede ser la predeterminada. ## Desactiva una ubicación Desactiva una ubicación cuando dejes de operar desde ahí. Abre la ubicación, haz clic en **Desactivar** y confirma. Para poder hacerlo: * No debe ser la predeterminada. Establece otra primero. * Ninguna variante debe tener unidades en mano ni comprometidas en esa ubicación. Pon el stock en cero y espera a que los pedidos pendientes se despachen o se cancelen. Una ubicación inactiva no aparece en el selector de la cuadrícula de inventario, no recibe stock y no despacha pedidos. Si una política comercial la ofrecía como ubicación de compra, deja de ofrecerse sin que edites la política. La ubicación sigue en la lista con el estado **Inactiva** y conserva su historial. Para volver a usarla, ábrela y haz clic en **Reactivar**. Vuelve activa y no pasa a ser predeterminada por sí sola. Las ubicaciones no se eliminan. ## Ubicaciones y entrega Cada método de envío de tipo **Delivery** tiene un **Origen**: la ubicación desde la que despacha. Un método de **Recojo en local** ofrece puntos de recojo, y cada punto es una ubicación. Los configuras en **Configuración → Envío**. Lee [Qué es un método de envío](/plataforma/envios/introduccion). Cuando un comprador elige cómo recibir su pedido, esa elección define de qué ubicación sale el stock. Lee [Controla el stock en la tienda](/plataforma/inventario/control-de-stock). # Migrar desde Riqra Legacy Source: https://docs.riqra.com/plataforma/migracion/cambios-nueva-plataforma Conoce las diferencias principales de la nueva plataforma y prepara la revisión de tu tienda. Esta guía explica los cambios que afectan la administración de la tienda, la experiencia de compra y la operación diaria después de migrar desde Riqra Legacy. > [!NOTE] > > La disponibilidad de algunas funciones depende de los productos y la configuración contratados. El equipo de migración confirmará por separado qué datos, medios e integraciones forman parte de tu migración. ## Explora los cambios por área > **[Tienda y navegación](/plataforma/migracion/tienda-y-navegacion)** > > Políticas legales, aviso de cookies, menús y landing pages. > **[Catálogo y compras](/plataforma/migracion/catalogo-y-compras)** > > Colecciones, filtros, orden, presentación y favoritos. > **[Precios y políticas comerciales](/plataforma/migracion/precios-y-politicas)** > > Listas de precios, catálogos, políticas comerciales y segmentos. > **[Clientes y checkout](/plataforma/migracion/clientes-y-checkout)** > > Contraseñas, acceso social, compra como invitado y checkout de una página. > **[Promociones](/plataforma/migracion/promociones)** > > Tipos disponibles y reglas de Legacy que necesitan rediseño. > **[Envíos y cobertura](/plataforma/migracion/envios-y-cobertura)** > > Métodos de envío, zonas, tarifas, plazos y programación de entrega. > **[Pedidos y estadísticas](/plataforma/migracion/pedidos-y-estadisticas)** > > Indicadores, estados, exportaciones e integraciones de analítica. > **[Lista antes de publicar](/plataforma/migracion/lista-de-revision)** > > Revisión final para el equipo comercial y operativo. ## Cambios que simplifican la gestión * Las políticas legales, el aviso de cookies, las páginas y los menús se administran desde el panel. * Las colecciones pueden ser manuales o automáticas, con filtros y orden configurable. * El checkout reúne contacto, entrega, pago y resumen en una sola página y permite comprar como invitado. * Las promociones compatibles se crean y administran desde el panel. * La vista de ventas compara períodos e incorpora ticket promedio y artículos por pedido. ## Diferencias que requieren adaptación | Comportamiento de Riqra Legacy | Tratamiento en la nueva plataforma | | - | - | | Lista de precios asignada al cliente | El cliente pertenece a un segmento y el segmento tiene una política comercial que elige catálogo y lista de precios. | | Producto oculto por no tener precio en la lista | La visibilidad depende del catálogo. Un producto sin precio aparece sin precio y no se puede comprar. | | Precio pactado con un cliente desde el importador | Se reproduce con una lista de precios propia y su política comercial. | | Favoritos desde las tarjetas de producto | El cliente agrega o quita favoritos desde el detalle del producto. | | Inicio de sesión con Google o Facebook | El cliente usa correo y contraseña. Si solo usaba acceso social, debe crear una contraseña. | | Etiqueta de presentación | Se agrega al nombre del producto, por ejemplo **Aceituna \| Frasco 240 g**. | | Costo de envío por localidad | Las localidades con la misma tarifa y el mismo plazo forman una zona. La tarifa y el plazo se definen por zona dentro del método de envío. | | Tipo de envío habilitado por cliente | La política comercial que le corresponde al cliente decide qué métodos de envío ve. | | Estados de pedido personalizados | Se usan estados separados para pedido, pago y preparación. | | Límite máximo de compra por producto | No está disponible como configuración del producto. | | Plantillas personalizadas de exportación | La exportación usa un formato Excel definido por la plataforma. | | Universal Analytics | No se carga. Migra la medición web a GA4; Google Tag Manager y Meta Pixel siguen disponibles. | ## Cómo usar esta guía Revisa primero las páginas relacionadas con tu función. La [lista antes de publicar](/plataforma/migracion/lista-de-revision) es la fuente única de tareas para catálogo, marketing, atención al cliente y operaciones. # Catálogo y compras Source: https://docs.riqra.com/plataforma/migracion/catalogo-y-compras Revisa colecciones, filtros, variantes y favoritos antes de publicar la tienda. La nueva plataforma separa la clasificación interna del catálogo de la forma en que los productos se exhiben al comprador. ## Categorías y colecciones Las categorías mantienen la clasificación permanente de los productos. Las colecciones controlan su exhibición en la tienda. Una colección puede ser: * **Manual:** eliges los productos y el orden en el que aparecen. * **Automática:** los productos ingresan según reglas de etiqueta, marca o categoría. En ambos tipos puedes elegir el orden predeterminado: * Orden manual. * Más recientes. * Precio ascendente. * Precio descendente. * Nombre. El comprador puede elegir otro orden desde la colección. ## Filtros en colecciones y búsqueda El comprador puede filtrar por: * Marca. * Rango de precio. * Disponibilidad. * Atributos de opciones, como talla, color o material. Para mostrar un atributo como filtro, activa **Mostrar en filtros de la tienda**. Esta opción está disponible para atributos con una lista definida de opciones. La configuración es general para la tienda. El filtro aparece únicamente cuando los resultados contienen valores aplicables. Los grupos de atributos se muestran en orden alfabético y no tienen un orden distinto por colección. ## Presentación y variantes La nueva plataforma no tiene una etiqueta de presentación independiente. Si un producto tenía presentación, la migración la agrega a su nombre: **Aceituna** con presentación **Frasco 240 g** queda como **Aceituna | Frasco 240 g**. Si el comprador debe elegir la presentación, conviértela en un atributo de variante, por ejemplo **Tamaño: 500 ml**, y quítala del nombre. No hay un límite máximo de compra configurado por producto. Si tu tienda usaba esta restricción, revísala con el equipo de migración. ## Favoritos En Riqra Legacy, el cliente podía marcar un favorito desde la tarjeta o el detalle del producto. En la nueva tienda, un cliente que inició sesión puede agregarlo o quitarlo únicamente desde el detalle. Los productos guardados aparecen en **Mi cuenta → Mis favoritos**. > [!TIP] > > Completa las tareas de esta área en la [lista antes de publicar](/plataforma/migracion/lista-de-revision). # Clientes y checkout Source: https://docs.riqra.com/plataforma/migracion/clientes-y-checkout Prepara el acceso de clientes y prueba el nuevo checkout de una sola página. El nuevo acceso usa correo y contraseña. El checkout permite comprar con una cuenta o como invitado. ## Acceso con correo y contraseña La nueva plataforma no ofrece inicio de sesión con Google ni Facebook. Las cuentas nuevas verifican su correo con un código. Las cuentas migradas que ya tenían una contraseña pueden continuar usándola. La plataforma la actualiza de forma segura después del primer ingreso correcto. Los clientes que usaban únicamente un acceso social deberán crear una contraseña mediante **¿Olvidaste tu contraseña?** antes de su primer ingreso. > [!WARNING] > > Comunica este cambio antes de publicar la tienda. Los clientes que usaban solo Google o Facebook no podrán ingresar hasta crear una contraseña. Los clientes deshabilitados en Legacy llegan pausados: no pueden iniciar sesión ni hacer pedidos hasta que los actives desde el panel **Estado** de su [ficha](/plataforma/clientes/personas). Si el equipo de migración vuelve a importar tus clientes, cada uno toma el estado que tenga en Legacy en ese momento: para mantener activo a un cliente, habilítalo también en Legacy. ## Checkout de una sola página Contacto, entrega, pago y resumen se completan en una sola página. El comprador puede revisar los datos y confirmar el pedido sin avanzar entre pantallas separadas. ## Compra como invitado El comprador puede completar el checkout sin crear una cuenta. El pedido usa el nombre, correo, teléfono y datos de entrega ingresados durante esa compra. Una compra como invitado crea o vincula un registro de cliente usando el correo del checkout. Si esa persona luego crea una cuenta con el mismo correo, podrá ver esos pedidos en su historial, identificados como **Compra como invitado**. La tienda no muestra datos guardados ni completa información privada para un visitante sin sesión. > [!TIP] > > Completa las tareas de esta área en la [lista antes de publicar](/plataforma/migracion/lista-de-revision). # Envíos y cobertura Source: https://docs.riqra.com/plataforma/migracion/envios-y-cobertura Convierte la cobertura por localidad de Legacy en métodos de envío, zonas reutilizables, tarifas y plazos por zona. En Riqra Legacy no configurabas los envíos desde el panel. La cobertura, los costos, los patrones de entrega y los tipos de envío se cargaban por ti a pedido, y cada cambio pasaba por soporte. La cobertura era la lista de localidades que atendías, cada una con su costo de envío y, a veces, su propio patrón de entrega. La tienda tenía un patrón propio, una hora máxima de pedido y un calendario de atención. Los tipos de envío se habilitaban para toda la tienda o solo para clientes específicos. En la nueva plataforma administras todo esto tú, desde el panel. La nueva plataforma reparte ese trabajo en cinco piezas. Las cuatro primeras viven en **[Configuración → Envío](https://app.riqra.com/settings/shipping/methods)**. | Pieza | Qué resuelve | | - | - | | [Método de envío](/plataforma/envios/introduccion) | Cómo llega el pedido: **Delivery**, **Recojo en local** o **Recojo en agencia**. | | Zona | Un grupo de divisiones geográficas con nombre, reutilizable en varios métodos. | | Tarifa y plazo por zona | Cuánto cuesta y en cuántas horas llega un pedido que cae en esa zona, definidos dentro de cada método. | | Programación de entrega | Días que reciben pedidos, días de entrega, hora de corte, horarios y días bloqueados. | | [Política comercial](/plataforma/politicas-comerciales/introduccion) | Qué métodos de envío ve cada grupo de clientes. Vive en **[Configuración → Políticas comerciales](https://app.riqra.com/settings/commercial-policies)**. | El cliente ya no tiene tipos de envío asignados en su ficha. Ve los métodos activos que permite la política comercial que le corresponde: la de su segmento, la de su empresa o sucursal, o la predeterminada. ## En qué se convierte cada parte de la cobertura | En Riqra Legacy | En la nueva plataforma | | - | - | | Tipo de envío a domicilio | Método de tipo Delivery, con una ubicación de origen. | | Recojo en tienda | Método de tipo Recojo en local. Cada tienda es una [ubicación](/plataforma/inventario/ubicaciones) agregada como punto de recojo. | | Recojo en agencia o entrega con transportista | Método de tipo Recojo en agencia, o couriers dentro de un método de delivery. **Flete por pagar** cubre el envío que el cliente paga al transportista. | | Localidad atendida y su costo | La localidad es una división dentro de una zona. El costo se define en el método, por zona. | | Etiqueta de la cobertura | Nombre de la zona. | | Patrón de entrega de la cobertura | Plazo de la zona, en horas, dentro del método. | | Patrón de entrega de la tienda | Plazo de las zonas que no tenían patrón propio. | | Patrón de entrega por cliente o territorio | Todos los clientes de una zona reciben el mismo plazo. | | Patrón de recojo de cada tienda | **Recojo desde**, un solo valor por método de recojo. | | Costo por peso y localidad | Tarifa **Por kg** con tramos de peso, por zona. | | Otras fórmulas de costo | La zona se importa con costo fijo y ajustas la tarifa a mano. | | Recargo porcentual | La localidad no se importa. Crea su zona y su tarifa a mano. | | Hora máxima de pedido | **Pedidos hasta las**, en la programación de entrega. | | Días máximos para elegir fecha | **Días a mostrar**. | | Calendario de atención: atiende y entrega por día | **Días que reciben pedidos** y días de entrega, con hora de corte por día. | | Rangos horarios de entrega | Horarios de la programación. Si existían en Legacy, elegir uno es obligatorio en el checkout. | | Fechas bloqueadas de entrega y de atención | **Días bloqueados**: **Sin reparto** y **Cerrado**. | | Tipos de envío habilitados por cliente | Métodos de envío permitidos por una política comercial. | | Geocercas en KML | No se migran. Puedes importar el KML a mano en **Áreas**; lee [Áreas en el mapa](#areas-en-el-mapa). | > [!NOTE] > > La migración crea las zonas, el método de delivery, el método de recojo con sus puntos, los couriers y sus métodos, y los días bloqueados a partir de los datos de Legacy. La programación de entrega solo se crea si tu tienda pedía una fecha de entrega en el checkout. El equipo de migración te indicará qué datos no pudo convertir y necesitan que los completes a mano. ## Cómo se arma la cobertura En Legacy, cada localidad atendida llevaba su propio costo. En la nueva plataforma, las localidades con la misma tarifa y el mismo plazo forman una zona, y la zona se agrega al método con esa tarifa y ese plazo. **1. Revisa la ubicación de origen** Cada método de delivery despacha desde una [ubicación](/plataforma/inventario/ubicaciones) activa. La migración usa la ubicación predeterminada. **2. Revisa las zonas** Ve a **[Configuración → Envío → Zonas](https://app.riqra.com/settings/shipping/zones)**. Una zona agrupa divisiones geográficas de cualquier nivel. En Perú, un departamento, una provincia o un distrito; en Chile, una región o una comuna. Elegir un departamento cubre todos sus distritos. **3. Revisa la tarifa y el plazo de cada zona** Abre el método de delivery en **[Configuración → Envío → Métodos](https://app.riqra.com/settings/shipping/methods)**. Cada zona agregada al método tiene su tarifa (**Fijo**, **Por kg** o **Por tramo de peso**) y su plazo en horas. La misma zona puede tener otra tarifa en otro método. **4. Revisa la programación de entrega** En el mismo método, confirma los días que reciben pedidos, los días de entrega, la hora de corte, los horarios y **Días a mostrar**. Los días bloqueados se administran para toda la organización en **[Configuración → Envío → Días bloqueados](https://app.riqra.com/settings/shipping/blackouts)**. **5. Confirma que el método quedó activo** La migración activa los métodos que crea. Si en el panel un método aparece inactivo, le falta la ubicación de origen, una zona con al menos una división o un punto de recojo en una ubicación activa, y el método muestra el motivo. Corrígelo y actívalo. Dentro de un método, dos zonas no pueden incluir la misma división. La cobertura de Legacy podía listar la misma localidad dos veces con nombres distintos, como Lima y Cercado de Lima. La migración conserva la tarifa de la división y, entre coberturas del mismo nivel, la más baja. Revisa la tarifa de esas localidades en la zona donde quedaron. No hay una zona comodín. Cada zona enumera sus divisiones y una dirección fuera de todas las zonas no recibe ninguna opción de delivery. Para cubrir el resto del país, crea una zona con las regiones o departamentos que faltan. ## Tarifas Cada zona dentro de un método tiene una de tres tarifas. * **Fijo.** Gratis o un monto único. Equivale a la cobertura de Legacy con costo fijo por localidad. * **Por kg.** Tramos de peso, cada uno con una tarifa por kilo. Es el mismo cálculo del costo por peso y localidad de Legacy. * **Por tramo de peso.** Tramos de peso, cada uno con un monto único. En las dos tarifas por peso, el tramo se elige con el peso exacto del pedido. Cada tramo cubre hasta un peso máximo y el último queda abierto. En **Por kg**, la tarifa se multiplica por el peso redondeado a kilos enteros. Un pedido de 7.5 kg usa el tramo de hasta 10 kg y paga 8 kilos. Un pedido menor a 0.5 kg paga 0. El peso del pedido es la suma de cantidad por peso de cada variante. Si alguna variante del carrito no tiene peso, el método con tarifa por peso no se ofrece para ese carrito. Los métodos con tarifa fija y el recojo no se ven afectados. Completa el peso de tus variantes antes de publicar. Si tu tienda cobraba por peso, el equipo de migración te indicará cuántos productos publicados no lo tienen. Un tramo siempre tiene un monto mayor a cero. Para una zona gratis, usa la tarifa Fijo sin monto. Una cobertura de Legacy podía tener una escalera de peso con tramos gratis y tramos con costo en la misma localidad. Esa combinación no cabe en una sola zona, así que la migración no la convierte. Crea su zona y sus tramos a mano. ### Reglas de costo que cambian * **Tramos por subtotal.** Define una tarifa por zona. El costo ya no depende del monto del pedido. * **Envío gratis a partir de un monto.** Crea una [promoción](/plataforma/migracion/promociones) de tipo Envío gratis con un requisito mínimo de monto. * **Recargo porcentual sobre el pedido.** La migración no convierte esas localidades. Crea sus zonas con una tarifa fija. * **Peso volumétrico.** Las tarifas por peso usan el peso de la variante. * **Cotización en línea con un transportista.** Las tarifas se definen en el panel. ## Plazo de entrega En Legacy, el plazo de un pedido se resolvía en cadena. Primero el patrón del cliente, luego el del territorio, luego el de la cobertura y por último el de la tienda. En la nueva plataforma, el plazo de un delivery depende de la dirección. Cada zona del método tiene su plazo en horas, obligatorio, y `0` promete entrega el mismo día. La migración toma el patrón de la cobertura y, si no tenía, el de la tienda. Los patrones absolutos de Legacy, como `1,4` para entregar lunes y jueves, no se convierten. Esas zonas quedan con el plazo general de la tienda. Para reproducir un día fijo de entrega, marca solo ese día como día de entrega en la programación del método. El plazo de una zona no puede superar los **Días a mostrar** de la programación y el panel rechaza el guardado si lo hace. El plazo se compara en días, redondeado hacia arriba. Con 14 días a mostrar, una zona con plazo de 336 horas se guarda, y una con 360 horas necesita que amplíes ese valor antes de guardarla. El tiempo de recojo no depende de la dirección. En un método de recojo, **Recojo desde** fija el tiempo mínimo entre el pedido y el recojo, y aplica a todos sus puntos de recojo. En Legacy, cada tienda tenía su propio patrón y su propio horario de recojo. La migración conserva el patrón cuando todas las tiendas coinciden y usa 24 horas para una tienda sin patrón. Si tus tiendas tenían tiempos u horarios distintos, crea un método de recojo por cada grupo de tiendas que coincida. ## Áreas en el mapa En Legacy, las geocercas se dibujaban en Google My Maps, se exportaban en KML y se enviaban a soporte para cargarlas con un patrón y un costo de entrega por polígono. En la nueva plataforma, **[Configuración → Envío → Áreas](https://app.riqra.com/settings/shipping/areas)** permite dibujar polígonos en el mapa o importar un archivo KMZ/KML, y exportarlos para editarlos en otra herramienta. Un área admite hasta 20 000 vértices. Las áreas solo dibujan tu cobertura en un mapa. No tienen tarifa, no se agregan a un método y el checkout no las consulta. La cobertura que cobra y ofrece delivery es la de las zonas por división geográfica. Si tu cobertura de Legacy estaba definida por geocercas, tradúcela a zonas con las divisiones que esos polígonos cubren, y conserva los polígonos como áreas para consultarlos. > [!WARNING] > > Importar un KML no configura tarifas ni cobertura. El checkout solo ofrece delivery a las direcciones que caen en una zona del método. ## Qué métodos ve cada cliente En Legacy, un tipo de envío se habilitaba para toda la tienda o solo para ciertos clientes, siempre a pedido. La nueva plataforma no asigna métodos a clientes. La [política comercial](/plataforma/politicas-comerciales/crear-una-politica) acepta todos los métodos de envío activos o solo los que selecciones. Si en Legacy un grupo de clientes tenía acceso a un tipo de envío que el resto no, la migración crea una política con esos métodos y un segmento para ese grupo, con el nombre de su lista de precios seguido de los métodos. Revisa esas políticas en **[Configuración → Políticas comerciales](https://app.riqra.com/settings/commercial-policies)**. En el checkout, el comprador ve los métodos activos de su política, en el orden en que los ordenaste en **[Configuración → Envío → Métodos](https://app.riqra.com/settings/shipping/methods)**. Si su dirección no cae en ninguna zona, solo ve las opciones de recojo, si tienes alguna activa. ## Métodos incompletos Un método sin ubicación de origen, sin zonas o sin puntos de recojo no se puede activar y el panel muestra el motivo. Si desactivas la ubicación de origen de un delivery, o todas las ubicaciones de recojo de un método, el método pasa a inactivo por sí solo y desaparece del checkout hasta que lo corrijas y lo vuelvas a activar. Un método seleccionado por una política comercial no se puede eliminar. Cambia la política primero. ## Diferencias que requieren adaptación | Comportamiento de Riqra Legacy | Tratamiento en la nueva plataforma | | - | - | | Costo definido localidad por localidad | Las localidades con la misma tarifa y el mismo plazo forman una zona. La tarifa se define por zona dentro del método. | | La misma localidad con dos nombres y dos costos | Una división pertenece a una sola zona por método. Se conserva la tarifa de la división y, entre coberturas del mismo nivel, la más baja. | | Plazo por cliente o territorio | Todos los clientes de una zona reciben el mismo plazo. | | Patrón de entrega con días fijos | Marca solo esos días como días de entrega en la programación. | | Escalera de peso con tramos gratis y tramos con costo | Una zona es gratis o cobra en todos sus tramos. | | Tramos por subtotal, recargo porcentual, peso volumétrico | Define tarifas fijas o por peso por zona. | | Envío gratis a partir de un monto | Promoción de tipo Envío gratis con requisito mínimo. | | Producto sin peso en una tienda con costo por peso | El método por peso no se ofrece para carritos que lo incluyan. Completa los pesos. | | Tipo de envío habilitado por cliente | Política comercial con los métodos seleccionados y un segmento para ese grupo, creados por la migración. | | Patrón y horario de recojo por tienda | Un método de recojo tiene una sola programación. Crea un método por cada grupo de tiendas con el mismo tiempo y horario. | | Geocercas con costo y patrón | Las áreas se conservan como mapa. La cobertura y la tarifa se definen en zonas por división. | | Delivery express con integración de última milla | No está disponible. | > [!TIP] > > Completa las tareas de esta área en la [lista antes de publicar](/plataforma/migracion/lista-de-revision). # Lista antes de publicar Source: https://docs.riqra.com/plataforma/migracion/lista-de-revision Completa las verificaciones comerciales y operativas antes de publicar la tienda migrada. Usa esta lista con las personas responsables de catálogo, marketing, atención al cliente y operaciones. Completa las pruebas en la tienda que se publicará, con la misma configuración de pagos, envíos y dominio. **1. Confirma responsables y alcance** * Define quién aprueba catálogo, contenido, promociones, checkout y pedidos. * Confirma qué datos, pedidos históricos e integraciones forman parte de la migración. * Registra cualquier función de Legacy que necesite una alternativa. **2. Revisa la tienda y la navegación** * Publica las políticas legales. * Confirma el aviso de cookies. * Revisa menús, enlaces y landing pages. * Comprueba la navegación en escritorio y móvil. **3. Valida el catálogo** * Revisa categorías y colecciones. * Confirma el orden predeterminado de cada colección principal. * Activa y prueba los filtros necesarios. * Revisa los nombres de los productos que tenían etiqueta de presentación. * Revisa cualquier producto que usaba un límite máximo de compra. * Confirma que los favoritos se puedan guardar y consultar desde **Mi cuenta**. **4. Revisa precios y políticas comerciales** * Confirma que cada lista de precios de Legacy tenga su lista y su política comercial. * Confirma que cada política tenga su segmento, salvo la predeterminada, que ya cubre a los clientes sin segmento. * Revisa las políticas que la migración creó para clientes con métodos de envío o pago propios: llevan el nombre de la lista seguido de los métodos. * Compara una muestra de precios entre Legacy y la nueva lista. * Verifica el pedido mínimo de cada política. * Excluye del catálogo los productos que ocultabas dejándolos sin precio. * Revisa los clientes con precios pactados y confirma con qué política quedaron. * Inicia sesión con un cliente de cada segmento y comprueba el catálogo y los precios que ve. **5. Prepara el acceso de clientes** * Prueba una cuenta migrada con contraseña. * Prueba la recuperación para una cuenta que usaba acceso social. * Confirma la verificación de una cuenta nueva. * Comunica que Google y Facebook ya no están disponibles para iniciar sesión. **6. Revisa envíos y cobertura** * Revisa con el equipo de migración qué datos de envío no se pudieron convertir. * Confirma que cada localidad que atendías pertenezca a una zona del método de delivery. * Compara una muestra de costos de envío entre Legacy y la nueva tarifa, incluidos pedidos con peso si cobras por kilo. * Verifica el plazo de cada zona y que no supere los días a mostrar de la programación. * Completa el peso de las variantes si algún método cobra por peso. * Revisa los días de entrega, la hora de corte, los horarios y los días bloqueados. * Confirma los puntos de recojo y el tiempo de recojo de cada método. * Confirma que cada método quedó activo y que cada política comercial permite los que corresponden. **7. Prueba promociones y checkout** * Recrea las promociones que seguirán activas. * Valida tipos, códigos, condiciones, fechas, público elegible y combinaciones. * Confirma el descuento calculado en el carrito y el checkout. * Completa una compra como invitado. * Completa otra compra con una cuenta iniciada. * Prueba cada medio de pago y método de entrega disponible. * Revisa el checkout en escritorio y móvil. * Confirma que el pedido de invitado aparezca con la identificación correcta en el historial. **8. Valida pedidos y estadísticas** * Confirma los estados de pago y preparación con operaciones. * Descarga y revisa una exportación de pedidos. * Compara las estadísticas usando únicamente el período histórico migrado. * Prueba GA4, Google Tag Manager y Meta Pixel. * Actualiza cualquier reporte interno que dependía de una vista de Legacy no disponible. **9. Aprueba la publicación** * Documenta cualquier diferencia aceptada frente a Legacy. * Asigna un responsable y una fecha a cada pendiente no bloqueante. * No publiques mientras exista un bloqueo de acceso, pago, entrega o creación de pedidos. ## Criterio de salida La tienda está lista cuando el equipo puede navegar, comprar, pagar, procesar y consultar un pedido sin depender de una función que solo exista en Riqra Legacy. # Pedidos y estadísticas Source: https://docs.riqra.com/plataforma/migracion/pedidos-y-estadisticas Comprende los nuevos indicadores, estados de pedido, exportaciones e integraciones de analítica. La nueva plataforma organiza las estadísticas de ventas y el seguimiento operativo de los pedidos con un modelo distinto a Riqra Legacy. ## Estadísticas de ventas En **Estadísticas → Ventas** puedes elegir un período y compararlo con el período anterior. La vista incluye: * Ingresos. * Pedidos. * Ticket promedio. * Artículos por pedido. * Precio promedio por artículo. * Rendimiento por producto. Los indicadores se calculan con los pedidos disponibles en la nueva plataforma. El período histórico que puedas consultar dependerá del alcance de pedidos incluido en la migración. ### Diferencias frente al dashboard de Legacy La vista no replica uno a uno todos los reportes anteriores. Actualmente no incluye los antiguos desgloses por: * Dispositivo. * Método de pago. * Cliente. * Búsquedas frecuentes. * Categorías visitadas. ## Estados de pedido Los estados personalizados de Legacy no se trasladan como estados nuevos. La nueva plataforma separa tres dimensiones: | Dimensión | Estados principales | | - | - | | Pedido | Activo, por confirmar o cancelado. Un pedido queda por confirmar cuando supera la línea de crédito de una empresa con sobregiro; lee [Pedidos por confirmar](/plataforma/clientes/linea-de-credito#pedidos-por-confirmar). | | Pago | Pendiente, parcial, pagado o con error. | | Preparación | Por preparar, en preparación, despachado y entregado. Para recojo: listo para recoger y recogido. | Esta separación permite saber si un pedido está pagado aunque todavía no haya sido preparado o entregado. ## Exportación de pedidos La exportación usa un archivo Excel con columnas definidas por la plataforma y una fila por artículo. Incluye los datos necesarios del pedido, comprador, entrega y comprobante. No incluye el editor de plantillas personalizadas de Riqra Legacy. ## Analítica externa La nueva tienda admite: * Google Analytics 4. * Google Tag Manager. * Meta Pixel. Universal Analytics ya no se carga. Migra la medición web a GA4 y revisa que cada identificador corresponda al servicio correcto antes de publicar. > [!TIP] > > Completa las tareas de esta área en la [lista antes de publicar](/plataforma/migracion/lista-de-revision). # Precios y políticas comerciales Source: https://docs.riqra.com/plataforma/migracion/precios-y-politicas Reparte lo que hacía tu lista de precios de Legacy entre catálogos, listas de precios, políticas comerciales y segmentos. En Riqra Legacy, la lista de precios resolvía todo por sí sola: fijaba el precio de cada producto, decidía cuáles veía el cliente y guardaba el mínimo de compra. Cada cliente tenía una lista asignada en su ficha. La nueva plataforma reparte ese trabajo en cuatro piezas. | Pieza | Qué resuelve | | - | - | | [Catálogo](/plataforma/productos/catalogos) | Qué productos y variantes puede comprar el cliente. | | [Lista de precios](/plataforma/precios/introduccion) | Cuánto cuesta cada variante. | | [Política comercial](/plataforma/politicas-comerciales/introduccion) | Une un catálogo con una lista de precios y agrega el pedido mínimo y los métodos de pago y envío. | | Segmento | Agrupa a los clientes que reciben esa política. | El cliente ya no lleva una lista de precios en su ficha. Pertenece a un segmento, el segmento tiene una política comercial y esa política elige el catálogo y la lista. ## En qué se convierte cada parte de la lista | En Riqra Legacy | En la nueva plataforma | | - | - | | Precio de cada producto | Precio de venta en la lista de precios. | | Qué productos veía el cliente, según tuvieran precio en su lista | Catálogo de la política comercial. | | Mínimo de compra de la lista | Pedido mínimo de la política comercial. | | Lista asignada en la ficha del cliente | Política comercial asignada a su segmento. | | Precio pactado con un cliente | Lista de precios propia, con su política y su segmento. | ## Arma la equivalencia lista por lista Repite estos pasos con cada lista de precios que tengas en Legacy. **1. Crea la lista de precios** Ve a **[Configuración → Listas de precios](https://app.riqra.com/settings/price-lists)**. Si la lista de Legacy era tu lista principal con un porcentaje de aumento o descuento, créala como lista derivada y te ahorras cargar los precios uno por uno. Lee [Crea una lista de precios](/plataforma/precios/crear-una-lista). **2. Carga los precios** Edita la cuadrícula en **[Productos → Precios](https://app.riqra.com/prices)** o usa la importación. La importación ya no crea la lista cuando el nombre no existe, y el SKU debe existir en tu catálogo. **3. Decide el catálogo** Si esos clientes veían menos productos que el resto, crea un [catálogo](/plataforma/productos/catalogos) y excluye lo que no deben ver. Si veían todos tus productos, usa **Catálogo general**. **4. Crea la política comercial** Ve a **[Configuración → Políticas comerciales](https://app.riqra.com/settings/commercial-policies)**, elige el catálogo y la lista, y escribe el pedido mínimo que tenía la lista en Legacy. Aprovecha para limitar los métodos de pago y envío si ese grupo compra con condiciones distintas. **5. Crea el segmento y mueve a los clientes** Ve a **[Clientes → Segmentos](https://app.riqra.com/clients/segments)**, crea el segmento, asígnale la política y agrega a las personas. Ponle el nombre de la lista de Legacy para ubicarlo rápido durante la revisión. Deja la lista que usaba la mayoría de tus clientes en la política predeterminada. Así la reciben los visitantes sin sesión y las personas que no quedaron en ningún segmento, y te ahorras un segmento que contenga a casi todos tus clientes. ## Cada persona pertenece a un solo segmento Una persona pertenece como máximo a un segmento, así que recibe una sola política y esa política aplica completa. Nunca se mezcla el catálogo de una política con los precios de otra. Cuando la persona no tiene segmento, o su segmento no tiene política, compra con la política predeterminada. > [!NOTE] > > Las empresas y sucursales solo aparecen en **Clientes** si usas [PedidosIA](/pedidos-ia/introduccion). Sus políticas se asignan sin pasar por un segmento. En una orden de compra, la política decide el catálogo y los precios, pero el pedido mínimo y los métodos de pago y envío no se validan, porque tú revisas y confirmas la orden. ## Quitar el precio ya no oculta el producto En Legacy, un producto sin precio en la lista desaparecía de la tienda para los clientes de esa lista. Ahora la visibilidad depende del catálogo. Un producto publicado que pertenece al catálogo del cliente aparece aunque no tenga precio en su lista. Se muestra sin precio y el comprador no puede agregarlo al carrito. Revisa los productos que ocultabas dejándolos sin precio y exclúyelos del catálogo que corresponda. ## Precios pactados con un cliente El importador de Legacy aceptaba una columna **Cliente** para darle a ese cliente un precio distinto en un producto. Ahora los precios pertenecen a una lista, no a un cliente. Para reproducir un precio pactado: * **Tienda online.** Crea una lista con los precios negociados, una política que la use y un segmento para ese cliente. Como cada persona pertenece a un solo segmento, un cliente con precios pactados no puede estar además en otro. * **PedidosIA.** Asigna la política a la empresa o a una de sus sucursales. Cuando el precio pactado es el precio general con un porcentaje de descuento, una lista derivada evita volver a cargar cada precio. Fija el ajuste y corrige a mano solo las variantes que se salgan de la regla. ## Ofertas y precio tachado Legacy guardaba un precio original y un texto de oferta de hasta ocho caracteres en cada producto de la lista. El precio tachado ahora es el **precio de lista** de la variante. Pertenece a la variante y vale lo mismo en todas las listas, así que no puedes marcar una oferta solo en la lista mayorista escribiendo un precio original distinto. La tienda lo tacha cuando es mayor que el precio de venta. No hay un texto de oferta por producto. Algunos temas muestran una etiqueta de oferta con un texto único para toda la tienda. Para un descuento temporal, o para uno dirigido a un grupo de clientes, crea una [promoción](/plataforma/migracion/promociones) en lugar de mover el precio de la lista. ## Precios escalonados La columna **Cantidad mínima** del importador de Legacy corresponde a los tramos por cantidad. Un tramo ahora ocupa dos columnas: `cantidad_min` es la cantidad desde la que aplica el precio y `cantidad_max` es la cantidad hasta la que aplica. La escalera de una variante empieza en 1, no deja huecos y solo el último tramo queda sin `cantidad_max`. Por ejemplo, un producto que en Legacy tenía 10.00 con cantidad mínima 1 y 9.00 con cantidad mínima 12 se carga como dos filas, la primera con `cantidad_min` 1 y `cantidad_max` 11, y la segunda con `cantidad_min` 12 y `cantidad_max` vacía. Lee [Define tramos por cantidad](/plataforma/precios/tramos-por-cantidad). En Legacy, **Cantidad mínima** valía 1 en todas las filas, también en las que solo fijaban el precio normal. No copies ese 1. Un precio fijo deja vacías las dos columnas de cantidad, y `cantidad_min` solo acepta números enteros de 1 en adelante. ## Equivalencia de columnas del importador El archivo ahora es Excel `.xlsx`, no CSV. Lee [Importa precios desde Excel](/plataforma/transferencia-de-datos/importar-precios). | Columna en Legacy | En la nueva plataforma | | - | - | | Lista de precio | `lista_precios`. La lista debe existir antes de importar. | | SKU | `sku`. | | Precio de venta | `precio`. | | Precio original | `precio_lista`, en la [importación de productos](/plataforma/transferencia-de-datos/importar-productos), porque pertenece a la variante. | | Texto oferta | Sin equivalente. | | Cantidad mínima | `cantidad_min`, más `cantidad_max` para cerrar el tramo. Solo en escaleras reales. Un precio fijo deja las dos vacías. | | Cliente | Sin equivalente. Usa una lista de precios propia. | > [!TIP] > > Completa las tareas de esta área en la [lista antes de publicar](/plataforma/migracion/lista-de-revision). # Promociones Source: https://docs.riqra.com/plataforma/migracion/promociones Conoce los tipos de promoción disponibles y qué reglas de Legacy necesitan revisión. Todas las promociones compatibles se crean y administran desde **Marketing → Promociones**. ## Tipos disponibles El motor actual admite: * **Descuento en productos:** porcentaje o monto sobre productos o colecciones seleccionados. * **Compra X y lleva Y:** aplica un beneficio cuando el carrito cumple una cantidad o un monto requerido. * **Descuento en el pedido:** porcentaje o monto sobre el subtotal del pedido. * **Envío gratis:** elimina el costo de un envío elegible. ## Cómo se activan Una promoción puede ser: * **Automática:** se aplica cuando el carrito cumple las condiciones. * **Con código:** el comprador ingresa un código durante la compra. También puedes configurar: * Fecha de inicio y finalización. * Requisito mínimo de monto o cantidad. * Productos o colecciones participantes. * Clientes o segmentos elegibles. * Límites de uso. * Combinación con otros descuentos. ## Reglas sin equivalencia exacta Una promoción de Riqra Legacy no siempre se puede copiar como una sola promoción. Revisa especialmente: * Reglas por medio de pago o BIN de tarjeta. * Precios fijos por SKU. * Escalas de descuentos no lineales. * Promociones con varios efectos simultáneos. * Descuentos parciales sobre el costo de envío. En algunos casos será necesario dividir la regla, cambiar su mecánica o definir una alternativa comercial. > [!WARNING] > > Las promociones que continuarán activas deben recrearse y probarse antes de publicar la tienda. No asumas que una regla de Legacy tendrá el mismo resultado sin validarla en carrito y checkout. > [!TIP] > > Completa las tareas de esta área en la [lista antes de publicar](/plataforma/migracion/lista-de-revision). # Tienda y navegación Source: https://docs.riqra.com/plataforma/migracion/tienda-y-navegacion Configura políticas legales, cookies, menús y landing pages en la nueva plataforma. La nueva plataforma concentra el contenido y la navegación de la tienda en herramientas que puedes administrar desde el panel. ## Políticas legales En Riqra Legacy, la tienda enlazaba documentos o páginas externas. Ahora puedes redactar y actualizar estos documentos desde **Configuración → Políticas**: * Política de privacidad. * Términos del servicio. * Política de reembolsos. * Política de envíos. Cuando publicas una política, la tienda puede enlazarla desde el pie de página, el checkout o una sección configurada en el tema. ## Aviso de cookies La activación del aviso de cookies ya no requiere una solicitud a soporte. Desde **Tienda online → Personalizar** puedes cambiar: * El mensaje. * El texto del botón. * El enlace a la política de privacidad. El aviso recuerda la aceptación en el navegador. No bloquea por sí solo la carga de herramientas de analítica. ## Carrito siempre visible Si tu tienda en Riqra Legacy mostraba el carrito fijo a la derecha del catálogo, puedes activarlo tú mismo con el tema Origin. En **Tienda online → Personalizar**, agrega la sección **Carrito fijo** al encabezado y guarda. En pantallas anchas, el carrito queda abierto junto a cada página y tus clientes finalizan la compra desde ahí. En pantallas más pequeñas, el carrito vuelve al botón del encabezado. Desde la sección puedes mostrar u ocultar el campo de código de descuento. ## Menús independientes de las categorías Las categorías siguen organizando el catálogo, pero ya no construyen automáticamente la navegación. En **Tienda online → Menús** puedes crear una estructura de hasta tres niveles, cambiar el orden y enlazar cada elemento con: * La página de inicio. * Una colección. * Un producto. * Una landing page. * La búsqueda. * Una URL externa. Esto permite cambiar la navegación sin mover productos de categoría. ## Landing pages y editor visual En **Tienda online → Páginas** puedes crear páginas para campañas, contenido informativo o colecciones especiales. Cada página puede guardarse como borrador, publicarse y agregarse a un menú. El editor visual permite organizar el contenido por secciones y bloques, ocultar elementos y revisar la tienda en escritorio, tableta y móvil. > [!TIP] > > Completa las tareas de esta área en la [lista antes de publicar](/plataforma/migracion/lista-de-revision). # Asigna políticas a tus clientes Source: https://docs.riqra.com/plataforma/politicas-comerciales/asignar-a-clientes Aplica una política comercial a un segmento, a una empresa o a una sucursal. Una política comercial solo tiene efecto cuando la asignas. Puedes hacerlo en tres niveles. Usa el más amplio que cubra el caso y reserva los más específicos para excepciones. | Nivel | Úsalo cuando | Dónde se asigna | | - | - | - | | **Segmento** | Muchos clientes comparten las mismas condiciones, por ejemplo mayoristas o farmacias. | [**Clientes → Segmentos**](/plataforma/clientes/segmentos) | | **Empresa** | Una empresa negoció condiciones propias para sus órdenes de compra. | [**Clientes → Empresas**](/plataforma/clientes/empresas-y-sucursales) | | **Sucursal** | Una sucursal necesita condiciones distintas al resto de su empresa. | Dentro de la empresa, en **Sucursales** | Las personas no tienen política propia. Cuando compran en la tienda, reciben la política de su segmento o la predeterminada. Los cambios aplican de inmediato. El carrito del comprador se recalcula con la política vigente en su siguiente visita. ## Asigna a un segmento **1. Abre el segmento** Ve a **[Clientes → Segmentos](https://app.riqra.com/clients/segments)** y haz clic en el segmento. **2. Elige la política** En el panel **Política comercial**, selecciona una política de la lista. **3. Guarda** Haz clic en **Guardar**. La política aplica a todas las personas y empresas del segmento. Para quitar la asignación, selecciona **Sin política asignada**. Los miembros del segmento pasan a usar la política predeterminada. ## Empresas y sucursales > [!NOTE] > > Las empresas y sucursales aparecen en **Clientes** solo si usas [PedidosIA](/pedidos-ia/introduccion). Sus políticas aplican a las órdenes de compra, no a las compras en la tienda online. ### Asigna a una empresa **1. Abre la empresa** Ve a **[Clientes → Empresas](https://app.riqra.com/clients/companies)** y haz clic en la empresa. **2. Elige la política** En el panel **Política comercial**, selecciona una política de la lista. **3. Guarda** Haz clic en **Guardar**. La política aplica a las órdenes de compra de la empresa desde cualquiera de sus sucursales, salvo las que tengan política propia. Para quitar la asignación, selecciona **Sin política asignada**. La empresa pasa a usar la política de su segmento o la predeterminada. ### Asigna a una sucursal **1. Abre la sucursal** En la página de la empresa, en la sección **Sucursales**, haz clic en la sucursal. **2. Elige la política** En el panel **Política comercial**, selecciona una política de la lista. **3. Guarda** Haz clic en **Guardar**. La política aplica solo a las órdenes de compra entregadas en esa sucursal. Para quitar la asignación, selecciona **Heredar de la empresa**. La opción muestra el nombre de la política de la empresa cuando tiene una. ## Ejemplo Una distribuidora vende a minoristas por su tienda online y recibe órdenes de compra de cadenas de farmacias por [PedidosIA](/pedidos-ia/introduccion). Configura: * **Política general** como predeterminada, con el catálogo completo y la lista de precios de venta al público. * **Política mayorista**, con precios por volumen, asignada al segmento **Mayoristas**. * **Política Farmacias Norte**, con un catálogo reducido a productos farmacéuticos, asignada a la empresa **Farmacias Norte**, que pertenece al segmento **Mayoristas**. * **Política Cusco**, con una lista de precios negociada para esa plaza, asignada a la sucursal **Cusco** de Farmacias Norte. Con esa configuración, cada comprador recibe: | Comprador | Cómo compra | Política | | - | - | - | | Visitante sin sesión | Tienda online | Política general | | Persona sin segmento | Tienda online | Política general | | Persona del segmento Mayoristas | Tienda online | Política mayorista | | Empresa del segmento Mayoristas sin política propia | Orden de compra | Política mayorista | | Farmacias Norte, sucursal Lima | Orden de compra | Política Farmacias Norte | | Farmacias Norte, sucursal Cusco | Orden de compra | Política Cusco | # Crea una política comercial Source: https://docs.riqra.com/plataforma/politicas-comerciales/crear-una-politica Define el catálogo, la lista de precios, el pedido mínimo, los métodos de pago y envío y las ubicaciones de compra para un grupo de clientes. Una política comercial combina un [catálogo](/plataforma/productos/catalogos), una lista de precios y las condiciones del pedido. Una vez creada, la asignas a segmentos, empresas o sucursales desde sus propias páginas. ## Antes de empezar * Crea el catálogo que verán estos clientes. Si van a ver todos tus productos, usa **Catálogo general**. * Crea la [lista de precios](/plataforma/precios/crear-una-lista) y actívala. Una política solo acepta listas activas. * Si vas a limitar los métodos de pago o de envío, configúralos primero en **Configuración → Pagos** y en [Configuración → Envío](/plataforma/envios/introduccion). ## Crea la política **1. Abre las políticas comerciales** Ve a **[Configuración → Políticas comerciales](https://app.riqra.com/settings/commercial-policies)** y haz clic en **Nueva política**. **2. Escribe un nombre** El nombre es interno y los compradores no lo ven. Debe ser único en tu organización, por ejemplo **Política mayorista**. **3. Elige el catálogo y la lista de precios** En **Selección comercial**, haz clic en **Elegir catálogo** y selecciona uno. Luego haz clic en **Elegir lista de precios** y selecciona una lista activa. **4. Define las condiciones** Completa el **Pedido mínimo**, elige qué **Métodos de pago** y **Métodos de envío** acepta la política y, si vendes desde varias tiendas, sus **Ubicaciones de compra**. Las secciones siguientes explican cada opción. **5. Guarda** Haz clic en **Guardar**. La política queda lista para asignarla desde [segmentos, empresas y sucursales](/plataforma/politicas-comerciales/asignar-a-clientes). ## Pedido mínimo Escribe el monto en **Pedido mínimo** o déjalo vacío para no exigir uno. El mínimo se compara con el subtotal de mercadería después de aplicar promociones, sin incluir el costo de envío. Si el carrito no llega al mínimo, el comprador ve cuánto le falta y no puede confirmar el pedido. ## Métodos de pago y de envío Cada sección tiene dos opciones: * **Todos los métodos.** La política acepta todos los métodos de pago habilitados o todos los métodos de envío activos de tu organización, incluidos los que habilites más adelante. * **Métodos seleccionados.** La política acepta solo los métodos que elijas con **Seleccionar métodos**. Debes seleccionar al menos uno. Si deshabilitas un método de pago o desactivas un método de envío, deja de ofrecerse en todas las políticas que lo incluyen. No necesitas editar cada política. > [!NOTE] > > Mientras una política seleccione un método, no puedes eliminar ese método. Lo mismo ocurre con el catálogo y la lista de precios de la política: cambia la política antes de eliminarlos o desactivar la lista. ## Ubicaciones de compra De forma predeterminada, una política no restringe ubicaciones: el comprador ve el mayor disponible entre tus ubicaciones activas y el pedido sale de la ubicación que define su forma de entrega. Con **Ubicaciones seleccionadas**, eliges desde qué ubicaciones activas compran los clientes de la política. Debes seleccionar al menos una. Con una sola, todo el stock y los pedidos salen de esa ubicación. Si seleccionas varias, el comprador elige una en la cabecera de la tienda y todo lo que ve se calcula con el stock de esa ubicación. Lee [Controla el stock en la tienda](/plataforma/inventario/control-de-stock). Si desactivas una ubicación seleccionada, deja de ofrecerse sin que edites la política. Si todas quedan inactivas, los clientes de la política ven todo agotado hasta que reactives una o cambies la selección. ## Cambia la política predeterminada Abre la política que quieres usar como predeterminada y, en el panel **Política predeterminada**, haz clic en **Establecer como predeterminada**. La política anterior deja de serlo en ese momento. La política predeterminada aplica a los clientes sin una asignación específica y a los visitantes que no iniciaron sesión. ## Elimina una política Al final del detalle, haz clic en **Eliminar política comercial** y confirma. No puedes eliminar la política predeterminada. Establece otra como predeterminada primero. Tampoco puedes eliminar una política asignada a segmentos, empresas o sucursales. Quita esas asignaciones antes. Los pedidos confirmados con la política eliminada conservan sus precios y condiciones. # Qué es una política comercial Source: https://docs.riqra.com/plataforma/politicas-comerciales/introduccion Una política comercial define qué productos puede comprar un cliente, a qué precio y con qué condiciones de pedido mínimo, pago y envío. Una política comercial reúne en un solo lugar las condiciones de venta para un grupo de clientes: qué [catálogo](/plataforma/productos/catalogos) ven, qué lista de precios se les aplica y qué requisitos debe cumplir su pedido. Asignas una política a un segmento, a una empresa o a una sucursal, y se aplica en la tienda, en el carrito y en el checkout de esos clientes. Las administras desde **[Configuración → Políticas comerciales](https://app.riqra.com/settings/commercial-policies)**. ## Qué define una política | Campo | Qué controla | | - | - | | **Catálogo** | Qué productos y variantes puede comprar el cliente. | | **Lista de precios** | Qué precio paga por cada variante. Lee [Qué es una lista de precios](/plataforma/precios/introduccion). | | **Pedido mínimo** | Monto mínimo de mercadería para confirmar un pedido. Vacío significa sin mínimo. | | **Métodos de pago** | Todos los métodos de pago habilitados o solo los que selecciones. | | **Métodos de envío** | Todos los métodos de envío activos o solo los que selecciones. | | **Ubicaciones de compra** | Desde qué ubicaciones compra el cliente. Con varias, elige una en la tienda y ve el stock de esa ubicación. | Un mismo catálogo o una misma lista de precios puede usarse en varias políticas. Por ejemplo, dos políticas pueden mostrar el mismo catálogo con listas de precios distintas. ## Cómo se elige la política de un cliente La búsqueda sigue este orden y aplica la primera política que encuentra. La política aplica completa. Nunca se combina el catálogo de una política con los precios de otra. ### Compras en tu tienda online Aplica a las compras y cotizaciones de la tienda: 1. La política del segmento de la persona. 2. La política predeterminada. Un visitante que no inició sesión ve el catálogo y los precios de la política predeterminada. ### Órdenes de compra de PedidosIA Una orden de compra de [PedidosIA](/pedidos-ia/introduccion) la emite una empresa y se entrega en una de sus sucursales: 1. La política de la sucursal. 2. La política de la empresa. 3. La política del segmento de la empresa. 4. La política predeterminada. > [!NOTE] > > Las empresas y sucursales aparecen en **Clientes** solo si usas [PedidosIA](/pedidos-ia/introduccion). Si vendes por tu tienda online, tus clientes son personas y se agrupan en [segmentos](/plataforma/clientes/segmentos). ## La política predeterminada Cada organización tiene exactamente una política predeterminada. Se crea al activar tu cuenta con el nombre **Política general**, enlazada al catálogo **Catálogo general** y a la lista de precios **Lista base**. Puedes editarla o establecer otra política como predeterminada, pero no puedes eliminarla ni dejar la organización sin una. La columna `precio` de la [importación de productos](/plataforma/transferencia-de-datos/importar-productos) escribe en la lista de precios de la política predeterminada. ## Dónde se aplica * **Tienda online.** Las páginas de producto, las colecciones y el carrito muestran solo el catálogo y los precios de la política del comprador. * **Checkout.** El comprador solo ve los métodos de pago y envío que permite su política, y no puede confirmar el pedido hasta alcanzar el pedido mínimo. * **Cotizaciones.** Usan el catálogo y los precios de la política de la persona. * **PedidosIA.** Las órdenes de compra toman los precios de la política de la empresa. El pedido mínimo y los métodos de pago y envío no se validan, porque revisas y confirmas la orden tú mismo. * **Pedidos.** Al confirmar un pedido, se guardan la política, el catálogo y la lista de precios que se usaron. Cambiar la política después no modifica los pedidos existentes. ## Siguientes pasos * [Crea una política comercial](/plataforma/politicas-comerciales/crear-una-politica) * [Asigna políticas a tus clientes](/plataforma/politicas-comerciales/asignar-a-clientes) # Crea una lista de precios Source: https://docs.riqra.com/plataforma/precios/crear-una-lista Crea una lista independiente con sus propios precios o una lista derivada que aplica un ajuste porcentual sobre otra. Una lista nueva no cambia lo que ven tus clientes hasta que una [política comercial](/plataforma/politicas-comerciales/crear-una-politica) la seleccione. ## Crea la lista **1. Abre las listas de precios** Ve a **[Configuración → Listas de precios](https://app.riqra.com/settings/price-lists)** y haz clic en **Nueva lista**. **2. Escribe un nombre** El nombre es interno y debe ser único en tu organización, por ejemplo **Lista mayorista**. **3. Elige el tipo de lista** En **Tipo de lista**, elige **Independiente** o **Derivada de otra lista**. Si eliges derivada, selecciona la lista base entre tus listas independientes activas. El tipo y la lista base no se pueden cambiar después. **4. Define el ajuste** Solo en listas derivadas. En **Ajuste de precio**, elige **Sin ajuste**, **Aumento porcentual** o **Descuento porcentual** y escribe el porcentaje, entre 0 y 100. **5. Guarda** Haz clic en **Guardar**. Una lista independiente nace sin precios. Una lista derivada ya tiene el precio de venta de cada variante que tenga precio en su lista base. ## Cómo se calcula el precio de venta de una lista derivada El ajuste se aplica sobre el precio de venta de la lista base. Con un precio base de 100.00: | Ajuste | Precio de venta | | - | - | | Sin ajuste | 100.00 | | Aumento porcentual de 10 % | 110.00 | | Descuento porcentual de 15 % | 85.00 | El resultado se redondea a cuatro decimales y nunca baja de cero. Si la variante no tiene precio en la lista base, tampoco lo tiene en la lista derivada, salvo que fijes uno a mano. Puedes cambiar el ajuste de una lista derivada en cualquier momento. El cambio aplica a todas sus variantes que no tengan un precio fijado a mano. ## Desactiva o reactiva una lista Abre la lista y, en el panel de estado, haz clic en **Desactivar** o **Reactivar**. Luego guarda. Una lista inactiva no puede asignarse a nuevas políticas y sus precios no se editan. No puedes desactivar una lista mientras una política comercial la use o mientras otra lista derive de ella. Cambia esas referencias primero. ## Elimina una lista Al final del detalle, haz clic en **Eliminar lista de precios** y confirma. Se eliminan también todos los precios y tramos de la lista. Aplican las mismas restricciones que al desactivar. Los pedidos confirmados con esa lista conservan sus precios. # Edita los precios de tus variantes Source: https://docs.riqra.com/plataforma/precios/editar-precios Usa la cuadrícula de precios para editar el precio de venta y el precio de lista de muchas variantes a la vez. Los precios se editan en **[Productos → Precios](https://app.riqra.com/prices)**, una cuadrícula con una fila por variante, o desde la ficha de cada producto. ## Edita en la cuadrícula **1. Elige la lista** Con el selector de la parte superior, elige la lista de precios que vas a editar. Debajo del nombre de cada lista derivada aparece la lista de la que deriva y, a la derecha, su ajuste, por ejemplo **+10%**. **2. Encuentra las variantes** Usa el buscador para filtrar por nombre de producto o SKU. La cuadrícula se pagina con **Anterior** y **Siguiente**. **3. Escribe los precios** Edita las celdas de la fila. Las columnas dependen del tipo de lista. Las secciones siguientes explican cada una. **4. Guarda** Haz clic en **Guardar**. Mientras tengas cambios sin guardar no puedes cambiar de lista, buscar, paginar ni importar. **Descartar** vuelve a los valores guardados. ## Columnas de una lista independiente | Columna | Qué escribes | | - | - | | **Precio de lista** | El precio de comparación. Cuando es mayor que el precio de venta, la tienda lo muestra tachado junto a él. Es el mismo en todas las listas. | | **Precio de venta** | Lo que paga el comprador con esta lista. Deja la celda vacía para que la variante quede sin precio en esta lista. | ## Columnas de una lista derivada | Columna | Qué muestra | | - | - | | **Precio en** y el nombre de la lista base | El precio de venta de la lista base. Solo lectura. | | **Precio de venta** | El precio calculado con el ajuste, en gris, mientras la celda está vacía. El encabezado muestra el ajuste de la lista. | Para fijar un precio distinto al calculado en una variante, escribe el valor en **Precio de venta**. Ese precio fijo aplica a toda cantidad y deja de seguir a la lista base hasta que lo borres. Para volver al precio calculado, vacía la celda o haz clic en el botón (**Volver al calculado**) de la fila. El precio de lista solo se edita desde una lista independiente. El costo se edita en la ficha de la variante. ## Edita desde la ficha del producto En la variante de un producto encuentras **Costo**, **Precio de lista** y una tabla con una fila por cada lista activa. Las listas derivadas aparecen debajo de su lista base con su ajuste. Al cambiar el precio de una lista independiente, las filas derivadas muestran el nuevo precio calculado antes de guardar. Los precios se guardan junto con el producto. ## Precios por cantidad Una variante puede tener una escalera de precios en lugar de un precio fijo. En la cuadrícula, la escalera reemplaza a la celda de precio. Lee [Define tramos por cantidad](/plataforma/precios/tramos-por-cantidad). ## Precios en bloque Para actualizar muchos precios a la vez, usa **Exportar** e **Importar** en la misma página. Lee [Importa precios desde Excel](/plataforma/transferencia-de-datos/importar-precios). # Qué es una lista de precios Source: https://docs.riqra.com/plataforma/precios/introduccion Una lista de precios define cuánto cuesta cada variante. Puedes tener varias listas y elegir cuál ve cada cliente a través de su política comercial. Una lista de precios asigna un precio de venta a cada [variante](/plataforma/productos/variantes) de tu catálogo. Puedes crear varias listas, por ejemplo una para el público general y otra con precios mayoristas, y decidir cuál ve cada cliente mediante su [política comercial](/plataforma/politicas-comerciales/introduccion). Las listas se administran en **[Configuración → Listas de precios](https://app.riqra.com/settings/price-lists)**. Los precios de cada variante se editan en **[Productos → Precios](https://app.riqra.com/prices)** o desde la ficha del producto. ## Listas independientes y derivadas | Tipo | Cómo obtiene sus precios | Úsala cuando | | - | - | - | | **Independiente** | Escribes el precio de venta de cada variante. | Es tu lista principal o una lista con precios negociados que no dependen de otra. | | **Derivada** | Toma los precios de una lista independiente, la **lista base**, y les aplica un ajuste porcentual. Puedes fijar un precio distinto en variantes puntuales. | Quieres una variante de tu lista principal, por ejemplo con un 10 % de descuento, sin volver a escribir cada precio. | Una lista derivada sigue a su lista base. Si cambias un precio en la base, el precio derivado cambia solo. La lista base se elige al crear la lista derivada y no se puede cambiar después. Una lista derivada no puede servir de base para otra. Al activar tu cuenta se crea la lista independiente **Lista base**, seleccionada por la política comercial predeterminada. Es una lista normal. Puedes renombrarla o apuntar la política a otra lista. ## Los precios de una variante | Precio | Dónde vive | Qué es | | - | - | - | | **Precio de venta** | En cada lista | Lo que paga el comprador cuando su política usa esa lista. En una lista derivada es el precio base con el ajuste aplicado, o el precio que fijaste a mano para esa variante. | | **Precio base** | En una lista derivada | El precio de venta de la lista base, visto desde la lista derivada. En la cuadrícula de precios aparece como **Precio en** y el nombre de la lista base. | | **Precio de lista** | En la variante | El precio de comparación. En la tienda aparece tachado junto al precio de venta cuando es mayor, para mostrar el descuento. | | **Costo** | En la variante | Lo que te cuesta adquirir o producir la variante. El comprador nunca lo ve. | El precio de lista y el costo pertenecen a la variante y son los mismos en todas las listas. ## Tramos por cantidad En lugar de un precio fijo, una variante puede tener una escalera de precios por cantidad. Por ejemplo, 10.00 de 1 a 11 unidades y 9.00 desde 12. La escalera aplica en la tienda, en el carrito y en las órdenes de compra según la cantidad pedida. Lee [Define tramos por cantidad](/plataforma/precios/tramos-por-cantidad). ## Cómo llega el precio al cliente Una lista no se asigna a un cliente directamente. La [política comercial](/plataforma/politicas-comerciales/introduccion) del cliente selecciona una lista, y esa lista se usa en las páginas de producto, el carrito, el checkout, las cotizaciones y las órdenes de compra. Al confirmar un pedido, se guardan la lista y el precio cobrado en cada línea. Cambiar la lista después no modifica los pedidos existentes. Si una variante no tiene precio en la lista del cliente, no se toma de otra lista. La variante queda sin precio para ese cliente. ## Estado de una lista Una lista está **Activa** o **Inactiva**. Solo las listas activas pueden asignarse a una política comercial. La cuadrícula de precios y la ficha del producto solo editan listas activas. No puedes desactivar ni eliminar una lista mientras una política la use o mientras otra lista derive de ella. ## Siguientes pasos * [Crea una lista de precios](/plataforma/precios/crear-una-lista) * [Edita los precios de tus variantes](/plataforma/precios/editar-precios) * [Define tramos por cantidad](/plataforma/precios/tramos-por-cantidad) * [Importa precios desde Excel](/plataforma/transferencia-de-datos/importar-precios) # Define tramos por cantidad Source: https://docs.riqra.com/plataforma/precios/tramos-por-cantidad Cobra un precio distinto según la cantidad que pide el comprador, con hasta 15 tramos por variante y lista. Un tramo es un precio que aplica cuando la cantidad pedida cae dentro de un rango. Los tramos de una variante forman una escalera que cubre todas las cantidades desde 1. La escalera es el precio de la variante en esa lista. Reemplaza al precio fijo. Por ejemplo, para una caja de 12 unidades: | Desde | Hasta | Precio | | - | - | - | | 1 | 11 | 10.00 | | 12 | 47 | 9.00 | | 48 | Sin límite | 8.50 | Un pedido de 20 unidades paga 9.00 por unidad. La escalera se muestra en la página del producto y aplica en el carrito, el checkout y las órdenes de compra. ## Reglas de una escalera * El primer tramo empieza en la cantidad 1. * Los tramos son contiguos. Cada uno empieza una unidad después del máximo del anterior. * Solo el último tramo queda sin cantidad máxima. * Cada precio debe ser mayor que cero. * Una variante admite hasta 15 tramos por lista. ## Crea los tramos de una variante **1. Abre la cuadrícula de precios** Ve a **[Productos → Precios](https://app.riqra.com/prices)** y elige la lista. **2. Abre el editor de tramos** En la fila de la variante, haz clic en el botón (**Definir tramos por cantidad**). **3. Escribe los tramos** Completa **Desde**, **Hasta** y **Precio** de cada tramo. Usa **Agregar tramo** para sumar uno. Deja el último tramo sin cantidad máxima. **4. Guarda** Confirma el editor y luego haz clic en **Guardar** en la cuadrícula. La celda de precio pasa a mostrar la escalera, con el precio desde 1 unidad y la cantidad de tramos. Puedes hacer lo mismo desde la ficha del producto, en la fila de cada lista. Para editar la escalera, haz clic sobre ella. Para volver a un precio fijo, haz clic en el botón (**Quitar tramos y fijar un precio**) de la escalera y escribe el precio. ## Tramos en una lista derivada Si la variante tiene tramos en la lista base, la lista derivada muestra una **escalera heredada** con el ajuste aplicado a cada tramo. Sigue a la lista base: si cambias los tramos en la base, la escalera heredada cambia sola. Desde una escalera heredada puedes: * **Personalizarla.** Haz clic en la escalera para abrir el editor con los precios ajustados y modifícalos. Al guardar, la lista derivada guarda sus propios tramos y deja de seguir a la base en esa variante. * **Fijar un precio para toda cantidad.** Haz clic en el botón (**Fijar un precio para toda cantidad**) de la escalera y escribe el precio. La variante deja de tener tramos en esta lista. * **Volver a la escalera heredada.** En una variante con tramos propios o precio fijo, haz clic en el botón (**Volver a la escalera heredada**). En una lista derivada, cada variante tiene una sola forma de precio a la vez: tramos propios, un precio fijo, o el precio calculado a partir de la lista base, con su escalera heredada si la base tiene tramos. # Crea un catálogo Source: https://docs.riqra.com/plataforma/productos/catalogos Un catálogo decide qué productos y variantes ve un cliente. Incluye todo lo publicado y excluye lo que ese cliente no debe ver. Un catálogo es la parte de tu surtido que ve un grupo de clientes. Parte de todos los productos publicados y todas las variantes activas, y tú excluyes productos completos o variantes puntuales. Un catálogo sin exclusiones muestra todo. Un catálogo no se asigna a un cliente directamente. La [política comercial](/plataforma/politicas-comerciales/introduccion) de cada cliente define qué catálogo y qué lista de precios le corresponden. Al activar tu cuenta se crea el catálogo **Catálogo general**, sin exclusiones, seleccionado por la política predeterminada. Se administran en **[Productos → Catálogos](https://app.riqra.com/catalogs)**. ## Crea el catálogo **1. Abre los catálogos** Ve a **[Productos → Catálogos](https://app.riqra.com/catalogs)** y haz clic en **Nuevo catálogo**. **2. Escribe el nombre** En **Información**, escribe un **Nombre** único en tu organización, por ejemplo **Catálogo mayorista**, y una **Descripción** opcional para tu equipo. **3. Guarda** Haz clic en **Guardar**. El catálogo nace sin exclusiones. **4. Asígnalo a una política comercial** El catálogo no cambia lo que ven tus clientes hasta que una [política comercial](/plataforma/politicas-comerciales/crear-una-politica) lo seleccione. ## Excluye productos y variantes La sección **Inventario del catálogo** lista los productos publicados de tu organización. Busca por nombre o SKU y usa las pestañas **Todos**, **Con exclusiones** y **Solo excluidos** para filtrar. Cada cambio se aplica al instante, sin pasar por **Guardar**. * Para ocultar un producto completo, haz clic en **Excluir** en su fila. La fila pasa a **Excluido**. * Para ocultar solo algunas variantes, expande el producto y marca las variantes a excluir. La fila pasa a **Parcial**. * Para volver a mostrar un producto, haz clic en **Incluir**. Se limpian tanto la exclusión del producto como las de sus variantes. Excluir un producto completo borra las exclusiones de variantes que tuviera. Marcar variantes en un producto excluido lo vuelve a incluir con solo esas variantes ocultas. Un producto en borrador o archivado no aparece en la lista porque ya no es visible en ningún catálogo. Si lo publicas más tarde, entra incluido. ## Qué ve el cliente Un producto excluido no aparece en la tienda, en la búsqueda ni en las colecciones para los clientes de ese catálogo. Una variante excluida desaparece de la página del producto. Un pack se incluye o excluye por sí mismo: excluir uno de sus componentes no oculta el pack. ## Elimina un catálogo Al final de la ficha, haz clic en **Eliminar catálogo** y confirma. No puedes eliminar un catálogo mientras una política comercial lo use. Cambia el catálogo de esa política primero. # Organiza el catálogo en categorías Source: https://docs.riqra.com/plataforma/productos/categorias Arma un árbol de categorías de hasta tres niveles y asigna cada producto a una o varias de ellas. Las categorías clasifican tus productos en un árbol de hasta tres niveles, por ejemplo **Bebidas → Jugos → Néctares**. Un producto puede estar en varias categorías, de cualquier nivel, y una asignación cuenta también para las categorías superiores: un producto en **Jugos** aparece al filtrar por **Bebidas**. Las categorías no arman el menú de la tienda. Los menús y las [colecciones](/plataforma/productos/colecciones) deciden cómo se navega y se agrupa. Se administran en **[Configuración → Categorías](https://app.riqra.com/settings/categories)**. ## Crea una categoría **1. Abre las categorías** Ve a **[Configuración → Categorías](https://app.riqra.com/settings/categories)** y haz clic en **Nueva categoría**. Para crear una subcategoría desde el árbol, expande la categoría padre y haz clic en **Añadir subcategoría**. **2. Escribe el nombre y la descripción** En **Información básica**, completa el **Nombre** y, si quieres, una **Descripción**. **3. Elige la categoría padre** En el panel **Organización**, selecciona la **Categoría padre**. Déjala vacía para crear una categoría raíz. El selector oculta las categorías que no pueden ser padre por el límite de tres niveles. **4. Guarda** Haz clic en **Guardar**. La categoría nace **Activa**. ## Mueve una categoría Abre la categoría y cambia la **Categoría padre**. La categoría se mueve con todas sus subcategorías y conserva sus productos. No puedes moverla debajo de sí misma ni de una de sus subcategorías, ni a un lugar donde su rama supere los tres niveles. Cualquier categoría puede volver a la raíz. ## Asigna productos Los productos se asignan desde la ficha de cada producto, en la sección **Categorías**. Solo puedes asignar una categoría si ella y todas sus categorías superiores están activas. La sección **Productos asignados** de la ficha de la categoría lista sus productos. Desde allí puedes quitar un producto con el botón (**Quitar de la categoría**). El producto sigue existiendo y conserva sus otras categorías. Esta acción se aplica de inmediato, así que guarda o descarta los cambios pendientes del formulario antes. ## Busca en el árbol Sin texto en el buscador, la página muestra las categorías raíz y expandes cada rama con su flecha. Al escribir un nombre, la página pasa a una lista plana con todas las coincidencias de cualquier nivel, cada una con su ruta arriba del nombre. ## Desactiva o reactiva una categoría Abre la categoría y, en el panel de estado, haz clic en **Desactivar** o **Reactivar**. Luego guarda. Una categoría inactiva conserva su lugar en el árbol y sus productos, pero no acepta asignaciones nuevas, ni ella ni sus subcategorías. ## Elimina una categoría Al final de la ficha, haz clic en **Eliminar categoría** y confirma. Solo se puede eliminar una categoría sin productos asignados y sin subcategorías. Quita los productos y mueve o elimina las subcategorías primero. # Crea una colección Source: https://docs.riqra.com/plataforma/productos/colecciones Agrupa productos en una página de la tienda, eligiéndolos a mano o con condiciones de etiqueta, marca y categoría. Una colección es un grupo de productos con su propia página en la tienda, por ejemplo **Novedades**, **Ofertas de verano** o **Sin azúcar**. Tú decides qué productos entran y en qué orden se muestran. Se administran en **[Productos → Colecciones](https://app.riqra.com/collections)**. ## Manual o automática | Tipo | Cómo entran los productos | Úsala cuando | | - | - | - | | **Manual** | Los eliges y ordenas uno por uno. Hasta 500 productos. | Eliges cada producto a mano y la lista cambia poco. | | **Automática** | Entran solos los productos que cumplen condiciones de **Etiqueta**, **Marca** o **Categoría**. Sin límite. | La colección debe mantenerse sola cuando agregas productos. | Puedes cambiar el tipo de una colección después de crearla. Al pasar de manual a automática, la lista de productos se vacía y pasa a depender de las condiciones. ## Crea la colección **1. Abre las colecciones** Ve a **[Productos → Colecciones](https://app.riqra.com/collections)** y haz clic en **Nueva colección**. **2. Escribe el nombre y la descripción** En **Información básica**, completa el **Nombre** y, si quieres, una **Descripción**. En **Imagen** puedes subir o elegir de la biblioteca una imagen que los temas de la tienda pueden usar al mostrar la colección. **3. Elige el tipo** En **Tipo de colección**, elige **Manual** o **Automática**. **4. Agrega productos o define condiciones** En una colección manual, haz clic en **Agregar productos**, busca por nombre o SKU y confirma. Arrastra las filas para ordenarlas. En una colección automática, en **Condiciones**, elige si los productos deben cumplir **todas las condiciones** o **cualquier condición** y agrega cada condición con **Agregar condición**. La lista de productos muestra qué coincide con las condiciones que vas escribiendo, antes de guardar. **5. Elige el orden por defecto** En **Orden por defecto**, elige qué ve un comprador que no ha elegido un orden: **Manual** muestra tu orden. **Más recientes**, **Precio: menor a mayor**, **Precio: mayor a menor** y **Nombre A-Z** usan el criterio que corresponde. **6. Guarda** Haz clic en **Guardar**. La colección nace **Activa**. ## Cómo funcionan las condiciones Cada condición tiene un campo, una relación y uno o más valores. | Campo | **es igual a** | **no es igual a** | | - | - | - | | **Etiqueta** | El producto tiene alguna de las etiquetas. | El producto no tiene ninguna de ellas. Incluye productos sin etiquetas. | | **Marca** | La marca del producto es una de las elegidas. | La marca es otra, o el producto no tiene marca. | | **Categoría** | El producto está en alguna de las categorías elegidas o en sus subcategorías. | No está en ninguna de ellas. Incluye productos sin categoría. | Una colección automática necesita al menos una condición con valores. Una condición sin valores no coincide con ningún producto. ## El orden de una colección automática Puedes ordenar a mano los productos de una colección automática igual que los de una manual. Un producto que empieza a cumplir las condiciones después de tu último guardado se agrega al final de la lista, ordenado por nombre, hasta que lo muevas. ## Qué ve el comprador La página de la colección muestra solo productos publicados que el catálogo del comprador incluye. Un borrador o un producto archivado no aparece aunque esté en la lista. Si el comprador elige un orden o aplica un filtro en la página, ese criterio manda. El **Orden por defecto** solo aplica cuando no ha elegido nada. ## Desactiva, reactiva o elimina una colección En el panel de estado, haz clic en **Desactivar** o **Reactivar** y guarda. Una colección inactiva no se muestra en la tienda. Para eliminarla, haz clic en **Eliminar colección** al final de la ficha y confirma. Los productos no se eliminan. # Crea un producto Source: https://docs.riqra.com/plataforma/productos/crear-un-producto Crea la ficha de un producto, elige su tipo, completa sus atributos e imágenes y publícalo cuando esté listo. Un producto nuevo nace como borrador y no aparece en la tienda hasta que lo publicas. Puedes guardarlo incompleto y volver después. ## Antes de empezar * Si el producto tiene opciones como color o talla, crea antes el [tipo de producto y sus atributos](/plataforma/productos/tipos-y-atributos). El tipo se elige al crear el producto y no se puede cambiar después de guardarlo. * Crea las [marcas](/plataforma/productos/marcas) y [categorías](/plataforma/productos/categorias) que vas a asignar. * Para cargar muchos productos a la vez, usa la [importación desde Excel](/plataforma/transferencia-de-datos/importar-productos). ## Crea el producto **1. Abre el formulario** Ve a **[Productos](https://app.riqra.com/products)** y haz clic en **Nuevo producto**. Para un producto compuesto por otros, usa **Nuevo pack** y sigue [Crea un pack](/plataforma/productos/packs). **2. Escribe el nombre y la descripción** En **Información básica**, completa **Nombre** y **Descripción**. El nombre admite hasta 200 caracteres y la descripción hasta 10 000. La URL del producto se genera a partir del nombre la primera vez que guardas. Si otro producto ya usa esa URL, se le agrega un número al final (`polo-azul-2`, `polo-azul-3`). Si escribes la URL tú mismo en **SEO**, se guarda tal cual; si otro producto ya la usa, el producto no se crea hasta que elijas otra. **3. Elige el tipo de producto** En el panel **Configuración**, selecciona el **Tipo de producto**. Solo aparecen los tipos que ya tienen atributos. Si el producto no tiene opciones, déjalo en **Sin tipo**: el producto tendrá una única variante. Puedes cambiar el tipo mientras el producto no esté guardado. Al cambiarlo se borran los atributos y las variantes que hayas completado. Después de guardar, el tipo queda fijo. Un producto guardado sin tipo no podrá recibir uno. **4. Completa los atributos del producto** En **Atributos del producto** aparecen los atributos de producto de su tipo, con sus valores. Un atributo marcado como requerido es un recordatorio: puedes guardar y publicar sin completarlo. **5. Asigna marca, impuesto y categorías** En el panel **Configuración**, elige la **Marca** y el **Impuesto**. Si dejas el impuesto en la opción predeterminada, el producto usa la tasa predeterminada de tu organización. En **Categorías**, haz clic en el botón (**Agregar categoría**) y elige una o varias. El selector muestra un nivel a la vez y solo ofrece categorías activas. **6. Sube las imágenes** En **Imágenes**, usa **Subir** o **Biblioteca**. La primera imagen es la portada. Arrastra para reordenar. Cada producto admite hasta 50 imágenes de hasta 10 MB. **7. Guarda** Haz clic en **Guardar**. El producto queda en **Borrador** y ya puedes trabajar sus variantes. ## Completa las variantes Un producto sin tipo ya tiene su variante única. Un producto con tipo necesita que generes las variantes a partir de sus atributos de variante. Lee [Administra las variantes](/plataforma/productos/variantes) para generar la matriz, completar los SKU y definir precios, stock y medidas. ## Documentos, SEO, sinónimos y etiquetas Estas secciones son opcionales y se guardan con el resto del formulario. | Sección | Para qué sirve | Límites | | - | - | - | | **Documentos** | Fichas técnicas, certificados y manuales que el comprador descarga desde la página del producto. | Hasta 10 archivos PDF, DOC, DOCX, XLS o XLSX de 25 MB cada uno. | | **SEO** | La **URL del producto**, el **Título SEO** y la **Meta descripción**. Si dejas vacío el título SEO, la tienda usa el nombre del producto. La meta descripción no tiene valor predeterminado: si la dejas vacía, la página se publica sin ella. | Al cambiar la URL, la anterior redirige a la nueva. Se conserva solo la última redirección. | | **Sinónimos** | Nombres alternativos con los que los compradores buscan el producto. No se muestran en la tienda. | Hasta 10. | | **Etiquetas** | Palabras para agrupar productos. Las [colecciones automáticas](/plataforma/productos/colecciones) las usan como condición. | Hasta 250. | ## Publica el producto En el panel de estado, haz clic en **Publicar producto**. El cambio se aplica al instante: el producto pasa a **Publicado** y aparece en la tienda para los clientes cuyo catálogo lo incluye. Para ocultarlo sin archivarlo, haz clic en **Pasar a borrador**. Un producto publicado necesita al menos una variante activa. ## Archiva o restaura un producto Al final del formulario, haz clic en **Archivar producto** y confirma. El producto deja de aparecer en la tienda y en los catálogos. Sus pedidos y sus datos se conservan. Para volver a usarlo, haz clic en **Restaurar producto**. Vuelve a **Borrador** y puedes editarlo y publicarlo de nuevo. Si el producto forma parte de un pack, el panel **Packs** te avisa. Archivarlo hace que esos packs ya no puedan venderse hasta que lo restaures o cambies la composición del pack. # Qué es un producto Source: https://docs.riqra.com/plataforma/productos/introduccion Un producto agrupa todo lo que compartes sobre algo que vendes. Cada versión comprable, con su propio SKU, es una variante. Un producto es la ficha de algo que vendes: nombre, descripción, imágenes, marca y categorías. Una variante es cada versión que un comprador puede pedir, con su propio SKU, precio y stock. Una camiseta en tres tallas es un producto con tres variantes. Un producto sin opciones tiene una sola variante. Los productos se administran en **[Productos](https://app.riqra.com/products)**. Las piezas que los estructuran viven en **Configuración**: tipos de producto, atributos, categorías y marcas. ## Las piezas del catálogo | Concepto | Qué es | Dónde se administra | | - | - | - | | **Producto** | La ficha compartida por todas sus variantes. | [Productos](https://app.riqra.com/products) | | **Variante** | Una versión comprable del producto, con medidas, peso, stock, precio y SKU propios. | Dentro de cada producto | | **Atributo** | Un campo reutilizable, por ejemplo **Color** o **Material**, con su tipo de dato y sus valores. | [Configuración → Atributos](https://app.riqra.com/settings/attributes) | | **Tipo de producto** | Una plantilla que dice qué atributos tiene una clase de productos y cuáles generan variantes. | [Configuración → Tipos de producto](https://app.riqra.com/settings/product-types) | | **Categoría** | Un nodo del árbol con el que clasificas productos, hasta tres niveles. | [Configuración → Categorías](https://app.riqra.com/settings/categories) | | **Marca** | El fabricante o sello de un producto. | [Configuración → Marcas](https://app.riqra.com/settings/brands) | | **Colección** | Un grupo de productos con su propia página en la tienda, elegido a mano o por condiciones. | [Productos → Colecciones](https://app.riqra.com/collections) | | **Catálogo** | Qué productos y variantes puede ver un cliente. La política comercial de cada cliente define qué catálogo le corresponde. | [Productos → Catálogos](https://app.riqra.com/catalogs) | | **Pack** | Un producto compuesto por variantes de otros productos, con precio propio y stock derivado. | [Productos](https://app.riqra.com/products) | ## Cómo se organiza el catálogo Categorías, colecciones y catálogos responden preguntas distintas y no se reemplazan entre sí. * **Categorías** clasifican. Un producto puede estar en varias, y una asignación a **Jugos** cuenta también para **Bebidas**. Las categorías no arman el menú de la tienda. * **Colecciones** agrupan para vender. Una colección **Novedades** o **Sin azúcar** tiene su propia página en la tienda y un orden que tú decides. * **Catálogos** deciden quién ve qué. Un catálogo incluye todo lo publicado y excluye productos o variantes puntuales. Cada cliente ve el catálogo que le corresponde según su [política comercial](/plataforma/politicas-comerciales/introduccion). * **Marcas** sirven para filtrar la tienda y para armar colecciones automáticas. ## Estado de un producto | Estado | En la tienda | Se puede pedir | | - | - | - | | **Borrador** | Oculto | No | | **Publicado** | Visible, según el catálogo del cliente | Sí | | **Archivado** | Oculto | No | Un producto nuevo nace como borrador. Tú lo publicas cuando está listo. Archivar un producto lo oculta sin borrar sus pedidos ni sus datos, y puedes restaurarlo a borrador cuando quieras. Cada variante está **Activa** o **Descontinuada**. Una variante descontinuada no se vende, aunque el producto siga publicado. Un producto publicado necesita al menos una variante activa. ## Precio y stock viven en la variante El precio de venta de una variante se define por [lista de precios](/plataforma/precios/introduccion). El costo y el precio de lista son de la variante y valen para todas las listas. El stock se lleva por variante y por ubicación, y cada variante decide si la tienda controla su stock o se vende sin límite. ## Siguientes pasos * [Crea un producto](/plataforma/productos/crear-un-producto) * [Administra las variantes](/plataforma/productos/variantes) * [Define tipos de producto y atributos](/plataforma/productos/tipos-y-atributos) * [Organiza el catálogo en categorías](/plataforma/productos/categorias) * [Crea una colección](/plataforma/productos/colecciones) * [Administra las marcas](/plataforma/productos/marcas) * [Crea un catálogo](/plataforma/productos/catalogos) * [Crea un pack](/plataforma/productos/packs) * [Importa productos desde Excel](/plataforma/transferencia-de-datos/importar-productos) # Administra las marcas Source: https://docs.riqra.com/plataforma/productos/marcas Crea la lista de marcas de tu catálogo para asignarlas a productos, filtrar la tienda y armar colecciones automáticas. Una marca es el fabricante o sello de un producto. Con una lista de marcas, todos tus productos de un mismo fabricante comparten el mismo nombre escrito igual, y esa marca sirve para filtrar la tienda y como condición de una [colección automática](/plataforma/productos/colecciones). Se administran en **[Configuración → Marcas](https://app.riqra.com/settings/brands)**. Cada producto tiene una marca como máximo, y puede no tener ninguna. ## Crea una marca **1. Abre las marcas** Ve a **[Configuración → Marcas](https://app.riqra.com/settings/brands)** y haz clic en **Nueva marca**. **2. Completa la información** En **Información básica**, escribe el **Nombre**. El **Slug** se genera a partir del nombre y es el identificador que la tienda usa para filtrar por marca. Puedes agregar el **Sitio web** y una **Descripción**. **3. Guarda** Haz clic en **Guardar**. La marca nace **Activa**. ## Asigna una marca a un producto Abre el producto y, en el panel **Configuración**, elige la **Marca**. Elige **Sin marca** para quitarla. El selector solo ofrece marcas activas. ## Desactiva o reactiva una marca Abre la marca y, en el panel de estado, haz clic en **Desactivar** o **Reactivar**. Luego guarda. Una marca inactiva no aparece al asignar productos ni en los filtros de la tienda. Los productos que ya la tienen la conservan. ## Elimina una marca Al final de la ficha, haz clic en **Eliminar marca** y confirma. La marca deja de estar disponible para los productos. Si algún producto la usa, cámbiale la marca primero. # Crea un pack Source: https://docs.riqra.com/plataforma/productos/packs Vende varias variantes juntas como un solo producto, con su propio SKU y precio, y con un stock que sale del stock de sus componentes. Un pack es un producto compuesto por variantes de otros productos: un six-pack de una bebida, un kit de limpieza con dos detergentes y un desinfectante, un surtido de inicio para clientes nuevos. El comprador lo agrega al carrito como un solo artículo, a un solo precio. Un pack tiene una única variante, con su propio SKU, su propio precio y su propio peso. Lo que no tiene es stock propio: su disponibilidad se calcula a partir del stock de sus componentes. ## Antes de empezar * Crea antes los productos que van dentro del pack. Un componente es una variante activa de otro producto. Para que el pack se venda, ese producto debe estar publicado. * Si quieres describir el pack con atributos, usa un [tipo de producto](/plataforma/productos/tipos-y-atributos) que solo tenga atributos de producto. Un tipo con atributos de variante no se puede asignar a un pack. ## Crea el pack **1. Abre el formulario** Ve a **[Productos](https://app.riqra.com/products)** y haz clic en **Nuevo pack**. **2. Completa la ficha** Nombre, descripción, imágenes, marca, categorías, documentos, SEO, sinónimos y etiquetas funcionan igual que en cualquier [producto](/plataforma/productos/crear-un-producto). **3. Agrega los componentes** En **Componentes**, haz clic en **Agregar componentes**, busca por nombre o SKU y marca las variantes que forman el pack. Luego escribe la cantidad de cada una por unidad de pack. El comprador ve la lista de componentes en la página del pack. **4. Completa la variante del pack** En la tabla **Variantes**, escribe el **SKU** y el precio. Desde la ficha de la variante puedes definir el costo, el precio en cada lista, el peso y las medidas del pack ya embalado. **5. Guarda y publica** Haz clic en **Guardar**. Cuando esté listo, publícalo como cualquier producto. ## Reglas de la composición * Un pack admite hasta 30 componentes. Cada componente lleva una cantidad de 1 a 999. * Una misma variante entra una sola vez. Para dos unidades de lo mismo, usa cantidad 2. * Puedes combinar varias variantes de un mismo producto, por ejemplo un surtido de sabores. * Un pack no puede contener otro pack. * Un pack sin componentes se puede guardar y publicar, pero no se vende hasta que tenga al menos uno. ## Precio del pack El pack tiene su propio precio en cada lista de precios, como cualquier variante. No se calcula sumando los componentes y no cambia cuando cambian sus precios. Los ajustes de una lista derivada y los [tramos por cantidad](/plataforma/precios/tramos-por-cantidad) aplican igual. ## Stock del pack El pack no aparece en la página de inventario ni en la importación de stock. En cada ubicación, la cantidad disponible de packs es la menor entre las de sus componentes, dividida cada una por la cantidad que el pack necesita. Un kit con 2 detergentes y 1 desinfectante, con 10 detergentes y 3 desinfectantes en una ubicación, tiene 3 kits disponibles. Al confirmar un pedido con un pack, el stock se reserva en cada componente. Las existencias se descuentan cuando el pedido pasa a **Despachado** o **Listo para recoger**. Si un componente no alcanza, el pedido no se confirma y el mensaje indica cuál faltó. Lee [Controla el stock en la tienda](/plataforma/inventario/control-de-stock). ## Importación y exportación Los packs se crean y se arman solo en el panel. En la [importación de productos](/plataforma/transferencia-de-datos/importar-productos), la fila de un pack edita sus campos de producto y de variante, como el precio, pero no sus componentes ni su stock: `controlar_stock` e `inventario` van vacíos. La [importación de inventario](/plataforma/transferencia-de-datos/importar-inventario) rechaza el SKU de un pack. Ninguna exportación incluye stock de packs. ## Cuando un componente deja de venderse Si descontinúas una variante que forma parte de un pack, o pasas su producto a borrador o lo archivas, el pack deja de venderse en toda la tienda hasta que lo revises. La ficha del pack y la lista de productos muestran una alerta. La ficha del producto componente indica en el panel **Packs** en cuántos packs está. No puedes eliminar una variante que forma parte de un pack. Quítala primero de los packs que la usan. Los pedidos ya confirmados conservan la composición que tenía el pack en ese momento. Cambiar los componentes solo afecta los pedidos siguientes. # Define tipos de producto y atributos Source: https://docs.riqra.com/plataforma/productos/tipos-y-atributos Crea una biblioteca de atributos reutilizables y arma tipos de producto que dicen qué campos tiene cada clase de producto y cuáles generan variantes. Un atributo es un campo con nombre y tipo de dato, por ejemplo **Color** con los valores Rojo, Azul y Verde. Un tipo de producto reúne varios atributos y decide, para cada uno, si describe al producto o si genera variantes. Los atributos se crean una vez y se usan en cualquier tipo. Ambos se administran en **Configuración**: **[Atributos](https://app.riqra.com/settings/attributes)** y **[Tipos de producto](https://app.riqra.com/settings/product-types)**. ## Atributos de producto y atributos de variante Dentro de un tipo, cada atributo tiene un alcance: | Alcance | Qué hace | Ejemplos | | - | - | - | | **Producto** | Toma un valor por producto, igual para todas sus variantes. | Material, País de origen, Contenido de alcohol | | **Variante** | Cada valor genera una variante distinta. Solo puede ser un atributo de tipo **Opciones**. | Color, Talla, Sabor | Un tipo con **Color** (3 valores) y **Talla** (4 valores) como atributos de variante genera hasta 12 variantes por producto. ## Crea un atributo **1. Abre la biblioteca** Ve a **[Configuración → Atributos](https://app.riqra.com/settings/attributes)** y haz clic en **Nuevo atributo**. **2. Escribe el nombre** El nombre debe ser único en tu organización. Es el que ven los compradores en la página del producto. **3. Elige el tipo de dato** **Texto**, **Número**, **Sí/No** u **Opciones**. El tipo de dato no se puede cambiar después de guardar. **4. Agrega los valores** Solo en atributos de tipo **Opciones**. En **Valores**, escribe cada valor y presiona Enter. Arrastra para ordenarlos. Ese orden se respeta en el formulario del producto y en la tienda. Un atributo admite hasta 100 valores. **5. Guarda** Haz clic en **Guardar**. Para que los compradores filtren la tienda por este atributo, activa **Mostrar en filtros de la tienda** en la sección **Filtros de la tienda**. Puedes cambiar el nombre del atributo y de sus valores en cualquier momento. El cambio se refleja en todos los productos y tipos que lo usan. Un valor nuevo queda disponible de inmediato en todos los tipos que incluyen el atributo. ## Crea un tipo de producto **1. Abre los tipos de producto** Ve a **[Configuración → Tipos de producto](https://app.riqra.com/settings/product-types)** y haz clic en **Nuevo tipo**. **2. Escribe el nombre** El nombre debe ser único en tu organización, por ejemplo **Ropa** o **Bebidas**. **3. Agrega atributos** Haz clic en **Agregar atributo** y marca uno o varios atributos de la biblioteca. Un tipo admite hasta 30 atributos. **4. Define el alcance y si es requerido** Cada atributo entra como atributo de producto. Para convertir uno de tipo **Opciones** en atributo de variante, haz clic en el indicador de su tipo: la fila pasa a mostrar la etiqueta **Variante**. Marca **Requerido** en los atributos que quieres que se completen siempre. **5. Ordena y guarda** Arrastra las filas para definir el orden en que aparecen en el formulario del producto. Haz clic en **Guardar**. Un tipo sin atributos se puede guardar, pero no aparece como opción al crear un producto. **Requerido** es un recordatorio visual en el formulario del producto. Guardar y publicar nunca se bloquean por un atributo requerido vacío. ## Qué pasa al modificar un tipo en uso Los cambios aplican de inmediato a todos los productos de ese tipo. | Cambio | Efecto en los productos existentes | | - | - | | Agregar un atributo | Aparece vacío en cada producto. No se borra nada. | | Quitar un atributo de producto | Se eliminan de forma permanente los valores guardados en todos los productos del tipo. Se pide confirmación. | | Quitar un atributo de variante | Las variantes existentes no cambian. Solo afecta la próxima generación de la matriz. Se pide confirmación. | | Cambiar el alcance | Las variantes existentes no cambian. Solo afecta la próxima generación. | | Cambiar el orden | Se reordena el formulario de cada producto. | ## Elimina atributos, valores y tipos Los tres se eliminan desde el final de su ficha. La eliminación se bloquea mientras algo dependa de ellos y la ficha indica qué. * Un **valor** no se elimina si algún producto lo tiene seleccionado o si forma parte de una variante. * Un **atributo** no se elimina si está en algún tipo de producto o si algún producto tiene un valor guardado para él. * Un **tipo de producto** no se elimina mientras algún producto lo use. # Administra las variantes Source: https://docs.riqra.com/plataforma/productos/variantes Genera las variantes de un producto a partir de sus atributos, completa el SKU de cada una y define su precio, stock y medidas. Una variante es cada versión comprable de un producto. Todas las variantes de un producto comparten la ficha, y cada una tiene su propio SKU, código de barras, precios, stock, imágenes, peso y medidas. La tabla **Variantes** de la ficha del producto muestra todas sus variantes. Cada fila abre la ficha de la variante, donde se editan los datos que la tabla no muestra. ## Genera la matriz de variantes Solo aplica a productos con un tipo que tenga al menos un atributo de variante. Un producto sin tipo tiene una variante única desde el inicio. **1. Abre el generador** En la sección **Variantes**, haz clic en **Generar matriz**. **2. Elige los valores** Cada atributo de variante aparece con sus valores marcados. Desmarca los que no vendes. Cada atributo necesita al menos un valor marcado. El cuadro inferior muestra cuántas variantes se van a generar. **3. Genera y guarda** Haz clic en **Generar** y luego en **Guardar**. Las variantes nuevas nacen vacías, sin SKU ni precio. Puedes volver a generar cuando quieras. En cada generación: * Una combinación que ya existía se conserva tal cual, con su SKU, precios y stock. * Una combinación nueva se crea vacía. * Una variante cuya combinación ya no está en la selección se elimina al guardar. Si un comprador la tenía en el carrito, la línea falla en el checkout como no disponible. Un producto admite hasta 500 variantes. Si la selección supera ese límite, el botón **Generar** se desactiva hasta que reduzcas los valores. ## Completa la tabla de variantes | Columna | Qué escribir | | - | - | | **SKU** | Obligatorio y único en tu organización. | | **Código de barras** | EAN, UPC o GTIN del fabricante. PedidosIA lo usa para asignar líneas de órdenes de compra a la variante. | | **Precio de venta** | Con una sola lista de precios activa, el precio de venta se escribe aquí. Con varias listas, la celda muestra el precio más bajo y se edita en la ficha de la variante. | | **Stock** | Existencias disponibles. Se editan por ubicación en la ficha de la variante. | | **Activa** | Desmárcala para descontinuar la variante. Una variante descontinuada no se vende. Un producto publicado necesita al menos una variante activa. | ## Edita la ficha de una variante Haz clic en una fila de la tabla para abrir la ficha de la variante. Disponible después de guardar el producto. | Sección | Qué contiene | | - | - | | **Imágenes de la variante** | Hasta 10 imágenes propias. La primera es la portada de la variante. En la tienda, cuando el comprador elige la variante, sus imágenes reemplazan las del producto, y el carrito y el pedido muestran su portada. Una variante sin imágenes propias muestra las del producto. | | **Precios** | **Costo**, lo que te cuesta adquirir o producir la variante, que el comprador nunca ve. **Precio de lista**, el precio de comparación que la tienda muestra tachado cuando es mayor que el precio de venta. Debajo, el precio de venta en cada lista activa. Lee [Edita los precios de tus variantes](/plataforma/precios/editar-precios). | | **Inventario** | La opción **Controlar stock** y las ubicaciones donde se vende la variante, con sus existencias. | | **Peso y dimensiones** | **Peso (kg)**, **Largo (cm)**, **Ancho (cm)** y **Alto (cm)**. | Los cambios se guardan con el botón **Guardar** de la ficha de la variante. ## Stock y disponibilidad Con **Controlar stock** activado, la tienda valida el stock disponible en cada compra y no deja pedir más de lo que hay. Con la opción desactivada, la variante se vende sin límite de cantidad en las ubicaciones que elijas. En ambos casos, una variante que no está en ninguna ubicación aparece como **Agotado** y no se puede vender. Las existencias de todas las variantes se editan también desde **[Productos → Inventario](https://app.riqra.com/inventory)**. Lee [Ajusta el stock de tus variantes](/plataforma/inventario/ajustar-stock) y [Controla el stock en la tienda](/plataforma/inventario/control-de-stock). ## Descontinúa una variante Desmarca **Activa** en la tabla de variantes y guarda. La variante deja de venderse, pero conserva su stock y sus pedidos. Si la variante forma parte de un pack, el pack deja de venderse hasta que la reactives o la quites de la composición. # Códigos de descuento y límites de uso Source: https://docs.riqra.com/plataforma/promociones/codigos-de-descuento Cómo funcionan los códigos que ingresa el comprador, cómo limitar sus usos y qué ve el comprador cuando un código no aplica. Una promoción **Con código** se aplica solo cuando el comprador ingresa su código. El código no cambia el descuento. La promoción define qué se descuenta y el código es la llave para recibirlo. ## Reglas del código * Entre 3 y 64 caracteres. Letras de la A a la Z sin tildes ni ñ, números, guiones y guiones bajos. * Se guarda en mayúsculas. El comprador puede escribirlo en minúsculas. * Es único en tu tienda. Dos promociones no pueden compartir un código. Si cambias el código de una promoción, los carritos que tenían el código anterior lo pierden. Los pedidos ya confirmados conservan el código con el que se compraron. ## Dónde lo ingresa el comprador En el carrito y en el checkout, en el campo **Código de descuento**. Un carrito admite hasta 5 códigos a la vez. Si el campo no aparece en el carrito, revisa el ajuste **Permitir descuentos** de la sección **Carrito** en el editor de tu tema. En algunos temas viene desactivado. El campo del checkout siempre está visible. Un código ingresado se queda en el carrito y se vuelve a evaluar con cada cambio. Si el comprador quita productos y deja de cumplir la condición, el código sigue visible con el motivo, y vuelve a aplicarse cuando el carrito cumple otra vez. ## Qué ve el comprador Al ingresar un código, el carrito rechaza los que el comprador no puede arreglar y muestra «Este código no se puede aplicar». Pasa cuando el código no existe, su promoción no está activa, el comprador no cumple la elegibilidad o la condición de Compra X lleva Y, se agotaron los usos o el comprador ya usó una promoción de un uso por persona. Con 5 códigos en el carrito, el mensaje es «Solo puedes usar 5 códigos por carrito». Los demás casos se aceptan y quedan visibles con su motivo, porque el comprador puede resolverlos: | Mensaje | Qué falta | | - | - | | **No alcanzas el mínimo** | Cumplir el requisito mínimo. | | **No aplica a los productos de tu carrito** | Agregar alguno de los productos que participan. | | **Se aplica al elegir el envío** | Elegir la entrega en el checkout. Solo en envío gratis. | | **No cubre el envío elegido** | El envío elegido cuesta más que el monto máximo de la promoción. | | **Se aplica al elegir un método de pago válido** | Elegir el método de pago en el checkout. | | **No aplica al método de pago elegido** | Elegir uno de los métodos permitidos. | | **No se combina con otro descuento** | Nada. Otra promoción que ahorra más ocupó su lugar. | | **El envío ya es gratis** | Nada. El envío no tenía costo. En recojo en tienda dice **No aplica al recojo en tienda**. | Mientras un código está en un estado que el comprador puede resolver, el checkout no deja confirmar el pedido y muestra «Quita el código … para continuar». Si el código espera un método de pago, el mensaje es «Elige un método de pago válido para el código … o quítalo para continuar». Los dos últimos mensajes no bloquean, porque el comprador no pierde nada al confirmar. Si un código ya ingresado cae después en uno de los casos que se rechazan al ingresarlo, por ejemplo porque la promoción expiró, se queda en el carrito con su motivo (**Código no disponible**, **No aplica a tu carrito**, **Código agotado** o **Ya usaste este código**) y el checkout pide quitarlo. ## Límites de uso En la sección **Usos máximos del descuento**: * **Limitar el número total de usos.** Cuántos pedidos pueden usar la promoción en total, entre todos los compradores. * **Un uso por persona.** Cada comprador puede usarla en un solo pedido. Se identifica por su cuenta o, si compra sin cuenta, por el correo que escribe en el checkout. Una compra con cuenta y otra sin cuenta con el mismo correo cuentan como compradores distintos. Un uso se registra al confirmar el pedido, antes del pago. Un pago rechazado no consume otro uso, porque el comprador reintenta el pago sobre el mismo pedido. Si el pedido se cancela o vence, el uso no vuelve. Si se agotó el límite total, súbelo. Si un comprador ya gastó su único uso, desmarca **Un uso por persona** o crea otro código. Puedes bajar el límite por debajo de los usos ya registrados. La promoción deja de aplicarse. La ficha de la promoción muestra los usos acumulados junto al estado. Eliminar la promoción borra ese contador. ## Códigos en una cotización Cuando el comprador guarda una cotización, los códigos del carrito se guardan con ella. Cuando pasa la cotización al carrito para comprarla, los códigos se aplican de nuevo con las condiciones de ese momento. Un código que el carrito rechaza se omite y el comprador ve cuáles quedaron fuera. # Cómo se aplican las promociones Source: https://docs.riqra.com/plataforma/promociones/como-se-aplican Dónde se calculan las promociones, en qué orden, cómo se resuelve un conflicto entre dos y qué queda registrado en el pedido. Las promociones se recalculan cada vez que se muestra el carrito o el checkout. El carrito solo guarda los códigos ingresados. Por eso un cambio en la promoción, o su desactivación, se ve la próxima vez que el comprador abre el carrito o el checkout. Al confirmar el pedido se calculan por última vez y el resultado queda guardado en el pedido. ## Dónde aplican En el carrito y el checkout de la tienda online, en las cotizaciones que el comprador convierte en pedido y en los pedidos que creas desde un borrador en el admin. En un borrador solo aplican las promociones automáticas. Las promociones no se aplican a las órdenes de compra de PedidosIA. Solo participan las líneas del carrito que se pueden comprar. Un producto sin precio para ese comprador, fuera de su catálogo, despublicado o desactivado no cuenta para las condiciones ni recibe descuento. Un producto sin stock suficiente sí participa, aunque el checkout no deja confirmar el pedido hasta ajustar la cantidad. ## Orden de aplicación Los descuentos se aplican siempre en este orden: 1. **Productos.** Descuento en productos y Compra X lleva Y. 2. **Pedido.** Descuento en el pedido, calculado sobre lo que queda después del paso anterior. 3. **Envío.** Envío gratis. Un descuento en el pedido del 10 % sobre un carrito de 200 con 50 de descuento en productos rebaja 15, no 20. Los requisitos mínimos se comparan siempre con los montos antes de cualquier descuento. El mínimo de compra de la [política comercial](/plataforma/politicas-comerciales/crear-una-politica) se compara después, con el subtotal ya rebajado. ## Cuando dos promociones no se combinan Cada promoción declara en **Combinaciones** con qué clases de descuento acepta aplicarse a la vez. Dos promociones se aplican juntas solo cuando cada una acepta a la otra. Cuando dos promociones no se combinan, se aplica la que ahorra más para ese carrito. Si la que pierde es un código, el comprador lo ve con el mensaje **No se combina con otro descuento** y puede confirmar el pedido igual. Una promoción se aplica una sola vez por pedido. En Compra X lleva Y, las repeticiones ocurren dentro de esa única aplicación. ## Montos e impuestos Los montos de una promoción se escriben como los ve el comprador. Si tus precios incluyen impuestos, el monto del descuento también los incluye. Los impuestos se calculan sobre el precio ya rebajado. El comprador paga impuestos solo por lo que paga. Un descuento nunca deja una línea en negativo. Un monto fijo mayor que el subtotal de los productos que participan se limita a ese subtotal. Si el total del pedido queda en cero, el pedido se confirma como pagado sin pasar por el cobro. ## Qué queda en el pedido El pedido guarda cada promoción aplicada con su título, su código si lo hubo y el monto exacto que descontó. Editar o eliminar la promoción después no cambia el pedido. En la ficha del pedido, los descuentos en productos se ven en cada línea. Los descuentos en el pedido y en el envío aparecen como filas en el panel **Pago**, con el código o el título de la promoción, y el envío cubierto se muestra como **Gratis** con el costo original tachado. Debajo del total, **Ahorro del cliente** suma todos los descuentos del pedido. # Crea una promoción Source: https://docs.riqra.com/plataforma/promociones/crear-una-promocion Elige el tipo y el método, configura el descuento y sus condiciones, y activa la promoción cuando esté lista. ## Antes de empezar * Si el descuento aplica a productos concretos, ten listos los [productos](/plataforma/productos/introduccion) o las [colecciones](/plataforma/productos/colecciones) que participan. Agrupar productos en una colección es la forma más cómoda de mantener una promoción grande. * Si la promoción es solo para algunos clientes, crea antes el [segmento](/plataforma/clientes/segmentos) que los reúne. ## Crea la promoción **1. Elige el tipo y el método** Ve a **[Marketing → Promociones](https://app.riqra.com/marketing/promotions)** y haz clic en **Nueva promoción**. Selecciona un **Tipo de promoción** y un **Método**, y haz clic en **Continuar**. Ninguno de los dos se puede cambiar después. Si te equivocas, crea otra promoción. **2. Escribe el título** El comprador ve el título junto al descuento en el carrito. En el checkout, una promoción con código muestra el código en lugar del título. Usa un texto que el comprador entienda, por ejemplo «20 % en bebidas». **3. Escribe el código** Solo en promociones con código. Escribe el código que el comprador ingresará. Lee las reglas en [Códigos de descuento y límites de uso](/plataforma/promociones/codigos-de-descuento). **4. Configura el descuento** Cada tipo tiene su propia sección. Sigue la pestaña de tu tipo en [Configura el descuento según el tipo](#configura-el-descuento-segun-el-tipo). **5. Define las condiciones** Completa **Elegibilidad de la persona**, **Métodos de pago**, **Requisitos mínimos**, **Combinaciones** y **Fechas activas**. Cada sección se explica en [Condiciones](#condiciones). **6. Crea y activa** Haz clic en **Crear promoción**. La promoción se guarda **Inactiva**. Revísala y, en el panel de estado, haz clic en **Activar**. Si la fecha de inicio es futura, queda **Programada** y empieza a aplicarse sola en esa fecha. ## Configura el descuento según el tipo **Descuento en productos** En la sección **Valor** elige cómo se descuenta: * **Porcentaje.** Un porcentaje sobre cada unidad de los productos que participan. * **Cantidad fija.** Un monto. Con **Aplicar a cada artículo** marcado, el monto se descuenta en cada unidad. Sin marcar, el monto se descuenta una sola vez y se reparte entre las líneas que participan. En **Se aplica a** elige qué productos participan: * **Todos los productos.** Cualquier producto del carrito. * **Productos.** Hasta 250 productos. Un producto incluye todas sus variantes, también las que crees después. * **Colecciones.** Hasta 250 colecciones. Participa cualquier producto que pertenezca a alguna de ellas. Una promoción usa productos o colecciones, no ambos. Si cambias de una opción a otra, la selección anterior se borra. **Compra X lleva Y** La sección **Compra X lleva Y** tiene dos partes. **La persona compra** define la condición: * **Cantidad mínima de artículos** o **Monto mínimo de compra**, medido sobre los **Productos que activan**. **La persona recibe** define el premio: * **Cantidad** de unidades premiadas por cada vez que se cumple la condición. * **Productos de regalo**, el conjunto del que salen esas unidades. * En **A un precio con descuento**, la rebaja de cada unidad premiada. Puede ser **Porcentaje de descuento**, **Monto de descuento por artículo** o **Gratis**. **Máximo de usos por pedido** limita cuántas veces se repite el premio en un mismo pedido. Vacío significa sin límite. La promoción descuenta unidades que ya están en el carrito. No agrega productos. Una unidad que cuenta para la condición no recibe el premio. Por ejemplo, con «compra 2 y lleva 1 gratis» sobre el mismo producto, un carrito con 3 unidades paga 2 y recibe 1 gratis. Con 2 unidades no hay premio. Cuando hay más unidades elegibles que premios, se rebajan las más baratas. **Descuento en el pedido** En la sección **Valor** elige **Porcentaje** o **Cantidad fija**. El descuento se calcula sobre el subtotal de productos del pedido, después de los descuentos en productos, y se aplica una sola vez. Nunca rebaja el costo de envío. **Envío gratis** No hay un valor que configurar. El costo de envío del pedido pasa a cero. En la sección **Tarifas de envío** puedes marcar **Excluir tarifas de envío superiores a un monto** y escribir el monto. Si el envío que eligió el comprador cuesta más que ese monto, la promoción no se aplica. No es un tope. La promoción cubre el envío completo o no lo cubre. Si el comprador elige recojo en tienda, no hay costo que descontar y la promoción no hace nada. ## Condiciones ### Elegibilidad de la persona | Opción | Quién recibe la promoción | | - | - | | **Todas las personas** | Cualquier comprador, con o sin cuenta. | | **Personas específicas** | Hasta 250 personas elegidas con **Seleccionar personas**. | | **Segmentos de personas** | Hasta 100 [segmentos](/plataforma/clientes/segmentos). Basta con pertenecer a uno. | Las dos últimas opciones exigen que el comprador haya iniciado sesión. Un comprador sin cuenta nunca las cumple. ### Métodos de pago Con **Todos los métodos**, la promoción no depende del pago. Con **Métodos específicos**, marca los métodos de pago permitidos. La promoción se aplica cuando el comprador elige uno de ellos en el checkout. Mientras no elige método, un código de esta promoción queda pendiente. Una promoción automática con métodos específicos no aparece en el carrito. Se aplica en el checkout cuando el comprador elige uno de esos métodos. ### Requisitos mínimos No aparece en Compra X lleva Y. | Opción | Qué se compara | | - | - | | **Sin requisitos mínimos** | Nada. | | **Monto mínimo de compra** | El subtotal, antes de cualquier descuento. | | **Cantidad mínima de artículos** | La cantidad de unidades. | En un descuento en productos, el mínimo se mide solo sobre los productos que participan en la promoción. En un descuento en el pedido y en envío gratis se mide sobre todo el carrito. ### Combinaciones Las casillas **Descuentos de productos**, **Descuentos del pedido** y **Descuentos de envío** indican con qué otros descuentos puede aplicarse esta promoción al mismo tiempo. Un descuento en el pedido nunca se combina con otro descuento en el pedido, y un envío gratis nunca se combina con otro envío gratis, así que esa casilla no aparece. Dos promociones se combinan solo si cada una permite a la otra. Cuando no se combinan, se aplica la que ahorra más. Lee [Cómo se aplican las promociones](/plataforma/promociones/como-se-aplican). ### Fechas activas **Inicio** es obligatorio y se llena con el momento actual. Marca **Definir fecha de fin** para que la promoción termine sola. Sin fecha de fin, sigue vigente hasta que la desactives. ## Edita, desactiva o elimina una promoción Puedes editar cualquier campo en cualquier estado, salvo el tipo y el método. Los cambios se ven en los carritos de inmediato. Los pedidos ya confirmados no cambian. **Desactivar**, disponible cuando la promoción está **Activa**, la detiene y conserva su configuración y su contador de usos. **Activar** la vuelve a poner en marcha dentro de sus fechas. **Eliminar promoción**, al final de la ficha, la borra de forma permanente. Los pedidos que la usaron conservan su descuento. Si quieres conservar el historial de usos, desactívala en lugar de eliminarla. # Qué es una promoción Source: https://docs.riqra.com/plataforma/promociones/introduccion Una promoción rebaja productos, el pedido o el envío en tu tienda online, de forma automática o con un código que ingresa el comprador. Una promoción es una oferta con condiciones. Define qué se descuenta, quién puede recibirlo, durante qué fechas y, si quieres, con qué código. Cuando un carrito cumple las condiciones, el descuento aparece en el carrito, en el checkout y en el pedido. Las promociones se administran en **[Marketing → Promociones](https://app.riqra.com/marketing/promotions)**. Las promociones se aplican en la tienda online, en las cotizaciones que el comprador convierte en pedido y en los pedidos que creas desde un borrador en el admin. En un borrador solo aplican las promociones automáticas. Las promociones no se aplican a las órdenes de compra de PedidosIA. ## Los cuatro tipos | Tipo | Qué hace | Ejemplo | | - | - | - | | **Descuento en productos** | Rebaja un porcentaje o un monto en los productos o colecciones que elijas. | 20 % en todas las bebidas. | | **Compra X lleva Y** | Regala o rebaja unidades de un conjunto de productos cuando el carrito incluye cierta cantidad o cierto gasto en otro conjunto. | Compra 2 gaseosas y lleva 1 gratis. | | **Descuento en el pedido** | Rebaja un porcentaje o un monto del subtotal de productos. | 10 % en todo el pedido. | | **Envío gratis** | Quita el costo de envío del pedido. | Envío gratis en compras desde 100. | El tipo se elige al crear la promoción y no se puede cambiar después. Cada tipo tiene su propia forma de configurar el descuento. Lee [Crea una promoción](/plataforma/promociones/crear-una-promocion). ## Automática o con código | Método | Cómo se aplica | | - | - | | **Automática** | Se aplica sola cuando el carrito cumple las condiciones. El comprador no hace nada. | | **Con código** | Se aplica solo cuando el comprador ingresa el código en el carrito o en el checkout. Admite límites de uso. | El método también se elige al crear la promoción y no se puede cambiar después. Puedes tener hasta 25 promociones automáticas activas o programadas al mismo tiempo. Las promociones con código no tienen ese límite. ## Condiciones que comparten todos los tipos * **Elegibilidad de la persona.** Todas las personas, personas específicas o segmentos. * **Métodos de pago.** Todos o solo algunos de los métodos de pago de tu tienda. * **Requisitos mínimos.** Un monto o una cantidad mínima de artículos. No aplica a Compra X lleva Y, porque su condición de compra ya es el requisito. * **Combinaciones.** Con qué otros descuentos puede aplicarse a la vez. * **Fechas activas.** Fecha de inicio y, opcionalmente, fecha de fin. ## Estado de una promoción El estado se calcula a partir de las fechas activas y de si la promoción está activada. | Estado | Cuándo | | - | - | | **Activa** | Está activada y la fecha actual cae dentro de sus fechas activas. Se aplica cuando se cumplen las condiciones. | | **Programada** | Está activada y su fecha de inicio todavía no llega. | | **Expirada** | Está activada y su fecha de fin ya pasó. Para volver a usarla, edita las fechas. | | **Inactiva** | Está desactivada. No se aplica aunque esté dentro de sus fechas. | Una promoción recién creada queda **Inactiva**. La activas desde su ficha cuando termines de revisarla. Puedes desactivar una promoción **Activa** en cualquier momento para que deje de aplicarse sin perder su configuración. ## Siguientes pasos * [Crea una promoción](/plataforma/promociones/crear-una-promocion) * [Códigos de descuento y límites de uso](/plataforma/promociones/codigos-de-descuento) * [Cómo se aplican las promociones](/plataforma/promociones/como-se-aplican) # Importa clientes desde Excel Source: https://docs.riqra.com/plataforma/transferencia-de-datos/importar-clientes Crea o actualiza empresas y sucursales en bloque con una plantilla de Excel. La importación de empresas te permite cargar a tus clientes con un solo archivo de Excel. Cada empresa lleva su razón social, su documento fiscal, su dirección fiscal y sus sucursales de entrega. Puedes iniciar una importación desde **[Empresas](https://app.riqra.com/clients/companies)**, con **Importar → Empresas y sucursales**. ## Antes de empezar * Descarga la plantilla o exporta tus empresas. Las columnas se reconocen por su nombre. Puedes borrar las que no vas a cambiar, pero conserva siempre `numero_documento_fiscal` y `sucursal`. * Guarda el archivo como Excel `.xlsx`, sin contraseña. No se admiten archivos `.xls` ni `.csv`. * El archivo puede pesar hasta 10 MB y contener hasta 10 000 filas de datos. * Mantén las columnas `numero_documento_fiscal`, `telefono`, `telefono_sucursal` e `id_externo_sucursal` con formato de texto para que Excel no altere los números. > [!WARNING] > > Un encabezado que no pertenece a la plantilla, o repetido, rechaza el archivo completo. ## Organiza empresas y sucursales El archivo usa una fila por sucursal. `numero_documento_fiscal` identifica a la empresa y `sucursal` identifica a una sucursal dentro de ella. Las filas de una misma empresa repiten su `numero_documento_fiscal`, y de cada columna de la empresa se usa el primer valor no vacío del grupo. Una empresa sin sucursales ocupa una sola fila, con las celdas de sucursal vacías. | `numero_documento_fiscal` | `sucursal` | `razon_social` | `direccion_fiscal` | `direccion_sucursal` | | - | - | - | - | - | | `20512345671` | CD Villa El Salvador | Supermercados Andinos S.A. | Av. Industrial 771, Lima | Av. El Sol 120, Villa El Salvador | | `20512345671` | Tienda Surco | | | Av. Caminos del Inca 351, Surco | | `20487654320` | | Distribuidora Norte E.I.R.L. | Jr. Piura 240, Chiclayo | | `numero_documento_fiscal` es el documento fiscal de empresa del país de tu tienda: RUC en Perú y Ecuador, RUT en Chile, NIT en Colombia, RFC en México. Cada país tiene un solo tipo, así que el archivo lleva solo el número. Al crear una empresa, el número se valida según ese país. En Perú, por ejemplo, un RUC debe tener 11 dígitos y un dígito verificador correcto, sin puntos ni guiones. Un RUT o un NIT pueden escribirse con puntos y guion. ## Cómo se resuelve cada fila | Fila | Resultado | | - | - | | Documento nuevo | Crea la empresa, y la sucursal si `sucursal` está lleno. | | Documento existente, `sucursal` vacía | Actualiza solo la empresa. | | Documento existente, `sucursal` existente | Actualiza la empresa y esa sucursal. | | Documento existente, `sucursal` nueva | Agrega una sucursal. | La sucursal se busca por su nombre dentro de la empresa, sin distinguir mayúsculas. * **Para crear una empresa** necesitas `razon_social` y `direccion_fiscal`. **Para crear una sucursal**, `direccion_sucursal`. * **Para actualizar** solo necesitas las columnas clave. Las celdas vacías, y las columnas que no están en el archivo, no cambian el valor guardado. ## Columnas de la empresa | Columna | Cómo completarla | | - | - | | `numero_documento_fiscal` | Obligatorio en todas las filas. Documento fiscal de la empresa. Máximo 50 caracteres. | | `razon_social` | Obligatorio al crear una empresa. Máximo 255 caracteres. | | `direccion_fiscal` | Obligatorio al crear una empresa. Máximo 500 caracteres. | | `email` | Correo de contacto de la empresa. | | `telefono` | Teléfono de contacto. Incluye el código de país si el número no es local. | ## Columnas de cada sucursal | Columna | Cómo completarla | | - | - | | `sucursal` | Nombre de la sucursal, único dentro de la empresa. Obligatorio si completas `direccion_sucursal`. Máximo 255 caracteres. | | `id_externo_sucursal` | Código de la sucursal en tu sistema. Máximo 50 caracteres. | | `direccion_sucursal` | Obligatorio al crear una sucursal. Máximo 500 caracteres. | | `telefono_sucursal` | Teléfono de la sucursal. | | `email_sucursal` | Correo de la sucursal. | Para editar en bloque, usa **Exportar → Empresas y sucursales** en la página de empresas. Descarga el archivo, edítalo y vuelve a importarlo. ## Corrige errores de validación Si una fila tiene errores, no se aplica ninguna fila del archivo. Descarga el reporte, que es tu mismo archivo con la columna `errores`. Corrige las filas indicadas y vuelve a importarlo. El flujo completo está en [Reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores). Los errores más comunes son una `razon_social` o `direccion_fiscal` vacía en una empresa nueva, una `direccion_sucursal` vacía en una sucursal nueva, un documento fiscal inválido para el país y una sucursal repetida dentro del archivo. # Importa códigos de cliente Source: https://docs.riqra.com/plataforma/transferencia-de-datos/importar-codigos Carga la homologación de cada cliente: el código con el que esa cadena identifica cada uno de tus productos. Muchas cadenas no imprimen tu SKU ni el código de barras en sus órdenes de compra. Usan un código interno propio, distinto para cada cadena. Los **códigos de cliente** son esa homologación, y registran por cada empresa qué código suyo corresponde a qué producto tuyo. Con los códigos cargados, las líneas de una OC se asignan solas desde el primer archivo. Además, si el documento no imprime el documento fiscal del comprador, la empresa puede deducirse a partir de sus códigos. ## Dónde importar * Desde **[Empresas](https://app.riqra.com/clients/companies)**, con **Importar → Códigos de cliente**, para cargar códigos de varias empresas en un solo archivo. * Desde la pestaña **Códigos** del detalle de una empresa, con **Importar códigos**. Descarga la plantilla con **Descargar plantilla** en el diálogo de importación. ## Formato del archivo Una fila por combinación de empresa y código. El archivo debe incluir las tres columnas, en cualquier orden: | Columna | Cómo completarla | | - | - | | `numero_documento_fiscal` | Documento fiscal de la empresa (RUC en Perú). La empresa ya debe existir. Máximo 50 caracteres. | | `codigo` | Código con el que esa empresa identifica tu producto. Máximo 120 caracteres. | | `sku` | SKU de tu variante. La variante ya debe existir. Máximo 64 caracteres. | | `numero_documento_fiscal` | `codigo` | `sku` | | - | - | - | | `20512345671` | `718803` | `QUESO-FRESCO-500` | | `20512345671` | `718804` | `YOGURT-NAT-1L` | | `20487654320` | `55-0212` | `QUESO-FRESCO-500` | Guarda el archivo como `.xlsx` (hasta 10 MB y 10 000 filas) y conserva las tres columnas con formato de texto. Los documentos fiscales, los códigos con ceros a la izquierda y los SKU numéricos se dañan si Excel los trata como números. ## Reglas * Los códigos son **por empresa**. El mismo producto puede tener un código distinto en cada cadena, y dos cadenas pueden usar el mismo número para productos distintos sin conflicto. * Cada empresa admite un solo SKU por código. Los espacios dentro del código se ignoran al compararlo: `71 8803` y `718803` son el mismo código, y dos filas así en un archivo se marcan como duplicadas. * Reimportar un código existente actualiza el SKU al que apunta. * La empresa y el producto deben existir antes de importar. Si no, la fila falla con `Empresa no encontrada` o `Producto no encontrado`. Importa primero [clientes](/plataforma/transferencia-de-datos/importar-clientes) y [productos](/plataforma/transferencia-de-datos/importar-productos). Si alguna fila tiene errores, no se aplica ninguna. Descarga el **reporte de errores** (tu mismo archivo con la columna `errores`), corrígelo y vuelve a subirlo. Lee [Reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores). ## Importados y aprendidos La pestaña **Códigos** de cada empresa muestra todos sus códigos con su origen: * **Importado**: cargado por archivo y aún sin usar en una OC. * **Aprendido**: creado o confirmado al revisar órdenes de compra. Cada vez que asignas a mano una línea y confirmas la orden, el código se guarda para esa empresa. También verás cuántas veces se usó cada código. No necesitas mantener el archivo al día a mano, porque la homologación crece sola con cada orden confirmada. ## Exportar * Desde la pestaña **Códigos** de una empresa: exporta solo la homologación de esa empresa. * Desde **Empresas**, con **Exportar → Códigos de cliente**: exporta los códigos de todas tus empresas. El archivo exportado usa el mismo formato de la importación, así que puedes editarlo y volver a subirlo. # Importa inventario desde Excel Source: https://docs.riqra.com/plataforma/transferencia-de-datos/importar-inventario Actualiza en bloque las existencias de tus variantes en cada ubicación con un archivo de Excel. La importación de inventario escribe las existencias de tus variantes por ubicación. Cada fila es la cantidad de un `sku` en una `ubicacion`. Un mismo archivo puede mezclar varias ubicaciones. El archivo cubre las mismas variantes que la página de inventario, que son las que tienen activado **Controlar stock**. Ese interruptor se cambia en la ficha de la variante o con la columna `controlar_stock` de la [importación de productos](/plataforma/transferencia-de-datos/importar-productos). Puedes iniciar una importación desde **[Productos → Inventario](https://app.riqra.com/inventory)**. ## Antes de empezar * Descarga la plantilla o exporta tu inventario. El archivo debe incluir las tres columnas: `ubicacion`, `sku` y `existencia`, en cualquier orden. * Guarda el archivo como Excel `.xlsx`, sin contraseña. Hasta 10 MB y 10 000 filas. * Las ubicaciones y las variantes deben existir. La importación las relaciona por el nombre de la ubicación y por `sku`, pero no las crea. * Para actualizar existencias, usa **Exportar** y edita el archivo descargado. La exportación usa el mismo formato. > [!WARNING] > > Si una fila tiene errores, no se aplica ninguna fila del archivo. Descarga el reporte, corrige las filas indicadas y vuelve a importarlo. El flujo completo está en [Reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores). ## Importa el archivo **1. Abre la importación** En **Productos → Inventario**, haz clic en **Importar**. Guarda o descarta antes los cambios pendientes de la cuadrícula. **2. Descarga la plantilla** Haz clic en **Descargar plantilla** y completa el archivo, o edita una exportación reciente. **3. Selecciona el archivo** Haz clic en el área de carga y elige el archivo `.xlsx`. **4. Inicia la importación** Haz clic en **Importar**. El archivo se valida completo y las existencias se aplican en segundo plano. **5. Revisa el resultado** El detalle muestra cuántas filas se crearon, se actualizaron o se omitieron. También puedes consultar el trabajo en **Configuración → Transferencia de datos**. ## Columnas | Columna | Cómo completarla | | - | - | | `ubicacion` | Nombre de una ubicación existente. No distingue mayúsculas de minúsculas, pero sí las tildes. | | `sku` | SKU de una variante existente que controla stock. Conserva la columna con formato de texto. Una fila con `sku` vacío se omite, sin error. | | `existencia` | Unidades en mano. Obligatorio. Número entero, cero o mayor. | ## Cómo se aplican las filas Los valores del archivo reemplazan a los guardados. Si una variante tiene 40 unidades y la fila dice `10`, queda en 10; no se suman ni se restan. * Las ubicaciones y las variantes que no aparecen en el archivo no cambian. * Cada par de `ubicacion` y `sku` puede aparecer una sola vez. * Si la variante no estaba en esa ubicación, la fila la agrega ahí con las existencias indicadas. * La `existencia` no puede quedar por debajo de las unidades comprometidas por pedidos en esa ubicación. * Una fila de una variante sin **Controlar stock** falla con el error "Esta variante no controla stock". Las ubicaciones donde se vende una variante sin control de stock se eligen en su ficha. * Los [packs](/plataforma/productos/packs) no tienen stock propio. Una fila con el `sku` de un pack falla con el error "Los packs no tienen stock propio", y la exportación no los incluye. Por ejemplo, un archivo que deja `CAJA-12` con 120 unidades en el almacén y 15 en una tienda: | `ubicacion` | `sku` | `existencia` | | - | - | - | | Almacén Lima | `CAJA-12` | `120` | | Tienda Arequipa | `CAJA-12` | `15` | ## Exportación **Exportar** descarga una fila por cada variante que controla stock en cada ubicación donde está, con sus existencias actuales. Incluye las variantes descontinuadas y las ubicaciones inactivas. # Importa líneas de crédito Source: https://docs.riqra.com/plataforma/transferencia-de-datos/importar-lineas-de-credito Asigna o cambia en bloque el límite, los permisos y el monto utilizado de la línea de crédito de tus empresas. Con este archivo asignas o cambias la [línea de crédito](/plataforma/clientes/linea-de-credito) de muchas empresas a la vez: su límite, si el crédito está habilitado, si permite sobregiro y el monto que la empresa ya tiene utilizado. ## Dónde importar Ve a **[Clientes → Empresas](https://app.riqra.com/clients/companies)** y haz clic en **Importar → Líneas de crédito**. Descarga la plantilla con **Descargar plantilla** en el diálogo de importación. ## Formato del archivo Una fila por empresa. Solo `numero_documento_fiscal` es obligatoria: incluye únicamente las columnas que vas a cambiar. | Columna | Cómo completarla | | - | - | | `numero_documento_fiscal` | Documento fiscal de la empresa (RUC en Perú). La empresa ya debe existir y aparecer una sola vez en el archivo. | | `linea_credito` | Límite de la línea. | | `credito_habilitado` | `si` o `no`. Con `no`, la empresa no puede comprar a crédito, pero conserva la línea y su historial. | | `permite_sobregiro` | `si` o `no`. Con `si`, la empresa sigue comprando a crédito después de agotar el límite, y cada pedido que lo supere queda por confirmar. | | `saldo_utilizado` | Monto que la empresa tiene pendiente de pago. Reemplaza el utilizado actual. Puede ser negativo si la empresa tiene saldo a favor. | | `numero_documento_fiscal` | `linea_credito` | `credito_habilitado` | `permite_sobregiro` | `saldo_utilizado` | | - | - | - | - | - | | `20512345671` | `15000` | `si` | `no` | `3200.50` | | `20487654320` | `8000` | | | | | `20601234561` | | `no` | | | Escribe los montos sin símbolo de moneda ni separador de miles, con punto decimal y con los decimales que admite la moneda de tu tienda. Conserva `numero_documento_fiscal` con formato de texto. ## Reglas * Una celda vacía deja el valor guardado como está. En el ejemplo, la segunda fila solo cambia el límite y la tercera solo suspende el crédito. * Si la empresa no tiene línea, cualquier celda completa le asigna una. Las celdas vacías toman estos valores: límite 0, crédito habilitado, sin sobregiro y utilizado 0. * Una fila igual a la línea guardada no cambia nada, así que puedes volver a subir una exportación sin efectos. * Los cambios de monto quedan en los **Movimientos de crédito** de la empresa a tu nombre: un **Ajuste de límite** si cambió el límite y un **Ajuste de saldo** si cambió el utilizado. Activar o desactivar el crédito o el sobregiro no genera un movimiento, igual que desde el panel. > [!WARNING] > > `saldo_utilizado` reemplaza el monto utilizado, no le suma ni le resta. Si editas una exportación antigua, los pedidos y pagos registrados después de exportarla se pierden del utilizado. Exporta el archivo justo antes de editarlo, o deja vacía la columna si no vas a cambiar el utilizado. Si alguna fila tiene errores, no se aplica ninguna. Descarga el **reporte de errores** (tu mismo archivo con la columna `errores`), corrígelo y vuelve a subirlo. Lee [Reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores). Si el trabajo queda **Fallido** mientras se aplica, las empresas procesadas hasta ese momento ya quedaron guardadas. Vuelve a subir el mismo archivo para terminar: las filas que ya se aplicaron no cambian nada. ## Exportar En **Empresas**, haz clic en **Exportar → Líneas de crédito**. El archivo lista solo las empresas que tienen línea de crédito. Para asignar una línea nueva, agrega una fila con el `numero_documento_fiscal` de la empresa. # Importa personas desde Excel Source: https://docs.riqra.com/plataforma/transferencia-de-datos/importar-personas Crea o actualiza personas en bloque, con su segmento y sus datos de facturación. La importación de personas carga o actualiza a tus clientes con un archivo de Excel. El archivo lleva su contacto, su estado, su segmento y sus datos de facturación. Inicia la importación desde **[Clientes → Personas](https://app.riqra.com/clients/individuals)** con **Importar**. **Exportar** descarga tus personas actuales en el mismo formato, listo para editar y volver a subir. La exportación agrega las columnas `id_externo` y `fecha_creacion`, que puedes dejar en el archivo al volver a subirlo. ## Antes de empezar * Descarga la plantilla o exporta tus personas. Las columnas se reconocen por su nombre. Puedes borrar las que no vas a cambiar, pero conserva `email`, `telefono` o ambas. Con [acceso por código](/plataforma/clientes/acceso-a-la-tienda), `codigo` también cuenta. * Guarda el archivo como Excel `.xlsx`, sin contraseña. No se admiten archivos `.xls` ni `.csv`. * El archivo puede pesar hasta 10 MB y contener hasta 10 000 filas de datos. * Mantén las columnas `telefono`, `codigo`, `numero_documento` y `numero_documento_fiscal` con formato de texto para que Excel no altere los números. > [!WARNING] > > Un encabezado que no pertenece a la plantilla, o repetido, rechaza el archivo completo. ## Columnas | Columna | Cómo completarla | | - | - | | `codigo` | Solo con acceso por código. El código con el que la persona inicia sesión, de hasta 50 caracteres y sin `@`. Identifica a la persona igual que `email` y `telefono`, sin distinguir mayúsculas de minúsculas. Vacío conserva el código actual. | | `email` | Correo electrónico. Identifica a la persona junto con `telefono` y, con acceso por código, `codigo`; cada fila necesita al menos uno de ellos. | | `telefono` | Teléfono con código de país, por ejemplo `+51999100001`. Sin el código de país la fila se rechaza. | | `nombre` | Obligatorio al crear una persona. Máximo 100 caracteres. | | `apellido` | Obligatorio al crear una persona. Máximo 100 caracteres. | | `estado` | `activa` o `pausada`. Vacío crea a la persona como `activa`. | | `id_externo` | Solo en la exportación. El ID que tu ERP asignó a la persona, si tienes una integración conectada. Con más de un ERP, lleva el primer ID registrado. Es de solo lectura: la importación lo ignora y la plantilla no lo incluye. | | `segmento` | Nombre del segmento. Si no existe, se crea. Vacío conserva el segmento actual, así que la importación no quita a nadie de un segmento. | | `tipo_documento` y `numero_documento` | Documento de identidad de la persona, por ejemplo `DNI`. Completa ambas o deja ambas vacías. | | `tipo_documento_fiscal` y `numero_documento_fiscal` | Documento para emitir factura, por ejemplo `RUC`. Completa ambas o deja ambas vacías. | | `razon_social_fiscal` | Razón social para la factura. Máximo 255 caracteres. | | `direccion_fiscal` | Domicilio fiscal para la factura. Máximo 500 caracteres. | | `fecha_creacion` | Solo en la exportación. Fecha y hora en que la persona se agregó a tu tienda, en la zona horaria de la tienda. Para una persona migrada desde tu plataforma anterior, es la fecha en que se creó allí. Es de solo lectura: la importación la ignora y la plantilla no la incluye. | Cada número se valida según el tipo indicado y el país de tu tienda, igual que en la ficha de la persona. Un DNI, por ejemplo, debe tener 8 dígitos. Un RUT, un NIT o una cédula de ciudadanía de Colombia pueden escribirse con puntos y guion (`12.345.678-5`). En los demás documentos, como el DNI o el RUC, un punto o un guion hacen que la fila se rechace. El archivo no incluye consentimientos. Una persona creada por importación empieza sin ninguno, y la importación no cambia los de una persona existente. Los consentimientos se revisan en la pestaña [Comunicaciones](/plataforma/clientes/personas#comunicaciones) de cada persona. La plantilla no incluye contraseñas. Para dar acceso a las personas importadas, envíales una invitación desde su ficha; lee [Da acceso a la tienda](/plataforma/clientes/acceso-a-la-tienda). ## Cómo se actualizan las personas existentes Cada fila se busca entre tus personas por `email`, por `telefono` y, con acceso por código, por `codigo`. * Si encuentra a la persona por cualquiera de ellos, actualiza los datos incluidos en el archivo. Los demás identificadores de la fila se escriben en esa persona. * Si no la encuentra, la crea. Para crear necesitas `nombre`, `apellido` y un `email` o `telefono`. Con acceso por código, necesitas `nombre`, `apellido` y `codigo`; el `email` y el `telefono` son opcionales. * Para actualizar basta el `email`, el `telefono` o el `codigo`. Las celdas vacías, y las columnas que no están en el archivo, no cambian el valor guardado. Si cambias el correo de una persona **Con acceso**, su correo anterior recibe un aviso y el nuevo queda **Sin verificar** hasta su siguiente inicio de sesión, igual que al editarlo desde su ficha. ## Corrige errores de validación Si una fila tiene errores, no se aplica ninguna fila del archivo. Descarga el reporte, que es tu propio archivo con una columna `errores`, corrige las filas señaladas y vuelve a subirlo. El flujo completo está en [Reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores). Los errores más comunes: * Una fila sin `email` ni `telefono` (ni `codigo`, con acceso por código). * Una persona nueva sin `nombre`, sin `apellido` o, con acceso por código, sin `codigo`. * Un `email`, `telefono` o `codigo` repetido dentro del archivo, o dos filas que corresponden a la misma persona (una por su correo y otra por su teléfono). * Datos de una misma fila (`email`, `telefono` o `codigo`) que pertenecen a personas distintas en tu lista. Corrige el dato o unifica las fichas antes de importar. * Una columna `codigo` en una tienda sin acceso por código. * Un `telefono` sin código de país o con un formato que no corresponde a ningún país. * Un `estado` distinto de `activa` o `pausada`. * Un tipo de documento sin su número, o un número sin su tipo. * Un tipo de documento que no corresponde a tu país, o un número que no es válido para su tipo. # Importa personas de empresas Source: https://docs.riqra.com/plataforma/transferencia-de-datos/importar-personas-de-empresas Asigna en bloque a tus personas a una empresa y a sus sucursales, y exporta quién pertenece a cada una. Con este archivo asignas muchas [personas](/plataforma/clientes/personas) a la vez a una [empresa y sus sucursales](/plataforma/clientes/empresas-y-sucursales). La exportación muestra a qué empresa y sucursales pertenece cada persona. ## Dónde importar Ve a **[Clientes → Empresas](https://app.riqra.com/clients/companies)** y haz clic en **Importar → Personas de empresas**. Descarga la plantilla con **Descargar plantilla** en el diálogo de importación. ## Formato del archivo Una fila por persona y sucursal. Una persona con tres sucursales ocupa tres filas. Para asignar solo la empresa, deja vacías las columnas de la sucursal. | Columna | Cómo completarla | | - | - | | `numero_documento_fiscal_empresa` | Documento fiscal de la empresa (RUC en Perú). Obligatoria. | | `sucursal` | Nombre de la sucursal, sin distinguir mayúsculas de minúsculas. | | `id_externo_sucursal` | Código de la sucursal en tu ERP. Si lo completas, la sucursal se busca por este código y `sucursal` no se usa. | | `codigo` | Solo con [acceso por código](/plataforma/clientes/acceso-a-la-tienda). Identifica a la persona igual que `email` y `telefono`. | | `email` | Correo de la persona. Cada fila necesita `email`, `telefono` o, con acceso por código, `codigo`. | | `telefono` | Teléfono con código de país, por ejemplo `+51999100001`. | | `numero_documento_fiscal_empresa` | `sucursal` | `id_externo_sucursal` | `email` | `telefono` | | - | - | - | - | - | | `20512345671` | `Surco` | | `ana@acme.pe` | | | `20512345671` | | `ERP-SJL` | `ana@acme.pe` | | | `20512345671` | | | | `+51999100002` | Conserva `telefono`, `codigo`, `numero_documento_fiscal_empresa` e `id_externo_sucursal` con formato de texto. La exportación también trae `razon_social_empresa`, `nombre` y `apellido` para que el archivo sea fácil de leer. Al importar, esas columnas se ignoran: puedes volver a subir una exportación sin borrarlas. ## Reglas * La persona y la empresa ya deben existir. Crea las personas con [Importar personas](/plataforma/transferencia-de-datos/importar-personas) y las empresas con [Importar empresas y sucursales](/plataforma/transferencia-de-datos/importar-clientes). * Si la persona no tiene empresa, la fila se la asigna. * Una persona pertenece a una sola empresa, así que todas sus filas deben tener el mismo `numero_documento_fiscal_empresa`. * La importación solo agrega asignaciones. Una persona que ya está en la sucursal no cambia, y una sucursal que no aparece en el archivo no se le quita. Para quitar una sucursal o cambiar a la persona de empresa, edítala desde su ficha. * Si dos sucursales de la empresa tienen el mismo nombre, usa `id_externo_sucursal` para indicar cuál. Estas filas se rechazan: * Una fila sin `email` ni `telefono` (ni `codigo`, con acceso por código). * Una persona o una empresa que no existe. * Datos de una misma fila (`email`, `telefono` o `codigo`) que pertenecen a personas distintas. * Una persona que ya pertenece a otra empresa, o que aparece con dos empresas en el archivo. * Una sucursal que no existe en la empresa, o un nombre que coincide con varias sucursales. * La misma persona y sucursal repetidas en el archivo. Si alguna fila tiene errores, no se aplica ninguna. Descarga el **reporte de errores** (tu mismo archivo con la columna `errores`), corrígelo y vuelve a subirlo. Lee [Reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores). ## Exportar En **Empresas**, haz clic en **Exportar → Personas de empresas**. El archivo viene ordenado por empresa, con una fila por persona y sucursal, y una fila con las columnas de sucursal vacías para cada persona que tiene empresa pero ninguna sucursal. Las personas sin empresa no aparecen. # Importa precios desde Excel Source: https://docs.riqra.com/plataforma/transferencia-de-datos/importar-precios Actualiza en bloque los precios de venta y los tramos por cantidad de cualquier lista de precios con un archivo de Excel. La importación de precios escribe precios de venta y tramos por cantidad en tus listas de precios. Cada fila es un precio para un `sku` en una `lista_precios`. Un mismo archivo puede mezclar varias listas. Puedes iniciar una importación desde **[Productos → Precios](https://app.riqra.com/prices)**. ## Antes de empezar * Descarga la plantilla o exporta tus precios. El archivo debe incluir `sku`, `lista_precios` y `precio`, en cualquier orden. `cantidad_min` y `cantidad_max` solo hacen falta para escribir tramos, y un archivo sin ellas tiene solo precios fijos. * Guarda el archivo como Excel `.xlsx`, sin contraseña. Hasta 10 MB y 10 000 filas. * Las variantes y las listas de precios deben existir. La importación las relaciona por `sku` y por nombre de lista, pero no las crea. * Para actualizar precios existentes, usa **Exportar** y edita el archivo descargado. La exportación usa el mismo formato. > [!WARNING] > > Si una fila tiene errores, no se aplica ninguna fila del archivo. Descarga el reporte, corrige las filas indicadas y vuelve a importarlo. El flujo completo está en [Reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores). ## Importa el archivo **1. Abre la importación** En **Productos → Precios**, haz clic en **Importar**. Guarda o descarta antes los cambios pendientes de la cuadrícula. **2. Descarga la plantilla** Haz clic en **Descargar plantilla** y completa el archivo, o edita una exportación reciente. **3. Selecciona el archivo** Haz clic en el área de carga y elige el archivo `.xlsx`. **4. Inicia la importación** Haz clic en **Importar**. El archivo se valida completo y los precios se aplican en segundo plano. **5. Revisa el resultado** El detalle muestra cuántos precios se crearon o actualizaron. También puedes consultar el trabajo en **Configuración → Transferencia de datos**. ## Columnas | Columna | Cómo completarla | | - | - | | `sku` | SKU de una variante existente. Conserva la columna con formato de texto. | | `lista_precios` | Nombre exacto de una lista de precios existente. | | `cantidad_min` | Vacía para un precio fijo. Para un tramo, la cantidad desde la que aplica. | | `cantidad_max` | Vacía para un precio fijo y para el último tramo. Para los demás tramos, la cantidad hasta la que aplica. | | `precio` | Obligatorio. Número con punto y como máximo los decimales de tu moneda (2 en soles, 0 en pesos chilenos), sin símbolo de moneda ni separador de miles. Un precio fijo puede ser cero. El precio de un tramo debe ser mayor que cero. | ## Precios fijos y tramos Una fila con `cantidad_min` vacía es un precio fijo. En una lista independiente escribe el precio de venta. En una lista derivada escribe un precio fijo para esa variante, que reemplaza al precio calculado. Una fila con `cantidad_min` es un tramo. Los tramos de un mismo `sku` y `lista_precios` se validan juntos como una escalera completa, con las mismas reglas del editor. El primer tramo empieza en 1, los tramos son contiguos y solo el último queda sin `cantidad_max`. Lee [Define tramos por cantidad](/plataforma/precios/tramos-por-cantidad). Por ejemplo, un precio fijo en **Lista base** y una escalera de tres tramos en **Lista mayorista**: | `sku` | `lista_precios` | `cantidad_min` | `cantidad_max` | `precio` | | - | - | - | - | - | | `CAJA-12` | Lista base | | | `10.00` | | `CAJA-12` | Lista mayorista | 1 | 11 | `9.50` | | `CAJA-12` | Lista mayorista | 12 | 47 | `9.00` | | `CAJA-12` | Lista mayorista | 48 | | `8.50` | Reglas para un mismo `sku` y lista: * Solo una fila de precio fijo. * No puede haber una fila de precio fijo y filas de tramos a la vez. * Una escalera importada reemplaza la escalera anterior completa y borra el precio fijo. Para cambiar un rango, envía todos los tramos de ese `sku` y lista, no solo el que cambia. * Una fila sin cantidades deja un precio fijo y borra la escalera anterior. * Las variantes y listas que no aparecen en el archivo no cambian. ## Exportación **Exportar** descarga todos los precios fijos y tramos guardados en todas tus listas, con `cantidad_min` y `cantidad_max` vacías en los precios fijos. Los precios calculados de las listas derivadas no se incluyen, porque se calculan al momento a partir de la lista base. # Importa productos desde Excel Source: https://docs.riqra.com/plataforma/transferencia-de-datos/importar-productos Crea o actualiza productos y variantes en bloque con una plantilla de Excel. La importación de productos te permite crear y actualizar el catálogo con un archivo de Excel. Cada fila representa una variante. El `handle` identifica al producto y el `sku` identifica a la variante. Las variantes de un mismo producto se agrupan con el mismo `handle`. Puedes iniciar una importación desde **[Productos](https://app.riqra.com/products)**. > [!NOTE] > > Esta guía corresponde a la nueva plataforma. Si tu panel utiliza archivos CSV, selecciona **Legacy** en el selector de versión. ## Antes de empezar * Descarga la plantilla o exporta tus productos. Las columnas se reconocen por su nombre. Puedes borrar las que no vas a cambiar, pero conserva siempre `handle` y `sku`. * Guarda el archivo como Excel `.xlsx`, sin contraseña. No se admiten archivos `.xls` ni `.csv`. * El archivo puede pesar hasta 10 MB y contener hasta 10 000 filas de datos. * Un producto no puede tener más de 500 variantes. * Crea primero los tipos de producto, marcas, categorías, impuestos, atributos y opciones que vas a escribir en el archivo. La importación los relaciona por nombre, pero no los crea. * Si vas a actualizar productos existentes, usa **Exportar** en la página de productos y edita el archivo descargado. La exportación utiliza el mismo formato de la importación. > [!WARNING] > > Un encabezado que no pertenece a la plantilla, o repetido, rechaza el archivo completo. Si cambias el nombre de una columna, la importación no la reconoce. ## Importa el archivo **1. Abre la importación** En **Productos**, haz clic en **Importar**. **2. Descarga la plantilla** Haz clic en **Descargar plantilla**. Completa ese archivo o copia en él los datos que ya preparaste. **3. Selecciona el archivo** Haz clic en el área de carga y elige el archivo `.xlsx`. **4. Inicia la importación** Haz clic en **Importar**. El archivo se carga, todas las filas se validan y los cambios se aplican en segundo plano. **5. Revisa el resultado** La pantalla de detalle muestra cuántos productos se crearon o actualizaron. También puedes consultar el trabajo desde **Configuración → Transferencia de datos**. ## Organiza productos y variantes El `handle` es la URL del producto. Corresponde al campo **URL del producto** de la sección SEO del panel y a la última parte de la dirección `/products/{handle}` de tu tienda. Repítelo en todas las filas de las variantes del producto. Las columnas del producto, como `nombre`, `tipo`, `marca` y `categorias`, pueden ir solo en la primera fila de cada `handle`. De cada columna se usa el primer valor no vacío. Las columnas de la variante, como `precio`, las opciones, las medidas y el inventario, se aplican al `sku` de su fila. Un producto sin opciones tiene una sola variante, por lo que ocupa una fila. Si un producto tiene opciones, agrega una fila por cada combinación. Por ejemplo, un producto de tipo **Ropa** con los atributos diferenciadores **Color** y **Talla** puede verse así: | `handle` | `sku` | `nombre` | `tipo` | `precio` | `opcion1_nombre` | `opcion1_valor` | `opcion2_nombre` | `opcion2_valor` | `inventario` | | - | - | - | - | - | - | - | - | - | - | | `camiseta-basica` | `CAM-AZ-M` | Camiseta básica | Ropa | `49.90` | Color | Azul | Talla | M | `20` | | `camiseta-basica` | `CAM-AZ-L` | | | `49.90` | Color | Azul | Talla | L | `15` | | `camiseta-basica` | `CAM-NE-M` | | | `49.90` | Color | Negro | Talla | M | `12` | > [!NOTE] > > El tipo de producto debe contener los atributos diferenciadores y las opciones que escribas. Cada variante nueva debe incluir un valor para todos los atributos diferenciadores de ese tipo, y dos variantes de un producto no pueden repetir la misma combinación. ## Cómo se resuelve cada fila | `handle` | `sku` | Resultado | | - | - | - | | Vacío | Vacío | Error. | | Vacío | Nuevo | Crea un producto con una sola variante. Su `handle` se genera a partir del `nombre`. | | Vacío | Existente | Error: para actualizar una variante indica el `handle` de su producto. | | Existente | Vacío | Actualiza solo los datos del producto. No cambia ninguna variante. | | Existente | Existente del mismo producto | Actualiza el producto y esa variante. | | Existente | Nuevo | Agrega una variante al producto. | | Existente | Existente de otro producto | Error: una variante no puede cambiar de producto. | | Nuevo | Nuevo | Crea un producto con exactamente ese `handle`. Las filas con el mismo `handle` son sus variantes. | | Nuevo | Existente | Error: el `sku` pertenece a otro producto. | La importación nunca cambia la URL de un producto. Un `handle` existente actualiza ese producto y uno nuevo crea otro. Para cambiar la URL, edita el campo **URL del producto** en el panel. Cuando el `handle` está vacío, se genera a partir del `nombre`. Si ya lo usa otro producto u otra fila del mismo archivo, se le agrega un número: `polo-azul`, `polo-azul-2`, `polo-azul-3`. Un `handle` que escribes tú se usa tal cual, y si no es válido la fila falla. Así, dos filas con `handle` vacío y el mismo `nombre` crean dos productos distintos. > [!WARNING] > > Un `handle` mal escrito en una fila con un `sku` nuevo crea un producto nuevo. Revisa el resultado de la importación. Un producto sin tipo tiene una sola variante, y el tipo de un producto existente no cambia por importación. Para crear un producto con variantes, escribe su `handle` y su `tipo` desde el principio. ### Para crear * Un producto necesita `nombre` y al menos una fila con `sku`. * Una variante necesita su `sku`. Si el tipo tiene atributos diferenciadores, también un valor para cada uno. * `estado` vacío crea el producto como borrador, y `controlar_stock` vacío crea la variante controlando stock, igual que en el panel. ### Para actualizar * Un producto solo necesita su `handle`. * Una variante necesita el `handle` de su producto y su `sku`. Si dejas vacías las columnas de opciones, la variante conserva su combinación. * Las celdas vacías, y las columnas que no están en el archivo, no cambian el valor guardado. * Una lista llena (`categorias`, `etiquetas`, `sinonimos`) reemplaza la lista completa guardada; vacía la conserva. * Las variantes que el archivo no menciona se conservan sin cambios. ## Columnas del producto | Columna | Cómo completarla | | - | - | | `handle` | La URL del producto. Usa letras minúsculas, números y guiones, sin espacios ni tildes, por ejemplo `camiseta-basica`. Máximo 255 caracteres. Vacío solo al crear un producto de una variante. | | `nombre` | Obligatorio al crear un producto. Máximo 200 caracteres. | | `tipo` | Nombre de un tipo de producto existente. Es necesario cuando el producto usa atributos diferenciadores. No puede cambiar en un producto existente, así que un tipo distinto rechaza la fila. | | `descripcion` | Descripción del producto. Máximo 10 000 caracteres. | | `marca` | Nombre de una marca existente. | | `categorias` | Nombres de categorías activas, de cualquier nivel. Separa varias con una barra vertical. | | `estado` | Usa `borrador`, `publicado` o `archivado`. Un producto nuevo queda como borrador si dejas la celda vacía. | | `impuesto` | Nombre de un impuesto de tu tienda. Vacío en un producto nuevo usa el impuesto predeterminado. | | `etiquetas` | Separa varias con una barra vertical. | | `sinonimos` | Nombres alternativos para la búsqueda. Separa varios con una barra vertical. Puedes agregar hasta 10. | | `seo_titulo` | Título para buscadores. Máximo 60 caracteres. | | `seo_descripcion` | Descripción para buscadores. Máximo 160 caracteres. | | `imagenes` | Una o más URL públicas de imágenes. Deben usar `https`. Separa hasta 50 con una barra vertical; la primera será la portada. Se admiten imágenes JPEG, PNG y WebP de hasta 10 MB cada una. | ## Columnas de cada variante | Columna | Cómo completarla | | - | - | | `sku` | Identifica la variante. Único dentro del archivo. Máximo 64 caracteres. Conserva esta columna con formato de texto para evitar que Excel cambie los SKU numéricos. Queda vacío en una fila que solo actualiza el producto, y esa fila no admite columnas de variante. | | `codigo_barras` | Código de barras (EAN) de la variante. Máximo 64 caracteres. Conserva la columna con formato de texto. PedidosIA lo usa para asignar líneas de órdenes de compra. | | `precio` | Precio de venta fijo en la lista de la política comercial predeterminada; las demás listas se escriben con la [importación de precios](/plataforma/transferencia-de-datos/importar-precios). Usa un número positivo o cero, con punto y como máximo los decimales de tu moneda (2 en soles), sin símbolo de moneda ni separador de miles. | | `costo` | Lo que te cuesta adquirir o producir la variante. Usa el mismo formato de `precio`. | | `precio_lista` | Precio de comparación, que la tienda muestra tachado cuando es mayor que el precio de venta. Usa el mismo formato de `precio`. | | `controlar_stock` | El interruptor **Controlar stock** de la variante. Usa `si` o `no`. Vacío en un pack. | | `opcion1_nombre` a `opcion3_nombre` | Nombre exacto de un atributo diferenciador existente, por ejemplo `Color` o `Talla`. | | `opcion1_valor` a `opcion3_valor` | Opción existente para el atributo correspondiente, por ejemplo `Azul` o `M`. Completa siempre el nombre y el valor de cada opción. | | `peso` | Peso en kilogramos. Usa un número positivo o cero, con punto y hasta tres decimales. | | `largo`, `ancho`, `alto` | Dimensiones en centímetros. Usa un número positivo o cero, con punto y hasta dos decimales. Si completas una dimensión, debes completar las tres. | | `inventario` | Existencias en la ubicación predeterminada. Usa un número entero positivo o cero. Solo se acepta en una variante que controla stock, incluida una que la misma fila activa con `controlar_stock`, y no puede quedar por debajo de las unidades comprometidas por pedidos en esa ubicación. Vacío en un pack. La exportación lo deja vacío en los packs y en las variantes que no controlan stock. | | `imagenes_variante` | Una o más URL públicas de imágenes de esta variante. Deben usar `https`. Separa hasta 10 con una barra vertical; la primera será la portada de la variante. Se admiten los mismos formatos y el mismo tamaño máximo que en `imagenes`. | > [!TIP] > > Para varias categorías, etiquetas, sinónimos o imágenes, usa `|` sin comas. Ejemplo: `Polos|Ofertas`. Una variante sin `sku` no se puede editar por importación. La exportación deja vacías sus columnas de variante, y una fila sin `sku` con alguna columna de variante llena se rechaza con el error "Indica el sku para cambiar los datos de la variante". ### Packs Los [packs](/plataforma/productos/packs) se crean y se arman solo en el panel: un `handle` nuevo siempre crea un producto normal. La fila de un pack existente actualiza sus columnas de producto y de variante, salvo `controlar_stock` e `inventario`: un pack no tiene stock propio, así que cualquiera de las dos llena rechaza la fila con el error "Los packs no tienen stock propio". La exportación las deja vacías en los packs. Los componentes no están en el archivo y la importación no los cambia. ### Precio fijo y tramos por cantidad Los tramos por cantidad se editan solo con la [importación de precios](/plataforma/transferencia-de-datos/importar-precios). En esta importación: * La exportación deja `precio` vacío en una variante con tramos en la lista de la política comercial predeterminada. * Un `precio` vacío conserva los tramos. * Un `precio` lleno fija un precio único y borra los tramos, igual que un precio fijo en la importación de precios o en el panel. ## Corrige errores de validación Si una fila tiene errores, no se aplica ninguna fila del archivo. Descarga el reporte, que es tu mismo archivo con la columna `errores`. Corrige las filas indicadas y vuelve a importarlo. El flujo completo está en [Reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores). Los errores más comunes son un encabezado mal escrito, un `handle` con espacios, un `sku` repetido, un `sku` que pertenece a otro producto, una marca o categoría inexistente, una opción que no pertenece al tipo de producto, un precio con más decimales que tu moneda, dimensiones incompletas, un `inventario` en una variante que no controla stock o por debajo de lo comprometido, `controlar_stock` o `inventario` en un pack, o una columna de variante llena en una fila sin `sku`. # Transferencia de datos Source: https://docs.riqra.com/plataforma/transferencia-de-datos/introduccion Todas las importaciones y exportaciones usan el mismo mecanismo: plantillas de Excel, validación completa del archivo e historial de trabajos. La transferencia de datos carga y descarga datos en bloque con archivos de Excel. Todas las entidades usan el mismo mecanismo: descargas una plantilla, la completas, la subes, y el archivo completo se valida antes de aplicar cualquier cambio. Cada operación queda registrada como un trabajo con su historial. ## Qué puedes importar y exportar | Entidad | Desde dónde | Importa | Exporta | | - | - | - | - | | Productos | **Productos** | [Sí](/plataforma/transferencia-de-datos/importar-productos) | Sí | | Empresas y sucursales | **Empresas** | [Sí](/plataforma/transferencia-de-datos/importar-clientes) | Sí | | Códigos de cliente | **Empresas** o la pestaña **Códigos** de una empresa | [Sí](/plataforma/transferencia-de-datos/importar-codigos) | Sí | | Líneas de crédito | **Empresas** | [Sí](/plataforma/transferencia-de-datos/importar-lineas-de-credito) | Sí | | Personas de empresas | **Empresas** | [Sí](/plataforma/transferencia-de-datos/importar-personas-de-empresas) | Sí | | Personas | **Personas** | [Sí](/plataforma/transferencia-de-datos/importar-personas) | Sí | | Precios | **Precios** | [Sí](/plataforma/transferencia-de-datos/importar-precios) | Sí | | Inventario | **Inventario** | [Sí](/plataforma/transferencia-de-datos/importar-inventario) | Sí | | Pedidos | **Pedidos** | No | Sí | Los botones **Importar** y **Exportar** están en la página de cada entidad. Cada diálogo de importación incluye **Descargar plantilla** con los encabezados correctos y las columnas de texto ya configuradas. ## Reglas comunes de importación * Solo archivos Excel `.xlsx`, sin contraseña. No se admiten `.xls` ni `.csv`. * Hasta 10 MB y 10 000 filas de datos por archivo. * Las columnas se reconocen por su nombre, en cualquier orden. Puedes subir solo las columnas que vas a cambiar, siempre que incluyas las obligatorias. La guía de cada importación indica cuáles son. * Un encabezado que no pertenece a la plantilla, o que aparece dos veces, rechaza el archivo completo. Así un nombre mal escrito nunca se ignora en silencio. * Una celda vacía, o una columna que no está en el archivo, deja el valor guardado como está. La importación nunca borra un dato. * Al crear un registro, una celda vacía toma el valor por defecto, salvo en las columnas obligatorias para crear. * Los montos aceptan como máximo los decimales de la moneda de tu tienda, que son 2 en soles y 0 en pesos chilenos. Usa punto decimal, sin símbolo de moneda ni separador de miles. Un monto con más decimales rechaza la fila; nunca se redondea. * Las columnas con valores numéricos largos (documento fiscal, SKU, códigos de barras, teléfonos) deben conservar el formato de texto; la plantilla ya las trae configuradas así. * Las filas completamente vacías se ignoran. * Si alguna fila tiene errores, no se aplica ninguna. Revisa el [reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores). ## El ciclo de un trabajo Cada importación o exportación es un trabajo que avanza en segundo plano. Puedes cerrar la página y el trabajo continúa. | Estado | Significado | | - | - | | **Pendiente** | El trabajo está en cola. | | **Cargando** | El archivo se está leyendo. | | **Validando** | Se están validando todas las filas. | | **Errores de validación** | Una o más filas fallaron; nada se aplicó. Descarga el reporte de errores. | | **Aplicando** | Las filas ya validadas se están guardando. | | **Completado** | El trabajo terminó. El detalle muestra cuántos registros se crearon o actualizaron. | | **Fallido** | El trabajo se interrumpió por un error inesperado. Vuelve a intentarlo. | ## Historial de trabajos Los trabajos de todas las entidades están en **[Configuración → Transferencia de datos](https://app.riqra.com/settings/data-transfers)**. Cada trabajo muestra la entidad, el archivo, quién lo inició, su estado y sus resultados. > [!NOTE] > > Los enlaces de descarga (archivo original, reporte de errores, exportación) expiran a los 10 minutos. Si un enlace venció, recarga la página del trabajo para generar uno nuevo. ## Exportaciones Las exportaciones también corren en segundo plano, con un límite de 50 000 filas. Si permaneces en el detalle del trabajo, el archivo se descarga solo al terminar; también queda disponible con **Descargar Excel**. Toda exportación usa el mismo formato que su importación, con las columnas clave primero. El flujo de edición en bloque es siempre el mismo: exporta, edita el archivo descargado y vuelve a importarlo. También puedes borrar del archivo las columnas que no vas a cambiar, salvo las obligatorias. # Corrige errores con el reporte Source: https://docs.riqra.com/plataforma/transferencia-de-datos/reporte-de-errores Cuando una importación tiene filas con errores, no se aplica nada y recibes tu mismo archivo con una columna de errores para corregir y volver a subir. Las importaciones son todo o nada: si una sola fila tiene errores, no se aplica ninguna fila del archivo. Así un archivo a medio corregir nunca deja tus datos en un estado intermedio. El trabajo queda en estado **Errores de validación** y genera el reporte: tu mismo archivo, con todas las filas en su lugar y una columna adicional `errores` al final. ## El flujo de corrección **1. Descarga el reporte** En el detalle del trabajo, haz clic en **Descargar reporte de errores**. **2. Revisa la columna de errores** La columna `errores` explica qué corregir en cada fila marcada. Si una fila tiene varios problemas, aparecen separados por punto y coma. Las filas sin errores tienen la celda vacía. **3. Corrige el mismo archivo** Edita las filas indicadas directamente en el reporte. No necesitas eliminar la columna `errores`. Se ignora al volver a leer el archivo. **4. Vuelve a importar** Sube el archivo corregido como una nueva importación desde la página de la entidad. Si aún quedan errores, obtendrás un nuevo reporte marcando las filas que siguen mal. > [!TIP] > > Como las filas correctas no se aplicaron la primera vez, reimporta el archivo completo, no solo las filas corregidas. ## Cuándo no hay reporte Algunos problemas afectan al archivo entero, no a filas individuales. En esos casos el trabajo queda en **Errores de validación** o **Fallido** con un mensaje, sin reporte descargable: * Un encabezado que no pertenece a la plantilla o que aparece dos veces, o una columna obligatoria que falta. El mensaje nombra las columnas. * Más de 10 000 filas de datos. * Un archivo que no es `.xlsx`, o protegido con contraseña. Corrige el archivo según el mensaje y súbelo de nuevo. Ante un encabezado mal escrito, compáralo con la plantilla. ## Errores frecuentes * Referencias a registros que no existen: una marca o categoría no creada, una empresa no encontrada por su `numero_documento_fiscal`, un producto no encontrado por su `sku`. Crea o importa primero el registro referenciado. * Valores duplicados dentro del archivo: dos filas con el mismo `sku`, la misma sucursal o el mismo código de cliente. * Formatos inválidos: un documento fiscal que no corresponde al país, un precio con símbolo de moneda o con más decimales que tu moneda, un número con separador de miles. * Celdas obligatorias vacías al crear un registro nuevo. # Configura los dominios de tu tienda Source: https://docs.riqra.com/tienda-online/dominios Cambia el subdominio Riqra de tu tienda y conecta tu propio dominio con los registros DNS que te indica el panel. Tu tienda siempre responde en un subdominio Riqra, por ejemplo `acme.tiendariqra.com`. Además puedes conectar un dominio propio, como `acme.com` o `tienda.acme.com`. Mientras el dominio propio no esté verificado, el subdominio Riqra es la dirección oficial de la tienda. Cuando se verifica, tu dominio pasa a ser la dirección oficial y el subdominio Riqra redirige a él. Los administras en **[Configuración → Dominios](https://app.riqra.com/settings/domains)**, dentro del grupo **Tienda online**. La página tiene dos tarjetas, **Subdominio Riqra** y **Dominio personalizado**. ## El subdominio Riqra Al activar tu cuenta, la tienda recibe un subdominio derivado del nombre de tu organización. Si ese nombre ya estaba tomado, se agrega un número al final. La tarjeta muestra la dirección completa con un enlace para abrir la tienda y una etiqueta que indica si es el **Host principal** o si **Redirige a** tu dominio propio. ### Cambia el subdominio **1. Abre el editor** En la tarjeta **Subdominio Riqra**, haz clic en **Editar**. **2. Escribe el nuevo subdominio** Escribe solo la parte que va antes de `.tiendariqra.com`. Debajo del campo se muestra la dirección completa que quedará. El subdominio debe tener entre 3 y 63 caracteres en minúsculas, y solo puede usar letras, números y guiones. No puede empezar ni terminar con guion. **3. Guarda** Haz clic en **Guardar**. El cambio se aplica al instante. La dirección anterior deja de funcionar y no redirige a la nueva. Algunos nombres están bloqueados. Los nombres reservados, como `admin`, `api`, `shop` o `checkout`, se rechazan con el mensaje **Ese subdominio está reservado**. Un subdominio que otra tienda ya usa se rechaza con **Ese subdominio ya está en uso**. > [!WARNING] > > Cuando cambias el subdominio, la dirección anterior queda en cuarentena por 7 días. Durante ese tiempo ninguna tienda puede tomarla, ni siquiera la tuya. Actualiza los enlaces que compartiste y avisa a tus clientes antes de cambiarlo. ## Conecta tu dominio propio Puedes conectar un dominio raíz, como `acme.com`, o un subdominio de tu dominio, como `tienda.acme.com`. Cada tienda admite un dominio propio a la vez. Si conectas un dominio raíz, la tienda se sirve en `www.acme.com` y `acme.com` redirige ahí. Escribir `acme.com` o `www.acme.com` da el mismo resultado. Si conectas un subdominio, la tienda se sirve en la dirección exacta que escribiste. ### Antes de empezar * Necesitas acceso al panel DNS de tu dominio. Es el registrador donde lo compraste o el proveedor donde administras sus registros, como GoDaddy, Namecheap, Cloudflare o Punto.pe. * Si esa dirección ya muestra otro sitio, dejará de mostrarlo cuando cambies los registros. ### Agrega el dominio **1. Abre el formulario** En la tarjeta **Dominio personalizado**, haz clic en **Agregar dominio personalizado**. **2. Escribe el dominio** Escribe el dominio sin `https://` ni rutas, por ejemplo `acme.com` o `tienda.acme.com`. Haz clic en **Agregar**. **3. Copia los registros DNS** La tarjeta muestra el dominio con el estado **Pendiente de DNS** y una tabla **Registros DNS requeridos** con el tipo, el nombre y el valor de cada registro. Cada fila tiene un botón para copiar el valor. **4. Crea los registros en tu proveedor DNS** Entra al panel DNS de tu dominio y crea cada registro tal como aparece en la tabla. Si ya existe un registro con el mismo tipo y nombre, reemplaza su valor en lugar de agregar otro. **5. Verifica** Vuelve al panel y haz clic en **Verificar**. Cada clic consulta tu DNS en ese momento. Si los registros todavía no se propagaron, el estado sigue en **Pendiente de DNS**. Espera unos minutos y vuelve a hacer clic en **Verificar**. Cuando el estado pase a **Activo**, la tienda ya responde en tu dominio con HTTPS. ### Qué registros vas a ver | Dominio que escribiste | Registros | | - | - | | `acme.com` o `www.acme.com` | Un registro `A` con nombre `@` y un registro `CNAME` con nombre `www`. | | `tienda.acme.com` | Un registro `CNAME` con nombre `tienda`. | Copia los valores desde tu panel. A veces la tabla incluye también un registro `TXT`. Créalo igual que los demás. Si tu proveedor no acepta `@` como nombre, usa el campo vacío o el dominio completo, según lo que pida su formulario. > [!NOTE] > > Si usas Cloudflare, deja el proxy desactivado (nube gris) en estos registros hasta que el dominio esté **Activo**. Los cambios de DNS pueden tardar hasta 48 horas en propagarse, aunque en la mayoría de los proveedores tardan minutos. ### Estados del dominio | Estado | Qué significa | Qué hacer | | - | - | - | | **Pendiente de DNS** | Los registros aún no se detectan. | Revisa que cada registro coincida con la tabla y haz clic en **Verificar**. | | **Activo** | El dominio responde con HTTPS y es la dirección oficial de la tienda. | Nada. La tabla de registros se oculta. | | **Configuración rota** | El dominio estuvo activo y los registros dejaron de coincidir. | Restaura los registros que muestra la tabla. Mientras tanto, el subdominio Riqra deja de redirigir y vuelve a servir la tienda. | El estado solo cambia cuando agregas el dominio o haces clic en **Verificar**. Abrir la página no consulta tu DNS. Si la tabla de registros aparece vacía después de agregar el dominio, haz clic en **Verificar** para cargarla. Si cambias los registros DNS de un dominio activo, haz clic en **Verificar** para confirmar que sigue en **Activo**. ### Si el panel rechaza el dominio * **Este dominio ya está conectado a otra tienda Riqra.** Otra organización ya lo usa. Escribe a soporte para resolverlo. * **Esta tienda ya tiene un dominio personalizado.** Quita el actual antes de agregar otro. * **No reconocemos ese dominio** u otro mensaje de validación. Revisa que sea un dominio público real. No se aceptan direcciones IP ni dominios de prueba. ## Cambia o quita el dominio Para cambiar de dominio, quita el actual y agrega el nuevo. En la tarjeta **Dominio personalizado**, haz clic en **Quitar**. No pide confirmación. El dominio deja de servir la tienda al instante y no redirige a ningún lado. El subdominio Riqra vuelve a ser la dirección oficial. Los registros DNS que creaste en tu proveedor no se borran, así que elimínalos si ya no los usas. ## Qué dirección usan tus clientes Mientras tu dominio esté **Activo**, cualquier enlace al subdominio Riqra redirige a la misma página en tu dominio, así que los enlaces antiguos siguen funcionando. Los correos y enlaces de acceso que la plataforma envía a tus clientes usan la dirección oficial vigente en ese momento. # Qué es la tienda online Source: https://docs.riqra.com/tienda-online/introduccion La tienda online es el canal donde tus clientes compran por su cuenta desde un sitio web con tu marca y tu propio dominio. La tienda online es el canal de venta web. Tus clientes entran al sitio, ven el catálogo con los precios y las condiciones que les asignan tus [políticas comerciales](/plataforma/politicas-comerciales/introduccion), arman su pedido y pagan sin hablar con nadie de tu equipo. Los pedidos que llegan por este canal entran a la misma lista de pedidos que los de WhatsApp o PedidosIA. > [!NOTE] > > La tienda online se contrata por separado. Si no ves **Tienda online** en el menú del panel, contacta a tu ejecutivo de Riqra para activarla. ## Qué incluye * Un sitio público en un subdominio Riqra, como `acme.tiendariqra.com`, o en tu propio dominio. * Un tema con páginas, menús, colores y tipografía que ajustas sin programar. * Un checkout con los métodos de envío y de pago que tengas configurados. * Una cuenta para cada cliente, con su historial de pedidos y sus direcciones. ## Dónde se configura Este canal se administra desde dos lugares del panel. El menú **[Tienda online](https://app.riqra.com/online-store)** tiene el contenido del sitio. Ahí están **Páginas**, **Menús**, **Archivos**, **Reclamaciones** y el personalizador del tema, que abres con **Personalizar**. En **[Configuración](https://app.riqra.com/settings)**, el grupo **Tienda online** tiene los ajustes que afectan a todo el sitio. | Ajuste | Qué haces | | - | - | | **Dominios** | Cambias el subdominio Riqra y conectas tu propio dominio. | | **Redirecciones** | Envías URLs antiguas a las nuevas para no perder tráfico ni posicionamiento. | | **Checkout** | Decides qué consentimientos pide el formulario de compra. | | **Políticas** | Publicas los términos, la política de privacidad y la de devoluciones. | | **Analítica** | Agregas las etiquetas de medición de tus herramientas de analítica. | Los productos, los precios, el inventario y los clientes no son propios de este canal. Son los mismos para toda tu operación y tienen sus propias guías en [Productos](/plataforma/productos/introduccion), [Precios](/plataforma/precios/introduccion), [Inventario](/plataforma/inventario/introduccion) y [Clientes](/plataforma/clientes/introduccion). ## Siguientes pasos * [Configura los dominios de tu tienda](/tienda-online/dominios) # Cómo aprueba Meta tus plantillas Source: https://docs.riqra.com/whatsapp/aprobacion-de-plantillas Entiende los estados de tus plantillas y qué hacer cuando Meta las rechaza o pausa. Después de [crear una plantilla](/whatsapp/crear-plantilla) y enviarla, Meta la revisa antes de que puedas usarla. La revisión puede tomar **hasta 24 horas**. ## Estados de una plantilla | Estado | Qué significa | | - | - | | **Pendiente** | Meta está revisando la plantilla. | | **Aprobado** | Lista para usar en conversaciones y campañas. | | **Rechazado** | Meta no la aprobó. Si Meta envía un motivo, se muestra en el aviso de estado. | | **Pausado** | Meta la pausó por baja calificación. Puedes editarla y reenviarla. | | **Deshabilitado** | Meta la deshabilitó. No se puede usar ni eliminar. | | **En apelación** | La apelación se gestiona en **WhatsApp Manager**. | ## Si te rechazan o pausan una plantilla 1. Abre la plantilla. El aviso superior indica el estado y, cuando Meta lo proporciona, el motivo. 2. Corrige el contenido. 3. Haz clic en **Enviar para revisión** y confirma en **¿Reenviar la plantilla a Meta?**. La plantilla vuelve a **Pendiente**. Para apelar una plantilla **En apelación**, usa el enlace **[Abrir WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates)**. ## Mantén los estados actualizados Usa el botón **Sincronizar** en la lista de plantillas para traer desde Meta los últimos estados (creadas, actualizadas o eliminadas). ## Consejos para evitar rechazos * Elige la **categoría correcta**: no uses **Utilidad** para contenido promocional. * Sé claro y específico; evita texto engañoso o promesas exageradas. * Revisa que las variables `{{...}}` tengan sentido y un ejemplo válido. * Evita enlaces sospechosos o acortadores poco confiables. > [!NOTE] > > Meta puede **reclasificar** la categoría de una plantilla si el contenido no coincide con la que elegiste. Esto puede afectar el costo de envío. ## Siguiente paso Con una plantilla **Aprobada**, ya puedes [crear una campaña](/whatsapp/crear-campana) o usarla en la [bandeja de conversaciones](/plataforma/conversaciones/responder-mensajes). # Construye audiencias para segmentar tus envíos Source: https://docs.riqra.com/whatsapp/audiencias Agrupa clientes con filtros para reutilizarlos en tus campañas de WhatsApp. Una audiencia es un grupo de clientes definido por filtros, que luego puedes reutilizar en tus [campañas](/whatsapp/crear-campana). Las administras en **[Marketing → Audiencias](https://app.riqra.com/marketing/audiences)**. Haz clic en **Nueva audiencia** para crear una. ## Crea una audiencia **1. Detalles** En **Detalles**, escribe el **Nombre** y, si quieres, una **Descripción**. **2. Define las personas** En la sección **Personas**, agrega filtros. Tienes tres tipos: * **Personas** — selecciona clientes específicos. * **Empresa** — filtra por empresas específicas. * **Segmentos** — limita por segmento de clientes. **3. Guarda** Haz clic en **Guardar**. La audiencia queda **Activa** y disponible para tus campañas. > [!NOTE] > > Cuando combinas varios filtros, solo se incluyen las personas que cumplen **todos** los filtros a la vez. ## Revisa quién queda incluido Debajo de los filtros, una tabla muestra a las personas con su **Teléfono** y su **Estado**: * **Elegible** — puede recibir mensajes. * **Sin consentimiento** — no aceptó recibir mensajes por WhatsApp. * **Sin número** — no tiene teléfono registrado. * **Pausada** — la cuenta de la persona está pausada. ## Archiva una audiencia Para dejar de usar una audiencia sin eliminarla, ábrela y usa **Archivar audiencia**. Las audiencias **Archivadas** no aparecen al elegir audiencia en una campaña nueva, pero las campañas ya programadas la siguen usando. Puedes **Restaurar** una audiencia archivada cuando la necesites otra vez. # Conectar un número nuevo Source: https://docs.riqra.com/whatsapp/conectar-numero-nuevo Registra en Riqra un número que todavía no usa WhatsApp ni otro proveedor. Usa esta guía para conectar un número que todavía no está registrado en WhatsApp, WhatsApp Business ni otra plataforma de WhatsApp Cloud API. > [!WARNING] > > Si el número ya está activo en la app de WhatsApp Business, no uses este flujo. Usa [Migrar número en coexistencia](/whatsapp/migrar-en-coexistencia). Si el número ya usa la API con otro proveedor, usa [Migrar desde WhatsApp Cloud API](/whatsapp/migrar-desde-cloud-api). ## Antes de empezar Ten listo lo siguiente: * Una cuenta de **Meta Business**. * Un número de teléfono dedicado a WhatsApp Business. * El teléfono o línea capaz de recibir un código por **SMS o llamada**. * Un **método de pago** para agregar en Meta. * La **información de tu negocio**: nombre, rubro y datos de contacto. ## Paso a paso **1. Abre WhatsApp en Riqra** En el panel de administración ve a **[Configuración → Riqra Inbox → WhatsApp Business](https://app.riqra.com/settings/channels/whatsapp)**. **2. Elige número nuevo** En la tarjeta **WhatsApp Business**, selecciona **Conectar un número nuevo**. **3. Autoriza en Meta** Se abrirá una ventana de Meta. Inicia sesión, elige o crea el **Meta Business** del negocio y sigue el registro de WhatsApp. **4. Verifica el número** Meta enviará un código por **SMS o llamada**. Ingrésalo en la ventana de Meta para confirmar que el número pertenece al negocio. **5. Confirma la conexión** Al terminar, el número aparecerá como **Conectado**. Si aparece como **Número pendiente** o **Nombre pendiente**, espera unos minutos a que Meta termine de sincronizar. ## Completa la activación en Meta Conectar el número no basta: Meta exige completar la configuración de la cuenta para enviar mensajes. **1. Agrega un método de pago** Entra a **[WhatsApp Manager](https://business.facebook.com/wa/manage/home/)** y agrega un método de pago. **2. Completa la información del negocio** En la **[configuración de Meta Business](https://business.facebook.com/settings)** completa los datos del negocio. Meta puede pedir verificación para subir los límites de envío. > [!WARNING] > > Mientras no agregues un método de pago en **WhatsApp Manager**, la cuenta puede quedar conectada, pero no podrá enviar plantillas ni campañas. ## Prueba la conexión Envía un mensaje desde otro teléfono al número del negocio y confirma que aparece en **Conversaciones**. Luego responde desde Riqra para validar que el cliente recibe el mensaje. ## Siguiente paso Completa el [perfil de negocio](/whatsapp/perfil-de-negocio) y revisa la [ventana de 24 horas](/whatsapp/ventana-de-24-horas). # Crea y envía tu primera campaña Source: https://docs.riqra.com/whatsapp/crear-campana Envía un mensaje con plantilla a un grupo de clientes por WhatsApp. Una campaña envía una [plantilla aprobada](/whatsapp/crear-plantilla) a un grupo de clientes. Las administras en **[Marketing → Campañas](https://app.riqra.com/marketing/campaigns)**. Haz clic en **Nueva campaña** para empezar. ## Arma la campaña **1. Detalles** En **Detalles**, escribe el **Nombre** de la campaña. Es un nombre interno para identificarla. **2. Contenido** En **Contenido**, elige una **Plantilla** aprobada y completa sus variables. Puedes usar **Enviar prueba** para enviártela a 1 o 2 clientes antes del envío real. La prueba omite los filtros de consentimiento y frecuencia. **3. Audiencia** En **Audiencia**, define quién recibe la campaña: * **Guardada**: elige una [audiencia](/whatsapp/audiencias) que ya creaste. * **Personalizada**: define filtros directamente en la campaña. **4. Programación** En **Programación**, elige **Enviar ahora** o **Programar** una fecha y hora futura (en la zona horaria de tu organización). **5. Reglas de entrega (opcional)** Activa **Saltar personas con interacción reciente** para no escribir a quienes te contactaron en la última hora. ## Revisa audiencia y costo El panel **Audiencia y costo** muestra cuántas personas recibirán el mensaje, con el desglose de **elegibles**, **sin consentimiento**, **sin número** y **pausadas**. El costo estimado se calcula solo sobre los **elegibles**, porque son los únicos que pueden recibir el mensaje. > [!WARNING] > > Solo reciben la campaña los clientes **elegibles**: con número válido, activos y que dieron su consentimiento para recibir mensajes por WhatsApp. Los demás se marcan como **Omitido** en los resultados. ## Envía y haz seguimiento Haz clic en **Enviar ahora** o **Programar**. La campaña pasa por estados como **Borrador**, **Programada**, **En espera**, **Enviando** y **Completada**. En **Destinatarios** ves el estado de cada persona: **Enviado**, **Entregado**, **Leído**, **Respondió**, **Fallido** u **Omitido**. > [!NOTE] > > Si la calidad de tu número cae o la plantilla es rechazada, la campaña puede pausarse automáticamente con un motivo (por ejemplo, **Caída de calidad del número** o **Plantilla rechazada o deshabilitada**). # Crea tu primera plantilla de mensaje Source: https://docs.riqra.com/whatsapp/crear-plantilla Arma una plantilla y envíala a Meta para iniciar conversaciones con tus clientes. Las plantillas son mensajes aprobados por Meta que te permiten **iniciar** una conversación o retomarla cuando la [ventana de 24 horas](/whatsapp/ventana-de-24-horas) está cerrada. Las administras en **[Marketing → Plantillas](https://app.riqra.com/marketing/templates)**. ## Dos formas de empezar * **Elegir de la biblioteca**: abre **Biblioteca de plantillas**, una galería de ejemplos listos para personalizar. Elige uno y haz clic en **Usar esta plantilla**. * **Crear plantilla**: arma una desde cero con el formulario. ## Llena el formulario **1. Información básica** Escribe el **Nombre** (por ejemplo, `Confirmación de pedido`), elige la **Categoría** y el **Idioma**. Las categorías disponibles son: * **Marketing** — promociones, ofertas, actualizaciones de producto. * **Utilidad** — confirmaciones de pedido, actualizaciones de envío. > [!WARNING] > > El **nombre** y el **idioma** no se pueden cambiar después de enviar la plantilla a Meta. **2. Encabezado (opcional)** Aparece encima del cuerpo. Puede ser **Sin encabezado**, **Texto**, **Imagen**, **Video** o **Documento**. **3. Cuerpo del mensaje** Es el texto principal. Usa variables con llaves dobles para personalizarlo, por ejemplo: `Hola {{primer_nombre}}, tu pedido #{{numero_pedido}} ha sido confirmado.` **4. Pie de mensaje (opcional)** Un texto corto al final, por ejemplo: `Responde STOP para dejar de recibir mensajes`. **5. Botones (opcional)** Agrega botones debajo del mensaje. Puedes combinar **Respuesta rápida** con botones de acción: **Visitar sitio web**, **Llamar por teléfono** o **Copiar código**. ## Envía a aprobación Haz clic en **Enviar para aprobación** y confirma en el diálogo. La plantilla pasa a estado **Pendiente** y Meta la revisa: la revisión puede tomar hasta 24 horas. > [!NOTE] > > Meta puede reclasificar la categoría si el contenido no coincide con la que elegiste. Conoce los estados y los motivos de rechazo en [Cómo aprueba Meta tus plantillas](/whatsapp/aprobacion-de-plantillas). # Elige cómo conectar tu número Source: https://docs.riqra.com/whatsapp/elegir-conexion Identifica qué tipo de conexión de WhatsApp necesitas antes de iniciar el registro en Meta. Para usar WhatsApp en Riqra necesitas conectar un número de **WhatsApp Business** mediante Meta. La conexión se hace desde una ventana de Meta, sin copiar tokens ni credenciales. Elige el camino correcto antes de empezar. Cada opción usa un proceso distinto. > **[Conectar un número nuevo](/whatsapp/conectar-numero-nuevo)** > > Para un número que no está activo en WhatsApp ni conectado a otra plataforma. > **[Migrar desde WhatsApp Cloud API](/whatsapp/migrar-desde-cloud-api)** > > Para un número que ya usa la API con otro proveedor y no está activo en la app. > **[Migrar número en coexistencia](/whatsapp/migrar-en-coexistencia)** > > Para un número que sigue activo en la app de WhatsApp Business y usa otra plataforma. ## Cómo elegir | Situación actual del número | Usa esta guía | | - | - | | El número no está registrado en WhatsApp, WhatsApp Business ni otra API. | [Conectar un número nuevo](/whatsapp/conectar-numero-nuevo) | | El número ya usa WhatsApp Cloud API con otro proveedor. | [Migrar desde WhatsApp Cloud API](/whatsapp/migrar-desde-cloud-api) | | El número sigue activo en la app de WhatsApp Business y está vinculado a otra plataforma en **Business Platform**. | [Migrar número en coexistencia](/whatsapp/migrar-en-coexistencia) | > [!WARNING] > > No uses **Conectar un número nuevo** si el número ya está activo en la app de WhatsApp Business o con otro proveedor. Elegir el flujo incorrecto puede bloquear el registro o desconectar el número de donde lo usas hoy. ## Después de conectar Cuando el número quede conectado, completa el [perfil de negocio](/whatsapp/perfil-de-negocio), revisa la [ventana de 24 horas](/whatsapp/ventana-de-24-horas) y crea tus [plantillas](/whatsapp/crear-plantilla). # WhatsApp Source: https://docs.riqra.com/whatsapp/introduccion Conversa, automatiza y envía campañas a tus clientes desde tu número de WhatsApp Business. WhatsApp te permite atender a tus clientes y enviarles mensajes desde el número de **WhatsApp Business** de tu tienda, conectado a través de la **API de WhatsApp Cloud** de Meta. > [!NOTE] > > Para usar WhatsApp necesitas conectar un número de **WhatsApp Business** mediante Meta. Empieza por [conectar tu número](/whatsapp/elegir-conexion). ## Primeros pasos Sigue esta ruta para dejar tu WhatsApp listo: **1. Conecta tu número** Vincula tu número de WhatsApp Business y completa la activación en Meta. → [Conectar tu número](/whatsapp/elegir-conexion) **2. Configura tu perfil** Agrega tu foto, descripción y datos de contacto. → [Perfil de negocio](/whatsapp/perfil-de-negocio) **3. Crea una plantilla** Arma tu primer mensaje aprobado por Meta para iniciar conversaciones. → [Crear una plantilla](/whatsapp/crear-plantilla) **4. Responde a tus clientes** Atiende los mensajes desde la bandeja de conversaciones. → [Responder mensajes](/plataforma/conversaciones/responder-mensajes) **5. Envía tu primera campaña** Llega a varios clientes a la vez con una plantilla. → [Crear una campaña](/whatsapp/crear-campana) ## Qué puedes hacer > **[Bandeja de conversaciones](/plataforma/conversaciones/responder-mensajes)** > > Responde a tus clientes desde un solo lugar y organiza todo con etiquetas. > **[Plantillas](/whatsapp/crear-plantilla)** > > Mensajes aprobados por Meta para iniciar o retomar conversaciones. > **[Campañas](/whatsapp/crear-campana)** > > Envíos masivos a grupos de clientes (audiencias). > **[Equipo y asignación](/plataforma/conversaciones/asignacion-y-carteras)** > > Reparte conversaciones y define carteras de venta. ## La ventana de 24 horas Cuando un cliente te escribe, se abre una **ventana de 24 horas** para responder con mensajes libres. Pasado ese tiempo, solo puedes retomar la conversación con una **plantilla** aprobada. Más en [Qué es la ventana de 24 horas](/whatsapp/ventana-de-24-horas). ## Costos WhatsApp cobra por conversación, y las plantillas de **Marketing** tienen un costo distinto al de las de **Utilidad**. El precio varía según el país. Antes de enviar una campaña, revisa el panel **Audiencia y costo** para ver el estimado. ## ¿Algo no funciona? Revisa [Soluciona problemas de envío](/whatsapp/solucion-de-problemas) para los avisos más comunes y cómo resolverlos. # Migrar desde WhatsApp Cloud API Source: https://docs.riqra.com/whatsapp/migrar-desde-cloud-api Mueve a Riqra un número que ya usa WhatsApp Cloud API con otro proveedor. Usa esta guía si tu número ya está conectado a la **API de WhatsApp Cloud** con otro proveedor y quieres moverlo a Riqra. Este proceso es para números que funcionan como API. Si el número sigue activo en la **app de WhatsApp Business**, usa [Migrar número en coexistencia](/whatsapp/migrar-en-coexistencia). ## Antes de empezar Coordina estos puntos antes de iniciar la migración: * Acceso de administrador al **Meta Business** del negocio. * La cuenta de Meta Business está verificada o lista para completar la verificación. * El WABA actual está aprobado y tiene un método de pago válido. * El nombre visible del número está aprobado y no tiene cambios pendientes. * La **verificación en dos pasos** del número está desactivada. Si no puedes hacerlo en WhatsApp Manager, solicita al proveedor actual que la desactive. * Las campañas, automatizaciones y respuestas del proveedor anterior están pausadas. > [!NOTE] > > Meta valida estos requisitos durante el registro. Si falta alguno, la ventana de Meta puede mostrar un error y bloquear la migración. ## Paso a paso **1. Pausa el proveedor actual** Antes de transferir el número, pausa campañas, automatizaciones y respuestas automáticas en la plataforma anterior. **2. Desactiva la verificación en dos pasos** En **WhatsApp Manager**, desactiva la verificación en dos pasos del número. Si el proveedor actual administra esa configuración, pídele que la desactive. **3. Abre WhatsApp en Riqra** En Riqra ve a **[Configuración → Riqra Inbox → WhatsApp Business](https://app.riqra.com/settings/channels/whatsapp)**. **4. Elige migración Cloud API** En la tarjeta **WhatsApp Business**, selecciona **Migrar desde WhatsApp Cloud API**. **5. Autoriza en Meta** Se abrirá una ventana de Meta. Inicia sesión con una cuenta administradora y selecciona el **Meta Business** correcto. **6. Confirma la transferencia** Ingresa el mismo número y confirma cuando Meta indique que el número será transferido desde otro proveedor. **7. Finaliza la conexión** Cuando Meta termine, el número aparecerá como **Conectado**. Desde ese momento, los nuevos mensajes llegan a tu bandeja. ## Qué se conserva Normalmente se conserva el número, el nombre visible, la calidad, los límites de mensajería y el estado de la cuenta. Las plantillas aprobadas pueden copiarse al nuevo WABA si cumplen los requisitos de Meta. > [!WARNING] > > No asumas que todas las plantillas estarán listas después de migrar. Revisa tus [plantillas](/whatsapp/crear-plantilla) en Riqra antes de enviar campañas. ## Pruebas recomendadas * Envía un mensaje entrante al número y confirma que aparece en **Conversaciones**. * Responde desde Riqra y confirma que el cliente recibe el mensaje. * Revisa que las plantillas necesarias estén disponibles y aprobadas. * Confirma que el proveedor anterior ya no envía mensajes desde ese número. ## Si algo falla Si Meta indica que la verificación en dos pasos sigue activa, vuelve a WhatsApp Manager o solicita al proveedor anterior que la desactive. Si Meta indica que el número no puede migrarse, revisa la verificación del negocio, el estado del WABA, el método de pago y el nombre visible del número. Si el número todavía aparece activo en la app de WhatsApp Business, no sigas este flujo. Usa [Migrar número en coexistencia](/whatsapp/migrar-en-coexistencia). # Migrar número en coexistencia Source: https://docs.riqra.com/whatsapp/migrar-en-coexistencia Conecta en Riqra un número que ya usas en la app de WhatsApp Business y en otra plataforma. Usa esta guía si tu número sigue activo en la **app de WhatsApp Business** y también está conectado a otra plataforma mediante **Business Platform**. Este modo se conoce como **coexistencia**: puedes mantener el mismo número en la app y atenderlo también desde Riqra. > [!WARNING] > > No elimines tu cuenta de WhatsApp Business ni desinstales la app. Para coexistencia, el número debe seguir activo en la app. ## Cuándo usar esta guía Usa este proceso cuando: * Ya respondes clientes desde la **app de WhatsApp Business**. * En la app ves una conexión activa con otra plataforma en **Configuración → Cuenta → Business Platform**. * Quieres mover esa conexión a Riqra sin cambiar de número. Si el número ya no funciona en la app de WhatsApp Business y solo vive en otra plataforma o API, usa [Migrar desde WhatsApp Cloud API](/whatsapp/migrar-desde-cloud-api). ## Antes de empezar Ten listo lo siguiente: * Acceso de administrador a la cuenta de **Meta Business** del negocio. * El teléfono donde está instalada la **app de WhatsApp Business** con ese número. * La app de WhatsApp Business actualizada y abierta. * Las campañas, automatizaciones o respuestas activas en la plataforma anterior pausadas. * Confirmación de que la plataforma anterior ya no debe enviar ni recibir mensajes por ese número. > [!NOTE] > > Meta puede limitar la disponibilidad de coexistencia según el país, la antigüedad del número, el uso de la app y la calidad de la cuenta. Si Meta indica que el número no es elegible, no fuerces el registro como número nuevo. ## Paso a paso **1. Confirma la conexión actual** En la **app de WhatsApp Business**, entra a **Configuración → Cuenta → Business Platform**. Verifica qué plataforma está conectada actualmente. **2. Desconecta la plataforma anterior** Desde esa misma pantalla, usa **Desconectar** para retirar la conexión anterior. Si no tienes esa opción, solicita a tu proveedor actual que libere o desconecte el número. **3. Abre WhatsApp en Riqra** En Riqra ve a **[Configuración → Riqra Inbox → WhatsApp Business](https://app.riqra.com/settings/channels/whatsapp)**. **4. Elige migrar número en coexistencia** En la tarjeta **WhatsApp Business**, selecciona **Migrar número en coexistencia**. **5. Autoriza en Meta** Se abrirá una ventana de Meta. Inicia sesión con una cuenta administradora, elige el **Meta Business** correcto y sigue los pasos de autorización. **6. Vincula la app** Meta mostrará instrucciones para vincular la app. En el teléfono, abre la **app de WhatsApp Business** y escanea el código QR que aparece en pantalla. **7. Confirma la sincronización** Si Meta ofrece sincronizar contactos o historial, elige la opción que corresponda para tu operación. La sincronización puede tardar varios minutos. **8. Verifica la conexión** Al terminar, el número aparecerá como **Conectado** con la etiqueta **Coexistencia**. ## Pruebas recomendadas Antes de cerrar la sesión de migración, prueba estos tres casos: * Envía un mensaje desde otro teléfono al número del negocio y confirma que aparece en **Conversaciones**. * Responde desde Riqra y confirma que el cliente recibe el mensaje. * Responde desde la app de WhatsApp Business y confirma que el mensaje también aparece en Riqra. ## Qué no hacer * No elijas **Conectar un número nuevo** para este caso. * No elijas **Migrar desde WhatsApp Cloud API** si quieres mantener activa la app de WhatsApp Business. * No elimines la cuenta en la app de WhatsApp Business. * No desinstales la app ni cambies el número a WhatsApp normal. * No mantengas automatizaciones activas en la plataforma anterior después de desconectarla. ## Si algo falla Si Meta indica que el número ya está conectado a Business Platform, la plataforma anterior todavía no se desconectó por completo. Vuelve a revisar **Configuración → Cuenta → Business Platform** en la app o solicita ayuda al proveedor anterior. Si Meta indica que el número no es elegible, contacta a soporte. Puede deberse a restricciones de Meta sobre la cuenta, el país, la calidad o el uso reciente del número. ## Siguiente paso Después de conectar el número, revisa tu [perfil de negocio](/whatsapp/perfil-de-negocio), crea o sincroniza tus [plantillas](/whatsapp/crear-plantilla) y valida la [ventana de 24 horas](/whatsapp/ventana-de-24-horas) con tu equipo. # WhatsApp normal vs. WhatsApp Business API Source: https://docs.riqra.com/whatsapp/normal-vs-business-api Qué cambia respecto al WhatsApp que ya conoces cuando atiendes desde Riqra. La conexión con WhatsApp usa la **API de WhatsApp Cloud** de Meta. Funciona distinto del WhatsApp que usas en tu teléfono. Conocer estas diferencias evita sorpresas con tu equipo. ## Qué funciona igual * Mensajes de **texto** (enviar y recibir). * **Imágenes, video, audio y documentos**, dentro de los límites de tamaño. * **Responder o citar** un mensaje específico. * **Reacciones con emoji**. * **Estados de entrega**: enviado, entregado y leído. ## Qué cambia | Tema | Cómo funciona en la API | | - | - | | **Ventana de 24 horas** | Fuera de las 24 horas solo puedes escribir con [plantillas aprobadas](/whatsapp/crear-plantilla), que tienen costo. | | **Llamadas de voz y video** | No están disponibles. | | **Grupos** | No existen: toda conversación es 1 a 1. | | **"Escribiendo…", "en línea", "última vez"** | No se muestran en ninguna dirección. | | **Ver una vez** | Las fotos o videos enviados como "ver una vez" **no llegan**. Pide al cliente que los reenvíe de forma normal. | | **Editar o eliminar mensajes** | No se puede editar ni borrar un mensaje ya enviado. Envía una corrección como mensaje nuevo. | | **Límites de medios** | Video **16 MB**, documento **100 MB**, imagen **5 MB**. Los archivos más grandes no se reciben. | > [!NOTE] > > La diferencia más importante en el día a día es la [ventana de 24 horas](/whatsapp/ventana-de-24-horas). Si un cliente no responde en 24 horas, solo podrás retomar la conversación con una plantilla. # Configura el perfil de tu negocio Source: https://docs.riqra.com/whatsapp/perfil-de-negocio Define la foto, descripción y datos de contacto que ven tus clientes en WhatsApp. El perfil de negocio es la información que ven los contactos que interactúan con tu número de WhatsApp Business. Lo editas desde **[Configuración → Riqra Inbox → WhatsApp Business](https://app.riqra.com/settings/channels/whatsapp)**, en la sección **Perfil de negocio**. > [!NOTE] > > La sección **Perfil de negocio** solo aparece cuando tu número está **Conectado**. Si aún no lo conectas, sigue primero [Conecta tu número de WhatsApp Business](/whatsapp/elegir-conexion). ## Foto de perfil Haz clic en **Cambiar foto** para subir una imagen. Acepta archivos **JPG o PNG** de máximo **5 MB**. ## Campos del perfil | Campo | Para qué sirve | Límite | | - | - | - | | **Acerca de** | Texto corto que se muestra debajo de la foto de perfil. | 139 caracteres | | **Descripción** | Texto visible en la sección de información del perfil. | 512 caracteres | | **Categoría de industria** | Define el rubro de tu negocio (por ejemplo, **Retail**, **Restaurante**, **Salud**). | — | | **Dirección** | Dirección física de tu negocio. | 256 caracteres | | **Correo electrónico** | Correo de contacto. | 128 caracteres | | **Sitios web** | Hasta dos URLs de tu negocio. | 2 URLs | ## Vista previa y guardado A la derecha (o debajo, en móvil) verás una **Vista previa** de cómo se ve tu perfil en WhatsApp. Cuando hagas cambios aparecerá el indicador **Cambios sin guardar**. Haz clic en **Guardar perfil** para aplicarlos, o en **Descartar** para deshacerlos. # Soluciona problemas de envío Source: https://docs.riqra.com/whatsapp/solucion-de-problemas Los avisos más comunes al enviar mensajes por WhatsApp y cómo resolverlos. Si un mensaje no se envía como esperabas, casi siempre es por una de estas razones. El aviso aparece en el panel; aquí te decimos cómo resolverlo. > **No puedo conectar mi número** > > Si al conectar ves **No se pudo conectar. Verifica los permisos en Meta Business.**, revisa que hayas aceptado **todos** los permisos en la ventana de Meta y haz clic en **Reintentar**. Más en [Conectar tu número](/whatsapp/elegir-conexion). > **Conecté el número pero no puedo enviar mensajes** > > Tu cuenta queda conectada, pero Meta exige un **método de pago** para poder enviar. Agrégalo en tu **WhatsApp Manager**. Más en [Conectar tu número](/whatsapp/elegir-conexion). > **No puedo escribir un mensaje libre** > > Si ves **Ventana de 24 h expirada**, pasaron más de 24 horas desde el último mensaje del cliente. Solo puedes continuar con una **plantilla** (botón **Enviar plantilla**) hasta que el cliente vuelva a responder. Más en [Ventana de 24 horas](/whatsapp/ventana-de-24-horas). > **No puedo usar mi plantilla** > > Solo puedes enviar plantillas en estado **Aprobado**. Si está **Pendiente**, espera la revisión de Meta (hasta 24 horas). Si está **Rechazado** o **Pausado**, corrígela y usa **Enviar para revisión**. Más en [Cómo aprueba Meta tus plantillas](/whatsapp/aprobacion-de-plantillas). > **Mi campaña no llegó a todos los clientes** > > Solo reciben la campaña los clientes **elegibles**. En el panel **Audiencia y costo** y en **Destinatarios** verás por qué se omitió a alguien: > > * **Sin consentimiento** — no aceptó recibir mensajes. Actívalo en el perfil del cliente, en **Consentimiento de WhatsApp** (**Recibe mensajes por WhatsApp**). > * **Sin número** — el cliente no tiene teléfono registrado. > * **Pausada** — la cuenta de la persona está pausada. Actívala desde el panel **Estado** del cliente. > > A quienes se omite aparecen como **Omitido**. > **Mi campaña se pausó sola** > > Una campaña puede pausarse automáticamente. El motivo aparece junto al estado: > > * **Demasiados envíos fallidos** > * **Caída de calidad del número** > * **Plantilla rechazada o deshabilitada** > * **Límite diario de WhatsApp alcanzado** > * **Problema con la cuenta de WhatsApp** > > Resuelve el motivo (por ejemplo, corrige la plantilla o cuida la calidad de tu número) y reanuda la campaña. > **No puedo responder una conversación** > > Solo la persona asignada puede responder. Si ves **Conversación sin asignar**, haz clic en **Reclamar**. Si ves **Solo la persona asignada puede responder en esta conversación.**, pide que te la reasignen. Más en [Asignación y carteras de venta](/plataforma/conversaciones/asignacion-y-carteras). # Qué es la ventana de 24 horas Source: https://docs.riqra.com/whatsapp/ventana-de-24-horas Entiende cuándo puedes responder con texto libre y cuándo necesitas una plantilla. WhatsApp Business funciona con una regla de Meta llamada **ventana de servicio de 24 horas**. Entenderla evita confusiones cuando un mensaje no se puede enviar. ## Cómo funciona * Cuando un cliente te escribe, se abre una **ventana de 24 horas**. * Dentro de esa ventana puedes responder con **mensajes libres**: texto, imágenes, documentos, etc. * Cada vez que el cliente vuelve a escribir, la ventana se reinicia a 24 horas. * Cuando pasan 24 horas sin que el cliente responda, la ventana **se cierra**. A partir de ese momento solo puedes retomar la conversación con una [plantilla aprobada](/whatsapp/crear-plantilla). ## Cómo lo ves en la bandeja En cada conversación, un indicador muestra el estado de la ventana: * **Xh Ym restantes** — la ventana está abierta y puedes responder con texto libre. * **Ventana vencida** — pasaron las 24 horas; necesitas una plantilla. * **Sin ventana activa** — el cliente nunca ha iniciado una conversación contigo. Cuando la ventana está cerrada, el cuadro de mensaje se reemplaza por el aviso **Ventana de 24 h expirada** y el botón **Enviar plantilla**: > **Ventana de 24 h expirada.** Solo puedes enviar plantillas aprobadas hasta que el contacto responda. ## Por qué existe Es una política de Meta para proteger a los usuarios del spam. Los mensajes con plantilla tienen un costo por conversación y deben estar aprobados por Meta antes de usarse. > [!TIP] > > Si necesitas iniciar tú una conversación (no responder), también necesitas una plantilla. Aprende a [crear tu primera plantilla](/whatsapp/crear-plantilla). # Fulfill (dispatch / mark ready) Source: https://docs.riqra.com/api-reference/fulfillment/fulfill-dispatch-mark-ready /desarrolladores/api/openapi.json post /orders/{id}/fulfillment/fulfill Advance the order to FULFILLED. Delivery orders may include carrier + tracking; pickup orders must send an empty body. Requires the `fulfillment:write` scope. # Mark delivered (or picked up) Source: https://docs.riqra.com/api-reference/fulfillment/mark-delivered-or-picked-up /desarrolladores/api/openapi.json post /orders/{id}/fulfillment/deliver Advance the order to DELIVERED. A delivery order may include one-shot tracking here when it skipped fulfill. Requires the `fulfillment:write` scope. # Start preparation Source: https://docs.riqra.com/api-reference/fulfillment/start-preparation /desarrolladores/api/openapi.json post /orders/{id}/fulfillment/start Advance the order to IN_PROGRESS. Requires the `fulfillment:write` scope. # Update tracking Source: https://docs.riqra.com/api-reference/fulfillment/update-tracking /desarrolladores/api/openapi.json patch /orders/{id}/fulfillment/tracking Overwrite carrier + tracking on a FULFILLED delivery order. Requires the `fulfillment:write` scope. # Identify the authenticated API key Source: https://docs.riqra.com/api-reference/identity/identify-the-authenticated-api-key /desarrolladores/api/openapi.json get /whoami # Register the invoice of an order Source: https://docs.riqra.com/api-reference/invoicing/register-the-invoice-of-an-order /desarrolladores/api/openapi.json post /orders/{id}/invoice Record the reference of the fiscal document (factura/boleta) your ERP or invoicing system emitted for the order. Registration is independent of the order lifecycle: it does not change `status`, `paymentStatus`, or `fulfillmentStatus`, and may happen before or after payment or fulfillment. An order split across several documents takes one call per document; every registered reference rides on the order's `invoices` array under `orders:read`, and the order's `invoiceStatus` flips to `INVOICED` on the first one. Repeating a number already registered on the order responds 409 `ORDER_ALREADY_INVOICED` — a retry receiving that 409 can treat that invoice as already registered. Cancelling an invoiced order keeps its references. Pass `invoiceUrl` to have the file ingested into our storage: the 200 confirms the registration only, and the file appears once the asynchronous download completes. A failed download never undoes the registration and is not reported back — the merchant can attach the file from the admin. Requires the `invoices:write` scope. # Cancel an order Source: https://docs.riqra.com/api-reference/orders/cancel-an-order /desarrolladores/api/openapi.json post /orders/{id}/cancel Cancel an order that has not been dispatched yet. Records the reason, the optional internal note, and returns committed stock unless told otherwise. The buyer is not emailed unless `notifyCustomer` is `true`. Send no body to accept every default. Requires the `orders:write` scope. # Get an order by id Source: https://docs.riqra.com/api-reference/orders/get-an-order-by-id /desarrolladores/api/openapi.json get /orders/{id} A single order by its UUID. Requires the `orders:read` scope. # List orders Source: https://docs.riqra.com/api-reference/orders/list-orders /desarrolladores/api/openapi.json get /orders Cursor-paginated orders for the authenticated organization, newest first by default. Filter by status, payment status, fulfillment status, invoice status, source, customer, display code, and created/updated ranges; sort by createdAt or updatedAt for incremental sync. Requires the `orders:read` scope. # List active price lists Source: https://docs.riqra.com/api-reference/prices/list-active-price-lists /desarrolladores/api/openapi.json get /prices/lists Active (writable) price lists, so an integration can resolve the priceListId required by the price-set payload. Requires the `prices:read` scope. # Set prices for many SKUs Source: https://docs.riqra.com/api-reference/prices/set-prices-for-many-skus /desarrolladores/api/openapi.json post /prices/set Absolute SET of the price per (sku, price list). Each item sets either `price` (a flat unit price, or a manual override on a derived list) or `tiers` (the full quantity ladder); the one that is set replaces the other. Requires the `prices:write` scope. Prices reach shoppers through the commercial policy that selects the list. The request is 200 when structurally valid; each row carries its own status in the results array. # List active locations Source: https://docs.riqra.com/api-reference/stock/list-active-locations /desarrolladores/api/openapi.json get /stock/locations Active (writable) locations, so an integration can resolve the locationId required by the stock-set payload. Requires the `stock:read` scope. # Set stock for many SKUs Source: https://docs.riqra.com/api-reference/stock/set-stock-for-many-skus /desarrolladores/api/openapi.json post /stock/levels/set Absolute SET of stock per (sku, location). Each item sets either `onHand` (the physical quantity) or `available` (the sellable quantity; the server persists `onHand = available + committed`). Requires the `stock:write` scope. Reservations (committed) are system-owned and never written here. The request is 200 when structurally valid; each row carries its own status in the results array. # Cancelar pedidos Source: https://docs.riqra.com/desarrolladores/api/guides/cancelling-orders Anular un pedido no despachado, con motivo, nota y control del stock. `POST /orders/{id}/cancel` cancela un pedido que aún no fue despachado. Requiere el scope `orders:write` y devuelve el pedido actualizado, con el mismo formato que `GET /orders/{id}`. Sin cuerpo, la llamada toma todos los valores por defecto: ```bash theme={null} curl -X POST "https://api-v2.riqra.com/public/v1/orders/0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b/cancel" \ -H "Authorization: Bearer rq_live_tu_api_key" ``` Todos los campos del cuerpo son opcionales — la referencia del endpoint documenta cada uno y su valor por defecto: ```bash theme={null} curl -X POST "https://api-v2.riqra.com/public/v1/orders/0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b/cancel" \ -H "Authorization: Bearer rq_live_tu_api_key" \ -H "Content-Type: application/json" \ -d '{ "reason": "INVENTORY", "note": "Sin stock en almacén", "notifyCustomer": true }' ``` Un pedido en `AWAITING_REVIEW` también se puede cancelar: es la forma de rechazarlo. Para ese caso existe el motivo `REVIEW_REJECTED`, que solo se acepta mientras el pedido está en `AWAITING_REVIEW` y se rechaza en cualquier otro. El crédito vuelve a la línea del cliente y el stock sigue lo que indique `restock`, como en cualquier cancelación. ## Cómo leer un pedido cancelado El objeto `cancellation` es `null` mientras el pedido no esté cancelado. Cuando lo está, trae: | Campo | Contenido | | - | - | | `cancellation.reason` | El motivo elegido, o el código automático si lo canceló la plataforma. Trata cualquier valor desconocido como `OTHER`: los pedidos migrados conservan el motivo original de su plataforma de origen. | | `cancellation.note` | La nota interna. Nunca se le muestra al comprador. | | `cancellation.byMemberId`, `cancellation.byName` | El operador que canceló desde el panel. Ambos son `null` cuando canceló la plataforma o una integración: una API key identifica a la organización, no a una persona. | La fecha de cancelación sigue en la raíz del pedido, junto al resto de fechas del ciclo de vida: `cancelledAt`. # Preparación y entrega Source: https://docs.riqra.com/desarrolladores/api/guides/fulfillment Avanzar el estado de preparación de un pedido y registrar la guía. Estos endpoints avanzan la preparación de un pedido y registran la guía de seguimiento. Todos requieren el scope `fulfillment:write` y devuelven el pedido actualizado. ## Estados La preparación avanza en un solo sentido por esta escalera: ``` UNFULFILLED → IN_PROGRESS → FULFILLED → DELIVERED ``` * Solo avanza, nunca retrocede. * Se permiten saltos (por ejemplo de `UNFULFILLED` directo a `FULFILLED`). * Un avance inválido responde `422` con `code` `INVALID_FULFILLMENT_TRANSITION`. * Un pedido en `AWAITING_REVIEW` no se puede preparar: cualquier avance responde `409` con `code` `ORDER_AWAITING_REVIEW` hasta que el comercio lo apruebe y pase a `PLACED`. El estado vive en `fulfillmentStatus`, en la raíz del pedido. El despacho en sí — transportista, guía y fechas — viaja en `fulfillments`, vacío mientras el pedido siga `UNFULFILLED`. Hoy un pedido se prepara y despacha en un solo envío, así que la lista nunca trae más de un elemento. ## Endpoints | Acción | Endpoint | Lleva a | | - | - | - | | Iniciar preparación | `POST /orders/{id}/fulfillment/start` | `IN_PROGRESS` | | Despachar / marcar listo | `POST /orders/{id}/fulfillment/fulfill` | `FULFILLED` | | Actualizar guía | `PATCH /orders/{id}/fulfillment/tracking` | (sin cambio de estado) | | Marcar entregado | `POST /orders/{id}/fulfillment/deliver` | `DELIVERED` | ## Envío vs. recojo El comportamiento depende del tipo de entrega del pedido (`shippingMethod.type`): * **Envío (`DELIVERY`)**: puedes incluir la guía (`carrier`, `trackingNumber`, `trackingUrl`) al despachar o entregar. * **Recojo en agencia (`COURIER_PICKUP`)**: el pedido viaja hasta una agencia del courier (`courierBranch`) donde el comprador lo recoge. Admite guía igual que un envío. * **Recojo (`PICKUP`)**: no lleva guía. Envía un cuerpo vacío. Si la organización registró sus couriers, puedes enviar `courierId` en lugar de (o además de) `carrier`: el pedido queda asignado a ese courier, `carrier` toma su nombre y `trackingUrl` se deriva de su plantilla de seguimiento cuando la tiene. Si el comprador eligió el courier en el checkout, el pedido lo conserva: un `courierId` o un `carrier` distinto devuelve `422` con el código `ROUTE_COURIER_LOCKED`. `shippingMethod.payment` indica quién paga el flete: `PREPAID` (cobrado en el checkout) o `COLLECT` (flete por pagar al courier). ```bash theme={null} # Despachar un pedido de envío con guía curl -X POST "https://api-v2.riqra.com/public/v1/orders/0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b/fulfillment/fulfill" \ -H "Authorization: Bearer rq_live_tu_api_key" \ -H "Content-Type: application/json" \ -d '{ "carrier": "Olva", "trackingNumber": "OL123456", "trackingUrl": "https://track.olva.pe/OL123456" }' ``` ## Actualizar la guía `PATCH /orders/{id}/fulfillment/tracking` sobrescribe la guía de un pedido de envío ya despachado (`FULFILLED`). Requiere `carrier` y `trackingNumber`. Sobre un pedido que no es de envío responde `422` con `code` `ORDER_NOT_SHIPPABLE`. # Sincronizar precios Source: https://docs.riqra.com/desarrolladores/api/guides/prices Fija el precio de cada SKU por lista de precios, con precio plano o tramos por cantidad. Estos endpoints leen tus listas de precios y fijan precios por SKU y lista. Sirven para mantener los precios de Riqra alineados con tu ERP o sistema de gestión, incluidos precios distintos para grupos de clientes. ## Cómo llegan los precios al comprador Una **lista de precios** define cuánto cuesta cada variante. El comprador no elige la lista: la **política comercial** que le corresponde selecciona una, y el **segmento** al que pertenece la persona asigna esa política. Para que un grupo de clientes (por ejemplo, tus trabajadores o tus clientes VIP) vea precios distintos: 1. Crea la lista de precios en el panel y cárgala con esta API. 2. Crea una política comercial que seleccione esa lista. 3. Crea un segmento con esa política y asigna a las personas. La API solo escribe precios. Las listas, políticas y segmentos se administran desde el panel. Revisa [Listas de precios](/plataforma/precios/introduccion) y [Segmentos](/plataforma/clientes/segmentos). ## Endpoints | Acción | Endpoint | Scope | | - | - | - | | Listar listas activas | `GET /prices/lists` | `prices:read` | | Fijar precios | `POST /prices/set` | `prices:write` | ## Listar las listas de precios `GET /prices/lists` devuelve las listas activas con el `id` que necesitas para fijar precios. ```bash theme={null} curl "https://api-v2.riqra.com/public/v1/prices/lists" \ -H "Authorization: Bearer rq_live_tu_api_key" ``` ```json theme={null} { "priceLists": [ { "id": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b", "name": "Lista base", "sourcePriceListId": null, "adjustmentType": "NONE", "adjustmentValue": "0" }, { "id": "1c3d4e6f-8a9b-4c1d-9e3f-4a5b6c7d8e9f", "name": "Empleados", "sourcePriceListId": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b", "adjustmentType": "PERCENT_DOWN", "adjustmentValue": "15.00" } ] } ``` Una lista con `sourcePriceListId` en `null` es **independiente**: el precio de cada SKU es el que tú fijas. Una lista con `sourcePriceListId` es **derivada**: toma el precio de la lista origen y le aplica el ajuste (`PERCENT_DOWN` de `15.00` es un 15 % de descuento). En una lista derivada solo necesitas fijar los SKUs que se apartan de la regla. ## Fijar precios `POST /prices/set` recibe hasta 100 ítems. Cada ítem identifica un par SKU + lista y lleva **exactamente uno** de estos campos: * `price`: precio unitario plano. En una lista independiente es el precio de venta; en una lista derivada es un precio pactado que reemplaza al derivado. * `tiers`: la escalera completa de tramos por cantidad. ```bash theme={null} curl -X POST "https://api-v2.riqra.com/public/v1/prices/set" \ -H "Authorization: Bearer rq_live_tu_api_key" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "sku": "SKU-001", "priceListId": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b", "price": "12.50" }, { "sku": "SKU-001", "priceListId": "1c3d4e6f-8a9b-4c1d-9e3f-4a5b6c7d8e9f", "tiers": [ { "minQty": 1, "maxQty": 11, "price": "10.50" }, { "minQty": 12, "maxQty": null, "price": "9.90" } ] } ] }' ``` La respuesta es `200` siempre que el cuerpo sea válido. Cada fila trae su propio `status`, en el mismo orden del pedido: ```json theme={null} { "results": [ { "sku": "SKU-001", "priceListId": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b", "status": 200 }, { "sku": "SKU-001", "priceListId": "1c3d4e6f-8a9b-4c1d-9e3f-4a5b6c7d8e9f", "status": 200 } ] } ``` ### Reglas * La escritura es **absoluta**: el valor enviado reemplaza al almacenado, no es un incremento. * `price` y `tiers` son excluyentes en un mismo ítem, y el que envías **reemplaza al otro**: un precio plano borra los tramos del par, y una escalera borra el precio plano. * Los precios viajan como string decimal, sin signo y con hasta cuatro decimales. Un tramo debe tener precio mayor a cero. Revisa [Montos y moneda](/desarrolladores/api/money). * Una escalera empieza en cantidad `1`, es contigua, solo el último tramo queda abierto (`maxQty: null`) y tiene como máximo 15 tramos. Revisa [Tramos por cantidad](/plataforma/precios/tramos-por-cantidad). * El SKU debe coincidir exactamente con el de la variante, incluidas mayúsculas y minúsculas. * Un par SKU + lista repetido en el mismo pedido responde `400`. * La API no elimina precios ni crea listas. Ambas cosas se hacen desde el panel. ### Errores por fila | `code` | `status` | Cuándo | | - | - | - | | `SKU_NOT_FOUND` | `404` | Ninguna variante tiene ese SKU. | | `PRICE_LIST_NOT_FOUND` | `404` | La lista no existe en tu organización. | | `PRICE_LIST_INACTIVE` | `409` | La lista está inactiva. Actívala desde el panel. | Una fila con error no afecta a las demás: las filas válidas del mismo pedido se guardan. ## Flujo recomendado **1. Resuelve las listas una vez** Llama a `GET /prices/lists` y guarda el `id` de cada lista con la que trabajas. **2. Envía lotes de hasta 100 pares** Agrupa los cambios por SKU y lista. Puedes mezclar precios planos y tramos en un mismo lote. **3. Revisa las filas con error** Filtra los `results` con `status` distinto de `200`, corrige la causa (crear el SKU, activar la lista) y reenvía solo esas filas. Los cambios se reflejan en la tienda de inmediato. El buscador de la tienda se actualiza unos segundos después. # Leer pedidos Source: https://docs.riqra.com/desarrolladores/api/guides/reading-orders Filtrar, ordenar y sincronizar pedidos de forma incremental. El endpoint `GET /orders` devuelve los pedidos de tu organización, paginados por cursor y ordenados del más reciente al más antiguo por defecto. Requiere el scope `orders:read`. ## Filtros Combina cualquiera de estos parámetros de query: | Parámetro | Descripción | | - | - | | `status` | Estado del pedido: `PLACED`, `CANCELLED`, `AWAITING_REVIEW` (un pedido a crédito que superó la línea disponible del cliente y espera que el comercio lo apruebe —pasa a `PLACED`— o lo rechace —pasa a `CANCELLED`—; mientras tanto no se puede preparar, pagar ni facturar). | | `paymentStatus` | Estado de pago: `UNPAID`, `PARTIALLY_PAID`, `PAID`, `PENDING` (hay un intento de cobro abierto, se resuelve solo), `ERROR` (no se resolvió; el comercio debe verificar en la pasarela). | | `fulfillmentStatus` | Estado de preparación: `UNFULFILLED`, `IN_PROGRESS`, `FULFILLED`, `DELIVERED`. | | `invoiceStatus` | Estado de facturación: `NOT_INVOICED` (la cola de pedidos que aún necesitan comprobante), `INVOICED`. | | `source` | Origen del pedido: `STOREFRONT`. | | `customerId` | Pedidos de un cliente (UUID). | | `number` | Número de pedido. Acepta el entero o el formato `#123`. | | `createdAfter`, `createdBefore` | Rango por fecha de creación (ISO-8601 con zona horaria). | | `updatedAfter`, `updatedBefore` | Rango por fecha de actualización (ISO-8601 con zona horaria). | ## Orden | Parámetro | Valores | Por defecto | | - | - | - | | `sort` | `createdAt`, `updatedAt` | `createdAt` | | `order` | `asc`, `desc` | `desc` | > [!NOTE] > > Las fechas deben incluir zona horaria (offset o `Z`). Una fecha sin zona se rechaza con `400` > para que un punto de sincronización no se corra por la zona horaria del servidor. ## Sincronización incremental Para mantener una copia al día sin volver a leer todo, ordena por `updatedAt` ascendente y filtra desde la última fecha que procesaste (tu *watermark*). ```bash theme={null} curl "https://api-v2.riqra.com/public/v1/orders?sort=updatedAt&order=asc&updatedAfter=2026-06-01T00:00:00Z&limit=100" \ -H "Authorization: Bearer rq_live_tu_api_key" ``` En cada corrida: 1. Lee desde tu watermark con `updatedAfter`. 2. Recorre todas las páginas con `nextCursor` (revisa [Paginación](/desarrolladores/api/pagination)). 3. Guarda el `updatedAt` más alto que viste como nuevo watermark. El campo `updatedAt` se expone justamente para este patrón. ## Líneas de paquetes (bundles) Cuando una línea corresponde a un paquete, su campo `components` trae la composición del paquete congelada al momento del pedido — aunque el paquete cambie después, el pedido conserva lo que se vendió. En líneas de productos normales, `components` es un arreglo vacío. Cada componente incluye `quantityPerBundle`: las unidades dentro de un paquete. Para saber las unidades totales a preparar para la línea, multiplícalo por el `quantity` de la línea (en el ejemplo: 6 × 2 = 12 gaseosas). ```json theme={null} { "productName": "Six-pack Gaseosa", "quantity": 2, "components": [ { "productName": "Gaseosa 500ml", "variantSku": "GAS-500", "quantityPerBundle": 6 } ] } ``` ## Transacciones de pago El campo `transactions` trae el historial de cobros con pasarela del pedido, ordenado del intento más antiguo al más reciente. Los pedidos pagados por medios manuales (efectivo, transferencia registrada por el comercio) traen un arreglo vacío — ese pago se refleja en `paymentStatus`, `payment.paidAt` y `payment.amountPaid`. Cada transacción incluye el tipo de operación (`kind`: `SALE`, `AUTHORIZATION`), su resultado (`status`: `SUCCESS`, `FAILURE`, `PENDING`, `ERROR`), el monto en unidades mayores (misma moneda del pedido) y, para cobros con tarjeta, los datos enmascarados: `cardBrand`, `cardLast4` y `cardType` (`CREDIT`, `DEBIT`, `PREPAID`, `UNKNOWN`). ```json theme={null} { "kind": "SALE", "status": "SUCCESS", "amount": "159.90", "provider": "OPENPAY", "gatewayTransactionId": "trzt8m4kqxxi3yzptkm2", "cardBrand": "visa", "cardLast4": "4242", "cardType": "DEBIT", "installments": 6, "installmentsInterest": "WITHOUT_INTEREST", "authorizationCode": "801585", "gatewayResultCode": null, "errorCode": null, "test": false, "processedAt": "2026-07-30T14:03:40Z", "createdAt": "2026-07-30T14:03:39Z" } ``` Para conciliar contra la pasarela usa `gatewayTransactionId` (el identificador del cobro en la pasarela). En intentos fallidos, `errorCode` trae un código normalizado independiente de la pasarela (por ejemplo `INSUFFICIENT_FUNDS`, `EXPIRED_CARD`, `CARD_DECLINED`) y `gatewayResultCode` conserva el código crudo del proveedor. ### Cuotas El pedido se crea antes de cobrarse y guarda lo que el comprador eligió, así que `payment.installments` es siempre su última selección. Con tarjeta, mientras el pedido no esté pagado eso es una intención: si el cobro se rechaza y el comprador reintenta con otro número de cuotas, el pedido pasa a mostrar el nuevo. Una vez pagado, esa selección es la que se cobró. Es `null` cuando el pago va en una sola cuota. ## Un pedido `GET /orders/{id}` devuelve un solo pedido por su UUID. Si no existe en tu organización, responde `404` con `code` `RESOURCE_MISSING`. # Sincronizar stock Source: https://docs.riqra.com/desarrolladores/api/guides/stock Fija el stock disponible por SKU y ubicación desde tu sistema de inventario. Estos endpoints leen tus ubicaciones y fijan el stock de cada SKU en cada una. Sirven para que tu ERP o WMS mantenga el stock de Riqra al día, también cuando vendes desde más de un almacén. ## Endpoints | Acción | Endpoint | Scope | | - | - | - | | Listar ubicaciones activas | `GET /stock/locations` | `stock:read` | | Fijar stock | `POST /stock/levels/set` | `stock:write` | ## Listar las ubicaciones `GET /stock/locations` devuelve las ubicaciones activas con el `id` que necesitas para fijar stock. Las ubicaciones se crean desde el panel; revisa [Ubicaciones](/plataforma/inventario/ubicaciones). ```bash theme={null} curl "https://api-v2.riqra.com/public/v1/stock/locations" \ -H "Authorization: Bearer rq_live_tu_api_key" ``` ```json theme={null} { "locations": [ { "id": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b", "name": "Almacén Lima", "isDefault": true }, { "id": "1c3d4e6f-8a9b-4c1d-9e3f-4a5b6c7d8e9f", "name": "Almacén Chincha", "isDefault": false } ] } ``` ## Fijar stock `POST /stock/levels/set` recibe hasta 100 ítems. Cada ítem identifica un par SKU + ubicación y lleva **exactamente uno** de estos campos: * `onHand`: cantidad física en la ubicación. * `available`: cantidad vendible. Riqra guarda `onHand = available + committed`, donde `committed` son las unidades reservadas por pedidos abiertos. ```bash theme={null} curl -X POST "https://api-v2.riqra.com/public/v1/stock/levels/set" \ -H "Authorization: Bearer rq_live_tu_api_key" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "sku": "SKU-001", "locationId": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b", "available": 120 }, { "sku": "SKU-001", "locationId": "1c3d4e6f-8a9b-4c1d-9e3f-4a5b6c7d8e9f", "onHand": 35 } ] }' ``` La respuesta es `200` siempre que el cuerpo sea válido. Cada fila trae su propio `status`, en el mismo orden del pedido: ```json theme={null} { "results": [ { "sku": "SKU-001", "locationId": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b", "status": 200, "onHand": 123, "committed": 3, "available": 120 }, { "sku": "SKU-001", "locationId": "1c3d4e6f-8a9b-4c1d-9e3f-4a5b6c7d8e9f", "status": 200, "onHand": 35, "committed": 0, "available": 35 } ] } ``` ### Reglas * La escritura es **absoluta**: el valor enviado reemplaza al almacenado, no es un incremento. * `committed` lo administra Riqra a partir de los pedidos. La API nunca lo escribe. * Un `onHand` menor que `committed` responde `STOCK_BELOW_COMMITTED` en esa fila. Si tu sistema conoce el stock vendible, envía `available` y ese error nunca ocurre. * Fijar stock de un SKU en una ubicación lo marca como **vendido en esa ubicación**, aunque la cantidad sea `0` (aparece como agotado). Para dejar de vender un SKU en una ubicación usa el panel. * El SKU debe coincidir exactamente con el de la variante, incluidas mayúsculas y minúsculas. * Un par SKU + ubicación repetido en el mismo pedido responde `400`. ### Errores por fila | `code` | `status` | Cuándo | | - | - | - | | `SKU_NOT_FOUND` | `404` | Ninguna variante tiene ese SKU. | | `LOCATION_NOT_FOUND` | `404` | La ubicación no existe en tu organización. | | `LOCATION_INACTIVE` | `409` | La ubicación está desactivada. | | `STOCK_BELOW_COMMITTED` | `422` | El `onHand` enviado es menor que las unidades reservadas. | Una fila con error no afecta a las demás: las filas válidas del mismo pedido se guardan. ## Stock por ubicación y por comprador Cada **política comercial** decide desde qué ubicaciones compran las personas a las que aplica. Si una política selecciona una sola ubicación, sus compradores ven únicamente el stock de esa ubicación en el catálogo, el carrito y el checkout, y sus pedidos descuentan de ella. Así, un segmento de trabajadores de una sede puede comprar solo con el stock de esa sede. Una política sin ubicaciones seleccionadas muestra la mejor disponibilidad entre todas las ubicaciones activas. Si alimentas más de un almacén por esta API, asigna a cada política las ubicaciones que le corresponden desde el panel. # Versionado Source: https://docs.riqra.com/desarrolladores/api/versioning Cómo se versiona la API y qué cambios son compatibles. La versión va en la ruta. La versión actual es **v1**: ``` https://api-v2.riqra.com/public/v1 ``` ## Cambios compatibles Dentro de `v1` agregamos funcionalidad de forma **aditiva**. Estos cambios no rompen tu integración y pueden ocurrir sin aviso: * Nuevos endpoints. * Nuevos campos opcionales en una respuesta. * Nuevos valores en un campo de tipo enumerado. * Nuevos parámetros opcionales en una request. > [!NOTE] > > Diseña tu integración para tolerar campos y valores nuevos: ignora los campos que no conozcas y > no falles ante un valor de enum inesperado. ## Cambios incompatibles Un cambio que rompa el contrato (quitar un campo, cambiar un tipo, cambiar el significado de un valor) se publicaría bajo una nueva versión de ruta (`/public/v2`), no dentro de `v1`. ## Especificación La especificación OpenAPI de la API está disponible en: ``` https://api-v2.riqra.com/public/v1/openapi.json ``` # Anatomía de un tema Source: https://docs.riqra.com/desarrolladores/temas/anatomia-de-un-tema El árbol de archivos de un tema: secciones, snippets, plantillas, configuración y assets. Un tema es un directorio plano con esta estructura (es lo que genera `riqra-theme init`): ```text theme={null} mi-tema/ ├── config/ │ └── settings_schema.json # settings globales + theme_info ├── templates/ │ ├── index.json # home │ ├── product.json │ ├── collection.json │ ├── search.json │ ├── cart.json │ └── page.json ├── sections/ │ ├── header.liquid # secciones con {% schema %} │ ├── slideshow.liquid │ ├── … │ ├── header-group.json # grupo de encabezado │ └── footer-group.json # grupo de pie ├── snippets/ │ └── product-card.liquid # parciales para {% render %} └── assets/ ├── theme.css # enlazado automáticamente └── theme.js # enlazado automáticamente ``` No existen `layout/`, `locales/` ni `blocks/` como carpetas: el framework es dueño del documento HTML, los textos van inline en español y los bloques se declaran dentro del `{% schema %}` de cada sección. ## `config/settings_schema.json` Un arreglo de grupos de settings globales. La entrada `theme_info` es obligatoria y lleva los metadatos del tema: ```json theme={null} [ { "name": "theme_info", "theme_name": "Origin", "theme_author": "Riqra", "color_scheme": "only light" }, { "name": "Colores de marca", "settings": [ { "type": "color", "id": "brand_primary", "label": "Color primario", "default": "#234E52" } ] } ] ``` `color_scheme` es una extensión de Riqra: declara el esquema de color CSS para el que está diseñado el tema. El detalle de los grupos y tipos está en [Secciones y schema](/desarrolladores/temas/secciones-y-schema). ## `templates/*.json` Plantillas JSON al estilo OS 2.0: instancias de sección con clave propia más un arreglo `order`. Este es el `index.json` de Origin: ```json theme={null} { "sections": { "hero-1": { "type": "slideshow", "settings": { "autoplay": true, "interval_ms": 3000 } }, "featured-1": { "type": "featured-collection", "settings": {} } }, "order": ["hero-1", "featured-1"] } ``` > [!NOTE] > > Las plantillas subidas son **defaults**. La personalización del comerciante (secciones agregadas, settings cambiados) vive en la base de datos y siempre gana; una re-subida del tema nunca la sobreescribe. ## `sections/*.liquid` Cada sección es un archivo Liquid con un bloque `{% schema %}` al final que declara su nombre, settings, bloques y ubicaciones permitidas. Las secciones se renderizan en el servidor y el framework las envuelve en `
`. ## `sections/{header,footer}-group.json` Los grupos de encabezado y pie envuelven todas las páginas — incluidas las rutas propias del framework como el checkout de carrito. Formato igual a una plantilla, más `type`, `name` y el opcional `sticky`: ```json theme={null} { "type": "header", "name": "Encabezado", "sticky": false, "sections": { "announcement-1": { "type": "announcement-bar", "settings": {} }, "header-1": { "type": "header", "settings": { "menu": "main-menu" } } }, "order": ["announcement-1", "header-1"] } ``` ## `snippets/` Parciales invocados con `{% render 'nombre' %}`. Como en el Shopify moderno, `render` es aislado: el snippet solo ve los argumentos que le pasas. ```liquid theme={null} {%- render 'product-card', product: card, section_id: section.id -%} ``` > [!WARNING] > > No nombres un argumento de `render` igual que una clave global (`settings`, `cart`, `shop`, …) ni que una meta-propiedad de Liquid como `size` — colisionan al resolverse dentro del snippet. Usa nombres propios: `card_size`, `items_per_row`. ## `assets/` Archivos estáticos servidos desde el CDN. `assets/theme.css` y `assets/theme.js` se enlazan **automáticamente** en todas las páginas — no hay `theme.liquid` donde enlazarlos a mano. El resto de assets se referencia con el filtro `asset_url`: ```liquid theme={null} Logo ``` # Carrito AJAX y secciones Source: https://docs.riqra.com/desarrolladores/temas/cart-ajax-y-secciones Los endpoints AJAX del carrito, el Section Rendering API y los eventos del tema. El JavaScript del tema habla con la tienda por endpoints al estilo Shopify. Todos los montos son **centavos enteros** y todas las respuestas de carrito comparten una misma forma (el carrito completo), también en `add.js`. | Endpoint | Método | Para qué | | - | - | - | | `/cart.js` | GET | Leer el carrito actual. | | `/cart/add.js` | POST | Agregar una variante. | | `/cart/change.js` | POST | Cambiar la cantidad de una línea (0 la elimina). | | `/cart/update.js` | POST | Cambiar varias líneas en un solo request. | | `/cart/clear.js` | POST | Vaciar el carrito. | | `/cart/add` | POST | Fallback sin JavaScript de `{% form 'product' %}`; redirige a `/cart`. | | `/products/{handle}.js` | GET | JSON del producto (variantes, precios, disponibilidad). | | `/api/sections` | GET | Re-renderizar secciones de una ruta (Section Rendering API). | ## Leer el carrito ```js theme={null} const cart = await fetch("/cart.js").then((res) => res.json()); // { token, item_count, items: [...], total_price, original_total_price, total_discount, currency } ``` Cada línea trae `id`, `variant_id`, `quantity`, `title`, `variant_title`, `sku`, `price`, `line_price`, `final_line_price`, `image`, `url` y `available`. `image` es la primera imagen de la variante o, si no tiene, la portada del producto. ## Escribir en el carrito Los cuatro endpoints de escritura aceptan JSON (o form-encoded) y responden con el carrito completo: ```js theme={null} // Agregar: id = id de variante await fetch("/cart/add.js", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ id: variantId, quantity: 2 }), }); // Cambiar una línea; quantity: 0 la elimina await fetch("/cart/change.js", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ id: variantId, quantity: 0 }), }); // Varias líneas de una vez await fetch("/cart/update.js", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ updates: { [variantIdA]: 3, [variantIdB]: 0 } }), }); ``` Un error de negocio (sin stock, cantidad inválida) responde `422` con `{ status, message, description }`. Las cantidades aterrizan en la regla de la variante (`quantity_rule`, ver [JSON de producto](#json-de-producto)) antes de guardarse, así que la respuesta trae la cantidad que quedó y no la enviada. `add.js` redondea la línea resultante hacia arriba: agregar 1 de una variante que se vende en cajas de 12 deja la línea en 12. `change.js` y `update.js` llevan la cantidad enviada al múltiplo más cercano (los empates suben), sin importar cuánto tenía la línea: repetir la misma petición deja la misma cantidad. Por debajo de `min` la línea cae en `min`; solo la cantidad `0` la elimina. Ambas acotan entre `min` y `max`. El stock nunca entra en ese ajuste: una cantidad por encima del disponible responde `422`. Después de cada escritura exitosa, anuncia el cambio al resto del tema: ```js theme={null} window.dispatchEvent(new Event("riqra:cart-changed")); ``` > [!NOTE] > > Las analíticas no piden código del tema: cada agregado por `/cart/add.js` o `/cart/add` llega a Tráfico y a las etiquetas de la tienda (GA4, GTM, Meta Pixel) como `product_added_to_cart`, con el producto, el SKU y el precio de la línea. La tienda lo publica al recibir `riqra:cart-changed`; si el tema no lo despacha, con la siguiente vista de página. ## Secciones re-renderizadas en la misma respuesta Igual que en Shopify, las escrituras aceptan un parámetro `sections` para que la respuesta incluya el HTML actualizado de las secciones que nombres — un solo round-trip actualiza estado y DOM: ```js theme={null} const res = await fetch("/cart/add.js", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ id: variantId, quantity: 1, sections: "cart-1,header-1", sections_url: "/cart", }), }).then((r) => r.json()); // res.sections → { "cart-1": "
…
", "header-1": "…" } ``` `sections_url` es la ruta contra la que se renderizan (por defecto `/cart`). Cada fragmento llega con su wrapper `riqra-section-{id}` incluido: reemplaza el nodo completo. ## Section Rendering API Fuera de las escrituras de carrito, `GET /api/sections` re-renderiza secciones de cualquier ruta con superficie de tema — filtros de colección, mini-carrito, etc.: ```js theme={null} const sections = await fetch( `/api/sections?path=${encodeURIComponent("/collections/ofertas?brand=acme")}§ions=main-collection`, ).then((res) => res.json()); // { "main-collection": "
…
" } ``` > [!NOTE] > > A diferencia de Shopify, `?sections=` no se intercepta sobre las URLs de página: usa siempre este endpoint. Al reemplazar el HTML de una sección, despacha `riqra:section:load` sobre el nodo nuevo para que los scripts que escuchan ese evento se re-inicialicen (los custom elements se re-montan solos): ```js theme={null} function swapSection(id, html) { const target = document.getElementById(`riqra-section-${id}`); if (!target || typeof html !== "string") return; target.outerHTML = html; document .getElementById(`riqra-section-${id}`) ?.dispatchEvent(new Event("riqra:section:load", { bubbles: true })); } ``` El personalizador del panel usa este mismo evento cuando refresca secciones en la vista previa. ## Eventos del tema | Evento | Se despacha | Escúchalo para | | - | - | - | | `riqra:cart-changed` | En `window`, tras cualquier escritura de carrito. | Refrescar el contador del header, el mini-carrito, etc. | | `riqra:section:load` | Sobre una sección cuyo HTML acaba de reemplazarse. | Re-inicializar listeners no basados en custom elements. | Origin resume el patrón completo — un snapshot compartido del carrito, invalidado por el evento: ```js theme={null} let cartSnapshot = null; function readCart() { cartSnapshot ??= fetch("/cart.js") .then((res) => (res.ok ? res.json() : null)) .catch(() => null); return cartSnapshot; } window.addEventListener("riqra:cart-changed", () => { cartSnapshot = null; }); ``` ## JSON de producto Para pickers de variantes o vistas rápidas: ```js theme={null} const product = await fetch(`/products/${handle}.js`).then((res) => res.json()); // { id, title, handle, url, vendor, available, price, price_min, price_max, // compare_at_price, images, featured_image, variants: [...] } ``` `compare_at_price` mayor que `price` es la señal de oferta — los badges de descuento se derivan de esa comparación, no de un objeto de promociones. Cada variante trae `quantity_rule` con la forma de Shopify: `{ min, max, increment }`. Las cantidades válidas son los múltiplos de `increment` entre `min` y `max`; `max` es `null` cuando no hay tope. Una variante sin regla trae `{ min: 1, max: null, increment: 1 }`. Cada variante trae también `images` y `featured_image`: sus propias imágenes o, si no tiene, las del producto. `images` del producto no incluye las de las variantes. # Ciclo de desarrollo Source: https://docs.riqra.com/desarrolladores/temas/ciclo-de-desarrollo Del borrador con dev a la tienda del cliente: push, riqra.theme.json y la entrega a producción. ## El bucle de desarrollo `riqra-theme dev` es el bucle diario. En cada guardado el CLI valida el tema (el mismo `check` que corre el servidor), lo comprime y sube un **tema de desarrollo** con su instalación en borrador: ```text theme={null} $ riqra-theme dev Watching /work/mi-tema Preview: https://acme.riqra.site/?preview_theme_id=…&preview_token=… Draft install expires 2026-07-25T14:02:11.000Z ✓ updated 14:02:11 ``` * La URL de vista previa renderiza el borrador solo para quien la tiene; el resto de visitantes sigue viendo el tema publicado. * La página de vista previa detecta cada push y se recarga sola — no necesitas refrescar. * Si `check` falla, el CLI imprime los diagnósticos y espera el siguiente guardado; no sube nada roto. > [!WARNING] > > El tema de desarrollo y su borrador expiran a los **7 días**. Cada push de `dev` renueva el plazo, así que solo caduca si dejas de trabajar; al expirar, la plataforma lo elimina y `dev` crea uno nuevo en el siguiente arranque. ## Publicar una versión con `push` Cuando el trabajo está listo para compartirse, `push` sube el tema con su identidad definitiva: ```bash theme={null} riqra-theme push --theme acme-2026 ``` ```text theme={null} ✓ Pushed acme-2026 (version 3f9c21ab) ``` * El slug se pasa con `--theme` la primera vez; un push exitoso lo guarda en `riqra.theme.json` y los siguientes ya no lo necesitan. * Cada push calcula una versión por contenido (`versionHash`). Re-subir sin cambios es un no-op barato. * Un push **reemplaza el contenido del tema en su lugar**: toda tienda que lo tenga instalado pasa a servir la nueva versión. ### `riqra.theme.json` Archivo de proyecto del tema, versionado junto al código: ```json theme={null} { "theme": { "slug": "acme-2026" } } ``` `push` y `pull` lo leen para saber sobre qué tema operar, y `push` lo actualiza tras la primera subida. ## Entrega a producción Subir nunca publica. La entrega a la tienda del cliente está mediada por Riqra: 1. La agencia hace `push` del tema final; queda disponible en el registro de la organización. 2. El staff de Riqra lo instala en la tienda del cliente como instalación **no publicada**. 3. El comerciante (o el staff) revisa, personaliza y lo **activa** desde el panel. La activación es un intercambio atómico: el tema anterior pasa a no publicado y conserva su personalización. ## Versionado: no hay Un tema no tiene versiones ni migraciones. Re-subir actualiza en su lugar, así que cada push debe ser compatible con la personalización que el comerciante ya guardó (mismos ids de settings, mismos tipos de sección). Un rediseño incompatible no se sube encima: se entrega como **un tema nuevo** con otro slug, se instala junto al actual y se activa cuando el cliente esté listo. # Introducción Source: https://docs.riqra.com/desarrolladores/temas/introduccion Qué es un tema de Riqra y cómo se reparte el trabajo entre la agencia, Riqra y el comerciante. Un tema define la cara de una tienda online de Riqra: un árbol de archivos Liquid + JSON que la plataforma valida al subirse, almacena e interpreta en el servidor en cada request. No compilas ni despliegas código — el tema es datos subidos y la plataforma es quien lo ejecuta. Si vienes de Shopify, la gramática te va a resultar familiar a propósito: secciones OS 2.0 con `{% schema %}`, plantillas JSON, `settings_schema.json`, snippets con `{% render %}`. Las diferencias deliberadas están documentadas en [Viniendo de Shopify](/desarrolladores/temas/viniendo-de-shopify). ## El modelo 1. La agencia escribe el tema: secciones (`sections/*.liquid`), snippets, plantillas JSON, configuración y assets. [Anatomía de un tema](/desarrolladores/temas/anatomia-de-un-tema) describe el árbol completo. 2. Lo valida localmente (`riqra-theme check`) y lo sube (`riqra-theme push`) con el CLI, autenticada con un token de acceso. 3. La plataforma ejecuta la misma validación en el servidor, guarda los archivos e interpreta el Liquid en cada visita. 4. El comerciante personaliza el tema desde el personalizador del panel: settings globales y secciones por página. Esa personalización vive en la base de datos — una re-subida del tema nunca la pisa. ## Estados de un tema en una tienda Una tienda puede tener varios temas instalados, con exactamente uno publicado: | Estado | Qué significa | | - | - | | **Publicado** | El tema en vivo: lo ven los compradores y es el que edita el personalizador. | | **No publicado** | Instalado en la biblioteca de la tienda con su propia personalización guardada. Activarlo lo vuelve el publicado (intercambio atómico). | | **Desarrollo** | Borrador temporal creado por `riqra-theme dev`, visible solo con su URL de vista previa. Expira a los 7 días. | ## Quién hace qué | Rol | Responsabilidad | | - | - | | **Agencia** | Desarrolla el tema, lo valida, lo sube y lo itera con el CLI. | | **Riqra (staff)** | Emite y revoca los tokens de acceso, prepara la tienda de desarrollo e instala el tema en la tienda del cliente. | | **Comerciante** | Personaliza el tema instalado y lo publica. | Subir un tema nunca cambia lo que ven los compradores: la activación es siempre un acto humano en el panel. El detalle del flujo está en [Ciclo de desarrollo](/desarrolladores/temas/ciclo-de-desarrollo). ## Siguientes pasos * [Primeros pasos](/desarrolladores/temas/primeros-pasos) — instala el CLI y levanta tu primer tema. * [Secciones y schema](/desarrolladores/temas/secciones-y-schema) — la gramática de `{% schema %}` completa. # Primeros pasos Source: https://docs.riqra.com/desarrolladores/temas/primeros-pasos Instala el CLI, obtén tu token de acceso y levanta un tema sobre una tienda de desarrollo. **1. Instala el CLI** Descarga el binario `riqra-theme` para tu sistema desde los [GitHub Releases de riqra/theme-cli](https://github.com/riqra/theme-cli/releases) y colócalo en tu `PATH`. ```bash theme={null} riqra-theme --version ``` **2. Pide una tienda de desarrollo y un token** Tu contacto en Riqra crea una tienda de desarrollo para el proyecto y emite un **token de acceso de tema** (empieza con `riqthm_`). El token queda ligado a esa tienda: define contra qué tienda trabajan `dev`, `push` y `pull`. El secreto se muestra una sola vez al emitirse — guárdalo en un gestor de secretos. Si se pierde o se filtra, Riqra lo revoca y emite uno nuevo. **3. Inicia sesión** ```bash theme={null} riqra-theme login ``` Valida el token contra la API y lo guarda en `~/.riqra/credentials.json`. En CI puedes omitir `login` y exportar `RIQRA_THEME_TOKEN` en su lugar. ```text theme={null} Logged in to https://api.riqra.com Organization: Acme Foods Storefront: acme.riqra.site Token: Agencia Acme (expires never) ``` **4. Crea el tema** ```bash theme={null} riqra-theme init mi-tema cd mi-tema ``` Genera un tema funcional a partir del esqueleto de Origin (el tema base de Riqra). Funciona sin conexión. Valídalo de inmediato: ```bash theme={null} riqra-theme check ``` **5. Desarrolla en vivo** ```bash theme={null} riqra-theme dev ``` Sube un borrador a tu tienda de desarrollo, imprime la URL de vista previa y re-sube en cada guardado; la página de vista previa se recarga sola. Ctrl-C para salir. ## Siguientes pasos * [Ciclo de desarrollo](/desarrolladores/temas/ciclo-de-desarrollo) — `dev`, `push`, `riqra.theme.json` y la entrega a producción. * [Referencia del CLI](/desarrolladores/temas/referencia-cli) — todos los comandos y sus opciones. # Referencia del CLI Source: https://docs.riqra.com/desarrolladores/temas/referencia-cli Todos los comandos de riqra-theme y sus opciones. ```text theme={null} riqra-theme — Riqra storefront theme CLI Usage: riqra-theme [options] Commands: login Validate and store a theme access token logout Remove the stored token for an API URL init Scaffold a new theme from the Origin skeleton list List the themes uploaded by your organization check Validate the theme locally push Validate, zip and upload the theme dev Watch the theme and live-push a draft preview pull Download a theme's files from the server ``` Opciones globales: `-h, --help` (también por comando: `riqra-theme push --help`) y `-v, --version`. ## Variables de entorno | Variable | Uso | | - | - | | `RIQRA_THEME_TOKEN` | Token de acceso (`riqthm_...`); tiene prioridad sobre el guardado. Útil en CI. | | `RIQRA_API_URL` | URL base de la API (por defecto `https://api.riqra.com`). | Los comandos que hablan con la API (`login`, `logout`, `list`, `push`, `dev`, `pull`) también aceptan `--api ` y `--token ` como overrides puntuales. ## login ```bash theme={null} riqra-theme login [--token ] [--api ] ``` Valida un token de acceso contra la API y lo guarda para esa URL en `~/.riqra/credentials.json` (un token por URL de API). El token sale de `--token`, de `RIQRA_THEME_TOKEN` o de un prompt interactivo. Al validar imprime la organización, la tienda y la expiración del token. ## logout ```bash theme={null} riqra-theme logout [--api ] ``` Elimina el token guardado para la URL de API. ## init ```bash theme={null} riqra-theme init [name] [--path ] ``` Genera un tema nuevo a partir del esqueleto de Origin. Funciona sin conexión. * `name` — carpeta destino (por defecto `mi-tema`); `--path` la reemplaza. * Se niega a escribir sobre un directorio no vacío. ## list ```bash theme={null} riqra-theme list [--json] ``` Lista los temas subidos por tu organización: slug, nombre, tipo, versión (`versionHash` corto) y fecha de actualización. ## check ```bash theme={null} riqra-theme check [--path ] [--json] ``` Valida el árbol del tema localmente — estructura, parseo del Liquid, `{% schema %}`, JSON de plantillas y referencias cruzadas. Es la misma validación que ejecuta el servidor al subir. Sale con código 1 si hay errores; `--json` imprime los diagnósticos como JSON. ## push ```bash theme={null} riqra-theme push [--path ] [--theme ] [--name ] [--json] ``` Valida localmente, comprime el tema y lo sube. * El slug viene de `--theme` o de `riqra.theme.json`; un push exitoso lo guarda de vuelta ahí. * `--name` fija el nombre visible del tema (por defecto, el slug). * Si el servidor rechaza la subida (`422`), imprime los diagnósticos del servidor y sale con código 1. ## dev ```bash theme={null} riqra-theme dev [--path ] [--no-open] ``` Sube una instalación en borrador y re-sube en cada guardado. La URL de vista previa renderiza el borrador y la plataforma lo recarga sola tras cada push. En macOS abre la vista previa en el navegador, salvo con `--no-open`. Ctrl-C para salir. El tema de desarrollo y su borrador expiran a los 7 días; cada push renueva el plazo. ## pull ```bash theme={null} riqra-theme pull [--theme ] [--path ] [--force] ``` Descarga los archivos del tema desde el servidor. * El slug viene de `--theme` o del `riqra.theme.json` del directorio. * No sobreescribe archivos con modificaciones locales (los lista y sale con código 1); usa `--force` para forzarlo. # Secciones y schema Source: https://docs.riqra.com/desarrolladores/temas/secciones-y-schema La gramática de {% schema %}: tipos de setting, bloques, presets, ubicaciones y settings_schema.json. Cada sección declara su superficie editable en un bloque `{% schema %}` con JSON, al final del archivo. Es lo que el personalizador le muestra al comerciante y lo que la validación de subida verifica. Un ejemplo real de Origin: ```liquid theme={null} {% schema %} { "name": "Barra de anuncios", "enabled_on": { "groups": ["header"] }, "limit": 1, "settings": [ { "type": "text", "id": "message", "label": "Mensaje", "default": "" }, { "type": "url", "id": "link", "label": "Enlace" }, { "type": "checkbox", "id": "open_in_new_tab", "label": "Abrir en nueva pestaña", "default": false } ] } {% endschema %} ``` En el Liquid de la sección lees los valores con `section.settings.`; los settings globales de `settings_schema.json` con `settings.`. ## Tipos de setting Cada setting lleva `type`, `id` y `label`, más `default`, `info` y `placeholder` opcionales. Los tipos soportados son exactamente estos (cualquier otro es un error de validación): | Tipo | Guarda | Notas | | - | - | - | | `text` | string | Texto de una línea. | | `textarea` | string | Texto de varias líneas. | | `richtext` | string (HTML) | Texto enriquecido; el HTML se sanitiza en el servidor antes de llegar al drop. | | `color` | string | Color en hex, p. ej. `#407EFF`. | | `url` | string | URL escrita o elegida con el selector de recursos (colecciones, productos, páginas). | | `image_picker` | imagen | Imagen de la biblioteca de archivos del comercio. Se imprime como su URL, así que úsala con `image_url`, y expone `width` y `height` en píxeles cuando se conocen. | | `number` | number | Número libre. | | `range` | number | Número acotado con `min`, `max` y `step`. | | `checkbox` | boolean | Casilla. | | `select` | string | Una opción de `options: [{ "value", "label" }]`. | | `font_picker` | string | Familia tipográfica del catálogo de fuentes. | | `collection` | string (handle) | Referencia a una colección; resuélvela con `collections[section.settings.]`. | | `link_list` | string (handle) | Referencia a un menú de navegación; resuélvela con `linklists[section.settings.]`. | | `color_scheme` | string (id) | Referencia a un esquema de color del tema. Solo en secciones. | | `color_scheme_group` | — | La lista editable de esquemas de color. Solo en `settings_schema.json`. | | `header` | — | Encabezado no editable que agrupa settings. Lleva `content` en vez de `id`/`label`. | ```json theme={null} { "type": "header", "content": "Barra de contacto" }, { "type": "checkbox", "id": "show_contact_bar", "label": "Mostrar barra de contacto", "default": true } ``` ## Bloques `blocks` declara los elementos repetibles de la sección; el comerciante los agrega, reordena y elimina. En Liquid se iteran con `section.blocks` y cada uno expone `block.type`, `block.settings` y `block.shopify_attributes` (atributos para el resaltado en el personalizador). ```json theme={null} "blocks": [ { "type": "slide", "name": "Banner", "settings": [ { "type": "image_picker", "id": "image", "label": "Imagen" }, { "type": "url", "id": "link", "label": "Enlace" } ] } ] ``` ```liquid theme={null} {%- for block in section.blocks -%}
…
{%- endfor -%} ``` * `limit` en un bloque acota cuántas instancias de ese tipo se pueden agregar. * `max_blocks` en la raíz del schema acota el total de bloques de la sección. * `"static": true` (extensión de Riqra) marca un bloque fijo: existe exactamente una vez, se crea solo y queda anclado en el editor — el comerciante edita sus settings pero no puede quitarlo ni duplicarlo. ## Presets `presets` define las variantes con las que la sección aparece en el panel "Agregar sección", con settings y bloques iniciales: ```json theme={null} "presets": [ { "name": "Carrusel de banners", "settings": { "autoplay": true }, "blocks": [{ "type": "slide" }, { "type": "slide" }] } ] ``` ## Ubicaciones y límites * `limit` (raíz): máximo de instancias de la sección por plantilla, p. ej. `"limit": 1` para un encabezado único. * `enabled_on` / `disabled_on`: restringen dónde puede agregarse la sección, por plantilla (`templates: ["index", "collection", …]`) o por grupo (`groups: ["header", "footer"]`). Usa uno u otro, no ambos. ```json theme={null} "enabled_on": { "templates": ["index", "page"] } ``` * `tag` y `class` se aceptan por compatibilidad con Shopify pero se ignoran: el framework es dueño del wrapper `riqra-section-{id}`. ## `config/settings_schema.json` Los settings globales del tema — la pestaña "Configuración del tema" del personalizador — se declaran como un arreglo de grupos con nombre. La entrada `theme_info` es obligatoria: ```json theme={null} [ { "name": "theme_info", "theme_name": "Origin", "theme_author": "Riqra", "color_scheme": "only light" }, { "name": "Tipografía", "settings": [ { "type": "font_picker", "id": "body_font", "label": "Fuente del cuerpo", "default": "Open Sans" } ] } ] ``` `theme_info` acepta además `theme_version`, `theme_documentation_url` y `theme_support_url`. `color_scheme` (extensión de Riqra) declara el esquema CSS del tema: `"light"`, `"dark"`, `"light dark"`, `"dark light"` u `"only light"`. # Viniendo de Shopify Source: https://docs.riqra.com/desarrolladores/temas/viniendo-de-shopify Compatibilidad del dialecto Liquid de Riqra con Shopify: etiquetas, filtros, objetos y desviaciones deliberadas. El dialecto Liquid de Riqra es deliberadamente literal a Shopify OS 2.0: los nombres de etiquetas, filtros, objetos y tipos de setting se conservan para que tu conocimiento de Shopify aplique 1:1. Las tablas de esta página se generan desde el registro del dialecto — la misma fuente contra la que se valida cada subida de tema — así que no pueden desviarse del runtime. Todo el núcleo de Liquid viene incluido y no se lista aquí: control de flujo (`if`, `unless`, `case`, `for`), `assign`, `capture`, `liquid`, `echo`, `raw`, `comment`, `cycle`, `tablerow`, `increment`/`decrement`, `render`, y los filtros estándar de texto, arreglos, números, `date` y `json`. ## Etiquetas ### Soportadas | Etiqueta | | - | | `{% schema %}` | | `{% form %}` | | `{% paginate %}` | | `{% style %}` | | `{% stylesheet %}` | | `{% javascript %}` | | `{% section %}` | | `{% sections %}` | ### No soportadas | Etiqueta | Alternativa | | - | - | | `{% include %}` | usa `{% render %}` (aislado, como Shopify moderno) | | `{% layout %}` | el framework es dueño del documento; no hay theme.liquid | ## Filtros ### Soportados | Filtro | | - | | `asset_url` | | `image_url` | | `image_tag` | | `stylesheet_tag` | | `script_tag` | | `link_to` | | `handleize` | | `money` | | `money_with_currency` | | `money_without_trailing_zeros` | | `color_darken` | | `color_lighten` | | `escape` | ### No soportados | Filtro | Alternativa | | - | - | | `t` | los temas v1 llevan textos en español inline (sin locales/) | | `asset_img_url` | usa image\_url sobre un asset del tema | No hay filtros de expresiones regulares. Para transformar texto usa los filtros estándar de Liquid (`replace`, `split`, `slice`, `downcase`, `handleize`, …). ## Objetos ### Soportados | Objeto | | - | | `shop` | | `settings` | | `cart` | | `collections` | | `linklists` | | `request` | | `routes` | | `template` | | `section` | | `block` | | `product` | | `collection` | | `search` | | `page` | | `paginate` | | `breadcrumbs` | ### No soportados | Objeto | Alternativa | | - | - | | `metafields` | sin metafields en v1; usa settings del tema | | `localization` | temas v1 en español, sin selector de idioma | | `customer` | las páginas de cuenta son del framework, no del tema | | `selling_plan` | sin planes de venta | ## Desviaciones de comportamiento Diferencias deliberadas frente a Shopify que afectan cómo escribes el tema: * **Sin `layout/theme.liquid`.** El framework es dueño del documento HTML y enlaza automáticamente `assets/theme.css` y `assets/theme.js`. Un tema es secciones + snippets + plantillas + config + assets. Ver [Anatomía de un tema](/desarrolladores/temas/anatomia-de-un-tema). * **Sin `locales/` ni filtro `t`.** Los textos van en español, inline en el Liquid (v1). * **Sin versionado de temas ni migraciones.** Re-subir actualiza el tema en su lugar; un rediseño incompatible se entrega como un tema nuevo. * **Las plantillas subidas son defaults.** La personalización del comerciante vive en la base de datos y siempre gana; una re-subida nunca la pisa (a diferencia del write-back de Shopify). * **Wrapper y eventos propios.** Cada sección se envuelve en `
` (no `shopify-section-…`). El evento de refresco de sección es `riqra:section:load` y el de cambios de carrito es `riqra:cart-changed`. Ver [Carrito AJAX y secciones](/desarrolladores/temas/cart-ajax-y-secciones). * **`{% paginate %}` es por cursor.** No hay páginas numeradas: el drop `paginate` expone `next` y `previous`, nada más. * **El dinero es centavos enteros.** Todo precio en los drops (`product.price`, `cart.total_price`, …) es un entero en centavos; `| money` lo formatea con la moneda de la tienda. * **`request.query` no está expuesto.** Reconstruye los query strings desde los drops de filtros y orden (`collection.filters[*].values[*].url`, `collection.sort_options[*].url`), que ya traen la URL correcta con la paginación reseteada. * **Los badges de descuento se derivan.** No hay objeto de promociones en el catálogo: un producto está en oferta cuando `compare_at_price > price`. * **`quantity_rule` con la forma de Shopify, sin `quantity_price_breaks`.** `variant.quantity_rule` e `item.quantity_rule` (línea de carrito) traen `{ min, max, increment }`; `max` es `null` cuando no hay tope. En la tarjeta, `product.quantity_rule` solo existe cuando el producto tiene una sola variante; con varias es `nil` y la regla se lee en la PDP. Sin regla, los tres valores son `1`, `null`, `1`. El carrito ajusta cada escritura a la regla, así que un stepper que no la lea igual termina en un múltiplo válido; leerla evita que el cliente muestre una cantidad distinta a la que quedó guardada. `item.quantity_rule_valid` es `false` cuando un cambio de regla dejó la línea fuera de ella; el checkout la rechaza hasta que el comprador la corrija. Ver [Carrito AJAX y secciones](/desarrolladores/temas/cart-ajax-y-secciones#escribir-en-el-carrito). * **Cada variante tiene su propia galería.** `product.images` trae solo las imágenes del producto; las de las variantes no se suman. `variant.images` y `variant.featured_image` traen las imágenes de la variante o, si no tiene, las del producto. Al elegir una variante, el tema puede reemplazar la galería por `variant.images` sin más comprobaciones. * **`{% form %}` no acepta atributos.** Emite el `
` fijo para `product`, `cart` o `search`; no hay parámetro `class` ni atributos extra. Estiliza un contenedor propio alrededor. * **No nombres un argumento de `{% render %}` como una clave global o meta-propiedad.** `{% render 'card', size: 3 %}` colisiona con la meta-propiedad `.size` de Liquid; `settings`, `cart`, `shop`, etc. colisionan con los globals. Usa nombres propios (`items_per_row`, `card_size`). * **Endpoints AJAX propios (forma Shopify).** `GET /cart.js`, `POST /cart/{add,change,update,clear}.js` (con parámetro `sections` opcional para re-renderizar secciones en la misma respuesta), `POST /cart/add` como fallback sin JavaScript, `GET /products/{handle}.js` y `GET /api/sections?path=§ions=`. Ver [Carrito AJAX y secciones](/desarrolladores/temas/cart-ajax-y-secciones).