# Conectados - API Retail

## Docs
- [API Conectados](https://conectados.apidog.io/doc-535217.md): 
- [Autenticación](https://conectados.apidog.io/doc-535239.md): 
- Seguridad [Obtener Certificado](https://conectados.apidog.io/doc-535260.md): 
- Seguridad [Firmar Mensajes](https://conectados.apidog.io/doc-535265.md): 

## API Docs
- 🛒 Store [Obtener el Saldo de un Billetera Habiente](https://conectados.apidog.io/api-7503616.md): Este endpoint permite consultar el saldo disponible en las billeteras activas asociadas a un usuario, utilizando su número de identidad (`user_identity`) y, opcionalmente, los datos obtenidos del escaneo del código QR de su cédula (`qr_user_info`).
- 🛒 Store [Validar condiciones para proceder con la venta](https://conectados.apidog.io/api-7503618.md): Este endpoint valida si un usuario está habilitado para realizar una venta. Verifica categorías, billeteras disponibles y el monto total solicitado. También valida la identidad del usuario mediante QR (con certificadora autorizada) o identificación verbal.
- 🛒 Store [Anular la venta](https://conectados.apidog.io/api-7503620.md): Este endpoint permite anular una transacción ya realizada, eliminando cargos y registros asociados en casos de error o cancelación. Es especialmente útil para corregir transacciones que se procesaron de manera incorrecta o que deben revertirse por cualquier motivo válido.
- 🛒 Store [Crear una venta](https://conectados.apidog.io/api-7503621.md): Este endpoint permite registrar una nueva venta en el sistema, incluyendo todos los detalles relevantes del cliente y la operación. Es una herramienta clave para completar el flujo de ventas y garantizar que toda la información asociada quede correctamente registrada.
- 🛒 Store [Listar ventas por local](https://conectados.apidog.io/api-7503622.md): Este endpoint permite obtener un listado completo de las ventas realizadas en una tienda específica. Es útil para realizar consultas detalladas sobre el historial de transacciones asociadas a una tienda, facilitando el análisis, control y auditoría de las ventas.
- Webhooks [Aprobar condiciones](https://conectados.apidog.io/api-18604273.md): 
- Webhooks [Rechazo de aprobación](https://conectados.apidog.io/api-18605094.md): Este evento indica que la validación de condiciones necesarias para realizar una venta ha fallado. Puede deberse a que el usuario no cumple con los requisitos establecidos, como montos insuficientes, categorías no habilitadas, billeteras no disponibles o fallos en la verificación de identidad.
- Webhooks [Crear Venta](https://conectados.apidog.io/api-18605496.md): 
- Webhooks [Venta ya creada](https://conectados.apidog.io/api-18647731.md): 
- Webhooks [OTP expirado](https://conectados.apidog.io/api-18648282.md): 
- Webhooks [OTP Inválido](https://conectados.apidog.io/api-18650645.md): 
- Webhooks [Anulación de venta](https://conectados.apidog.io/api-18651073.md): 

## Schemas
- Sample Schemas [Pet](https://conectados.apidog.io/schema-2182374.md): 
- Sample Schemas [Category](https://conectados.apidog.io/schema-2182375.md): 
- Sample Schemas [Tag](https://conectados.apidog.io/schema-2182376.md): 
- Schemas [UserBalances](https://conectados.apidog.io/schema-2182377.md): 
- Schemas [CodeSale](https://conectados.apidog.io/schema-2182378.md): 
- Schemas [Sale](https://conectados.apidog.io/schema-2182379.md): 
- Schemas [VoidSale](https://conectados.apidog.io/schema-2182380.md): 
- [basic response](https://conectados.apidog.io/schema-6529963.md):