Conexiones con apps
Qué cuentas puede usar Master. Cada cambio aplica al instante, sin reiniciar Suite, y queda registrado con tu usuario. Apagar un permiso corta el acceso de inmediato.
| Canal | Cuenta | Estado | Master publica / lee | Master usa credenciales |
|---|---|---|---|---|
| Cargando… | ||||
Conexiones independientes
Cada tienda conserva nombre, canal, credenciales y auditoría independientes. Falabella mantiene su operación actual; Ripley valida la conexión con un canario OF21 y genera su snapshot mediante la exportación asíncrona oficial OF52/OF53/OF54, siempre en modo de solo lectura.
Retirar o eliminar este canal
Retirar deja la cuenta fuera de operación: Suite no lee ni envía ventas ni stock, ENIX la omite en la siguiente sincronización y Master deja de verla. El nombre, la auditoría y el historial de ventas, costos y devoluciones se conservan. Se puede restaurar. Eliminar definitivamente solo aplica a una cuenta ya retirada: borra sus credenciales y la saca de todas las listas; el historial se conserva.
Agregar una cuenta nueva en 3 pasos
- 1 · Canal y nombre
- 2 · Credenciales
- 3 · Probar conexión
Usa un nombre único que identifique la tienda. La cuenta se crea vacía y nunca reemplaza credenciales de otra conexión.
Escribe las credenciales del Seller Center. Se cifran al guardarse y nunca se vuelven a mostrar.
Una lectura real de solo lectura confirma que las credenciales sirven. Si pasa, la cuenta queda operativa en lectura; los permisos de Master y de escritura siguen apagados y se habilitan aparte.
Guarda primero la API Key protegida. La conexión nace con las lecturas apagadas.
Solo se puede habilitar después de guardar credenciales completas.
Exige API Key, lectura activa y canario OF21 reciente. Cada archivo se corrige, calcula y confirma en dos fases.
Todas las cuentas configuradas quedan habilitadas; este control sirve como corte de emergencia por cuenta.
Paris (Cencosud)
Suite lee Paris y no cambia precios ni publicaciones. Solo escribe stock, con «Stock Paris desde ENIX», y solo cuando lo enciendes. La API Key se cifra y nunca se vuelve a mostrar.
API Key
Ventas Paris (se guardan en Suite)
Con «Guardar órdenes» encendido, Suite lee Paris cada 15 minutos (últimos 14 días) y guarda cada sub-orden sin datos personales. Nunca se borran. Con «Enviar a ENIX» encendido, cada orden nueva o cambiada llega a la bandeja «Ventas por integración» de ENIX como pendiente de decisión, igual que Falabella: ENIX no descuenta stock solo.
| Sub-orden | Fecha | Estado | SKU Boss | Unid. | Precio pagado | ENIX |
|---|
Stock Paris desde ENIX
Cada 20 minutos Suite compara el stock que muestra Paris con el vendible de ENIX ÷ unidades del pack (SKU Boss de 12 dígitos tras el prefijo) y cambia solo los SKU distintos, subiendo o bajando. Cada publicación y cada versión recibe el vendible completo ÷ su pack. No sube un SKU que tuvo una venta Paris en las últimas 48 horas. Si un ciclo dejaría en 0 demasiadas publicaciones, se apaga solo. Apagado hasta que lo enciendas.
| SKU seller Paris | SKU ENIX | Pack | Vendible ENIX | Hoy en Paris | Quedaría | Motivo |
|---|
Consultar órdenes en Paris (sin guardar)
| Sub-orden | Fecha | Estado | SKU Paris | SKU Boss | Unid. | Precio pagado | Comisión |
|---|
Ver un SKU en Paris
Estado protegido
Credenciales de esta conexión
Los valores existentes nunca se muestran. Una cuenta nueva exige los tres campos.
Pruebas reales de solo lectura
Productos y ventas se consultan directamente. Las órdenes se muestran sin nombres, direcciones, teléfonos ni datos tributarios. Todas las escrituras siguen bloqueadas.
Falabella notificará solamente los SKU creados, actualizados o cuyo control de calidad cambie. Suite releerá esos SKU por la API; esta acción no cambia precios ni stock.
Buscar paquetes o tracking exactos en ventas recientes
Consulta de solo lectura en todas las cuentas Falabella configuradas. Conserva OrderId interno y OrderNumber comercial por separado, devuelve todas las líneas de cada orden encontrada y no exige ShopSku cuando cuenta + orden + OrderItemId + SellerSku ya forman una identidad inequívoca. No activa catálogo, bridge, intake, replay, stock, reservas, feeds ni estados.
| Buscado | Cuenta | OrderId interno | OrderNumber comercial | Fecha | Linea | PackageId | Tracking | Pre-tracking | SellerSku | Producto | Quantity raw | Cantidad resuelta | Fuente cantidad | Total linea | Estado |
|---|
Importar precios Falabella para promociones
Carga SellerPriceTemplate de la cuenta seleccionada. Suite valida el archivo en un proceso aislado, conserva SKU con ceros iniciales y guarda solo filas cuyo SellerSku + ShopSku coincide exactamente con esta cuenta; las demás quedan en cuarentena. El archivo no acredita stock ni ejecuta cambios en Falabella.
Revisar excepciones del archivo
Stock temporal Falabella para calcular promociones
Carga ProductStock de la cuenta seleccionada para actualizar únicamente QuantityFalabella. Suite usa SellerSku + ShopSku exactos; si ShopSku no viene, acepta SellerSku solo cuando identifica inequívocamente una publicación dentro de esta cuenta. No infiere por título, no suma SKU padres, no modifica costos, no escribe en Falabella y nunca convierte una cantidad vacía en cero.
El archivo no declara la cuenta: Suite lo contrasta con el catálogo de la conexión visible y solo guarda coincidencias exactas.
Revisar filas no aplicadas
Recuperación controlada de ventas INT
Permite revisar y retransmitir una venta histórica exacta cuando ENIX no confirmó su recepción. Esta herramienta no configura autoridad de inventario, no reserva y no descuenta stock.
Reintentos ENIX de ventas canónicas
Lista global para todas las cuentas INT. Recupera únicamente rechazos históricos compatibles y concilia el ACK del canario ya aceptado; cada acción conserva el mismo evento y payload, se ejecuta de a uno y no reserva ni descuenta inventario.
Cargando ventas rechazadas elegibles…
| Tienda | Orden | SKU canónico | Cantidad | Actualizada | Error anterior | Estado | Acción |
|---|---|---|---|---|---|---|---|
| Cargando candidatos… | |||||||
| Shop SKU | Producto | Precio y oferta | Vigencia oferta | Stock | Clase | Costo Suite | Comisión | Envío | Tarifa fija | Utilidad est. | Margen | Estado | Observado |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Aún no existe un snapshot Ripley completo. | |||||||||||||
Costos y score de la cuenta
El histórico, el score y FBS explican la rentabilidad del precio actual. Para calcular una nueva oferta se usa un solo costo Flex prorrateado según SpecialPrice: un tramo hasta $19.990 y otro desde $19.991. No se mezclan ambos métodos ni se altera el costo Suite.
Simulador de precio oferta rentable
Reutiliza pisos de ganancia y terminación comercial de Boss. Los descuentos de 50% o más están permitidos. Suite calcula primero el menor SpecialPrice que cubre el mayor piso entre porcentaje y pesos; después deriva Price para formar el descuento objetivo. Price puede bajar o subir respecto del valor API. Las autorizaciones operativas se muestran aparte y nunca ocultan una oferta económicamente calculable.
Solo recalcula y muestra los dos precios; nada se envía a Falabella sin la vista previa y tu doble confirmación. Si prefieres no tocar el precio regular, baja el descuento objetivo.
Genera el SellerPriceTemplate desde todas las publicaciones con precio y stock de la cuenta. Cada exclusión queda explicada en un manifiesto local. Esta acción no llama ProductUpdate, no consulta FeedStatus y no envía nada a Falabella.
El universo de campaña incluye todas las publicaciones de la cuenta con precio válido y stock positivo. Suite muestra cuántas son ejecutables y cuántas están bloqueadas por costo, logística, estado o evidencia; nunca las omite en silencio. “Seleccionar todas” toma las ejecutables de toda la cuenta, sin filtros ni paginación. Las consultas de 25 SKU son solo transporte técnico y la aplicación final continúa en bloques seriales de hasta 500.
| Aplicar | Regla de ganancia aplicada | Estado | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Aún no hay un snapshot de catálogo disponible. | ||||||||||||||||
Cómo se calcula y qué significa “parcial”
- Precio activo
- Oferta vigente cuando existe; en caso contrario, precio regular informado por GetProducts.
- Comisión estimada
- 20% del precio activo por regla comercial solicitada. El porcentaje puede cambiarse para simular; no sustituye la comisión de la liquidación real.
- Envío
- Es un componente separado: usa el promedio real del mismo SKU o, si no existe, el respaldo manual de la cuenta.
- Cofinanciamiento FBS
- Es un cargo por unidad distinto del envío. Con talla calculable, precio activo y score f.plus usa la tabla oficial por tramo; si falta alguno, recurre al histórico o al mínimo manual. Incluye IVA y se reconcilia después de la venta.
- Costo Flex prorrateado de oferta
- Para fijar Price y SpecialPrice se resta un solo monto por publicación simulada: el tramo hasta $19.990 o el tramo desde $19.991. Si margen, redondeo o 7EF cruzan el umbral, Suite vuelve a calcular con el tramo correcto. Nunca suma ambos y no usa FBS.
- Ventas reales
- El costo Flex, los aportes de Falabella, FBS y otros movimientos se mantienen fuera de esta regla previa. Después de vender se concilian con la orden y la liquidación real, una sola vez por pedido.
- Tamaño previsto API
- Usa PackageHeight/Width/Length en cm y PackageWeight en kg. La talla logística se obtiene con el mayor entre peso físico y largo × ancho × alto / 4.000. No corresponde a la talla comercial del producto.
- Score f.plus
- No está documentado en Seller API. Se registra una sola vez por cuenta y permanece vigente hasta que un operador lo cambie. El Opscore de un reporte importado solo se muestra como referencia y nunca es requisito para calcular.
- Regla dominante 7EF
- Permite no aplicar una regla especial, omitir del análisis las publicaciones cuyo título termina exactamente en 7EF o sumar un monto después de calcular la oferta base rentable por unidad y total del pack. Suite agrega el monto una vez; la variación del SKU hijo se aplica después y se recalculan comisión, logística y margen sobre el valor final, sin cambiar el costo Suite.
- Beneficio neto estimado
- Para la oferta convierte una sola vez a netos el precio, costo Suite, comisión y el único costo Flex prorrateado del tramo. No suma aporte Flex, FBS, comisión fija ni una segunda resta de IVA.
- FBS y cofinanciamiento
- Siguen visibles como referencia del precio actual y para la conciliación posterior, pero no deciden el precio de la oferta bajo la política prorrateada.
- Retorno neto/costo
- Beneficio neto estimado dividido por el costo Suite neto. Es porcentaje sobre costo, no margen sobre venta.
- Oferta sugerida
- SpecialPrice parte del menor valor que cumple el mayor piso de ganancia. Price se calcula siempre desde ese SpecialPrice y el porcentaje objetivo, por lo que puede bajar o subir respecto del Price API sin encarecer innecesariamente la oferta.
- Preparar oferta
- Copia SKU, precio regular, oferta y vigencia a una vista previa protegida. Solo podrá enviarse después de doble confirmación y cuando el canal de escritura esté habilitado.
Ciclo financiero Falabella
Conserva hasta 120 días de ventas para recibir liquidaciones tardías. La API mantiene el estado preliminar; ReportOrderSummary controla el payout y Reporte Transacciones explica comisiones, aportes, devoluciones y otros cargos.
Centro financiero por orden
Una venta detectada no equivale a un depósito. Los montos pagados y pendientes solo se clasifican cuando el reporte financiero de Falabella lo confirma.
Cómo leer cada cifra
- Ventas detectadas
- Lo pagado por productos según API o reporte. No significa que Falabella ya lo haya depositado.
- Liquidación conocida
- Importe neto reportado después de comisiones, cargos y abonos incluidos por Falabella.
- Pagado / pendiente
- Se obtiene del estado de pago del reporte de transacciones. Sin ese reporte la orden queda como “sin confirmar”.
- Descuentos Falabella
- Comisión y otros cargos explicativos. No se restan de nuevo porque ya forman parte del payout.
- Costo Suite
- Costo canónico del producto multiplicado por la cantidad vendida.
- Flex externo
- Costo que paga la empresa al transportista; se distribuye una sola vez entre los artículos de la orden.
- Utilidad conocida
- Payout menos costo Suite y Flex externo. Queda pendiente si falta costo o reporte financiero.
Archivos financieros procesados
| Fecha | Archivo | Formato | Recibidas | Nuevas | Actualizadas | Duplicadas |
|---|
Revisión y aplicación protegida
Revisa el precio regular y las ofertas rentables antes de generar ProductUpdate. Se exige evidencia de stock dentro de la ventana segura configurada, actualmente 6 horas. “Actualizar cambios recientes” usa deltas mientras el snapshot global siga vigente; si venció, inicia una reconciliación completa paginada y después aplica cualquier delta pendiente. Falabella procesa el lote como un feed asíncrono; Suite guarda el RequestId y no lo considera aplicado hasta reconciliar FeedStatus.
Doble confirmación de flujo
Ventas recientes
| Orden | Fecha | Total | Pago | Artículos | Estado | Envío |
|---|
Detalle cobrado y costo Suite
El margen es preliminar por orden: pagado + aporte Flex estimado − costo canónico − cargo de envío de la orden − costo Flex externo de la orden. Comisión y liquidación final se reemplazan al importar los reportes.
| Orden | PackageId | Tracking | Pre-tracking | SKU | Producto | Pagado | Descuento | Envío comprador | Cargo envío orden | Costo Flex orden | Aporte Flex orden | Costo Suite | Margen preliminar | Estado |
|---|