Shippo - Validar Direccion

Descripcion

Este modulo valida y normaliza una direccion de envio utilizando el servicio de validacion de Shippo. Recibe los campos individuales de la direccion (nombre, empresa, calle, ciudad, estado, codigo postal, pais, telefono, email) y un flag de validacion. Realiza una peticion POST al endpoint /addresses/ y retorna la direccion creada con su ID, resultados de validacion (valida o no) y mensajes de validacion con detalles.

Configuracion

Parametro	Tipo	Requerido	Descripcion
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 numero principal
street2	text	No	Direccion linea 2
city	text	Si	Ciudad
state	text	Si	Codigo de estado ISO (ej: CA, NY)
zip	text	Si	Codigo postal
country	text	Si	Codigo ISO 3166-1 alpha-2 (por defecto: US)
phone	text	No	Numero de telefono
email	text	No	Direccion de email
validate	boolean	No	Activar validacion de direccion (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 basico

{
  "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)
Documentacion: https://goshippo.com/docs/

Notas

La validacion se activa por defecto (validate: true)
Si la validacion falla, la direccion se crea igualmente pero is_valid sera false
Los mensajes de validacion 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