Evolución Shopee
La API dijo éxito. Dejé de llamar a eso confirmación.
Una llamada que termina sin error me dice que la ejecución llegó a su final técnico. No me dice que la operación terminó. Cuando esa diferencia se hizo visible, “aceptado” y “confirmado” tuvieron que convertirse en estados distintos.
En CM ORBE OS, Shopee dejó de ser solo una integración de lectura. El sistema observa el canal, prepara acciones controladas y necesita decidir cuándo una ejecución puede considerarse realmente terminada.
El error estaba en una palabra: éxito
Cuando una llamada a Shopee termina sin error, hay algo concreto que ya sé: esa ejecución llegó al final técnico esperado en ese momento.
Lo que todavía no sé es si el estado del canal quedó como debía.
Las dos frases parecen cercanas:
- la llamada terminó sin error;
- el cambio realmente ocurrió.
Para una integración simple, es tentador tratarlas como sinónimos. Cuando CM ORBE OS empezó a participar en acciones sobre el canal, esa simplificación dejó de ser aceptable.
Aceptado no es confirmado
El sistema pasó a separar la ejecución técnica del efecto observado después.
acción enviada
→ accepted
→ nueva lectura del canal
→ confirmed, si observado y esperado coinciden
→ divergent, si existe diferencia
accepted no es un fracaso. Tampoco es la palabra final. Significa que la ejecución llegó al punto técnico esperado, pero todavía falta la evidencia que pertenece al mundo externo.
confirmed exige otra etapa: volver a la fuente que es dueña de ese estado y observar qué muestra después de la acción.
Si lo observado no corresponde con lo esperado, el sistema no convierte esa diferencia en éxito por conveniencia. Sigue visible como divergent.
Por qué volver a comprobarlo en Shopee
Si solicito un cambio en una promoción, la respuesta técnica puede llegar antes de que una nueva consulta muestre el estado esperado. Por eso, una llamada completada no cierra la historia.
CM ORBE OS vuelve a leer el estado relevante y compara lo que debía ocurrir con lo que aparece en el canal. A veces hay que esperar otra lectura; otras, investigar una diferencia.
Ejecutar es una etapa. Demostrar el efecto es otra.
Cuando entra la IA, la frontera importa todavía más
Esta separación también cambia el papel de la IA, las herramientas conectadas al sistema y los agentes dentro de la operación.
Una IA puede ayudar a analizar contexto, formular una propuesta o acompañar una acción. Lo que no recibe automáticamente es autoridad para declarar que algo salió bien solo porque una ejecución terminó sin error.
La herramienta que inició la acción no es la fuente final de verdad sobre el efecto.
Eso obliga al sistema a entregar evidencia suficiente para distinguir al menos tres situaciones:
- la acción fue ejecutada;
- el canal aceptó la ejecución;
- el efecto volvió a leerse y fue confirmado.
Cuanta más autonomía existe, más importante se vuelve esta diferencia. Autonomía sin un lenguaje claro de evidencia solo hace que el error ocurra más rápido.
Qué cambió realmente
La implementación separa una acción aceptada técnicamente de su efecto confirmado mediante una nueva lectura. Es una decisión arquitectónica documentada, no una promesa de validación universal.
El artículo no afirma que todas las acciones de Shopee ya estén validadas en un entorno real ni que cualquier operación externa pueda reconciliarse automáticamente. La mejora consiste en dejar claro cuándo todavía falta comprobar el resultado.
La prueba para las próximas integraciones
Cuando se incorpora una nueva función externa, no basta con descubrir cómo enviar un cambio. Hay que saber cómo comprobar su efecto sin depender solo de la respuesta de la API.
Ese criterio también determina qué puede presentarse como una capacidad demostrada y qué todavía no.
La separación entre acción aceptada, confirmada y divergente está implementada en el control de Shopee. Eso no significa que todas las acciones del canal ya estén validadas en un entorno real.
