> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shippo

> Shippo te ayuda a crear etiquetas de envío, rastrear paquetes y gestionar operaciones de envío a través de tu cuenta conectada.

# Shippo

Usa Shippo cuando necesites datos de envío para pedidos, etiquetas o seguimiento. Funciona bien después de un checkout, una actualización de pedido o un paso de fulfillment.

## Configuración

| Opción | Requerido | Descripción |
| - | - | - |
| Name | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Yes | La cuenta conectada de Shippo que se usará para este paso. |
| Action | Yes | La acción de Shippo que se va a realizar (por ejemplo Create address, Get address, Validate address, Create parcel). |
| Arguments | Yes | Campos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay disponible una pestaña **Raw JSON** para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Shippo en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay una conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Formulario de argumentos

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las dos pestañas se mantienen sincronizados.

## Acciones comunes

| Acción | Descripción |
| - | - |
| **Create address** | Crea una nueva dirección en Shippo. |
| **Get address** | Recupera una dirección creada previamente. |
| **Validate address** | Comprueba si una dirección es válida. |
| **Create parcel** | Crea un paquete con dimensiones y peso. |
| **Get parcel** | Recupera un paquete por su ID. |
| **Create shipment** | Crea un nuevo envío con origen, destino y paquetes. |
| **Get shipment** | Recupera un envío por su ID. |
| **List shipment rates** | Lista las tarifas de envío disponibles para un envío. |
| **Create transaction** | Compra una transacción de etiqueta de envío. |
| **Get transaction** | Recupera una transacción de etiqueta de envío por su ID. |
| **Register tracking webhook** | Registra un webhook de seguimiento para un envío. |
| **Get tracking status** | Recupera el estado de seguimiento de un envío. |
| **Create order** | Crea un nuevo pedido en Shippo. |
| **Get order** | Recupera un pedido de Shippo. |
| **List orders** | Lista todos los pedidos de la cuenta. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Salida

Este paso almacena la respuesta de Shippo como la salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia completa de salida en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Ejemplo

1. Abre **Integrations** y conecta Shippo si aún no lo has hecho.
2. Agrega un paso de **Shippo** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Create address** en **Action**.
5. Completa los campos requeridos. Usa **Insert Variable** para referenciar la salida de un paso anterior para cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga devuelta en **Output**.

## Casos de uso

### Crear una etiqueta de envío

1. Create address
2. Create parcel
3. Create shipment
4. List shipment rates

### Rastrear el envío de un pedido

1. Create track
2. Get tracking status
3. Get transaction

### Procesar un pedido nuevo

1. Create order
2. Get order
3. Create shipment
4. Create transaction

## Notas

* Este paso depende de una integración conectada de Shippo en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto seleccionado de acciones. Los agentes con la herramienta Shippo pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar la marca de autorización de terceros.

## Usar Shippo como herramienta del agente

También puedes agregar Shippo como una herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Shippo**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a las acciones de Shippo cuando son relevantes para la conversación.

Ver también: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creación y edición](https://docs.fetchhive.com/es/workflows/creating-and-editing.md) y [Pruebas e iteración](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.