Cómo conectar ADM Cloud con Giro

Giro se conecta a ADM Cloud por su API REST con un usuario de ADM. Necesita cinco datos: App ID, Company, Role, Email API y Contraseña API.

Un usuario de ADM Cloud con acceso a la empresa y un rol que pueda ver y registrar lo que Giro hará (compras, pagos, depósitos, asientos). Lo más simple es un usuario solo para Giro con el rol de administradores.
En Giro, ser dueño o administrador de la empresa.

Lee: catálogo de cuentas, proveedores, clientes, artículos, impuestos, almacenes y los documentos de la empresa.
Escribe: solo lo que usted aprueba en una tarjeta (por ejemplo compras, pagos, depósitos, asientos o la firma de un e-CF).
Opcional: después de validar, Giro ofrece la «Lectura oficial de ADM». Es solo lectura y cada persona la autoriza con su propia cuenta de ADM.

Prepare el usuario de ADM para Giro. Configuración → Usuarios Cree un usuario (o elija uno) con acceso a la empresa y anote su correo y su contraseña.
Consiga el App ID. Es el identificador de aplicación que ADM Cloud da para usar su API. Si no lo tiene, pídalo a ADM Cloud.
Anote el Company. Es el identificador de la empresa en ADM Cloud, el mismo que usa la API. Si tiene varias empresas, use el de la que va a conectar.
Anote el Role. Configuración → Roles Es el nombre exacto del rol del usuario en ADM, con mayúsculas y en plural si así aparece (por ejemplo «Administradores»).
Complete el formulario y pulse «Validar y conectar». Giro hace una sola lectura del catálogo de cuentas para comprobar los datos. Si ADM los acepta, guarda la conexión y sigue con el almacén por defecto.

App ID: El identificador de aplicación de la API de ADM Cloud.
Company: El identificador de la empresa en ADM Cloud.
Role: El nombre exacto del rol del usuario en ADM (por ejemplo «Administradores»).
Email API: El correo con el que entra ese usuario a ADM.
Contraseña API: La contraseña de ese usuario.

«adm_auth_failed: 401» ADM rechazó los datos. Revise el correo y la contraseña, el App ID y el Company. No pruebe muchas veces seguidas: cada intento fallido cuenta para el bloqueo del usuario en ADM.
«El rol debe coincidir exactamente con ADM» Escriba el rol tal como aparece en ADM, con mayúsculas y en plural si así está (por ejemplo «Administradores», no «Administrador»).
«adm_auth_failed: 403» El usuario existe pero no tiene acceso a esa empresa o con ese rol. Dele acceso en ADM y vuelva a validar.
«ADM rechazó la clave guardada y Giro no la vuelve a enviar» La contraseña cambió o el usuario quedó bloqueado. Desbloquéelo en ADM y escriba la clave nueva en Mis empresas → Conexión.
«forbidden» Su usuario de Giro no es dueño ni administrador de esta empresa. Pida al dueño que conecte o que le dé el rol de administrador.

Giro guarda la credencial cifrada (AES-GCM, con una clave del servidor que no está en la base de datos) y nunca la vuelve a mostrar en pantalla.
Solo el dueño o un administrador de la empresa en Giro puede conectar o cambiar la conexión.
Giro pide solo lo necesario para leer y registrar. Nada se escribe sin una tarjeta que usted aprueba.
ADM Cloud no ofrece una llave aparte para la API: Giro guarda la contraseña del usuario (cifrada). Por eso conviene un usuario solo para Giro.

En ADM Cloud: cambie la contraseña del usuario de Giro o desactívelo. Giro deja de poder leer y escribir al instante.
La «Lectura oficial de ADM» se retira desde ADM, en las aplicaciones autorizadas de su cuenta.
En Giro: Mis empresas → Eliminar la empresa borra la conexión guardada.