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.
Agregar una cuenta nueva
Usa un nombre único que identifique la tienda. La cuenta se crea vacía y nunca reemplaza credenciales de otra conexión.
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.
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.
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 exige SellerSku + ShopSku exactos, deja el resto en cuarentena, no suma stock de 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
Piloto de stock compartido e INT
Administra hasta 10 identidades exactas SKU+bodega y revisa sus publicaciones por cuenta. Esta versión congela vistas previas y simulaciones locales; no reserva en ENIX ni modifica stock en marketplaces.
1. Alcance canónico
2. Cuenta y publicaciones
La cobertura se lee del snapshot local de la cuenta; cero llamadas al canal.
3. Vista previa congelada
Usa saldo de prueba hasta que ENIX exponga y verifique el contrato autoritativo. El disponible se valida como físico − reservado − retenido.
4. Excepción temporal y cambio manual
Un cambio manual queda como evidencia; nunca se interpreta como venta ni crea una reserva.
5. Simulación aislada de venta
Dependencias del piloto
| Cuenta/canal | SKU canónico | SellerSku | ShopSku | Bodega | Operador | Pack | Stock observado | Fuente | Estado | Acción |
|---|---|---|---|---|---|---|---|---|---|---|
| Guarda el alcance y revisa las publicaciones. | ||||||||||
| 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.
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 | SKU | Producto | Pagado | Descuento | Envío comprador | Cargo envío orden | Costo Flex orden | Aporte Flex orden | Costo Suite | Margen preliminar | Estado |
|---|