Buscar en la documentación

Módulos

Authentication

Merchant

Catalog

Order

Events

Logistics

Shipping

Review

Financial

Soluciones

Flujo de evaluación V2

El flujo V2 fue diseñado para ofrecer mayor transparencia, autonomía y eficiencia, con validaciones automáticas por IA y diálogo directo entre clientes y partners.

Principales cambios del V2

Autonomía ampliada: Clientes y partners interactúan directamente, reduciendo intermediaciones
Validación inteligente: IA identifica contenido inapropiado automáticamente
Estados granulares: Mayor control sobre visibilidad y respuestas
Visibilidad controlada: Cliente elige entre evaluación pública o privada

Conceptos fundamentales

Publicación

Una evaluación es considerada pública cuando cumple con los criterios de elegibilidad y el cliente elige visibility: PUBLIC.Características en V2:

Cliente controla visibilidad vía campo visibility (PUBLIC/PRIVATE)
Evaluaciones privadas no impactan la nota pública de la tienda
Estado PUBLISHED indica procesamiento concluido y elegibilidad para publicación
Validación automática por IA sustituye parte de la moderación manual

Evaluaciones con visibility: PRIVATE son visibles solo para el partner, no aparecen públicamente y no afectan estadísticas públicas. Aun así, su estado será PUBLISHED.

Comentario

Texto anexado por el consumidor a la evaluación, con procesamiento mejorado.Mejoras en V2:

Validación automática por IA para contenido inapropiado
Procesamiento más rápido vía automatización
Plazo de respuesta del partner: 5 días

Comentarios son validados automáticamente al recibirse. No hacemos cambios en comentarios. Si una evaluación contiene contenido ofensivo, datos personales del cliente o errores críticos de formato, es automáticamente invalidada y no será publicada.

Respuesta

En V2, respuestas evolucionaron de campo único (reply) para lista (replies), preparando soporte futuro para conversaciones bidireccionales.Cambios principales:

Solo una respuesta del partner permitida (array replies con un ítem)
Campo from identifica origen: MERCHANT o CUSTOMER
Validación automática de conformidad
Edición permitida en hasta 10 minutos después de la creación

Reglas mantenidas:

Límite de 10 a 300 caracteres por respuesta

Solo es posible responder evaluaciones con estado NOT_REPLIED. Después de la publicación, no es posible registrar respuestas. Las respuestas son validadas através de un proceso asincrónico. Si su respuesta contiene contenido inapropiado, datos personales del cliente o enlaces no autorizados, la evaluación será marcada como inválida y no será publicada.

Automoderación

Evaluaciones automoderadas pueden recibir estado INVALID o DISCARDED cuando se detectan fraude, contenido inapropiado o violación de políticas.Escenarios de descarte:

Expiración del período de 3 meses
IA identifica violación de directrices
Detección automatizada de fraude o contenido inapropiado
Intervención manual en casos específicos

Correspondencia con V1:

status: DISCARDED sustituye discarded: true
status: INVALID es nuevo (estado interno de moderación, tratado como descartado)

Estado de la API

Estado	Descripción
`CREATED`	Evaluación registrada (período de espera interno de 24h ya pasó, transparente para usted)
`NOT_REPLIED`	Evaluación con comentario, aguardando respuesta del partner
`REPLIED`	Evaluación con al menos una respuesta del partner
`PUBLISHED`	Evaluación publicada (elegible para visibilidad pública)
`INVALID`	Evaluación inválida por violación de directrices
`DISCARDED`	Evaluación descartada (fraude, política)
`UNKNOWN`	Caso raro/indeterminado

Flujo completo

1. Creación (Cliente)

Cliente evalúa pedido con comentario opcional
Por naturaleza, toda evaluación pasa por un período de espera interno de 24 horas antes de quedar disponible para respuesta. Cuando aparece para usted en estado CREATED, esa espera ya ha ocurrido y es completamente transparente — usted no necesita esperar.
Estado: CREATED (inmediato - visible en segundos) — el período de espera interno de 24h ya ha pasado

2. Validación y publicación (Automática)

Nota 5 o sin comentario: publicación inmediata
Caso contrario: permanece en NOT_REPLIED hasta respuesta del partner
Estado: CREATED → NOT_REPLIED o PUBLISHED

3. Respuesta del partner (Opcional)

Partner responde en hasta 5 días
Respuesta pasa por validación de conformidad
Estado: NOT_REPLIED → REPLIED

4. Interacción directa

Cliente recibe respuesta y puede ajustar nota
Si cliente ajusta nota, la puntuación PODRÍA mejorar (es un promedio, entonces se necesitarían muchos ajustes de nota entre evaluaciones para tener un efecto notable)
Si cliente ignora, evaluación es publicada después de 5 días de la respuesta
Estado: NOT_REPLIED/REPLIED → PUBLISHED

Ciclo de vida: Duración máxima de 10 días, comenzando con la respuesta del partner y finalizando con aceptación/rechazo del cliente o expiración del plazo.

Recursos principales del V2

Recurso	Descripción
Feedback público/privado	Cliente elige visibilidad; privadas no impactan nota pública
Resolución directa	Interacción cliente-partner con menos intermediación
IA en el proceso	Validaciones inteligentes garantizan conformidad
Edición y ajustes	Clientes ajustan notas con base en respuestas

Comparación V1 vs V2

Aspecto	V2
Respuestas	Lista `replies` (preparado para chat)
Moderación	Automática con IA
Visibilidad	Pública o privada
Plazo respuesta	5 días
Edición respuesta	10 minutos después de la creación
Estado descarte	Estado `DISCARDED`/`INVALID`

¿Esta página fue útil?

Evalúa tu experiencia en el nuevo portal de desarrolladores:

En esta página