← API nómina LATAM · Artículo en blog

Integrar la API de nómina LATAM en Node.js y Python

Esta guía cubre autenticación vía RapidAPI, el endpoint gross→net, reverse (neto objetivo) y recomendaciones para integrar en apps HR o fintech.

1. Suscripción y clave

1. Entra en LATAM & Iberia Payroll en RapidAPI.
2. Elige plan Basic ($0) y suscríbete.
3. Copia X-RapidAPI-Key y usa host latam-iberia-payroll.p.rapidapi.com.
4. Documentación OpenAPI: api.rovidev.com/docs.

2. Node.js — gross → net

const RAPIDAPI_KEY = process.env.RAPIDAPI_KEY;
const HOST = 'latam-iberia-payroll.p.rapidapi.com';

async function grossToNet(country, grossMonthly) {
  const res = await fetch(`https://api.rovidev.com/v1/payroll/${country}`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-RapidAPI-Key': RAPIDAPI_KEY,
      'X-RapidAPI-Host': HOST,
    },
    body: JSON.stringify({ gross_monthly: grossMonthly, pay_period: 'monthly' }),
  });
  if (!res.ok) throw new Error(await res.text());
  return res.json();
}

// MX 35 000 bruto → neto + coste empleador
grossToNet('mx', 35000).then(console.log);

3. Python — reverse (neto → bruto)

import os, requests

RAPIDAPI_KEY = os.environ["RAPIDAPI_KEY"]
HOST = "latam-iberia-payroll.p.rapidapi.com"
BASE = "https://api.rovidev.com"

def reverse_net(country: str, net_target: float) -> dict:
    r = requests.post(
        f"{BASE}/v1/payroll/{country}/reverse",
        headers={
            "Content-Type": "application/json",
            "X-RapidAPI-Key": RAPIDAPI_KEY,
            "X-RapidAPI-Host": HOST,
        },
        json={"net_monthly": net_target, "pay_period": "monthly"},
        timeout=30,
    )
    r.raise_for_status()
    return r.json()

# Neto 30 000 MXN → bruto necesario
print(reverse_net("mx", 30000))

4. Batch (hasta 50 nóminas)

POST https://api.rovidev.com/v1/payroll/batch con array items: cada elemento lleva country, gross_monthly o net_monthly + mode (forward / reverse).

5. Buenas prácticas

• Cachea reglas por país solo si aceptas desfase fiscal; la API ya devuelve desglose actualizado.
• Maneja 429 con backoff; respeta cuotas del plan RapidAPI.
• No sustituyas asesoría legal: muestra disclaimer en UI de planificación salarial.
• Para una sola consulta humana, enlaza a calculadoras gratis.

Preguntas frecuentes

Probar en RapidAPI