Consola

La consola, en flashpi.com.ec/app, es donde configuras y supervisas tu integración. Los comprobantes siempre se emiten por la API: la consola los consulta, pero nunca los crea.

La consola está en español por defecto, con inglés en el menú de usuario, donde también eliges el tema oscuro o claro. Los términos para desarrolladores, como los nombres de las API keys, los tipos de evento y los códigos de error, quedan en inglés en ambos idiomas.

Registro e inicio de sesión

Regístrate en flashpi.com.ec/app/signup con Continuar con Google, o con un correo y una contraseña (de 12 a 128 caracteres). El registro con Google muestra los mismos términos y aviso de privacidad. Google verifica las direcciones de Gmail y Google Workspace; las demás necesitan el enlace de verificación que te enviamos. Para el registro con contraseña, abre el enlace en el mismo navegador o en uno con la sesión iniciada en esa cuenta. Verificar el correo activa el sandbox.
Inicia sesión con Google en la página de acceso. Una cuenta existente y verificada se vincula automáticamente solo cuando Google es autoridad para la dirección coincidente (Gmail o Google Workspace); las demás necesitan la contraseña de Flashpi. Flashpi nunca cambia tu correo desde Google. Una cuenta de Google sin usuario en Flashpi debe registrarse primero. Las invitaciones también ofrecen Google, con el correo exacto de la invitación.
La verificación en dos pasos con una app de autenticación (TOTP) es obligatoria para los propietarios de la cuenta, a quienes la consola les pide activarla cuando inician sesión por primera vez, y opcional para los miembros, salvo que un propietario la exija a todo el equipo. Al activarla recibes diez códigos de recuperación de un solo uso; guárdalos en un lugar seguro.
Las sesiones duran 12 horas y terminan después de 2 horas sin actividad.
Las acciones sensibles, como crear una llave de producción, subir un certificado, leer un secreto de webhook o cambiar el equipo, te piden confirmar con el código de tu app de autenticación (o tu contraseña, si no tienes app de autenticación). Si solo usas Google y no tienes autenticador, debes activarlo antes de las acciones sensibles. Una confirmación vale 10 minutos. Revocar una API key nunca lo pide, para que una llave filtrada se pueda detener de inmediato.

Secciones

El menú de la izquierda agrupa las secciones. Arriba, debajo de tu cuenta, el selector Pruebas / Producción elige el ambiente de toda la consola, porque los dos están separados: Resumen, Comprobantes, API keys, webhooks y request logs muestran el ambiente elegido, y la consola lo mantiene al cambiar de sección y lo recuerda en cada cuenta. En el teléfono está arriba a la derecha. Emisores, con los certificados de cada emisor, sirve para los dos ambientes. Cuando Flashpi pausa los correos de comprobantes de la cuenta, un aviso arriba de cada página lo indica, con qué hacer (Correos pausados).

Resumen

Tu sandbox: el ID, el establecimiento y el punto de emisión del emisor demo, la cuota de prueba del día con su hora de renovación, una primera solicitud lista para ejecutar en modo síncrono, una lista de pasos para empezar y tus últimos comprobantes de prueba. Consulta Sandbox y emisor demo. En Producción, el Resumen muestra los pasos para emitir con validez tributaria y tus últimos comprobantes de producción.

Facturación

Comprobantes: busca los comprobantes de un ambiente por emisor, tipo, estado, fechas de emisión, identificación de la contraparte o clave de acceso, revisa cada uno con sus estados tributario, de RIDE y de correo (con un aviso cuando la dirección del destinatario parece mal escrita) y sus mensajes del SRI, y descarga su XML y su RIDE.
Emisores: agrega un emisor desde su firma electrónica (.p12) con Nuevo emisor: Flashpi lee el RUC y el titular, y después revisas y completas su perfil tributario (consulta Crear un emisor desde su certificado). Después administra su perfil, establecimientos, puntos de emisión y color de marca. En la pestaña Certificados de cada emisor renuevas su .p12, que sirve para pruebas y producción, y sigues su verificación, su validez y sus revisiones de revocación, con un aviso cuando un certificado está pendiente, bloqueado, revocado o por vencer. Consulta Certificados. El emisor demo compartido aparece aquí en solo lectura.

Desarrolladores

API keys: crea llaves de prueba y de producción con su nombre, alcance, nivel de acceso y lista de IP permitidas, mira cuándo se usó cada una por última vez, cambia el nombre y la lista de IP, y revócalas. La llave completa se muestra una sola vez. Consulta Autenticación y API keys.
Webhooks: agrega endpoints, elige sus eventos y su modo de contenido, lee o rota el secreto de firma, inicia una nueva verificación y revisa el registro de entregas con cada intento, con reenvíos manuales. Consulta Webhooks.
Request logs: cada solicitud hecha con tus llaves en los últimos 30 días, con su método, ruta, estado, latencia, llave, IP del cliente (como la ven las listas de IP permitidas), ID de la solicitud y código de error. Los cuerpos nunca se registran, y la ruta se guarda sin su query string. Filtra por clase de estado, método, llave o ID de solicitud para encontrar una integración que falla.

Cuenta

Equipo: invita personas por correo como propietarios o miembros. Un miembro recibe un alcance (todos los emisores, o una lista de emisores) y un nivel de acceso (solo lectura, o lectura y escritura), igual que una API key. Se permiten varios propietarios; el último propietario no puede salir de la cuenta.
Configuración: tu perfil, la cuenta de Google conectada y el idioma de los correos que te enviamos, tu contraseña (o un enlace para crearla por correo), la verificación en dos pasos y los códigos de recuperación, y el nombre de la cuenta y la plantilla del RIDE (moderna, clásica o minimalista; consulta RIDE y correo).

Quién puede hacer qué

Acción	Propietarios	Miembros con todos los emisores, lectura y escritura	Miembros con algunos emisores, lectura y escritura	Miembros de solo lectura
Consultar comprobantes, su XML y su RIDE	Sí	Sí	Sus emisores	Sí (sus emisores, si están limitados)
Agregar emisores	Sí	Sí	No	No
Cambiar emisores, subir certificados	Sí	Sí	Sus emisores (un certificado por ambiente)	No
Administrar llaves de prueba y endpoints de webhooks	Sí	Sí	No	No
Ver API keys, webhooks y request logs	Sí	Sí	No	Si llegan a todos los emisores
Crear y cambiar llaves de producción	Sí	No	No	No
Equipo y configuración de la cuenta, plantilla del RIDE	Sí	No	No	No