EasyPost - Comprar Envio / Etiqueta

Descripcion

Este modulo compra una tarifa seleccionada de EasyPost y genera la etiqueta de envio correspondiente. Recibe el ID del shipment (obtenido del nodo Obtener Tarifas), el ID de la tarifa seleccionada y el formato de etiqueta. Realiza una peticion POST al endpoint /shipments/{shipment_id}/buy y retorna el ID del envio, codigo de seguimiento, URL de la etiqueta, transportista, servicio, precio y estado.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial EasyPost (provider: easypost)
shipment_id	text	Si	ID del shipment obtenido del nodo Obtener Tarifas (shp_…)
rate_id	text	Si	ID de la tarifa seleccionada (rate_…)
label_format	select	No	Formato de etiqueta: PDF (por defecto), PNG, ZPL (Thermal), EPL2

Credenciales

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

api_key: API Key de EasyPost

Salida

{
  "success": true,
  "shipment_id": "shp_abc123",
  "tracking_code": "9400111899223456789012",
  "tracker_id": "trk_abc123",
  "label_url": "https://easypost.com/labels/shp_abc123.pdf",
  "label_format": "PDF",
  "carrier": "USPS",
  "service": "Priority",
  "rate": "7.58",
  "status": "purchased",
  "message": "Etiqueta generada - Tracking: 9400111899223456789012"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_easypost",
  "shipment_id": "shp_abc123",
  "rate_id": "rate_def456",
  "label_format": "PDF"
}

API Utilizada

Endpoint: POST /shipments/{shipment_id}/buy
Base: EasyPost API (via helper _easypostHelper)
Documentacion: https://www.easypost.com/docs/api

Notas

Este nodo se usa en combinacion con el nodo Obtener Tarifas, que proporciona el shipment_id y los rate_id disponibles
Una vez comprada la etiqueta, se genera automaticamente un tracker
El tracker_id puede usarse para rastrear el envio con el nodo Rastrear Envio
Los formatos disponibles incluyen PDF, PNG, ZPL (impresoras termicas) y EPL2