Conector de QuickBooks OAuth 1.0a para crear una aplicación de QuickBooks

Antes de comenzar, asegúrese de cumplir con los requisitos definidos en Conector QuickBooks OAuth 1.0a - requisitos previos.

Configurar una aplicación de QuickBooks Online es la primera de las dos actividades principales que debe realizar dentro de QuickBooks para permitir que Jitterbit acceda a su instancia de QuickBooks Online. Durante la creación de su aplicación de QuickBooks Online, también generará un token de aplicación, una clave de consumidor, un secreto de consumidor, un token de acceso y un secreto de acceso únicos para ingresarlos en Jitterbit Design Studio más adelante en el proceso de configuración.

Los siguientes pasos muestran cómo crear su aplicación QuickBooks Online dentro de QuickBooks.

Ambiente de prueba

Estos pasos suponen que está utilizando una cuenta sandbox de QuickBooks mientras desarrolla y prueba su integración.

1. Vaya a https://developer.intuit.com/ e inicie sesión con las credenciales de su cuenta de QuickBooks.

2. En el menú de la parte superior de la página, haz clic en Mis aplicaciones. Si ya tienes aplicaciones creadas en tu cuenta, las verás aquí. Selecciona el botón Crear nueva aplicación para pasar a la página siguiente. Si aún no tienes ninguna aplicación creada, ya estarás en la página que se describe en el siguiente paso.

3. Ahora deberías ver una página similar a la que se muestra a continuación. En la sección Comienza a codificar, haz clic en el botón Seleccionar APIs.

4. Una ventana emergente le pedirá que seleccione la API. La API de "Contabilidad" es la API principal para la integración con QuickBooks Online y debe seleccionarse para la integración con Harmony. Marque la casilla de la API de Contabilidad y luego haga clic en el botón Crear aplicación.

5. Una vez creada la aplicación, se lo dirigirá a la pestaña Panel de control en la sección Desarrollo. La página Panel de control muestra una vista previa de los pasos que deberá seguir para configurar su nueva aplicación. Como su aplicación acaba de crearse, tendrá un nombre predeterminado de "Desconocido".

   Nota

   Puedes volver a tu aplicación en cualquier momento volviendo a Mis aplicaciones en el menú en la parte superior de cualquier página.

   

6. Vaya a la pestaña Claves. Las claves que aparecen en esta página se generaron previamente para su nueva aplicación. Estas claves serán necesarias en partes posteriores de esta documentación, tanto cuando genere tokens de acceso como para que el token de aplicación único ingrese en Design Studio más adelante. Volverá a esta pestaña más adelante.

   

7. Vaya a la pestaña Configuración. Aquí puede cambiar el título de su nueva aplicación, así como otra información según su proyecto de integración específico. Haga clic en la parte que desea editar para cambiar cualquier información de su aplicación y haga clic en el botón Guardar cuando se completen los cambios. En este ejemplo, el nombre de la aplicación se cambia a "JBTestOAuth1".

   

8. Regrese a la pestaña Panel de control. En la sección Recursos, haga clic en el enlace OAuth Playground.

   

9. Ahora debería ver una página similar a la que se muestra a continuación, indicando que se encuentra en el patio de juegos de OAuth.

   1. Cambie la Duración del token de acceso de la configuración predeterminada de 120 segundos a un número más grande, por ejemplo, 14000000 segundos. Este es el período durante el cual su token de acceso será válido, después del cual deberá generar un nuevo token para conectarse a su aplicación QuickBooks.
   2. Haga clic en el botón Conectarse a QuickBooks en el medio de la pantalla.

   

10. Aparecerá un mensaje de advertencia emergente que indica que abandonará el sitio. Seleccione el botón Abandonar.

11. Ahora debería ver una página similar a la que se muestra a continuación. Este es el paso final dentro de QuickBooks para autorizar a Harmony QuickBooks Connector a acceder a sus datos de QuickBooks Online. Seleccione el botón Conectar.

12. Ahora debería ver una página similar a la que se muestra a continuación, en la que se muestran el token de acceso, el secreto del token de acceso y el RealmId, así como la clave y el secreto del consumidor. Estas credenciales serán necesarias en secciones posteriores de esta documentación para ingresar a Design Studio. Deje esta página abierta en su navegador, ya que deberá regresar aquí más tarde.

Próximo paso: Conector QuickBooks OAuth 1.0a: crear extremo

Ambiente de producción

Cuando esté listo para llevar su integración a un ambiente de producción, siga los pasos a continuación para obtener claves de producción específicas para su aplicación.

1. Vaya a https://developer.intuit.com/ e inicie sesión con las credenciales de su cuenta de QuickBooks.

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

   

3. Ahora debería ver una página similar a la que se muestra a continuación. El perfil de la cuenta debe estar completo antes de que las claves de producción para su aplicación estén disponibles.

   1. Si ya completaste el perfil de tu cuenta, haz clic en la pestaña Configuración y continúa con el Paso 4.

   2. Si no ha completado el perfil de su cuenta anteriormente, desplácese hasta la sección 2. Active su aplicación y haga clic en el enlace Complete su perfil de cuenta. Complete la información en la página Perfil de cuenta y haga clic en el botón Guardar. Regrese a su aplicación de conector y haga clic en la pestaña Configuración.

      

4. Ahora debería ver una página similar a la que se muestra a continuación. Desplácese hacia abajo hasta la sección Enlaces a los términos del servicio. Ingrese la URL del acuerdo de licencia de usuario final y la URL de la política de privacidad para su aplicación. Haga clic en el botón Guardar.

   

5. Seleccione la pestaña Claves y desplácese hacia abajo hasta Claves de producción. Una vez que se hayan completado los vínculos de Perfil de cuenta y Condiciones de servicio, las claves de producción para su aplicación deberían aparecer de manera similar a la página que se muestra a continuación. Estas claves serán necesarias en secciones posteriores de esta documentación, tanto cuando genere los tokens de acceso de producción como para ingresar a Design Studio más adelante. Volverá a esta pestaña más adelante.

   

6. Regrese a la pestaña Panel de control. En la sección Recursos, haga clic en el enlace OAuth Playground. Deje esta ventana abierta en su navegador para que pueda regresar aquí más fácilmente más tarde.

7. Ahora debería ver una página similar a la que se muestra a continuación, que indica que se encuentra en el área de pruebas de OAuth. Deberá copiar las Claves de producción en los campos Clave de consumidor y Secreto de consumidor.

   

8. Regrese a la ventana abierta del navegador que muestra la página Intuit Developer Dashboard. Seleccione la pestaña Keys y desplácese hacia abajo hasta Production Keys.

   1. Seleccione el botón Mostrar a la derecha de la Clave de consumidor de OAuth para visualizar la clave. Haga clic en el botón Copiar, vuelva a la ventana del navegador que muestra el OAuth Playground y pegue la clave en el campo Clave de consumidor.
   2. Seleccione el botón Mostrar a la derecha del OAuth Consumer Secret para visualizar la clave. Haga clic en el botón Copiar, vuelva a la ventana del navegador que muestra el OAuth Playground y pegue la clave en el campo Consumer Secret.

   3. Haga clic en el botón Conectarse a QuickBooks en el centro de la página OAuth Playground.

      

9. Aparecerá un mensaje de advertencia emergente que indica que abandonará el sitio. Seleccione el botón Abandonar.

10. Ahora debería ver una página similar a la que se muestra a continuación. Este es el paso final dentro de QuickBooks para autorizar a Harmony QuickBooks Connector a acceder a su instancia de producción de QuickBooks Online. Seleccione el botón Conectar.

11. Ahora debería ver una página similar a la que se muestra a continuación, en la que se muestran Access Token, Access Token Secret y RealmId, así como también la Consumer Key y Consumer Secret. Estas credenciales serán necesarias en secciones posteriores de esta documentación para ingresar a Design Studio. Deje esta página abierta en su navegador, ya que deberá regresar aquí más tarde.

    

Próximo paso: Conector QuickBooks OAuth 1.0a: crear extremo