Saltar al contenido principal

​
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

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

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:

​
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, Creating and Editing, y Testing and Iteration