Entender los estados de añadir y editar una dirección

El formulario de dirección puede recopilar los datos de entrega, mostrar las herramientas de ubicación configuradas e iniciar una solicitud para añadir o editar una dirección. Que el formulario parezca completo o cambie la pantalla no demuestra por sí solo que hayan cambiado la dirección guardada, la predeterminada, la ubicación del pedido activo y el contexto de entrega del carrito.

:::warning Límites importantes Considera que el guardado no se ha resuelto hasta que la aplicación devuelva un estado actual y autorizado para la cuenta o el recorrido de invitado previsto. No repitas el guardado solo porque se haya abierto otra pantalla, movido un marcador o desaparecido un indicador de carga. :::

Añadir y editar son destinos distintos

Añadir inicia una nueva dirección candidata. Editar parte de una dirección candidata ya guardada. Los campos visibles pueden parecer iguales, pero para editar también hace falta un destino actual y autorizado por su propietario.

La información de la pantalla anterior puede determinar si el formulario parece ser para añadir o editar y a dónde intenta volver. Ese contexto de ruta es una indicación de navegación, no una prueba de que la dirección, la cuenta, la sesión de invitado, el proyecto, el pago o el carrito sean actuales o estén autorizados.

Campos y validación

El formulario puede incluir la dirección, información interna o de unidad, datos postales, instrucciones de entrega y una etiqueta. Los campos visibles u obligatorios pueden depender de la configuración actual del proyecto y del estado de validación.

La validación solo indica si la dirección candidata actual cumple las reglas del formulario. No demuestra que el usuario sea su propietario, que la zona tenga cobertura de entrega, que el proveedor haya respondido correctamente ni que el servidor haya guardado los datos. También se puede rechazar una dirección que parezca duplicada antes de intentar guardarla.

La ubicación escrita y la precisa son distintas

Escribir una dirección crea una candidata de texto. Elegir una sugerencia, usar la ubicación del dispositivo o mover el marcador del mapa puede añadir una candidata de ubicación más precisa. Estos estados deben distinguirse:

Estado visible	Qué puede significar	Qué no demuestra
Texto escrito	Existe una candidata de dirección local	Que un proveedor la haya resuelto o que se pueda entregar allí
Sugerencias	Un proveedor configurado devolvió opciones	Que una opción esté autorizada, vigente o tenga cobertura
Mapa o marcador	El formulario tiene una candidata de ubicación para mostrar	Que se haya guardado o activado la ubicación
Resultado de ubicación del dispositivo	El sistema operativo y el flujo de ubicación devolvieron una candidata	Que el permiso siga concedido o que la dirección sea correcta
Datos manuales	Se introdujo contexto de entrega adicional	Que ahora figure en el registro guardado o en el carrito

El permiso de ubicación y la disponibilidad del proveedor son independientes de la autoridad sobre las direcciones guardadas. Si no se dispone de una ubicación precisa, usa solo una alternativa manual o una dirección guardada que se ofrezca; no infieras las coordenadas a partir de un marcador ni repitas una acción del proveedor.

Mantener separadas las identidades de dirección

El mismo texto de dirección puede aparecer en varias capas que se actualizan de forma independiente:

Capa	Responsable o autoridad	Interpretación segura
Candidata del formulario	Generación actual del formulario	Datos locales sin guardar
Dirección guardada	Cuenta actual o transferencia de invitado autorizada	Solo es un registro persistido después de una respuesta autorizada
Dirección predeterminada guardada	Propietario de la dirección y transacción para establecerla como predeterminada	Registro preferido; no necesariamente es la ubicación activa del pedido
Ubicación del pedido activo	Contexto actual de pedidos	Ubicación utilizada para el descubrimiento o las decisiones del pedido actual
Contexto de entrega del carrito	Autoridad actual del carrito y del pago	Datos de entrega que se consideran durante el pago

Que el texto coincida o un control parezca seleccionado no vuelve equivalentes estas capas.

El guardado puede tener varias etapas

Guardar puede implicar más que el registro de la dirección. Según el recorrido, la aplicación también puede intentar seleccionar la nueva dirección, actualizar la información de la cuenta, cambiar las opciones del pedido, conciliar un carrito o volver a otra pantalla.

Esas etapas pueden completarse en momentos distintos. Por ejemplo, puede aceptarse el registro de dirección mientras su estado predeterminado o el del pedido activo todavía se desconoce, o la navegación puede ocurrir antes de que termine otra etapa. Si las capas no coinciden, mantén el resultado sin resolver hasta conciliarlas mediante lecturas actuales y autorizadas.

Límites entre invitado, cuenta y pago

Una dirección candidata de invitado no debe convertirse silenciosamente en una dirección de otra cuenta que haya iniciado sesión. Crear la sesión de invitado, convertirla después en cuenta, asignar la propiedad de las direcciones guardadas, introducir los datos de entrega del pago y transferir el carrito son responsabilidades distintas.

Si cambia la cuenta, el proyecto, la sesión o el pago, descarta los resultados obsoletos del formulario y del proveedor. Vuelve a entrar desde el recorrido actual y confirma qué capa de dirección muestra la pantalla antes de realizar otra acción deliberada.

Resultados parciales y desconocidos

Usa estas categorías de estado cuando corresponda:

• No iniciado: no se envió una intención de guardar.
• Pendiente: la generación actual del guardado aún no tiene un resultado final.
• Rechazado: la etapa actual devolvió un error de validación, autorización, conflicto o disponibilidad.
• Parcial: cambió una capa, pero otra no devolvió un estado conciliado.
• Desconocido: la aplicación no puede determinar si se confirmó una escritura, por ejemplo, después de una interrupción o de perder la respuesta.
• Conciliado: el estado actual autorizado identifica el registro guardado y las capas pertinentes de dirección predeterminada, pedido y carrito.

Un aviso, marcador, formulario cerrado o destino no bastan para informar que se completó correctamente.

Solución de problemas según el estado observado

Estado observado	Siguiente paso seguro	Responsable del límite
Un campo obligatorio sigue siendo inválido	Revisa únicamente la indicación visible para ese campo	Validación o configuración del formulario
El texto escrito no tiene sugerencias	Usa una alternativa manual o guardada que se ofrezca	Proveedor de sugerencias y formulario
La ubicación del dispositivo no está disponible	Revisa la guía de permisos de ubicación; no vuelvas a solicitarlo repetidamente	Permiso o ubicación del sistema operativo
El marcador y el texto no coinciden	Considera que la ubicación no está resuelta y no la guardes hasta que el formulario sea coherente	Mapa, proveedor y generación del formulario
El guardado sigue pendiente	Espera; no repitas la escritura	API de direcciones y generación de la solicitud actual
Se cerró el formulario, pero no aparece la dirección	Vuelve a abrir el estado de direcciones actual y autorizado; no des por sentado que falló ni lo repitas	Conciliación de direcciones guardadas
La dirección está guardada pero no activa	Mantén separados los estados de dirección guardada, predeterminada, pedido y carrito	Responsables de opciones del pedido y carrito
El estado cambió después de cambiar de cuenta o proyecto	Sal del flujo obsoleto y vuelve a entrar desde el contexto actual	Ciclo de vida de sesión o proyecto

Los informes de soporte deben usar solo categorías sin valores, como «guardado de dirección sin resolver». No incluyas el texto de la dirección, detalles de ubicación o contacto, identificadores de cuenta o carrito, datos del proveedor ni capturas privadas.

Privacidad y accesibilidad

Comparte solo la información mínima de dirección y ubicación que requiera la acción elegida. No copies a las notas de soporte la ubicación precisa, las respuestas del proveedor ni los datos de entrega guardados.

Las etiquetas de campos, los estados obligatorios y de error, las alternativas al mapa, la carga, la disponibilidad de guardado y los anuncios de resultados deben entenderse sin depender únicamente del color, la posición de un marcador o un aviso. El texto grande, el teclado, el orden del foco, los nombres para lectores de pantalla, la asociación de errores y el retorno del foco requieren verificación en la plataforma actual antes de afirmar que son accesibles.

Guías relacionadas: Elegir una ubicación · Permiso de ubicación y estados de ubicación no disponible · Entender los estados del mapa · Elegir el tipo y horario del pedido · Gestionar las direcciones guardadas · Datos del cliente y de entrega