Shippo - Crear Envío / Etiqueta

Descripción

Este modulo crea un envío en Shippo comprando una tarifa previamente seleccionada. Recibe el ID de la tarifa (obtenido del nodo Obtener Tarifas), el formato de etiqueta y metadata/referencia opcional. Realiza una petición POST al endpoint /transactions/ de forma sincrona y retorna el ID de la transacción, número de seguimiento, URL de rastreo del proveedor, URL de la etiqueta, URL de factura comercial, ETA, estado y mensajes de error si los hubiera.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial Shippo (provider: shippo)
rate_id	text	Si	ID de la tarifa obtenida con el nodo Obtener Tarifas
label_file_type	select	No	Formato de etiqueta: PDF (por defecto), PDF_4x6, PDF_A4, PDF_A6, PNG, ZPLII
metadata	text	No	Referencia o notas internas para este envío

Credenciales

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

api_token: API Token de Shippo

Las credenciales se obtienen desde el panel de Shippo (https://apps.goshippo.com/settings/api).

Salida

{
  "success": true,
  "transaction_id": "txn_abc123",
  "tracking_number": "9400111899223456789012",
  "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400111899223456789012",
  "label_url": "https://shippo-delivery.s3.amazonaws.com/label.pdf",
  "commercial_invoice_url": null,
  "eta": "2026-03-25T18:00:00Z",
  "status": "SUCCESS",
  "messages": [],
  "message": "Etiqueta generada - Tracking: 9400111899223456789012"
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi_credencial_shippo",
  "rate_id": "rate_abc123",
  "label_file_type": "PDF",
  "metadata": "Pedido #1234"
}

API Utilizada

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

Notas

Este nodo requiere un rate_id previo del nodo Obtener Tarifas
La transacción se ejecuta de forma sincrona (async: false)
El estado SUCCESS indica que la etiqueta fue generada correctamente
Si hay errores, se incluyen en el campo messages con el detalle
Shippo soporta múltiples formatos de etiqueta incluyendo formatos especificos como PDF_4x6 y PDF_A6
El transaction_id se necesita para cancelar/reembolsar el envío