Skip to main content
GET
Listar transacciones
Devuelve las transacciones de venta visibles para tu clave de API, con los cambios más recientes al final. Combínalo con Listar productos para montar una vista de catálogo más ventas en tu almacén de datos sin pasar por el flujo de exportación CSV de la aplicación.

Autenticación

Token Bearer. Consulta Autenticación.

Parámetros de consulta

Los filtros por rango de fechas y por producto o tienda (from_date, to_date, product_id, store_id) no están soportados en este endpoint. Los parámetros de consulta no soportados se ignoran en lugar de rechazarse, así que filtra en el lado del cliente o acota con updated_since.

Respuesta

Los resultados llegan bajo items, ordenados por última actualización y luego por id, con un next_cursor opaco para la página siguiente (null en la última página).
Consulta Convenciones para el formato de números y marcas de tiempo.

Extracciones incrementales

Las filas de transacciones no incluyen updated_at en la respuesta, así que registra en tu lado la hora de tu última sincronización exitosa y pásala como updated_since en la siguiente ejecución. Recorre cada ejecución con next_cursor hasta que devuelva null; el servidor ordena por última actualización y luego por id, por lo que una ejecución iniciada a mitad del flujo se mantiene consistente. Esto captura correcciones tardías de transacciones existentes sin releer todo el historial.

Ventanas grandes

Las páginas de hasta limit=10000 se sirven desde snapshots y son la forma más rápida de extraer muchas filas. Para extracciones muy grandes, como una recarga completa del historial o un backfill de BI, es preferible una exportación asíncrona antes que una paginación profunda con cursor.

Ejemplo de solicitud

Relacionado