Envío, stock y pago: un pedido coherente entre sistemas
Asigna quién controla cada dato y trata confirmaciones, cancelaciones y fallos para mantener una sola versión comprensible de la compra.
La tienda dice “pagado”, el sistema de stock sigue esperando confirmación y el transportista tiene una etiqueta con la dirección anterior. Cada integración puede responder normalmente mientras el pedido completo está equivocado.
Empieza siguiendo una compra de principio a fin. Enumera los sistemas e indica cuál controla precio, disponibilidad, pago, preparación y entrega. Dos sistemas modificando el mismo dato sin una regla clara generan discrepancias difíciles de explicar.
Relaciona los registros mediante referencias
Guarda el vínculo entre identificador del pedido, transacción del proveedor y registro de envío. El equipo debe poder partir de cualquiera y encontrar los demás. No dependas del nombre del cliente: una persona repite compras y varias pueden llamarse igual.
Define qué información queda registrada en la compra. Dirección elegida, artículos y precio de ese momento deben poder entenderse aunque cambien después el catálogo o los datos del cliente.
Describe las transiciones antes de integrar
Decide cuándo se reservan unidades, cuándo se descuentan y cuándo se libera una reserva. Imagina que dos personas empiezan a comprar la última unidad casi simultáneamente. Este caso hipotético exige evitar promesas incompatibles con el stock disponible.
Separa pago, preparación y expedición. Crear una etiqueta no significa que el transportista tenga el paquete; confirmar el cobro no significa que el producto esté preparado. Los estados deben orientar al equipo y explicar lo que realmente pasó.
Prevé mensajes repetidos
La documentación de webhooks de Stripe advierte que los eventos pueden repetirse y llegar fuera de orden.
El diseño necesita reconocer trabajo ya realizado. Reprocesar una confirmación no debe descontar stock dos veces ni crear otro envío. Pide que se demuestre con eventos de prueba, sin limitar la validación a una compra que siguió el camino ideal.
Haz visibles las excepciones
Prepara una lista de pedidos que requieren atención: cobrado sin preparar, envío sin etiqueta válida o cancelación pendiente. Registra último intento, causa del fallo y responsable de resolverlo. Un error silencioso hace que soporte solo lo descubra cuando reclama el cliente.
- Interrumpe temporalmente la integración de envío y observa la recuperación.
- Repite la confirmación de un mismo pago.
- Cancela antes y después de preparar el pedido.
- Cambia la dirección después de crear la etiqueta y comprueba la regla acordada.
- Compara saldos y registros tras cada caso.
La integración está preparada cuando el pedido recorre todo el proceso y sus excepciones pueden localizarse y resolverse. El número de sistemas conectados no lo demuestra por sí solo.
Continúa con el recorrido de Pix y tarjeta.
Sobre el autor
Tiago F SantiagoComentarios
Todavía no hay comentarios
Comparte una pregunta o una experiencia relacionada con el artículo.
Artículos relacionados
