Conector QuickBooks OAuth 2.0 para crear un extremo

Antes de comenzar con los pasos de esta página, ya debe haber completado estas actividades de configuración para permitir que Harmony acceda a su instancia de QuickBooks Online:

• Conector QuickBooks OAuth 2.0 para crear una aplicación QuickBooks
• Instalar Jitterbit Design Studio en Windows o Instalar Jitterbit Design Studio en macOS
• Instalar un agente de Windows o Instalar un agente de Linux

En este punto, debería tener toda la información que necesita para comenzar a trabajar en Harmony. Esta página describe cómo usar Harmony QuickBooks Connector para crear un extremo dentro de Jitterbit Design Studio.

Extremo de prueba

1. Abra la aplicación Design Studio, versión 8.29.2 o posterior. Inicie sesión con las credenciales creadas cuando se unió a su organización durante el proceso de registro a través del sitio web de Harmony.

2. Debería aparecer la pantalla Primeros pasos, donde podrá elegir realizar una variedad de tareas. Para este tutorial, crearemos un nuevo proyecto. En la parte inferior de la pestaña de la pantalla Primeros pasos, haga clic en Nuevo proyecto.

   1. Elija un nombre adecuado para su nuevo proyecto y luego seleccione otras configuraciones que sean apropiadas para su organización. Para los fines de este ejemplo, llamaremos a nuestro proyecto "QuickBooks New OAuth 2".
   2. Si es la primera vez que utiliza Design Studio, puede aceptar todos los valores predeterminados.
   3. Si ha utilizado Design Studio anteriormente, es posible que desee cambiar la configuración seleccionada según corresponda.

   4. Haga clic en el botón Crear.

      

3. Una vez que se haya creado el nuevo proyecto, la pantalla debería ser similar a la imagen que se muestra a continuación. El extremo izquierdo del Design Studio muestra las diferentes partes de la integración: Operaciones, Transformaciones, etc. En el lado izquierdo, desplácese hacia abajo hasta que vea la categoría Conectores. Haga doble clic en Conector de QuickBooks para que las actividades subyacentes sean visibles.

   

4. Luego, haga clic derecho en Extremos de QuickBooks como se ve en la imagen a continuación y seleccione Nuevo Extremo de QuickBooks de la lista.

   

5. En el lado derecho de la pantalla, debería ver una nueva pestaña en su espacio de trabajo llamada Extremos de QuickBooks. Aquí es donde configurará la capacidad de conectar Harmony a su instancia de sandbox de QuickBooks utilizando los valores que se obtuvieron anteriormente en esta documentación.

   

   1. Ingrese un nombre apropiado para el extremo en el campo Nombre. Para los fines de este ejemplo, llamaremos a nuestro extremo "Nuevo Extremo de QuickBooks ".
   2. Seleccione el botón de opción OAuth2. La pestaña mostrará ahora los campos de datos específicos necesarios para crear un extremo OAuth 2.0 de QuickBooks.
   3. ID de dominio: La ID de dominio se genera dentro de QuickBooks OAuth 2.0 Playground como se describe en Conector de QuickBooks OAuth 2.0: crear aplicación de QuickBooks.
      • Regresa a la ventana abierta del navegador que muestra la página OAuth 2.0 Playground.
      • Copie el ID de reino de la ventana del navegador y péguelo en el campo ID de reino dentro de la pestaña Nuevo Extremo de QuickBooks en Design Studio como se muestra en la imagen de arriba.
   4. *Código de autorización: *El código de autorización se genera dentro de QuickBooks OAuth 2.0 Playground como se describe en Conector de QuickBooks OAuth 2.0: crear aplicación de QuickBooks.
      • Regresa a la ventana abierta del navegador que muestra la página OAuth 2.0 Playground.
      • Copie el Código de autorización de la ventana del navegador y péguelo en el campo Código de autorización dentro de la pestaña Nuevo Extremo de QuickBooks en Design Studio como se muestra en la imagen de arriba.
   5. ID de cliente: La ID de cliente se genera durante la creación de la aplicación QuickBooks como se describe en Conector QuickBooks OAuth 2.0 - crear aplicación QuickBooks.
      • Regresa a la ventana abierta del navegador que muestra la página OAuth 2.0 Playground.
      • En el menú de la parte superior de la página, haga clic en Mis aplicaciones.
      • Seleccione la aplicación que creó durante la etapa de prueba y desarrollo específicamente para configurar Harmony QuickBooks Connector.
      • Haga clic en la pestaña Teclas.
      • Las Claves de desarrollo se muestran en la parte superior de la página.
      • Haga clic en el botón Copiar a la derecha de ID de cliente dentro de la pestaña Claves y péguelo en el campo ID de cliente dentro de la pestaña Nuevo Extremo de QuickBooks en Design Studio como se muestra en la imagen de arriba.
   6. Secreto del cliente: El secreto del cliente se genera durante la creación de la aplicación QuickBooks como se describe en Conector QuickBooks OAuth 2.0 - crear aplicación QuickBooks.
      • Regresa a la ventana abierta del navegador que muestra las Claves de desarrollo.
      • Haga clic en el botón Copiar a la derecha del Secreto del cliente dentro de la pestaña Claves y péguelo en el campo Secreto del cliente dentro de la pestaña Nuevo Extremo de QuickBooks en Design Studio como se muestra en la imagen de arriba.
   7. URL: Este valor es la URL del ambiente sandbox de QuickBooks o del ambiente de producción de QuickBooks, según el que esté utilizando. Puede copiarlo y pegarlo en el campo de texto de URL como se muestra en la imagen de arriba:
      • Ambiente de prueba: https://sandbox-quickbooks.api.intuit.com/v3/company
   8. Una vez que se hayan suministrado todos los valores necesarios, haga clic en el icono Guardar** en la barra de herramientas de Design Studio.
   9. Se debe probar la conexión para verificar que todo esté configurado correctamente. Para ello, haga clic en el botón Probar conexión. Se debe mostrar la siguiente ventana emergente una vez que Harmony se haya conectado correctamente a QuickBooks.
   10. El mensaje anterior confirma que la conexión de sandbox recién creada es válida y está funcionando. Si la conexión no es exitosa, se deben verificar dos veces los valores proporcionados para asegurarse de que no haya espacios adicionales o que no se haya copiado y pegado completamente un valor en una de las propiedades de conexión.

Configuración de la conexión al sandbox de QuickBooks en varios agentes

Si su grupo de agentes privados contiene más de un agente privado, complete estos pasos:

1. QuickBooks crea este archivo cuando la conexión es exitosa: "C:\ProgramData\qbdata\qbdata.properties". Este archivo se crea solo en uno de los agentes privados del grupo de agentes, pero es necesario para que QuickBooks se comunique con cada agente.
2. Busque cada agente privado dentro del grupo de agentes para determinar en qué agente reside el archivo "qbdata.properties".
3. Copie toda la carpeta "\qbdata" en la carpeta "c:\ProgramData" en cada uno de los agentes restantes dentro del grupo de agentes. Esto permite que todos los agentes dentro del grupo de agentes se comuniquen con QuickBooks.

Próximo paso: Una vez que su extremo de Harmony se haya conectado exitosamente a su instancia de sandbox de QuickBooks, el siguiente paso es crear las actividades apropiadas para integrar su instancia de QuickBooks Online con otros programas y aplicaciones.

Conector de QuickBooks : actividades de consultar

Conector QuickBooks : crear actividades

Conector de QuickBooks : actividades de actualización

Conector QuickBooks : eliminar actividades

Extremo de producción

Cuando esté listo para llevar su integración a un ambiente de producción, siga los pasos a continuación para crear un extremo de producción en Design Studio.

1. Abra la aplicación Design Studio, versión 8.29.2 o posterior. Seleccione un proyecto de QuickBooks existente en la pestaña Proyectos recientes y haga clic en el botón Abrir, o haga clic en la pestaña Nuevo proyecto y cree un nuevo proyecto.
2. En el lado izquierdo de Design Studio, desplácese hacia abajo hasta que vea la categoría Conectores. Haga doble clic en Conector de QuickBooks para que las actividades subyacentes sean visibles.
3. Haga clic derecho en Extremos de QuickBooks y seleccione Nuevo Extremo de QuickBooks de la lista.
4. En el lado derecho de la pantalla, debería ver una nueva pestaña en su espacio de trabajo llamada Extremos de QuickBooks. Aquí es donde configurará la capacidad de conectar Harmony a su instancia de producción de QuickBooks utilizando los valores que se obtuvieron anteriormente en esta documentación.
   1. Ingrese un nombre apropiado para el extremo en el campo Nombre. Para los fines de este ejemplo, llamaremos a nuestro extremo "Producción de QuickBooks ".
   2. Seleccione el botón de opción OAuth2. La pestaña mostrará ahora los campos de datos específicos necesarios para crear un extremo OAuth 2.0 de QuickBooks.
   3. ID de dominio: La ID de dominio se genera dentro de QuickBooks OAuth 2.0 Playground como se describe en Conector de QuickBooks OAuth 2.0: crear aplicación de QuickBooks.
      • Regresa a la ventana abierta del navegador que muestra la página OAuth 2.0 Playground.
      • Copie el Realm ID de la ventana del navegador y péguelo en el campo Realm ID dentro de la pestaña QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
   4. Código de autorización: El código de autorización se genera dentro de QuickBooks OAuth 2.0 Playground como se describe en Conector de QuickBooks OAuth 2.0: crear aplicación de QuickBooks.
      • Regresa a la ventana abierta del navegador que muestra la página OAuth 2.0 Playground.
      • Copie el Código de autorización de la ventana del navegador y péguelo en el campo Código de autorización dentro de la pestaña Extremo de QuickBooks en Design Studio como se muestra en la imagen de arriba.
   5. ID de cliente: La ID de cliente se genera durante la creación de la aplicación QuickBooks como se describe en Conector QuickBooks OAuth 2.0 - crear aplicación QuickBooks.
      • Regresa a la ventana abierta del navegador que muestra la página OAuth 2.0 Playground.
      • En el menú de la parte superior de la página, haga clic en Mis aplicaciones.
      • Seleccione la aplicación que creó durante la etapa de prueba y desarrollo específicamente para configurar Harmony QuickBooks Connector.
      • Haga clic en la pestaña Teclas.
      • Desplácese hacia abajo hasta la sección Claves de producción.
      • Haga clic en el botón Mostrar a la derecha del ID de cliente dentro de la pestaña Claves. Se mostrará el ID de cliente.
      • Haga clic en el botón Copiar a la derecha de ID de cliente y péguelo en el campo ID de cliente dentro de la pestaña Extremo de QuickBooks en Design Studio como se muestra en la imagen de arriba.
   6. Secreto del cliente: El secreto del cliente se genera durante la creación de la aplicación QuickBooks como se describe en Conector QuickBooks OAuth 2.0 - crear aplicación QuickBooks.
      • Regresa a la ventana abierta del navegador que muestra la sección Claves de producción.
      • Haga clic en el botón Mostrar a la derecha del Secreto del cliente dentro de la pestaña Claves. Se mostrará el secreto del cliente.
      • Haga clic en el botón Copiar a la derecha del Secreto del cliente y péguelo en el campo Secreto del cliente dentro de la pestaña Extremo de QuickBooks en Design Studio como se muestra en la imagen de arriba.
   7. URL: Este valor es la URL del ambiente sandbox de QuickBooks o del ambiente de producción de QuickBooks, según el que esté utilizando. Puede copiarlo y pegarlo en el campo de texto de URL como se muestra en la imagen de arriba:
5. Ambiente de producción: https://quickbooks.api.intuit.com/v3/company
6. Una vez que se hayan suministrado todos los valores necesarios, haga clic en el icono Guardar** en la barra de herramientas de Design Studio.
7. Se debe probar la conexión para verificar que todo esté configurado correctamente. Para ello, haga clic en el botón Probar conexión. Se debe mostrar la siguiente ventana emergente una vez que Harmony se haya conectado correctamente a QuickBooks.
8. El mensaje anterior confirma que la conexión de producción recién creada es válida y está funcionando. Si la conexión no es exitosa, se deben verificar dos veces los valores proporcionados para asegurarse de que no haya espacios adicionales o que no se haya copiado y pegado completamente un valor en una de las propiedades de conexión.

Configuración de la conexión a la producción de QuickBooks en varios agentes

Si su grupo de agentes privados contiene más de un agente privado, complete estos pasos:

1. QuickBooks crea este archivo cuando la conexión es exitosa: "C:\ProgramData\qbdata\qbdata.properties". Este archivo se crea solo en uno de los agentes privados del grupo de agentes, pero es necesario para que QuickBooks se comunique con cada agente.
2. Busque cada agente privado dentro del grupo de agentes para determinar en qué agente reside el archivo "qbdata.properties".
3. Copie toda la carpeta "\qbdata" en la carpeta "c:\ProgramData" en cada uno de los agentes restantes dentro del grupo de agentes. Esto permite que todos los agentes dentro del grupo de agentes se comuniquen con QuickBooks.