Validación de direcciones en Sendcloud

Propósito: En este artículo, explicamos qué es la validación de direcciones, por qué es importante y las distintas formas en que puedes comprobar las direcciones de tus clientes en Sendcloud, directamente en el panel, mediante las API de Shipments o a través de plugins de terceros.

¿Qué es la validación de direcciones?

La validación de direcciones comprueba si una dirección de envío existe en bases de datos oficiales de direcciones. Esto ayuda a garantizar que los paquetes se entreguen correctamente y reduce entregas fallidas, devoluciones y recargos del transportista.

¿Cuándo se comprueba una dirección?

En Sendcloud, la validación de direcciones se ejecuta automáticamente cada vez que una dirección se carga o se crea. Esto puede ocurrir en tres lugares del panel:

• Pedidos entrantes: ve el estado de validación de cada pedido de un vistazo en la nueva columna Comprobación de dirección.
• Pack & Go (próximamente): los comentarios de validación en Pack & Go estarán disponibles pronto.
• Formulario de nuevo envío: ve los comentarios de validación mientras creas un envío manualmente.

La validación se ejecuta en segundo plano y no bloquea tu flujo de trabajo. Aún puedes crear una etiqueta aunque una dirección esté marcada como no válida, así que utiliza el resultado de validación como orientación, no como una restricción estricta.

¿Qué ocurre cuando se valida una dirección?

Cada dirección recibe uno de varios estados según el resultado. Verás estos estados en la vista de Pedidos entrantes y dentro del editor de pedidos. Las secciones siguientes explican qué significa cada estado y qué hacer al respecto.

La columna Comprobación de dirección en Pedidos entrantes

En la vista de Pedidos entrantes, encontrarás una nueva columna Comprobación de dirección que muestra el estado de validación de cada pedido de un vistazo.

A continuación se muestran todos los estados que puede tener una dirección. Haz clic en uno para ver su significado.

Resolver una dirección no válida

Cuando un pedido está marcado como No válido, haz clic en Resolver en la columna Comprobación de dirección para abrir el modal de Comprobación de dirección. Dentro, verás dos tarjetas una al lado de la otra:

• Original: la dirección que introdujiste, con los campos que parecen incorrectos resaltados con un icono de advertencia.
• Recomendada: la dirección corregida, basada en datos postales oficiales, con los campos corregidos resaltados en verde.

Si la primera recomendación no es correcta, puedes elegir otra desde el menú desplegable Direcciones encontradas en la parte superior del modal.

Para finalizar:

• Haz clic en "Aplicar recomendada" para actualizar el pedido con la dirección sugerida.
• Haz clic en "Mantener original" si prefieres dejar la dirección tal como fue introducida.

Comprobación de dirección en el editor de pedidos

Cuando abres un pedido para editarlo, el estado de validación también se muestra justo encima de los campos de dirección en la sección Cliente. El mensaje que ves depende del resultado de la validación y de si has cambiado la dirección desde que se cargó el pedido. Revisa los siguientes ejemplos para ver cada caso.

Dirección verificada La dirección se validó correctamente. No se requiere ninguna acción. 

❮❯

Otras formas de validar direcciones

Además de la función integrada en el panel, también puedes validar direcciones antes en tu flujo de trabajo, en el momento en que un cliente introduce su dirección en tu tienda online. Esto se realiza mediante herramientas de terceros que son independientes de Sendcloud y se ejecutan en tu plataforma de tienda.

Utilizar una de estas herramientas además de la validación integrada de Sendcloud te proporciona una “doble comprobación”: una en el checkout (evitando errores tipográficos desde el origen) y otra antes de crear la etiqueta (detectando cualquier error que haya pasado desapercibido).

¿Por qué validar direcciones?

• Menos entregas fallidas. Detectar un error tipográfico antes de crear la etiqueta significa que el paquete realmente llegará a tu cliente, sin devoluciones, reenvíos ni recargos del transportista.
• Menores costes de envío. Muchos transportistas aplican recargos por direcciones incorrectas. Validarlas por adelantado reduce estos costes.
• Mayor satisfacción del cliente. Los clientes reciben sus paquetes a tiempo, en la dirección correcta, sin emails de seguimiento ni retrasos.
• Checkout más rápido (con plugins de checkout). Muchos plugins ofrecen autocompletado de código postal + número de casa, para que los clientes no tengan que escribir la calle y ciudad completas. (Nota: el autocompletado no forma parte de la validación integrada de Sendcloud ni de la API de Shipments).

Opciones de terceros

Si deseas validar direcciones durante el checkout o utilizar una base de datos de validación diferente junto con la de Sendcloud, hay dos tipos de herramientas de terceros a considerar: plugins (instalados en tu tienda online) y APIs (invocadas desde tu propio código).

No podemos recomendar una herramienta específica porque la mejor opción depende de tu sistema de tienda, los países a los que envías y tu presupuesto. Por favor, investiga por tu cuenta antes de elegir.

Validar direcciones mediante la API de Sendcloud

Si creas envíos mediante la API de Shipments de Sendcloud en lugar del panel, puedes habilitar el mismo motor de validación utilizado por la función integrada del panel. La lógica de validación, la cobertura por países y las limitaciones son idénticas; solo cambia la forma en que interactúas con ella.

Para habilitar la validación, incluye el siguiente parámetro en tu solicitud de envío:

"validation_methods": ["here"]

Si la dirección no puede encontrarse en nuestra base de datos, la API devuelve un mensaje de error: "Address doesn't exist". Si se encuentra una dirección recomendada, se utilizará en lugar de la dirección original compartida en la solicitud. Para más detalles, consulta la documentación de la API de Shipments.

Uso de la API de Validación de Direcciones

Cuando se utiliza la API de Validación de Direcciones con "validation_methods": ["here"], el comportamiento coincide con lo que ves en el panel. La respuesta de la API devuelve una lista de direcciones coincidentes, con una marcada como "recommended": true. Esto indica la dirección que consideramos con mayor probabilidad de poder entregarse correctamente.

Si todas las direcciones devueltas tienen "recommended": false, significa que no se pudo identificar ninguna dirección con suficiente confianza para garantizar una entrega exitosa.

La API de Validación de Direcciones también puede utilizarse para validar direcciones solo frente a límites del transportista. Para hacerlo, simplemente omite el parámetro "validation_methods": ["here"] de tu solicitud.

En este caso, una dirección aún puede marcarse como "recommended": true si cumple las restricciones del transportista, aunque no esté confirmada como una dirección real entregable.

Cuando se incluye "validation_methods": ["here"], se aplican tanto la validación de direcciones reales como las comprobaciones de límites del transportista.

{
    "label_details": {
        "mime_type": "application/pdf",
        "dpi": 72
    },
    "validation_methods": ["here"],
    "to_address": {
        "name": "John Doe",
        "company_name": "Sendcloud",
        "address_line_1": "Whitehall",
        "house_number": "54",
        "postal_code": "5611CR",
        "city": "Amsterdam",
        "country_code": "NL",
        "phone_number": "+393895422999",
        "email": "john.doe@sendcloud.com"
    },
    "from_address": {
        "name": "Marie Doe",
        "company_name": "Sendcloud",
        "address_line_1": "Stadhuisplein 10",
        "address_line_2": "2e verdieping",
        "house_number": "10",
        "postal_code": "5611 EM",
        "city": "Eindhoven",
        "country_code": "NL",
        "phone_number": "+31612345678",
        "email": "marie.doe@sendcloud.com",
        "po_box": "PO Box 478"
    },
    "ship_with": {
        "type": "shipping_option_code",
        "properties": {
            "shipping_option_code": "postnl:standard",
            "contract_id": 517
        }
    },
    "order_number": "1234567890",
    "total_order_price": {
        "currency": "EUR",
        "value": "11.11"
    },
    "parcels": [
        {
            "dimensions": {
                "length": "5.00",
                "width": "15.00",
                "height": "20.00",
                "unit": "cm"
            },
            "additional_insured_price": {
                "value": "50",
                "currency": "EUR"
            },
            "weight": {
                "value": "1.320",
                "unit": "kg"
            },
            "parcel_items": [
                {
                    "item_id": "5552",
                    "description": "T-Shirt XL",
                    "quantity": 1,
                    "weight": {
                        "value": 0.3,
                        "unit": "kg"
                    },
                    "price": {
                        "value": 12.65,
                        "currency": "EUR"
                    },
                    "hs_code": "620520",
                    "origin_country": "NL",
                    "sku": "TS1234",
                    "product_id": "19284",
                    "mid_code": "NLOZR92MEL",
                    "material_content": "100% Cotton",
                    "intended_use": "Personal use",
                    "properties": {
                        "size": "XL",
                        "color": "green"
                    }
                },
                {
                    "item_id": "98712",
                    "description": "Sneakers 42",
                    "quantity": 1,
                    "weight": {
                        "value": 1.02,
                        "unit": "kg"
                    },
                    "price": {
                        "value": 12.65,
                        "currency": "EUR"
                    },
                    "hs_code": "620520",
                    "origin_country": "US",
                    "sku": "TS1234",
                    "product_id": "19284",
                    "mid_code": "US1234567",
                    "material_content": "100% Cotton",
                    "intended_use": "Personal use",
                    "properties": {
                        "size": 42,
                        "color": "black"
                    }
                }
            ]
        }
    ]
}