Shippo - Crear Envio / Etiqueta

Descripcion

Este modulo crea un envio 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 peticion POST al endpoint /transactions/ de forma sincrona y retorna el ID de la transaccion, numero de seguimiento, URL de rastreo del proveedor, URL de la etiqueta, URL de factura comercial, ETA, estado y mensajes de error si los hubiera.

Configuracion

Parametro	Tipo	Requerido	Descripcion
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 envio

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 basico

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

Notas

Este nodo requiere un rate_id previo del nodo Obtener Tarifas
La transaccion 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 multiples formatos de etiqueta incluyendo formatos especificos como PDF_4x6 y PDF_A6
El transaction_id se necesita para cancelar/reembolsar el envio