Shippo - Validar Dirección

Descripción

Este modulo valida y normaliza una dirección de envío utilizando el servicio de validación de Shippo. Recibe los campos individuales de la dirección (nombre, empresa, calle, ciudad, estado, código postal, pais, telefono, email) y un flag de validación. Realiza una petición POST al endpoint /addresses/ y retorna la dirección creada con su ID, resultados de validación (valida o no) y mensajes de validación con detalles.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial Shippo (provider: shippo)
name	text	Si	Nombre del destinatario
company	text	No	Nombre de la empresa
street1	text	Si	Calle y número principal
street2	text	No	Dirección línea 2
city	text	Si	Ciudad
state	text	Si	Código de estado ISO (ej: CA, NY)
zip	text	Si	Código postal
country	text	Si	Código ISO 3166-1 alpha-2 (por defecto: US)
phone	text	No	Número de telefono
email	text	No	Dirección de email
validate	boolean	No	Activar validación de dirección (por defecto: true)

Credenciales

Se requiere una credencial de tipo shippo con los siguientes campos:

api_token: API Token de Shippo

Salida

{
  "success": true,
  "address": {
    "object_id": "addr_abc123",
    "name": "John Smith",
    "street1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "country": "US"
  },
  "address_id": "addr_abc123",
  "is_valid": true,
  "validation_messages": [],
  "message": "Direccion validada exitosamente"
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi_credencial_shippo",
  "name": "Juan Garcia",
  "street1": "123 Main Street",
  "city": "San Francisco",
  "state": "CA",
  "zip": "94105",
  "country": "US",
  "validate": true
}

API Utilizada

Endpoint: POST /addresses/
Base: Shippo API (via helper _shippoHelper)
Documentación: https://goshippo.com/docs/

Notas

La validación se activa por defecto (validate: true)
Si la validación falla, la dirección se crea igualmente pero is_valid será false
Los mensajes de validación proporcionan detalles sobre los problemas encontrados
El address_id retornado puede usarse como referencia en otros nodos de Shippo
Los campos opcionales (company, street2, phone, email) solo se incluyen si tienen valor