Saltar al contenido

Guía de conexión OAuth de QuickBooks Online para Jitterbit App Builder

Requisitos previos

  • Debes tener una cuenta de Intuit Developer

Configuración en Intuit Developer

  1. Inicia sesión en tu cuenta de Intuit Developer.
  2. En el menú de la esquina superior derecha de la página, selecciona Dashboard.
  3. Crea una nueva aplicación haciendo clic en el botón + Create App.
  4. Selecciona Quickbooks Online and Payments como la plataforma para la que deseas desarrollar.
  5. Proporciona un nombre de aplicación y selecciona los scopes para las APIs a las que deseas acceder.

    Ejemplo de aplicación con scopes seleccionados

  6. Una vez que se ha creado la aplicación, navega a la página Keys & Credentials desde el menú del lado izquierdo. Aquí puedes encontrar tu Client ID y Client Secret, asegúrate de anotar estos valores.

  7. En la misma página también configurarás el Redirect URI para el proveedor de seguridad en la instancia de App Builder. Si conoces el nombre de tu proveedor, puedes continuar y configurarlo ahora, o si no, podemos hacerlo más tarde. En este ejemplo, el nombre del proveedor es QBOnlineSupport. El formato de la URL de redirección debe ser https://<App Builder-Instance>/signin-<Security-Provider-Name>.

    Ejemplo que muestra los campos Client ID, Client Secret y URL de redirección

Configuración en App Builder

Crear un proveedor de seguridad

Después de crear una aplicación OAuth personalizada en el portal de desarrolladores de Intuit, crearás un proveedor de seguridad en App Builder.

  1. Navega a la sección Security Providers desde el IDE y crea un nuevo proveedor de seguridad usando el botón + Security Provider.
  2. Proporciona los siguientes detalles:
    • Name - Identifica el Security Provider y aparece en la URL. Ejemplo: QuickBooksOnline
    • Type - OAuth
    • Authentication Type - OAuth
    • OAuth Grant - Authorization Code
    • OAuth Client Authentication - Basic
    • OAuth Resource Authentication - Bearer
    • Token Owner - User
    • Redirect on Challenge - True
  3. Haz clic en + Endpoints y configura los siguientes 2 endpoints:
    • Authorization Endpoint - https://appcenter.intuit.com/connect/oauth2
    • Token Endpoint - https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer
  4. Haz clic en + Credential:
    • Type - Client
    • User Name - Client ID de la aplicación OAuth personalizada
    • Password - Client Secret de la aplicación OAuth personalizada
  5. En la sección Properties, haz clic en el botón + Property para agregar una nueva propiedad.
    • El Value debe ser com.intuit.quickbooks.accounting.
  6. Si no configuraste el Redirect URI en la aplicación OAuth personalizada en el portal de Intuit Developer para este nombre de proveedor de seguridad, adelante y hazlo ahora. (Paso 7 de la sección anterior) - El nombre de la propiedad debe ser Scopes.
  7. Esto completa la configuración del Security Provider.

Crear datasource de QuickBooks Online

Ahora que has creado una aplicación OAuth personalizada y un proveedor de seguridad, crearás el Datasource de QuickBooks Online.

  1. Desde el IDE, haz clic en Data Servers.
  2. Haz clic en el botón + Server.
  3. Asigna un nombre al servidor y selecciona el Type como Quick Books Online.

    Ejemplo de servidor QuickBooks Online

  4. Para el Instance Name, necesitaremos navegar de vuelta al portal de Intuit Developer. El Instance Name se encuentra en la página sandbox de tu empresa.

  5. En la esquina superior derecha de la página en el portal de Intuit Developer, haz clic en el icono de User y luego en Sandbox.
  6. Esto debe abrir la página Manage sandbox companies, donde puedes hacer clic en tu sandbox.
  7. En la página sandbox, haz clic en el icono de engranaje ubicado en la esquina superior derecha de la página y luego haz clic en Additional info.

    Enlace de Additional info en el portal de Intuit Developer

  8. Aquí encontrarás el Company ID que es lo que usaremos para el Instance Name en App Builder.

  9. Regresando a App Builder, configura el Instance Name, agrega el Security Provider que creamos en la sección Security Settings.

    Adding the QuickBooks security provider in App Builderg

  10. Ahora que hemos creado la aplicación OAuth personalizada, el proveedor de seguridad y la fuente de datos, estamos listos para hacer la prueba.

  11. Prueba la conexión usando el botón Test Connection y marca el campo Allow challenge.
  12. Si todo se ha configurado correctamente, deberías ver un mensaje de éxito. Ahora estás listo para importar tablas y trabajar con esta fuente de datos.