Integración · ERP y sistemas de gestión
Conectar Xero 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 Xero y sus concesiones: erp.xero_maestros muestra contactos (clientes y proveedores) y productos; erp.xero_ventas muestra facturas (de venta o compra en Invoices), vencimientos, saldos, notas de crédito y presupuestos; erp.xero_compras muestra órdenes de compra; erp.xero_finanzas muestra registros de cobros/pagos 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 Xero por WhatsApp o Teams?
Con Xero conectado, cualquier persona autorizada le escribe a Igniten en español, por WhatsApp o Teams, y la respuesta sale de leer Xero en el momento, sólo de los módulos que habilitó. Algunos ejemplos:
- ¿Qué facturas siguen vencidas y sin cobrar?
- ¿Qué cobros se registraron hoy?
- ¿Qué datos de contacto tiene <cliente>?
- ¿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.
-
Facturas vencidas por WhatsApp sobre Xero (ejemplo)
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 Xero, abra el portal de desarrolladores (el lugar donde se autoriza a otra aplicación) y elija crear una aplicación; verá sus datos.
developer.xero.com → My Apps → New app- Lo tiene que hacer alguien con permiso de administrador de Xero. Si no es usted, mándele este enlace.
- 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 Xero 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.xero.com → My Apps → New app- 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 Xero 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.xero.com → My Apps → New app- OAuth (el permiso que da al iniciar sesión con el proveedor) permite conectar la cuenta sin compartir su contraseña personal.
- Para cambiar datos, autorice aparte la escritura. Cada cambio sigue pidiendo una tarjeta de confirmación en Igniten.
Salió bien si Ve la confirmación de autorización
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
offline_access, accounting.contacts.read, accounting.settings.read, accounting.invoices.read, accounting.payments.read | Para consultar sólo módulos concedidos. | Siempre |
accounting.contacts, accounting.settings, accounting.invoices, accounting.payments | 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.
- La factura se crea en DRAFT (borrador); Igniten no la emite ni la envía.
- 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. La factura se crea en DRAFT (borrador); Igniten no la emite ni la envía.
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. La preparación del usuario y su rol puede tardar más.
¿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 Xero y sus concesiones: erp.xero_maestros muestra contactos (clientes y proveedores) y productos; erp.xero_ventas muestra facturas (de venta o compra en Invoices), vencimientos, saldos, notas de crédito y presupuestos; erp.xero_compras muestra órdenes de compra; erp.xero_finanzas muestra registros de cobros/pagos 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 Xero 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?
La factura se crea en DRAFT (borrador); Igniten no la emite ni la envía. 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.