API DocsCreate Ticket

Validación y corrección de direcciones

Validación y corrección de direcciones

Las direcciones incorrectas provocan entregas fallidas, devoluciones y costos adicionales. La validación de direcciones de atoship te ayuda a detectar los problemas antes de enviar.

Por qué es importante validar las direcciones

Costos de las direcciones incorrectas:

  • Cargos por devolución de envíos ($5-15 por paquete)
  • Costos de reenvío
  • Mercancía perdida
  • Clientes insatisfechos
  • Recargos de la paquetería

Problemas frecuentes en las direcciones:

  • Nombres de calles mal escritos
  • Códigos ZIP incorrectos
  • Falta el número de departamento
  • Direcciones desactualizadas
  • Direcciones inexistentes

Cómo funciona la validación

Coincidencia con direcciones de USPS: atoship valida las direcciones contra la base de datos oficial de USPS:

  1. Analiza los componentes de la dirección
  2. Estandariza el formato
  3. Busca coincidencias en la base de datos
  4. Devuelve un estado de validación
  5. Sugiere correcciones

Respuestas de la validación:

EstadoSignificadoAcción
Valid (válida)Se encontró coincidencia exactaEnvía tal cual
Corrected (corregida)Se aplicó un ajuste menorRevisa y acepta
Partial (parcial)Algunos datos son inciertosRequiere revisión manual
Invalid (no válida)No se encontró coincidenciaContacta al cliente

Cómo usar la validación de direcciones

Una sola dirección:

  1. Ingresa la dirección en el formulario de envío
  2. Haz clic en "Validate Address" (Validar dirección)
  3. Revisa las sugerencias
  4. Acepta o modifica

Validación por lotes:

  1. Importa los pedidos
  2. Haz clic en "Validate All" (Validar todas)
  3. Revisa las direcciones marcadas
  4. Procesa las correcciones de forma masiva

Entender las correcciones

Correcciones automáticas:

  • Completado del código ZIP (5 → 9 dígitos)
  • Estandarización del sufijo de la calle (Street → ST)
  • Abreviaturas de dirección cardinal (North → N)
  • Abreviaturas del estado
  • Ortografía del nombre de la ciudad

Ejemplo:

Input:  123 Main Street North, Anytown, California 90210
Output: 123 N MAIN ST, ANYTOWN, CA 90210-1234

Residencial vs. comercial

Por qué importa:

  • Se aplican tarifas distintas según la paquetería
  • Los tiempos de entrega varían
  • Cambian las opciones de servicio
  • Algunas paqueterías cobran recargos por direcciones residenciales

Detección: atoship detecta el tipo de dirección automáticamente:

  • Residencial: casas, departamentos
  • Comercial: empresas, oficinas
  • Uso mixto: se revisa caso por caso

Niveles de verificación de direcciones

Nivel 1 - Básico:

  • Validación del formato
  • El código ZIP existe
  • El estado coincide con el ZIP
  • Rápido y gratuito

Nivel 2 - USPS DPV:

  • Validación del punto de entrega (Delivery Point Validation)
  • Confirma que se puede entregar
  • Detecta direcciones desocupadas
  • Más preciso

Nivel 3 - Completo:

  • Verificación completa
  • Validación de suite/unidad
  • Detección del tipo de dirección
  • Máxima precisión

Cómo manejar direcciones no entregables

Cuando no se puede validar una dirección:

  1. Busca errores de escritura

    • Comunes: O/0, I/1, letras parecidas
    • Confusiones entre el número de la calle y el ZIP
  2. Verifica con el cliente

    • Envía un correo de confirmación
    • Ofrece las correcciones sugeridas
    • Pide referencias/notas
  3. Usa las herramientas de las paqueterías

    • Búsqueda de código ZIP de USPS
    • Validación de direcciones de UPS
    • Verificación con Google Maps

Funciones de la libreta de direcciones

Guardar direcciones validadas:

  • Almacénalas para clientes recurrentes
  • Evita volver a validarlas
  • Autocompletado al escribir
  • Se actualizan cuando hay correcciones

Administrar la libreta de direcciones:

Dashboard → Address Book → Add/Edit

Validación de direcciones internacionales

Desafíos:

  • Formatos distintos según el país
  • Diversos sistemas de códigos postales
  • Variaciones del idioma local
  • Datos menos estandarizados

Buenas prácticas:

  • Incluye siempre el código de país
  • Usa la transliteración al inglés
  • Verifica los códigos postales por separado
  • Incluye números de teléfono

Errores comunes de validación

"Address Not Found" (Dirección no encontrada):

  • Construcción nueva
  • Rutas rurales
  • Apartados postales (PO Box) con errores
  • Cambios recientes en la calle

"Multiple Matches" (Varias coincidencias):

  • Dirección ambigua
  • Falta el número de unidad
  • Nombres de calle duplicados
  • Se necesitan más datos

Buenas prácticas

Antes de enviar:

  1. Valida siempre las direcciones nuevas
  2. Revisa todas las coincidencias "partial" (parciales)
  3. Actualiza los registros del cliente con las correcciones
  4. Guarda las direcciones validadas

Comunicación con el cliente:

  • Pide direcciones completas
  • Solicita el número de departamento/unidad
  • Confirma la ortografía del nombre de la calle
  • Verifica los códigos ZIP

API de validación de direcciones

Para desarrolladores que integran con atoship:

POST /api/v1/addresses/validate
{
  "address": {
    "line1": "123 Main St",
    "city": "Anytown",
    "state": "CA",
    "zip": "90210"
  }
}

La respuesta incluye:

  • Estado de validación
  • Dirección corregida
  • Puntuación de confianza
  • Tipo de dirección (residencial/comercial)

Was this article helpful?