EasyPost - Crear/Validar Dirección

Descripción

Este modulo crea una dirección en EasyPost y opcionalmente la valida. Recibe los campos individuales de la dirección (nombre, empresa, calle, ciudad, estado, código postal, pais, telefono, email) y un flag de verificación. Realiza una petición POST al endpoint /addresses con la opción de verificar la entrega. Retorna la dirección creada con su ID, resultados de verificación y un mensaje indicando si la verificación fue exitosa o si hubo advertencias.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial EasyPost (provider: easypost)
name	text	Si	Nombre del destinatario
company	text	No	Nombre de la empresa
street1	text	Si	Dirección línea 1
street2	text	No	Dirección línea 2
city	text	Si	Ciudad
state	text	Si	Estado o provincia
zip	text	Si	Código postal
country	text	Si	Código del pais (por defecto: US)
phone	text	No	Número de telefono
email	text	No	Dirección de email
verify	boolean	No	Verificar dirección (por defecto: true)

Credenciales

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

api_key: API Key de EasyPost

Las credenciales se obtienen desde el panel de EasyPost (https://www.easypost.com/account/api-keys).

Salida

{
  "success": true,
  "address": {
    "id": "adr_abc123",
    "street1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "country": "US"
  },
  "address_id": "adr_abc123",
  "verifications": {
    "delivery": {
      "success": true,
      "errors": []
    }
  },
  "message": "Direccion verificada exitosamente"
}

Ejemplo de Uso

Caso básico

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

API Utilizada

Endpoint: POST /addresses
Base: EasyPost API (via helper _easypostHelper)
Documentación: https://www.easypost.com/docs/api

Notas

La verificación se realiza con el tipo “delivery” por defecto
Si la verificación esta desactivada (verify: false), la dirección se crea sin validar
El address_id retornado puede usarse en otros nodos de EasyPost
Los campos opcionales (company, street2, phone, email) solo se incluyen si tienen valor