# Construye con Istmo POS

Documentación pública para conectar tu tienda con Istmo Commerce.

## Una API para tu tienda

Conecta un sitio Vue, React o cualquier backend con el catálogo y las solicitudes de pedido de Istmo POS. Usa el contrato OpenAPI para generar clientes o comparte la versión Markdown con tu agente de IA.





- [Comenzar la integración](https://admin.istmotech.com/docs/inicio/)
- [Explorar la API](https://admin.istmotech.com/docs/api/)

## Estado del contrato · v1.5.0

/orders recibe solicitudes pendientes. checkout-commands permite cotizar/reservar y solicitar ACH habilitado por la empresa. Sólo el administrador concilia el pago y emite la factura. checkoutEnabled=false: no hay cobro automático.

- Disponible en código: credenciales por tienda, catálogo autorizado, solicitudes pendientes, consulta y rechazo administrativo.
- Requiere actualizar el servidor operativo y aplicar la migración de Commerce antes de usar sus endpoints. Publicar estas páginas no activa la API.
- Gateway y puente saliente implementados en código; requieren despliegue y configuración. Disponibles: cotización y reservas temporales por checkout-commands. Disponible por API administrativa: ACH/transferencia con conciliación y emisión idempotente. Disponible: preparación y retiro auditados. Pendientes: tarjeta/Yappy web y webhooks.





## Recursos para personas e IA

Las páginas contienen HTML estático y versiones Markdown. Se pueden leer sin iniciar sesión ni ejecutar JavaScript. La API operativa siempre requiere autenticación.





- [OpenAPI JSON](https://admin.istmotech.com/docs/openapi.json)
- [Índice para agentes · llms.txt](https://admin.istmotech.com/llms.txt)
- [Documentación completa en texto](https://admin.istmotech.com/llms-full.txt)
- [Guía para agentes](https://admin.istmotech.com/docs/ia/)
- [Cliente Node sin dependencias](https://admin.istmotech.com/docs/istmo-commerce.mjs)