SELLERP

Marketplaces

T1

Marketplace agregador de Grupo Salinas — T1, Sears y Sanborns en una sola cuenta. Slug: t1. Autenticación con Keycloak password grant (loginclaro.com). El enum `CS` (legacy Claro Shop) se mantiene en el API upstream pero la marca actual es T1; el modal y los labels visibles dicen T1.

Datos disponibles

  • Pedidos: vía endpoint kidal/v1/Ordersfull/seller/{idTienda}. Subcanal (CS/SR/SN/MELI) persistido en orders.fulfillment_channel — una sola cuenta de SELLERP agrega los 4 canales sin duplicar.
  • Publicaciones: vía cm/v2/product/commerce/{idTienda}/product. Status canónico mapeado desde el enum oficial OpenAPI (7 estados) +active flag → 4 estados internos (active / paused / under_review / rejected / closed).
  • Métricas: ventas brutas, total órdenes, ticket promedio, resumen por estado, top productos.

Cómo conectar

Desde Settings → Conexiones → T1 → ingresa:

  • ID de Tienda — 4 a 10 dígitos (ej. 10541).
  • Usuario API — típicamente store_{idTienda}_API_T1.
  • Contraseña API.
  • Client Secret — opcional, UUID que algunas tiendas reciben de T1.

Validamos las credenciales antes de guardar (token + permiso owner sobre la tienda + probe read-only a Ordersfull). Las credenciales se guardan cifradas con AES-256-GCM; el bearer JWT nunca se persiste — vive en memoria del cliente HTTP.

Sync inicial y cadencia

  • Sync inicial: back-fill de 12 meses al conectar la cuenta. Fan-out mensual; cada ventana corre como un evento Inngest independiente.
  • Crons:
    • Órdenes nuevas — cada 5 min.
    • Órdenes activas — cada 15 min.
    • Reconciliación — diario 9:00 UTC (3 AM CDMX), ventana de 90 días.
    • Publicaciones — cada 4 horas.

Subcanal MELI

T1 puede puentear ventas de Mercado Libre como un cuarto canal (MELI). En SELLERP esas órdenes se persisten con fulfillment_channel='MELI'. Si también conectas tu cuenta nativa de Mercado Libre, revisa que no estés contabilizando dos veces las mismas órdenes.

Webhooks

T1 no expone webhooks salientes. La sincronización es 100% pull-based vía polling — los crons listados arriba son la única vía de actualización.