Conector QuickBooks OAuth 2.0 para crear una aplicación QuickBooks

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

Configurar una aplicación QuickBooks Online con autenticación OAuth 2.0 en QuickBooks es el primer paso para permitir que Harmony acceda a su instancia de QuickBooks Online. Durante la creación de su aplicación QuickBooks Online, también generará un ID de cliente, un secreto de cliente, un código de autorización y un ID de dominio 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 OAuth 2.0 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.

   Nota

   Si acaba de registrarse para una prueba de QuickBooks, es posible que deba aceptar las indicaciones para convertirse en un "desarrollador de Intuit". Esto es necesario para configurar el acceso de Harmony a 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.

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. Como la aplicación acaba de crearse, tendrá un nombre predeterminado de "Sin título".

   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 de desarrollo que aparecen en esta página se generaron previamente para su nueva aplicación. Estas claves serán necesarias en secciones posteriores de esta documentación, tanto cuando genere el código de autorización de la zona protegida como para ingresar a 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 "JBConnectorApp".

   

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, que indica que se encuentra en el área de pruebas de OAuth 2.0. Haga clic en Seleccionar ámbitos, pase el cursor sobre Contabilidad en la lista desplegable y haga clic en la casilla de verificación correspondiente a Contabilidad. Haga clic en el botón Obtener código de autorización.

   

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 Jitterbit 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 código de autorización de la zona protegida y el ID de dominio. El código de autorización y el ID de dominio serán necesarios en secciones posteriores de esta documentación para ingresar a Design Studio. Deje esta página abierta en su navegador para permitir el acceso a esta información mientras avanza al siguiente paso en la configuración de QuickBooks Connector.

    Advertencia

    NO seleccione ninguna acción adicional en esta página. Ahora tiene toda la información para ingresar en QuickBooks Connector para crear un extremo de sandbox. QuickBooks Connector regenera internamente el token de acceso utilizando el token de actualización cuando caduca. El token de acceso se genera dinámicamente y no se almacena. Si se selecciona el botón Obtener tokens, QuickBooks esperará que el conector pase el token de acceso generado en línea para autenticar y la conexión fallará. El proceso descrito en este documento solo se aplica a la aplicación que se usa específicamente para configurar Harmony QuickBooks Connector. Para crear cualquier otra aplicación de QuickBooks, deberá consultar el Blog para desarrolladores de Intuit.

    

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.

   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 del Perfil de cuenta y los Términos 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 el Código de autorización 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. Desplácese hacia abajo hasta la sección Recursos y haga clic en el enlace OAuth Playground.

   

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 2.0. Haga clic en el menú desplegable debajo de 1. Obtener código de autorización. La aplicación del conector muestra dos versiones. Seleccione la versión (Producción) en la lista.

   

8. Haga clic en Seleccionar ámbitos, pase el cursor sobre Contabilidad en la lista desplegable y haga clic en la casilla de verificación correspondiente a Contabilidad. Seleccione el botón Obtener código de autorización.

   

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 QuickBooks Connector a acceder a sus datos 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 el código de autorización de producción y el ID de dominio. El código de autorización y el ID de dominio serán necesarios en secciones posteriores de esta documentación para ingresar a Design Studio. Deje esta página abierta en su navegador para permitir el acceso a esta información mientras avanza al siguiente paso en la configuración de QuickBooks Connector para acceder a los datos de producción.

    Advertencia

    NO seleccione ninguna acción adicional en esta página. Ahora tiene toda la información para ingresar en QuickBooks Connector para crear un extremo de producción. QuickBooks Connector regenera internamente el token de acceso utilizando el token de actualización cuando caduca. El token de acceso se genera dinámicamente y no se almacena. Si se selecciona el botón Obtener tokens, QuickBooks esperará que el conector pase el token de acceso generado en línea para autenticar y la conexión fallará. El proceso descrito en este documento solo se aplica a la aplicación que se usa específicamente para configurar Jitterbit QuickBooks Connector. Para crear cualquier otra aplicación de QuickBooks, deberá consultar la Documentación del producto QuickBooks y/o el Blog para desarrolladores de Intuit.