> ## 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.

# Harvest

> Harvest ayuda a equipos y freelancers a registrar el tiempo, gestionar proyectos y manejar la facturación a través de tu cuenta conectada.

# Harvest

Usa Harvest cuando necesites gestionar trabajo registrado, facturación o registros de clientes en un flujo de trabajo. Puedes crear, buscar y actualizar registros principales como clientes, proyectos, tareas, entradas de tiempo y facturas.

## Configuración

| Opción | Requerido | Descripción |
| - | - | - |
| Nombre | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Autenticación | Sí | La cuenta conectada de Harvest que se usará para este paso. |
| Acción | Sí | La acción de Harvest que se realizará (por ejemplo Create Client, Get Client, Update Client, Create Project). |
| Argumentos | Sí | 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 una pestaña **Raw JSON** disponible para uso avanzado. |
| Cuando falla el paso | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Harvest 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 el objeto completo de argumentos a mano. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

## Acciones comunes

| Acción | Descripción |
| - | - |
| **Create Client** | Crear un cliente nuevo. |
| **Get Client** | Recuperar un cliente por ID. |
| **Update Client** | Actualizar un cliente existente. |
| **Create Project** | Crear un proyecto nuevo. |
| **Get Project** | Recuperar un proyecto por ID. |
| **Update Project** | Actualizar un proyecto existente. |
| **Create Task** | Crear una tarea nueva. |
| **Get Task** | Recuperar una tarea por ID. |
| **Update Task** | Actualizar una tarea existente. |
| **Create Time Entry** | Crear una nueva entrada de tiempo. |
| **Get Time Entry** | Recuperar una entrada de tiempo por ID. |
| **Update Time Entry** | Actualizar una entrada de tiempo existente. |
| **Create Invoice** | Crear una factura nueva. |
| **Get Invoice** | Recuperar una factura por ID. |
| **Update Invoice** | Actualizar una factura existente. |

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

## Salida

Este paso guarda la respuesta de Harvest como la salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia de salida completa en pasos posteriores:

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

## Ejemplo

1. Abre **Integrations** y conecta Harvest si aún no lo has hecho.
2. Añade un paso de **Harvest** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Create Client** en **Action**.
5. Completa los campos requeridos. Usa **Insert Variable** para referenciar el valor de 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

### Registrar trabajo facturable

1. Get Project
2. Get Task
3. Create Time Entry

### Crear un proyecto de cliente

1. Create Client
2. Create Project
3. Update Project

### Redactar una factura

1. Get Client
2. Create Invoice
3. Update Invoice

## Notas

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

## Usar Harvest como una herramienta de agente

También puedes añadir Harvest como herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Harvest**. 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 Harvest cuando son relevantes para la conversación.

Ver también: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md), y [Testing and Iteration](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.