v1

latestOpenAPI 3.1.0Proprietary2026-07-22134294785.0 KB
API

Listar ventas

Lista las ventas de la organización. Soporta filtros por cliente, fecha, estado, punto de venta, vendedor e integración.

get/api/v1/sales

Query parameters

fieldsApiSharedEnumd1f2fb458d[]

Comma-separated top-level sale sections to include. Omit for the endpoint default. List default: id, document, customer, amounts, reversesVoucher, integration, audit. Detail default: id, document, customer, amounts, items, payments, applications, fiscal, reversesVoucher, integration, audit.

cursorstring

Valor de next_cursor recibido en la respuesta anterior

limitinteger

Cantidad máxima de resultados por respuesta

querystring

Texto de búsqueda por cliente, CUIT, número de comprobante, ID de integración, producto, SKU, código de barras o variante

searchstring

Alias de query

customer_idstring uuid

Filtra por cliente

date_fromstring date

Fecha inicial

date_tostring date

Fecha final

date_attribute'invoiceDate' | 'dueDate'

Campo de fecha a usar para el filtro

integration_sourcesstring[]

Fuentes de integración. Puede repetirse o enviarse separada por comas.

point_of_sale_idsstring[]

IDs de puntos de venta. Puede repetirse o enviarse separada por comas.

register_idsstring[]

IDs de cajas. Puede repetirse o enviarse separada por comas.

seller_idsstring[]

IDs de vendedores. Puede repetirse o enviarse separada por comas.

invoice_statusesApiSharedEnum9ac70a3316[]

Estados fiscales. Puede repetirse o enviarse separada por comas.

payment_statusesstring[]

Estados de cobranza. Puede repetirse o enviarse separada por comas.

voucher_typesstring[]

Tipos de comprobante. Puede repetirse o enviarse separada por comas.

amount_attribute'total' | 'balance'

Campo monetario a usar para min/max

min_amountinteger

Importe mínimo en centavos

max_amountinteger

Importe máximo en centavos

Response

Ventas obtenidas exitosamente

request_idstring required
has_moreboolean required
next_cursorstring nullable required
object'list' required

List-envelope discriminator.

urlstring required

Requested list path.