Saltar al contenido

QuickBooks Connector OAuth 1.0a Crear un Extremo

Advertencia

Todos los usuarios existentes de QuickBooks deben migrar a la autenticación OAuth 2.0 antes del 17 de diciembre de 2019. Consulte la publicación del blog para desarrolladores de Intuit del 10 de abril de 2019 y el Blog de Intuit OAuth para informacion adicional.

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

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

Nota

Si aún no está familiarizado con Harmony, puede visitar Guía de inicio rápido de Design Studio para obtener información detallada sobre cómo utilizar el producto. A los efectos de esta documentación, se utilizan ejemplos sencillos a modo de demostración.

Extremo de Prueba

  1. Abra la aplicación Design Studio, versión 8.10 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 mostrarse la pantalla Comenzando, donde puede elegir realizar una variedad de tareas. A los efectos de este recorrido, 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 apropiado para su nuevo proyecto y luego seleccione otras configuraciones que sean apropiadas para su organización. A los efectos de este ejemplo, llamaremos a nuestro proyecto "QuickBooks OAuth 1.0a".
    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.

      archivo adjunto

  3. Una vez que se haya creado su nuevo proyecto, su pantalla debería ser similar a la imagen que se muestra a continuación. El extremo izquierdo de Design Studio muestra las diferentes partes de su integración: operaciones, Transformaciones, etc. En el extremo izquierdo, desplácese hacia abajo hasta que vea la categoría Conectores. Haga doble clic en QuickBooks Connector para que las actividades subyacentes sean visibles. Luego haga clic derecho en QuickBooks Extremos como se ve en la imagen a continuación y seleccione New QuickBooks Extremo de la lista.

    archivo adjunto

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

    archivo adjunto

    1. Ingrese un nombre apropiado para el extremo en el campo Nombre. A los efectos de este ejemplo, llamaremos a nuestro extremo "QuickBooks Extremo OAuth 1.0a".
    2. Seleccione el botón de opción OAuth1. La pestaña ahora mostrará los campos de datos específicos requeridos para crear un extremo de QuickBooks OAuth 1.0a.
    3. Clave de consumidor: La clave de consumidor se genera durante la creación de la aplicación QuickBooks como se describe en QuickBooks Connector OAuth 1.0a - Crear aplicación QuickBooks y se encuentra en la pestaña Claves en la página Mis aplicaciones dentro del sitio web para desarrolladores de Intuit. La clave del consumidor también se usó en OAuth Playground para generar el token de acceso y el secreto del token.
      • Regrese a la ventana del navegador abierta que muestra la página OAuth Playground.
      • Copie la Clave de consumidor de la página OAuth Playground y péguela en el campo Clave de consumidor dentro de la pestaña de prueba QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
    4. Secreto del consumidor: El secreto del consumidor se genera durante la creación de la aplicación QuickBooks como se describe en QuickBooks Connector OAuth 1.0a - Crear aplicación QuickBooks y se encuentra en la pestaña Claves en la página Mis aplicaciones dentro del sitio web para desarrolladores de Intuit. El secreto del consumidor también se usó en OAuth Playground para generar el token de acceso y el token secreto.
      • Regrese a la ventana del navegador abierta que muestra la página OAuth Playground.
      • Copie el Secreto del consumidor de la página OAuth Playground y péguelo en el campo Secreto del consumidor dentro de la pestaña de prueba QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
    5. Token de acceso: El token de acceso se genera dentro de QuickBooks OAuth Playground como se describe en QuickBooks Connector OAuth 1.0a - Crear aplicación de QuickBooks.
      • Regrese a la ventana del navegador abierta que muestra la página OAuth Playground.
      • Copie el Token de acceso de la página OAuth Playground y péguelo en el campo Token de acceso dentro de la pestaña de prueba QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
    6. Token Secret: El Token Secret se genera dentro de QuickBooks OAuth Playground como se describe en QuickBooks Connector OAuth 1.0a - Crear aplicación QuickBooks.
      • Regrese a la ventana del navegador abierta que muestra la página OAuth Playground.
      • Copie el Token Secret de la ventana del navegador y péguelo en el campo Token Secret dentro de la pestaña de prueba QuickBooks Extremo en Design Studio como que se muestra en la imagen de arriba.
    7. ID de dominio: El ID de dominio se genera dentro de QuickBooks OAuth Playground como se describe en QuickBooks Connector OAuth 1.0a - Crear aplicación de QuickBooks.
      • Regrese a la ventana del navegador abierta que muestra la página OAuth Playground.
      • Copie el RealmId de la ventana del navegador y péguelo en el campo Realm ID dentro de la pestaña de prueba QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
    8. Token de la aplicación: el token de la aplicación se genera dentro del sitio web de desarrolladores de Intuit como se describe en QuickBooks Connector OAuth 1.0a - Crear una aplicación de QuickBooks y se encuentra en la pestaña Claves en la página Mis aplicaciones dentro del sitio web para desarrolladores de Intuit.
      • Regrese a la ventana del navegador abierta que muestra la pestaña Panel de control dentro de su aplicación en el sitio web de Intuit Developer.
      • Seleccione la pestaña Claves.
      • Dentro de la sección Claves de desarrollo en la pestaña Claves, haga clic en el botón Copiar a la derecha del Token de la aplicación y péguelo en el Campo Token de aplicación dentro de la pestaña de prueba QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
    9. URL: Este valor es la URL del ambiente de pruebas de QuickBooks o del ambiente de producción de QuickBooks, según el que esté utilizando. Se puede copiar y pegar en el campo de texto de su URL como se muestra en la imagen de arriba:
    10. Entorno de espacio aislado: https://sandbox-quickbooks.api.intuit.com/v3/company

  5. Una vez que se hayan proporcionado todos los valores necesarios, haga clic en el icono Guardar** en la barra de herramientas de Design Studio.

  6. Se debe probar la conexión para verificar que todo esté configurado correctamente. Para hacerlo, haga clic en el botón Probar conexión. La siguiente ventana emergente debería mostrarse una vez que Harmony se haya conectado con éxito a QuickBooks.

    archivo adjunto

  7. El mensaje anterior confirma que la conexión de sandbox recién creada es válida y funciona. Si la conexión no es exitosa, los valores proporcionados deben verificarse dos veces para asegurarse de que no haya espacios adicionales, o que un valor no se haya copiado y pegado completamente en una de las propiedades de la conexión.

Siguiente paso: Una vez que su extremo de Harmony se haya conectado con éxito a su instancia de espacio aislado de QuickBooks, su próximo paso es crear las actividades apropiadas para integrar su instancia de QuickBooks Online con otros programas y aplicaciones.

Conector QuickBooks - Actividades de consulta

Conector QuickBooks - Crear actividades

QuickBooks Connector - Actualizar actividades

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.10 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 QuickBooks Connector para que las actividades subyacentes sean visibles.
  3. Haga clic con el botón derecho en QuickBooks Extremos y seleccione New QuickBooks Extremo de la lista.

  4. En el lado derecho de la pantalla, debería ver una nueva pestaña en su espacio de trabajo llamada QuickBooks Extremos. 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.

    archivo adjunto

    1. Ingrese un nombre apropiado para el extremo en el campo Nombre. A los efectos de este ejemplo, llamaremos a nuestro extremo "QuickBooks Extremo 1.0 Prod".
    2. Seleccione el botón de opción OAuth1. La pestaña ahora mostrará los campos de datos específicos requeridos para crear un extremo de QuickBooks OAuth 1.0a.
    3. Clave de consumidor: La clave de consumidor se genera durante la creación de la aplicación QuickBooks como se describe en QuickBooks Connector OAuth 1.0a - Crear aplicación QuickBooks y se encuentra en la pestaña Claves en la página Mis aplicaciones dentro del sitio web para desarrolladores de Intuit. La clave del consumidor también se usó en OAuth Playground para generar el token de acceso y el secreto del token.
      • Regrese a la ventana del navegador abierta que muestra la página OAuth Playground.
      • Copie la Clave de consumidor de la página OAuth Playground y péguela en el campo Clave de consumidor dentro de la pestaña de producción QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
    4. Secreto del consumidor: El secreto del consumidor se genera durante la creación de la aplicación QuickBooks como se describe en QuickBooks Connector OAuth 1.0a - Crear aplicación QuickBooks y se encuentra en la pestaña Claves en la página Mis aplicaciones dentro del sitio web para desarrolladores de Intuit. El secreto del consumidor también se usó en OAuth Playground para generar el token de acceso y el token secreto.
      • Regrese a la ventana del navegador abierta que muestra la página OAuth Playground.
      • Copie el Secreto del consumidor de la página OAuth Playground y péguelo en el campo Secreto del consumidor dentro de la pestaña de producción QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
    5. Token de acceso: El token de acceso se genera dentro de QuickBooks OAuth Playground como se describe en QuickBooks Connector OAuth 1.0a - Crear aplicación de QuickBooks.
      • Regrese a la ventana del navegador abierta que muestra la página OAuth Playground.
      • Copie el Token de acceso de la página OAuth Playground y péguelo en el campo Token de acceso dentro de la pestaña de producción QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
    6. Token Secret: El Token Secret se genera dentro de QuickBooks OAuth Playground como se describe en QuickBooks Connector OAuth 1.0a - Crear aplicación QuickBooks.
      • Regrese a la ventana del navegador abierta que muestra la página OAuth Playground.
      • Copie el Token Secret de la ventana del navegador y péguelo en el campo Token Secret dentro de la pestaña de producción QuickBooks Extremo en Design Studio como que se muestra en la imagen de arriba.
    7. ID de dominio: El ID de dominio se genera dentro de QuickBooks OAuth Playground como se describe en QuickBooks Connector OAuth 1.0a - Crear aplicación de QuickBooks.
      • Regrese a la ventana del navegador abierta que muestra la página OAuth Playground.
      • Copie el RealmId de la ventana del navegador y péguelo en el campo Realm ID dentro de la pestaña de producción QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
    8. Token de la aplicación: el token de la aplicación se genera dentro del sitio web de desarrolladores de Intuit como se describe en QuickBooks Connector OAuth 1.0a - Crear una aplicación de QuickBooks y se encuentra en la pestaña Claves en la página Mis aplicaciones dentro del sitio web para desarrolladores de Intuit.
      • Regrese a la ventana del navegador abierta que muestra la pestaña Panel de control dentro de su aplicación en el sitio web de Intuit Developer.
      • Seleccione la pestaña Claves.
      • Desplácese hacia abajo hasta la sección Claves de producción en la pestaña Claves, haga clic en el botón Copiar a la derecha del Token de aplicación y pegue en el campo App Token dentro de la pestaña de producción QuickBooks Extremo en Design Studio como se muestra en la imagen de arriba.
    9. URL: Este valor es la URL del ambiente de pruebas de QuickBooks o del ambiente de producción de QuickBooks, según el que esté utilizando. Se puede copiar y pegar en el campo de texto de su URL como se muestra en la imagen de arriba:
    10. Entorno de producción: https://quickbooks.api.intuit.com/v3/company

  5. Una vez que se hayan proporcionado todos los valores necesarios, haga clic en el icono Guardar** en la barra de herramientas de Design Studio.

  6. Se debe probar la conexión para verificar que todo esté configurado correctamente. Para hacerlo, haga clic en el botón Probar conexión. La siguiente ventana emergente debería mostrarse una vez que Harmony se haya conectado con éxito a QuickBooks.

    archivo adjunto

  7. El mensaje anterior confirma que la conexión de producción recién creada es válida y funciona. Si la conexión no es exitosa, los valores proporcionados deben verificarse dos veces para asegurarse de que no haya espacios adicionales, o que un valor no se haya copiado y pegado completamente en una de las propiedades de la conexión.

Siguiente paso: Una vez que su extremo de Harmony se haya conectado con éxito a su instancia de producción de QuickBooks, su próximo paso es crear las actividades apropiadas para integrar su instancia de QuickBooks Online con otros programas y aplicaciones.

Conector QuickBooks - Actividades de consulta

Conector QuickBooks - Crear actividades

QuickBooks Connector - Actualizar actividades

Conector QuickBooks - Eliminar actividades