Coppel

Datos disponibles

• Pedidos con 26 columnas: status, items, payments, fechas. Categoría normalizada (RECEIVED→ENTREGADO, REFUNDED→REEMBOLSO, SHIPPED→ENVIADO).
• Métricas: KPIs, gráfica, status summary, top productos.
• Posventa: incidencias activas, resoluciones confirmadas desde SELLERP y conversaciones de Mirakl, con lectura local por usuario y adjuntos protegidos.

Posventa

SELLERP consulta incidencias activas desde OR11 y conversaciones desde M11/M10. El selector separa En curso de Resueltas desde SELLERP. La API pública de Mirakl no expone un expediente, un identificador estable ni el historial oficial de una incidencia.

• En curso: cada fila es una proyección activa de OR11 a partir de una línea INCIDENT_OPEN y muestra cuándo SELLERP la detectó.
• Resueltas desde SELLERP: cada fila proviene de una auditoría local, limitada por organización y cuenta, que sólo se conserva después de confirmar el readback de OR64. La vista cubre hasta 365 días; no es historial oficial, no incluye resoluciones hechas directamente en Coppel ni atribuye una fecha oficial de cierre. Si guardar la auditoría best effort falla, SELLERP nunca reintenta OR64 por ese motivo. CLOSED es el estado visible Cerrado del pedido y puede acompañar reembolsos, pero por sí solo no los demuestra. OR64 no cambia el pedido a CLOSED ni reembolsa.
• Mensajes: M11 actualiza la bandeja al consultarla y M10 actualiza el hilo al abrirlo. Las respuestas M12 son sólo texto y respetan el límite de 5,000 caracteres tanto en el cliente como en el servidor. No existe polling global ni un contador unread del proveedor.
• Continuidad: la sincronización conserva cursores M11 separados para la cabeza reciente y el historial. El watermark reciente sólo se promueve al cerrar el historial; un cursor histórico inválido se reproduce desde la última base durable.
• Lectura: Nuevo para ti es un marcador local por usuario; Por responder proviene de shop_reply_needed_since en Mirakl.
• Adjuntos: se descargan mediante un proxy autenticado después de validar cuenta, hilo y archivo. SELLERP no guarda el binario.

Cómo conectar

Desde Onboarding → Coppel → ingresa tu API key de Mirakl. Validamos con un endpoint de test, descubrimos el shop, encriptamos + guardamos, y disparamos el sync inmediatamente.

Sync

Sync inicial usa el flow async OR13/OR14/OR15 (~15s para descargar histórico) con fallback a OR11 paginado. Después corre cron cada 5 min vía Inngest.

Detalles

• SKU usa product_shop_sku con fallback a offer_sku.
• Date close usa created_date (no customer_debited_date).
• Mirakl no soporta webhooks para sellers — el polling de 5 min es el mecanismo principal.
• Las incidencias heredan esa frescura de 5 min; Mensajes se actualiza de forma síncrona al mostrar la bandeja o abrir un hilo.