Conectados - API Retail
  1. 🛒 Store
Conectados - API Retail
  • API Conectados
  • Autenticación
  • 🛒 Store
    • Listado de Categorías Disponibles
      GET
    • Obtener el Saldo de un Billetera Habiente
      GET
    • Crear una transacción
      POST
    • Validar condiciones para proceder con la venta
      POST
    • Anular la venta
      PUT
    • Crear una venta
      POST
    • Listar ventas por local
      GET
  • Seguridad
    • Obtener Certificado
    • Firmar Mensajes
  1. 🛒 Store

Listar ventas por local

GET
/store/$id/sales
store
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.

Request

Query Params
state
string 
optional
Estado de la venta
transaction_id
integer 
optional
ID de la transacción
limit
integer 
optional
Límite de cantidad de registros
user_id
string 
optional
Identificación del usuario, (DNI, Pasaporte)
Example:
1111111-1

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/store/$id/sales?state&transaction_id&limit&user_id=1111111-1'

Responses

🟢200Listado de ventas realizadas en el local
application/json
Body
id
number <int64>
required
Número de Comprobante | Longitud máxima 19
Example:
12312123
created_at
string <date-time>
required
Fecha de creación de la venta
completed_at
string <date-time>
required
Longitud máxima 24
Example:
2025-02-16T12:39:56Z
currency
string 
required
Moneda de la venta | Longitud máxima 3
Example:
CLP
base_amount
number <double>
required
Monto base de la venta | Longitud máxima 15
Example:
100
tax_amount
number <double>
required
Impuesto de la venta | Longitud máxima 15
Example:
19
tips_amount
number <double>
required
Monto equivalente a la propina
amount
number <double>
required
Monto total de la venta | Longitud máxima 15
Example:
119
commission_amount
number <double>
required
Monto equivalente a la comisión
voided_at
string <date-time>
required
Longitud máxima 24
paid_at
string <date-time>
required
Longitud máxima 24
state
string 
required
Estado de la venta | Longitud máxima 50
Example
[
    {
        "id": 124,
        "base_amount": 25,
        "tax_amount": 5,
        "amount": 30,
        "currency": "CLP",
        "completed_at": "2023-12-01T12:30:45Z",
        "voided_at": null,
        "paid_at": "2023-12-01T12:30:45Z",
        "state": "completed",
        "transaction_id": 457
    },
    {
        "id": 125,
        "base_amount": 50,
        "tax_amount": 10,
        "amount": 60,
        "currency": "CLP",
        "completed_at": null,
        "voided_at": "2023-12-02T14:15:20Z",
        "paid_at": null,
        "state": "voided",
        "transaction_id": 458
    },
    {
        "id": 126,
        "base_amount": 250,
        "tax_amount": 50,
        "amount": 300,
        "currency": "CLP",
        "completed_at": null,
        "voided_at": null,
        "paid_at": "2023-12-03T09:45:10Z",
        "state": "paid",
        "transaction_id": 459
    }
]
🟠404Tienda no encontrada
Modified at 2024-12-04 18:03:20
Previous
Crear una venta
Next
Obtener Certificado
Built with