Integración

API RUC con Node.js — Integración Express

Consulta SUNAT/RUC desde Node.js con axios y Express middleware.

Equipo Json.pe··4 min

Setup

npm install axios dotenv express

Middleware de validación RUC

const axios = require("axios");

async function validarRuc(ruc) {
  const { data } = await axios.post(
    "https://api.json.pe/api/ruc",
    { ruc },
    { headers: { Authorization: `Bearer ${process.env.JSONPE_TOKEN}` } }
  );
  return data;
}

// Express route
app.get("/proveedor/:ruc", async (req, res) => {
  try {
    const result = await validarRuc(req.params.ruc);
    res.json(result.data);
  } catch (err) {
    res.status(500).json({ error: "Error consultando RUC" });
  }
});

Validaciones recomendadas

  • RUC debe tener 11 dígitos
  • Verificar condicion === "HABIDO" para proveedores activos
  • Cachear respuestas 24h para RUCs frecuentes

👉 API RUC completa