Desarrolladores y agentes
Recursos de Espres para desarrolladores y agentes de IA
Todo lo que un integrador o un agente automatizado necesita para leer, entender y evaluar Espres: archivos legibles por máquina, Markdown por negociación de contenido, el modelo de permisos y la vía para pedir acceso programático.
Archivos legibles por máquina
Todos se sirven desde el dominio canónico https://www.espres.app y no requieren autenticación.
- /llms.txt
- Índice en texto plano de cada página pública con su descripción, los datos clave del producto y una sección explícita de cuándo conviene usar Espres y cuándo no. Es el punto de entrada recomendado para un agente.
- /sitemap.xml
- Conjunto completo de URL públicas con hreflang recíproco entre español e inglés.
- /robots.txt
- Reglas de rastreo. Las rutas de la aplicación autenticada están excluidas: no son accesibles sin sesión.
Markdown por negociación de contenido
Cada página pública devuelve Markdown limpio cuando la petición envía el encabezado Accept: text/markdown, y la respuesta incluye Vary: Accept para que ninguna caché intermedia mezcle las dos representaciones. Un cliente que no acepta ni text/html ni text/markdown recibe 406 Not Acceptable. Los valores q se respetan, incluido q=0 como rechazo explícito.
- Ejemplo
- curl -H "Accept: text/markdown" https://www.espres.app/pricing
- Sufijo .md
- Agregar .md a la ruta devuelve la misma representación Markdown sin necesidad de encabezado Accept, por ejemplo https://www.espres.app/pricing.md.
- Rutas inexistentes
- Una ruta que no existe responde 404 real, nunca 200 con el shell de la aplicación, y el cuerpo incluye el índice del sitio para que un agente pueda recuperarse sin adivinar más rutas.
Modelo de permisos
El acceso se decide por organización, rol y módulo. No es solo una comprobación en la interfaz: cada tabla lleva su organización y una política restrictiva por fila en la base de datos, y cada acción de servidor vuelve a comprobar el permiso.
- Aislamiento por organización
- Cada organización es un inquilino independiente. Ninguna sesión puede leer ni escribir filas de otra organización, ni siquiera por error de la aplicación.
- Rol admin
- Acceso completo: clientes, ventas, inventarios, productos y administración de la organización, incluida la facturación de la suscripción.
- Rol supervisor
- Clientes, ventas, inventarios y productos, sin el módulo de administración. Puede además limitarse a un equipo de vendedores concreto.
- Rol vendedor
- Ventas en ruta. Crea y edita clientes únicamente desde el flujo de venta; no ve inventarios, productos ni administración.
- Módulos por concesión
- Nómina, facturación CFDI y producción se habilitan por usuario desde la administración, además del rol base.
Acceso programático
Espres no publica hoy una API REST pública ni un servidor de autorización OAuth 2.0 para aplicaciones de terceros, y esta página no anuncia endpoints que no existan. Las vías soportadas para mover datos son la aplicación web, la app Android de campo, la importación y exportación CSV integradas, y el canal de pedidos por WhatsApp.
- ¿Necesitas una integración?
- Escríbenos a hola@espres.app con el caso de uso, los datos que necesitas leer o escribir y el volumen esperado. Respondemos con las opciones disponibles.
- Importación y exportación CSV
- Clientes, productos y listas de precios se importan y exportan en CSV desde la aplicación. La importación nunca borra: una celda vacía conserva el valor existente.
¿Construyes algo sobre Espres?
Cuéntanos qué necesitas y qué estás integrando.
Crear cuenta gratisEscríbenos hola@espres.app