Integración · ERP y sistemas de gestión
Conectar QuickBooks Online a Igniten
Permite consultar en vivo y crear maestros, facturas y registrar cobros o pagos contables con tarjeta. La conexión usa una cuenta o app de integración con el rol mínimo necesario, nunca la credencial personal del administrador. Cada persona ve sólo la intersección entre lo que ve ese usuario en QuickBooks Online y sus concesiones: erp.quickbooks_maestros muestra clientes, proveedores y productos; erp.quickbooks_ventas muestra facturas, vencimientos, saldos y notas de crédito y presupuestos; erp.quickbooks_compras muestra órdenes de compra; erp.quickbooks_finanzas muestra cobros registrados y cuentas contables. Sin concesión, no se consulta. La concesión de lectura no permite actuar; escribir exige el permiso de acción del módulo y tarjeta.
¿Qué puede preguntarle a QuickBooks por WhatsApp o Teams?
Con QuickBooks conectado, cualquier persona autorizada le escribe a Igniten en español, por WhatsApp o Teams, y la respuesta sale de leer QuickBooks en el momento, sólo de los módulos que habilitó. Algunos ejemplos:
- ¿Cuál es el saldo pendiente de la factura <número>?
- ¿Qué cobros de <cliente> se registraron esta semana?
- ¿Qué precio tiene cargado <producto>?
- ¿Qué órdenes de compra hay abiertas con <proveedor>?
Las sumas por período, como cuánto vendimos por mes, salen de la base que conectó como fuente de datos, no de esta conexión. Las respuestas llegan en 10 a 30 segundos por WhatsApp, Microsoft Teams, Google Chat o Slack. Vea también analítica conversacional por WhatsApp e integración con Microsoft Teams.
Qué lee Igniten, y qué no
Lee
- Clientes/contactos y productos en vivo
- Facturas con vencimiento y saldo
- Registros contables de cobros y pagos
- Cuentas contables; sin datos bancarios completos
No lee
- Números completos de cuentas bancarias, PAN y CVV
- Módulos sin concesión
- Otras empresas o conexiones
Cómo se conecta
3 pasos · ≈ 10 min
-
Cree la aplicación de su empresa
En QuickBooks Online, abra el portal de desarrolladores (el lugar donde se autoriza a otra aplicación) y elija crear una aplicación; verá sus datos.
developer.intuit.com → My Apps → Production Settings → Keys & credentials- Lo tiene que hacer alguien con permiso de administrador de QuickBooks Online. Si no es usted, mándele este enlace. Intuit evalúa la aplicación antes de entregar claves de producción; requiere completar App Assessment Questionnaire y la espera depende de Intuit, sin plazo garantizado.
- Cree una aplicación de integración exclusiva y un usuario de integración con el rol mínimo necesario en los módulos que vaya a conectar. No use la cuenta personal del administrador. En el panel de Igniten, Integraciones (/integrations/), copie la dirección de vuelta y regístrela en la aplicación; después verá su identificador y contraseña.
Salió bien si Ve los datos de la aplicación
-
Guarde los datos de la aplicación
En el panel de administración de Igniten, abra Integraciones (/integrations/), elija QuickBooks Online y complete Identificador de la aplicación y Contraseña de la aplicación. Toque Guardar; verá la conexión guardada. No pegue un JSON ni tokens de acceso.
developer.intuit.com → My Apps → Production Settings → Keys & credentials- El identificador de la aplicación (el nombre que usa el proveedor para reconocer a Igniten) no es su usuario.
- La contraseña de la aplicación (client secret en la consola) va en el campo protegido. Nunca la pegue en el chat.
Salió bien si Ve la conexión guardada
-
Autorice la cuenta
En Integraciones del panel de Igniten (/integrations/), toque Conectar sólo lectura. Inicie sesión en QuickBooks Online con el usuario de integración y permita la conexión; volverá al panel. Para cambiar datos, toque Autorizo escritura con tarjeta y revise ese consentimiento separado.
developer.intuit.com → My Apps → Production Settings → Keys & credentials- OAuth (el permiso que da al iniciar sesión con el proveedor) permite conectar la cuenta sin compartir su contraseña personal.
- Intuit da un único permiso contable para leer y escribir. Igniten guarda aparte su consentimiento de acción: Conectar sólo lectura no habilita escribir; Autorizo escritura con tarjeta sí. Cada cambio exige una tarjeta de confirmación.
Salió bien si Ve la confirmación de autorización
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
com.intuit.quickbooks.accounting | Para consultar sólo módulos concedidos. | Siempre |
consentimiento de acción guardado aparte del alcance contable de Intuit | Para registrar los cambios permitidos, siempre con tarjeta. | Quiere habilitar cambios además de consultas. |
Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.
Qué puede salir mal
- 401: conexión vencida o revocada
-
Por qué El proveedor rechazó los datos o el permiso.
Qué hacer Vuelva a conectar desde el panel y revise la cuenta de integración.
- 403: permiso denegado
-
Por qué Falta permiso del módulo o consentimiento de acción.
Qué hacer Pídale al administrador que revise el rol mínimo, los módulos y el consentimiento.
- 429: demasiados pedidos
-
Por qué El proveedor pidió esperar.
Qué hacer Espere el tiempo indicado y acote el pedido.
- Faltan datos del documento
-
Por qué No se completaron los campos o líneas obligatorios.
Qué hacer Complete los campos y líneas antes de preparar la tarjeta.
Los límites, dichos
- Hasta 100 resultados y 10 llamadas por pedido por defecto.
- Sin borrar, fusionar, transferir ni ejecutar pagos reales.
- Crear una factura la registra en la contabilidad; no hay garantía de borrador. No se envía al cliente.
- No se suman filas locales para reportes.
Preguntas frecuentes
¿Dónde encuentro la clave?
En la aplicación de integración del proveedor, copie el identificador y su contraseña a los dos campos del panel Integraciones (/integrations/). Registre la dirección de vuelta que muestra el panel. Conecte sólo lectura primero; no pegue tokens ni JSON en el campo protegido.
Me dice 403. ¿Qué hago?
403 significa permiso denegado. Pídale al administrador que revise el rol mínimo del usuario de integración, la empresa y los módulos concedidos. Nunca amplíes a administrador por defecto.
¿Puede borrar cosas?
Igniten no borra ni fusiona registros y no mueve plata. Puede crear maestros, facturas y registrar cobros o pagos contables, siempre con confirmación. Crear una factura la registra en la contabilidad; no hay garantía de borrador. No se envía al cliente.
No soy administrador.
Pídale al administrador que prepare la app o el usuario de integración con el rol mínimo necesario. Conectar no le da módulos sin concesión.
¿Cuánto tarda?
Con los datos a mano, aproximadamente 5 a 10 minutos. Intuit evalúa la aplicación para claves de producción; la espera depende de Intuit y no tiene plazo garantizado.
¿Qué ve Igniten?
La conexión usa una cuenta o app de integración con el rol mínimo necesario, nunca la credencial personal del administrador. Cada persona ve sólo la intersección entre lo que ve ese usuario en QuickBooks Online y sus concesiones: erp.quickbooks_maestros muestra clientes, proveedores y productos; erp.quickbooks_ventas muestra facturas, vencimientos, saldos y notas de crédito y presupuestos; erp.quickbooks_compras muestra órdenes de compra; erp.quickbooks_finanzas muestra cobros registrados y cuentas contables. Sin concesión, no se consulta. La concesión de lectura no permite actuar; escribir exige el permiso de acción del módulo y tarjeta. Consulta en vivo, sin espejo analítico ni números completos de cuentas bancarias, PAN o CVV.
¿Cómo lo desconecto?
En Conexiones, abra QuickBooks Online y toque Desconectar, o revoque la clave en Integraciones del panel. Después revoque la autorización de la app en el proveedor.
Pegué un secreto en el chat.
No pegue secretos en el chat. Revoque la clave expuesta y genere una nueva; guárdela sólo en el campo protegido. El agente de ayuda no la usa.
¿Puede crear una factura?
Crear una factura la registra en la contabilidad; no hay garantía de borrador. No se envía al cliente. La tarjeta explica el efecto contable antes de confirmar. Registrar un cobro o pago en el libro no mueve fondos ni inicia un pago real.