Bienvenido a las APIs públicas de Monibyte. Este conjunto de APIs permite que\nlas aplicaciones y sistemas de un cliente —sistemas contables, ERPs o\nherramientas internas— consuman de forma segura la información que Monibyte\nadministra, para automatizar procesos que hoy se realizan de forma manual.
\nLa primera API disponible expone la exportación de transacciones\nconfirmadas: permite descargar, con múltiples filtros, un archivo (CSV/XLSX)\nlisto para conciliar o importar en el sistema contable del cliente.
\nTodas las APIs se consumen sobre HTTPS, se autentican con un API Key y están\npensadas para integrarse desde cualquier lenguaje o plataforma.
\nTodas las peticiones requieren el API Key en el header x-api-key.
La URL base de esta documentación es la de producción\n(https://stag-api.impesa.net). Durante el desarrollo de la integración no se debe\nconsumir producción: se recomienda usar el Mock Server de Postman asociado a\nesta colección para simular las respuestas, sin afectar datos reales ni requerir\nlista blanca de IPs. Una vez que la conexión esté lista y probada, cambiar la\nURL base a la de producción y consumir el servicio real.
\n\n⚠️ Pendiente de confirmar los pasos exactos (pantalla / rol requerido).
\n
\n\n⚠️ Pendiente de confirmar cómo se solicita / registra la IP.
\n
Ante un error, el servicio responde con un código HTTP y un mensaje. Los\nprincipales:
\n\n\n⚠️ Pendiente de confirmar el status y cuerpo exactos que devuelve el\nGateway para: API Key inválida, IP no autorizada y límite de peticiones.
\n
El API está disponible actualmente en los siguientes países:
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introducción","slug":"introduccion"}],"owner":"17879691","collectionId":"c94b80db-98a6-4a5c-ab3a-4f46de26b72d","publishedId":"2sBYB1P8SW","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-09-22T14:10:08.000Z"},"item":[{"name":"Public API","item":[{"name":"Exportar archivo de transacciones","id":"e7c378df-4ca0-48b8-be31-026fb8a2b21d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://stag-api.impesa.net/transactions/v1/export/:templateId?startDate=2025-01-01&endDate=2025-12-31&extension=csv&transactionDirection=C&transactionCurrency=188&amount=1500.5&amountGt=1000&amountLt=2000&costCenter=1001&accountCatalog=110101&trxSettlementStatus=104&hasAttachments=true&card=string&receipts=false&electronicInvoice=false","description":"Exporta las transacciones confirmadas del cliente en un archivo (CSV/XLSX) según la plantilla indicada y los filtros enviados. La respuesta es el archivo en el cuerpo (Content-Disposition: attachment), no un JSON.
\n","urlObject":{"path":["transactions","v1","export",":templateId"],"host":["https://stag-api.impesa.net"],"query":[{"description":{"content":"(Obligatorio) Fecha de inicio del rango a exportar (inclusive). Tipo: string, formato YYYY-MM-DD. Obligatorio. Propósito: acota el período.
(Obligatorio) Fecha de fin del rango (inclusive). Tipo: string, formato YYYY-MM-DD. Obligatorio. El rango no puede superar 1 año.
Formato del archivo de salida. Tipo: string (enum): CSV (por defecto) / XLSX. Opcional. Propósito: define el tipo de archivo que se descarga.
Tipo de transacción. Tipo: string (enum): C (crédito) / D (débito). Opcional. Propósito: filtra por naturaleza del movimiento.
Código de moneda. Tipo: string (ej. 188). Opcional. Propósito: filtra por moneda.
Monto exacto (amount = valor). Tipo: number. Opcional. Los filtros de monto son mutuamente excluyentes con prioridad amount > amountGt > amountLt. Si no se envía ninguno, solo montos positivos (> 0).
\n","type":"text/plain"},"key":"amount","value":"1500.5"},{"description":{"content":"Monto estrictamente mayor que (amount > valor). Tipo: number. Opcional. Solo aplica si no se envía amount. No forma rango con amountLt.
Monto estrictamente menor que (amount < valor). Tipo: number. Opcional. Solo aplica si no se envían amount ni amountGt.
Código del centro de costo. Tipo: string. Opcional. Se envía el código que el cliente definió al crear el centro de costo en el módulo de Monibyte (no el nombre ni un id interno). Propósito: filtra las transacciones asignadas a ese centro de costo.
\n","type":"text/plain"},"key":"costCenter","value":"1001"},{"description":{"content":"Código de la cuenta contable (catálogo). Tipo: string. Opcional. Se envía el código que el cliente definió al crear la cuenta contable en el módulo de Monibyte (no el nombre ni un id interno). Propósito: filtra las transacciones asignadas a esa cuenta contable.
\n","type":"text/plain"},"key":"accountCatalog","value":"110101"},{"description":{"content":"Estado del reporte de gastos. Tipo: array de string (enum): 100 registrado, 101 aprobado, 102 pendiente de revisión, 103 rechazado, 104 cancelado. Opcional. Se envía repetido: trxSettlementStatus[]=101&trxSettlementStatus[]=102.
Adjuntos. Tipo: boolean. true (con) / false (sin) / omitir (todos). Opcional.
Filtro por tarjeta. Tipo: string. Opcional. Funcionalidad en desarrollo, disponible próximamente.
\n","type":"text/plain"},"key":"card","value":"string"},{"description":{"content":"Indicador de comprobantes. Tipo: boolean. Opcional. Funcionalidad en desarrollo, disponible próximamente.
\n","type":"text/plain"},"key":"receipts","value":"false"},{"description":{"content":"Indicador de factura electrónica. Tipo: boolean. Opcional. Funcionalidad en desarrollo, disponible próximamente.
\n","type":"text/plain"},"key":"electronicInvoice","value":"false"}],"variable":[{"id":"6249be89-e019-4cb3-af8a-2ca5b9e12cee","description":{"content":"(Obligatorio) Identificador del archivo exportable: la plantilla que define las columnas y el formato del archivo a descargar. Tipo: string. Obligatorio (va en la ruta).
\n","type":"text/plain"},"type":"any","value":"13c4628c78b74a61bafc6bce37fb503e","key":"templateId"}]}},"response":[{"id":"a389fc81-ea62-4355-a316-43758326b7eb","name":"response","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://stag-api.impesa.net/transactions/v1/export/:templateId?startDate=2025-01-01&endDate=2025-12-31&extension=csv&transactionDirection=C&transactionCurrency=188&amount=1500.5&amountGt=1000&amountLt=2000&costCenter=1001&accountCatalog=110101&trxSettlementStatus=104&hasAttachments=true&card=string&receipts=true&electronicInvoice=true","host":["https://stag-api.impesa.net"],"path":["transactions","v1","export",":templateId"],"query":[{"key":"startDate","value":"2025-01-01"},{"key":"endDate","value":"2025-12-31"},{"key":"extension","value":"csv"},{"key":"transactionDirection","value":"C"},{"key":"transactionCurrency","value":"188"},{"key":"amount","value":"1500.5"},{"key":"amountGt","value":"1000"},{"key":"amountLt","value":"2000"},{"key":"costCenter","value":"1001"},{"key":"accountCatalog","value":"110101"},{"key":"trxSettlementStatus","value":"104"},{"key":"hasAttachments","value":"true"},{"key":"card","value":"string"},{"key":"receipts","value":"true"},{"key":"electronicInvoice","value":"true"}],"variable":[{"key":"templateId","value":"13c4628c78b74a61bafc6bce37fb503e","description":"(Obligatorio) Identificador del **archivo exportable**: la plantilla que define las columnas y el formato del archivo a descargar. Tipo: string. Obligatorio (va en la ruta)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"e7c378df-4ca0-48b8-be31-026fb8a2b21d"}],"id":"c6711958-9a52-4d1d-87df-4e34a394319d","_postman_id":"c6711958-9a52-4d1d-87df-4e34a394319d","description":""}],"variable":[{"key":"baseUrl","value":"https://stag-api.impesa.net","type":"string"}]}