{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"c94b80db-98a6-4a5c-ab3a-4f46de26b72d","name":"Monibyte API","description":"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.\n\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.\n\nTodas las APIs se consumen sobre HTTPS, se autentican con un **API Key** y están\npensadas para integrarse desde cualquier lenguaje o plataforma.\n\n## Autenticación\n\nTodas las peticiones requieren el **API Key** en el header `x-api-key`.\n\n## Ambiente de pruebas (Mock Server)\n\nLa **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## Prerrequisitos\n\n1. **Generar un API Key.** Se genera desde la consola de Monibyte, en\n   *Configuración → Integraciones → Configuración de API*.\n   > ⚠️ Pendiente de confirmar los pasos exactos (pantalla / rol requerido).\n2. **Configurar la lista blanca de IPs.** Solo las IPs autorizadas pueden\n   consumir el API (el control se realiza en el API Gateway).\n   > ⚠️ Pendiente de confirmar cómo se solicita / registra la IP.\n\n## Manejo de errores\n\nAnte un error, el servicio responde con un código HTTP y un mensaje. Los\nprincipales:\n\n| HTTP | Mensaje | Causa | Cómo resolverlo |\n| --- | --- | --- | --- |\n| 400 | `startDate/endDate must be in format YYYY-MM-DD` | Formato de fecha inválido | Enviar las fechas en formato `YYYY-MM-DD`. |\n| 400 | `DATE_RANGE_EXCEEDS_MAX_PERIOD (max: 1 year)` | El rango supera 1 año | Reducir el rango a máximo 1 año. |\n| 400 | `TRANSACTION_SERVICE_ERROR_TRANSACTION_TYPE_NOT_FOUND` | Tipo de transacción inválido | Revisar el valor enviado. |\n| 404 | `NOT_FOUND_REPORT_ID` | El `templateId` no existe | Verificar el identificador de la plantilla. |\n| 401 / 403 | (auth) | API Key ausente o inválida | Enviar un `x-api-key` válido. |\n| 403 | (IP no autorizada) | La IP no está en la lista blanca | Registrar la IP en la lista blanca. |\n| 429 | (límite excedido) | Se superó el límite de peticiones | Reintentar más tarde o revisar la velocity. |\n\n> ⚠️ Pendiente de confirmar el **status y cuerpo exactos** que devuelve el\n> Gateway para: API Key inválida, IP no autorizada y límite de peticiones.\n\n## Disponibilidad por país\n\nEl API está disponible actualmente en los siguientes países:\n\n| País | Disponible |\n| --- | :---: |\n| Costa Rica | ✓ |\n| México | ✓ |\n| Guatemala | ✓ |\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"17879691","team":134944,"collectionId":"c94b80db-98a6-4a5c-ab3a-4f46de26b72d","publishedId":"2sBYB1P8SW","public":true,"publicUrl":"https://developer.monibyte.com","privateUrl":"https://go.postman.co/documentation/17879691-c94b80db-98a6-4a5c-ab3a-4f46de26b72d","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/7ed7e169-0561-4422-9782-7ef153b86b3c/bG9nby1hcHAucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/7ed7e169-0561-4422-9782-7ef153b86b3c/bG9nby1hcHAucG5n","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.6","publishDate":"2026-09-22T14:10:08.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/7ed7e169-0561-4422-9782-7ef153b86b3c/bG9nby1hcHAucG5n","logoDark":"https://content.pstmn.io/7ed7e169-0561-4422-9782-7ef153b86b3c/bG9nby1hcHAucG5n"}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/8ab36c2b55569a91137be74ff9af2b0029350cdbfdc63f2fd202d42f228d707b","favicon":"https://monibyte.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://developer.monibyte.com/view/metadata/2sBYB1P8SW"}