Documentación oficial

Banguat Exchange API Docs

API empresarial para consultar tipos de cambio del Banco de Guatemala, exponerlos en JSON y generar archivos CSV compatibles con SAP DTW.

Probar consulta Health Check Ver tasas del día

Resumen

  • Integración REST JSON
  • Exportación CSV para SAP
  • Consulta de monedas configuradas
  • Soporte de tasas por rango y fecha
  • Health endpoint para monitoreo

Contenido

Introducción Inicio rápido Endpoints Ejemplos Integración SAP Notas operativas

Base URL

https://www.banguat.computersolutionsla.com/public/index.php

Introducción

Banguat Exchange API fue diseñado para centralizar la consulta de tipos de cambio, normalizar las tasas respecto a GTQ y facilitar su uso desde sistemas externos como aplicaciones .NET, procesos internos y cargas a SAP Business One mediante DTW.

Inicio rápido

1. Verificar salud del servicio

https://www.banguat.computersolutionsla.com/public/index.php?page=health

2. Consultar monedas configuradas

https://www.banguat.computersolutionsla.com/public/index.php?page=api_currencies

3. Consultar tasa del día USD

https://www.banguat.computersolutionsla.com/public/index.php?page=api_rate_today&currency=2

4. Descargar CSV SAP

https://www.banguat.computersolutionsla.com/public/index.php?page=api_rate_today_csv&date=2026-03-27

Endpoints

Endpoint Método Descripción
?page=health GET Verifica que el servicio esté disponible.
?page=api_currencies GET Lista monedas configuradas localmente.
?page=api_banguat_variables GET Consulta variables disponibles publicadas por Banguat.
?page=api_rate_today&currency=2 GET Obtiene la tasa del día para una moneda específica.
?page=api_rate_today_all GET Obtiene tasas del día para todas las monedas activas.
?page=api_rate_from_date&currency=2&from=2026-03-01 GET Obtiene tasas desde una fecha inicial.
?page=api_rate_range&currency=2&from=2026-03-01&to=2026-03-27 GET Obtiene tasas dentro de un rango de fechas.
?page=api_rate_today_csv&date=2026-03-27 GET Descarga CSV compatible con SAP DTW.

Ejemplos

Ejemplo JSON - tasa del día USD

{
  "success": true,
  "source": "BANGUAT",
  "date": "2026-03-27",
  "data": {
    "date": "2026-03-27",
    "sap_code": "USD",
    "pair": "GTQ/USD",
    "quote_mode": "DIRECT_GTQ",
    "raw_buy_rate": 7.65053,
    "raw_sell_rate": 7.65053,
    "buy_rate": 7.65053,
    "sell_rate": 7.65053,
    "gtq_value": 7.65053,
    "sap_ready": "7.650530"
  }
}

Ejemplo CSV - SAP DTW

RateDate,Currency,BuyRate,SellRate
20260327,CAD,10.601339,10.602104
20260327,CHF,6.086762,6.087527
20260327,CRC,461.960000,466.890000
20260327,EUR,8.820296,8.820296
20260327,GBP,10.182855,10.183620
20260327,MXN,18.065200,18.070000
20260327,SEK,9.417500,9.419700
20260327,USD,7.650530,7.650530
20260327,YEN,159.850000,159.860000

Integración SAP

El endpoint CSV fue preparado para exportación compatible con SAP Business One mediante Data Transfer Workbench (DTW).

Campos del CSV

  • RateDate: fecha en formato YYYYMMDD
  • Currency: código SAP de moneda
  • BuyRate: tasa compra
  • SellRate: tasa venta

Recomendación

Para carga diaria, usar una fecha hábil y validar previamente el endpoint health y la disponibilidad de tasas.

Notas operativas

En fines de semana o días no hábiles, algunas monedas pueden no tener tasa exacta para la fecha solicitada.
  • La moneda base del sistema es GTQ.
  • Algunas monedas pueden requerir normalización especial según su forma de cotización.
  • Para procesos automáticos, se recomienda consumir primero el endpoint health.
  • El CSV para SAP excluye GTQ y exporta únicamente monedas extranjeras activas.