Obtén listados de tus ventas por periodo, por punto de cobro o por tipo de integración.
Esta página cubre las consultas de listados: tus ventas de un periodo, de varios puntos de cobro a la vez, o separadas por tipo de integración.
Si es tu primera vez con este servicio, empieza por API de Consulta de Transacciones para la configuración y los conceptos.
Ventas de un periodo
curl --location 'https://gateway.netpay-api.com/reports/v1/graphql' \
--header 'X-Netpay-Apikey: TU_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{"query":"{ allTransactions( storeId: [1234567] rangeDateFilter: { min: \"2026/09/01\", max: \"2026/09/30\" } ) { transaction_id order_id transaction_date status auth_amount capt_amount brand card_type promotion product_name } }"}'rangeDateFilter filtra por fecha de venta. El rango es inclusivo en los dos extremos.
No existe un filtro por estadoNo hay un argumento para pedir solo las
Aprobada. Trae el conjunto completo y filtra porstatusde tu lado.
Varios puntos de cobro a la vez
storeId acepta una lista:
curl --location 'https://gateway.netpay-api.com/reports/v1/graphql' \
--header 'X-Netpay-Apikey: TU_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{"query":"{ allTransactions( storeId: [1234567, 1234568, 1234569] rangeDateFilter: { min: \"2026/09/01\", max: \"2026/09/30\" } ) { transaction_id store_id store_name transaction_date auth_amount status product_name } }"}'Incluye store_id entre los campos para poder separar los resultados.
Si administras varios comerciosUna
secretKeypuede consultar todos los comercios de la misma empresa. Si omitesstoreId, la consulta devuelve todos los comercios asociados. Tenlo presente al diseñar los permisos de tus propios usuarios internos.
Separar ventas en línea de ventas en terminal
Trae product_name y terminal_id entre los campos: las transacciones de terminal traen identificador de terminal, y product_name te dice con qué integración se procesó cada una.
curl --location 'https://gateway.netpay-api.com/reports/v1/graphql' \
--header 'X-Netpay-Apikey: TU_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{"query":"{ allTransactions( storeId: [1234567] rangeDateFilter: { min: \"2026/09/01\", max: \"2026/09/30\" } ) { transaction_id product_name terminal_id store_name transaction_date auth_amount status } }"}'
No uses los filtrosproductnifilterPreauthpara reportes generalesEstos filtros excluyen registros. Si filtras por producto puedes dejar fuera parte de tus ventas sin darte cuenta. Para reportes completos, no los uses: trae todo y clasifica en tu sistema con
product_name.
Ventas a meses sin intereses
Los campos promotion y promo_term te dicen si la venta fue a plazos y a cuántos:
curl --location 'https://gateway.netpay-api.com/reports/v1/graphql' \
--header 'X-Netpay-Apikey: TU_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{"query":"{ allTransactions( storeId: [1234567] rangeDateFilter: { min: \"2026/09/01\", max: \"2026/09/30\" } ) { transaction_id order_id transaction_date auth_amount status promotion promo_term promo_term_description brand } }"}'También existe el filtro promotion si quieres acotar la consulta.
Ventas con propina
tip_amount trae la propina cuando aplica. El monto cobrado incluye la propina, así que si reportas venta y propina por separado, tienes que restarla.
Rendimiento
Cuánto pesa cada consulta
| Rango consultado | Resultados aproximados | Tiempo | Tamaño |
|---|---|---|---|
Búsqueda por orderId | 1 a 3 | menos de 1 s | menos de 1 KB |
| 1 día | cientos | ~1 s | cientos de KB |
| 1 mes | miles | 2 a 6 s | unos MB |
| 5 meses | decenas de miles | 8 a 15 s | varios MB |
No hay paginación: la consulta devuelve el conjunto completo.
Trocea los rangos amplios
Para periodos largos, consulta mes por mes y une los resultados en tu sistema. Cada respuesta pesa menos y baja el riesgo de timeout.
Pide solo los campos que necesitas
Es la optimización más simple y la más efectiva. Una consulta con 8 campos pesa una fracción de una con 30.
Si exportas a Excel
| Dato | Formato de celda |
|---|---|
order_id, transaction_id | Texto. Si Excel los toma como número, pierdes los últimos dígitos |
| Montos | Número con 2 decimales. Recuerda que vienen en pesos, no en centavos |
| Fechas | Vienen como texto DD/MM/YYYY HH:mm; conviértelas si necesitas ordenar o filtrar |
Siguientes pasos
- Conciliación de depósitos — cuadrar lo que te llega al banco.
- Buscar una transacción — búsquedas puntuales y aclaraciones.
- Referencia — catálogo completo de filtros y campos.
