EasyPost - Crear/Validar Direccion

Descripcion

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

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial EasyPost (provider: easypost)
name	text	Si	Nombre del destinatario
company	text	No	Nombre de la empresa
street1	text	Si	Direccion linea 1
street2	text	No	Direccion linea 2
city	text	Si	Ciudad
state	text	Si	Estado o provincia
zip	text	Si	Codigo postal
country	text	Si	Codigo del pais (por defecto: US)
phone	text	No	Numero de telefono
email	text	No	Direccion de email
verify	boolean	No	Verificar direccion (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 basico

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

Notas

La verificacion se realiza con el tipo “delivery” por defecto
Si la verificacion esta desactivada (verify: false), la direccion 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