Descargar movimientos

GET /operations/downloadOperations

Descarga tus movimientos de un rango de fechas en un archivo Excel, el mismo reporte de ventas que podés bajar desde el panel de Sipago. A diferencia de Consultar movimientos, no es paginado: el archivo trae todos los movimientos del período.

PARÁMETROS DE CONSULTA (QUERY STRING)

Nombre	Tipo	Obligatorio	Descripción
downloadType	string	Sí	Formato del archivo. Valor: xls .
start_date	string (AAAA-MM-DD)	Sí	Fecha desde.
end_date	string (AAAA-MM-DD)	Sí	Fecha hasta.
subsidiary	string	No	ID de la sucursal, para descargar solo sus movimientos. Vacío: todas.
status	string	No	Filtro por estado del movimiento. Vacío: todos.
transactionTypes	string	No	Filtro por tipo de operación. Vacío: todos.
users	string	No	Filtro por usuario que hizo la venta. Vacío: todos.

Consejo: Parámetros de fecha

Este endpoint usa start_date y end_date (con guion bajo), a diferencia de startDate/endDate de Consultar movimientos. Los parámetros van en la URL; no lleva cuerpo.

RESPUESTA 200 OK

El contenido del archivo, no JSON. Guardá el cuerpo de la respuesta tal como llega.

Encabezado	Valor
Content-Type	application/vnd.ms-excel
Content-Disposition	`attachment; filename="sales_<timestamp>.xls"`

Si algo falla, la respuesta es JSON con el formato de error (status, message, timestamp), así que revisá el código HTTP antes de guardar el archivo.

EJEMPLOS

curl --location --get 'https://api-gwt.sipago.online/services/operations/downloadOperations' \
--header 'apikey: TU_API_KEY' \
--header 'X-TRACE-ID: 3cc1aabd-eb40-48bc-bb84-d1c34f1e2934' \
--header 'X-VERSION: 1' \
--data-urlencode 'downloadType=xls' \
--data-urlencode 'start_date=2024-05-01' \
--data-urlencode 'end_date=2024-05-31' \
--fail --output movimientos-mayo.xls

Campos del archivo descargado

El archivo Excel contiene las siguientes columnas, en el orden del archivo de ejemplo ejemplo_descarga_movimientos.xls. Cada fila corresponde a un movimiento; algunos campos pueden estar vacíos según la operación.

Campo	Descripción
Origen	Canal de origen de la operación, por ejemplo, `ECOMMERCE`, `Pagos recurrentes` o `QR`.
Fecha	Fecha y hora del movimiento, con formato `AAAA-MM-DD HH:mm:ss` en el ejemplo.
Nombre de comercio	Nombre del comercio al que pertenece el movimiento.
Nombre de sucursal	Nombre de la sucursal asociada.
Usuario	Nombre del usuario asociado a la operación.
Estado	Estado del movimiento, por ejemplo, `Aprobada`.
Nombre del cliente	Nombre del cliente; puede aparecer `UNKNOWN` cuando no está disponible.
Número de documento	Número de documento del cliente, cuando está disponible.
E-mail del cliente	Correo electrónico del cliente, cuando está disponible.
Marca tarjeta	Marca o identificación del medio utilizado, por ejemplo, `Visa Débito`, `MasterCard Prepaga` o `PCT`.
Número tarjeta	Número de tarjeta enmascarado; puede estar vacío en operaciones sin tarjeta.
Método de pago	Método utilizado, por ejemplo, `Débito`, `Crédito` o `PREPAID`.
Moneda	Código de moneda; en el ejemplo figura `032`.
Importe bruto	Importe bruto del movimiento.
Importe neto	Importe neto informado para el movimiento.
Propina	Importe de la propina.
Impuestos	Importe de impuestos informado para el movimiento.
Arancel	Importe del arancel aplicado.
IVA Arancel	IVA correspondiente al arancel.
Costo Financiero	Importe del costo financiero.
IVA Costo Financiero	IVA correspondiente al costo financiero.
II.BB.	Importe informado bajo el concepto de Ingresos Brutos.
Ret. IVA	Importe de la retención de IVA.
Ret. Ganancias	Importe de la retención de Ganancias.
Ret. IIBB SIRTAC	Importe de la retención de Ingresos Brutos SIRTAC.
Ret. IIBB no inscripto	Importe de la retención de Ingresos Brutos por no inscripto.
Ret. IIBB por falta de alta	Importe de la retención de Ingresos Brutos por falta de alta.
Fecha de disponibilidad	Fecha de acreditación de fondos, con formato `AAAA-MM-DD`.
Nº Referencia	Número de referencia del movimiento.
Nº Autorización	Código de autorización de la operación.
ID Terminal	Identificador de la terminal; puede ser numérico o texto, como `COELSA`.
Tipo	Tipo de operación, por ejemplo, `Venta`.
Lector	Información del lector, cuando está disponible; está vacío en el archivo de ejemplo.
Cuentas de email a las que se envió boucher	Lista de correos a los que se envió el comprobante. El nombre de la columna conserva la escritura del archivo original.
Geolocalización	Información de geolocalización, cuando está disponible; está vacía en el archivo de ejemplo.

Resumen de totales

Al final del archivo, después del detalle de movimientos, aparece un resumen por moneda con estos campos:

Campo	Descripción
Moneda	Código de moneda del resumen.
Total bruto	Total bruto informado para esa moneda.
Total anuladas	Total de operaciones anuladas informado para esa moneda; está vacío en el ejemplo.
Total impuestos	Total de impuestos informado en el resumen.
Total neto	Total neto informado para esa moneda.