Reportes y exportaciones

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 estado

No hay un argumento para pedir solo las Aprobada. Trae el conjunto completo y filtra por status de 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 comercios

Una secretKey puede consultar todos los comercios de la misma empresa. Si omites storeId, 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 filtros product ni filterPreauth para reportes generales

Estos 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 consultadoResultados aproximadosTiempoTamaño
Búsqueda por orderId1 a 3menos de 1 smenos de 1 KB
1 díacientos~1 scientos de KB
1 mesmiles2 a 6 sunos MB
5 mesesdecenas de miles8 a 15 svarios 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

DatoFormato de celda
order_id, transaction_idTexto. Si Excel los toma como número, pierdes los últimos dígitos
MontosNúmero con 2 decimales. Recuerda que vienen en pesos, no en centavos
FechasVienen como texto DD/MM/YYYY HH:mm; conviértelas si necesitas ordenar o filtrar

Siguientes pasos