Saltar al contenido principal
Consultas

API de tipo de cambio SUNAT

Obtén en JSON el tipo de cambio de compra y venta publicado por SUNAT para cada día de un mes y úsalo en tus facturas en dólares, tu contabilidad o tus reportes.

Para qué sirve

  • Convertir a soles el total de facturas y boletas emitidas en dólares.
  • Registrar compras y ventas en moneda extranjera en tu contabilidad.
  • Calcular diferencias de cambio al cierre de mes.
  • Mostrar el tipo de cambio del día en tu sistema, web o punto de venta.
  • Llenar automáticamente la columna de tipo de cambio en reportes de Excel.

Qué devuelve la API

Envías en el cuerpo el anio y el mes (número del 1 al 12) y recibes success y un arreglo data. Cada elemento corresponde a un día:

CampoContenido
fechaDía en formato ISO aaaa-mm-dd, fácil de ordenar y de cruzar con tus registros.
compraTipo de cambio de compra del dólar, como texto con tres decimales.
ventaTipo de cambio de venta del dólar, como texto con tres decimales.

Los valores llegan como texto para conservar los decimales tal como se publican. Conviértelos a número decimal en tu lenguaje (por ejemplo parseFloat o un tipo Decimal) solo en el momento de calcular.

Compra, venta y días sin publicación

SUNAT publica el tipo de cambio que se usa como referencia para fines tributarios. Qué valor usar —compra o venta— y para qué fecha depende de la operación y de las normas tributarias y contables que te apliquen; confírmalo con tu contador.

Hay días en que no se publica un valor nuevo, como algunos fines de semana o feriados. Revisa qué fechas trae la respuesta y define en tu sistema una regla clara para esos días —habitualmente se toma el último tipo de cambio publicado— validada con tu área contable.

Cómo empezar

  1. Crea tu cuenta gratis en miapi.cloud; el plan gratuito te permite probar sin tarjeta.
  2. Copia tu token desde el panel admin.miapi.cloud.
  3. Envíalo en cada petición en la cabecera Authorization: Bearer TU_TOKEN, siempre por HTTPS.

Haz una petición POST con {"anio": 2024, "mes": 3} para ver la estructura y luego programa una tarea diaria que consulte el mes en curso y guarde los valores en tu base de datos.

La cantidad de consultas disponibles depende de tu plan; revisa los planes en miapi.cloud/#planes. Si tienes dudas para integrarla, escríbenos por WhatsApp.

Buenas prácticas

  • Guarda una tabla local con fecha, compra y venta. Los meses cerrados no cambian, así que basta consultarlos una vez.
  • Actualiza el mes en curso una o pocas veces al día; no consultes la API en cada factura.
  • Valida el cuerpo: año de cuatro dígitos y mes entre 1 y 12, ambos numéricos.
  • Reintenta con espera si recibes un 5xx y sigue usando el último valor guardado mientras tanto.

Guarda el token en el servidor, en una variable de entorno o en tu gestor de secretos. No lo pongas en el código de una página web ni en una app móvil: cualquiera podría leerlo y gastar tus consultas. Si sospechas que se filtró, genera uno nuevo desde el panel.

Si emites comprobantes en dólares, combínala con la API de facturación electrónica.

Referencia de la API

Todas las peticiones llevan tu token en la cabecera Authorization: Bearer TU_TOKEN. Lo copias desde tu panel en admin.miapi.cloud después de crear tu cuenta gratis. Más detalles en la documentación.

Tipo de Cambio SUNAT

Obtiene el tipo de cambio oficial de compra y venta de SUNAT por mes y año.

POST https://miapi.cloud/v1/tipodecambio

Petición
curl -X POST "https://miapi.cloud/v1/tipodecambio" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"anio":2024,"mes":3}'
Respuesta de ejemplo (datos ficticios)
{
  "success": true,
  "data": [
    {
      "fecha": "2024-03-01",
      "compra": "3.750",
      "venta": "3.758"
    },
    {
      "fecha": "2024-03-02",
      "compra": "3.752",
      "venta": "3.760"
    }
  ]
}

Errores frecuentes

CódigoQué significa
401Token ausente o inválido. Revisa la cabecera Authorization: Bearer TU_TOKEN.
400 / 422Año o mes faltante o con formato inválido. Envía números: anio con 4 dígitos y mes del 1 al 12.
429Alcanzaste el límite de consultas de tu plan. Guarda los valores localmente para consultar menos.
5xxLa fuente de SUNAT o nuestro servicio no respondió. Reintenta más tarde y usa el último valor guardado.

Preguntas frecuentes

¿De dónde sale el tipo de cambio?

Del tipo de cambio que publica SUNAT. MiAPI Cloud es un servicio independiente y no está afiliado a SUNAT.

¿Puedo consultar meses anteriores?

Sí. Envías el año y el mes que necesitas y recibes los valores de compra y venta por día de ese mes.

¿Uso el valor de compra o el de venta?

Depende del tipo de operación y de las normas que te apliquen. Valídalo con tu contador y deja la regla configurada en tu sistema.

¿Qué hago con los días que no aparecen?

Define una regla para los días sin publicación, habitualmente usar el último valor publicado, y confírmala con tu área contable.

¿Es gratis?

Puedes probarla con el plan gratuito al registrarte. Los límites dependen de tu plan; revisa los planes en miapi.cloud/#planes.

APIs relacionadas

Empieza gratis hoy

Crea tu cuenta gratis, copia tu token y haz tu primera consulta en minutos. Sin tarjeta de crédito.