Conecta tu sistema con AIONVEX

curl --request POST 'https://api.aionvex.com/v1/boletas' --header 'X-Api-Key: TU_API_KEY' --header 'X-Api-Secret: TU_API_SECRET' --header 'Content-Type: application/json' --header 'Idempotency-Key: VENTA-001' --data-binary '@boleta.json'

// Ejecuta este ejemplo en el servidor de tu sistema con Node.js 18 o superior.
// Guarda las credenciales en variables de entorno; no las pongas en el navegador.
const apiKey = process.env.AIONVEX_API_KEY;
const apiSecret = process.env.AIONVEX_API_SECRET;
if (!apiKey || !apiSecret) throw new Error("Configura las dos credenciales del negocio.");

// Usa la referencia REAL de la venta en tu sistema y guardala antes del envio.
// Dos ventas diferentes necesitan referencias diferentes.
const referenciaVenta = "VENTA-EJEMPLO-001";

const comprobante = {
  serie: "B001",                 // Serie de boleta habilitada para este negocio.
  fecha_emision: "2026-10-08",    // Reemplaza por la fecha de la operacion: AAAA-MM-DD.
  tipo_moneda: "PEN",            // PEN = soles. Tambien se admiten USD y EUR.
  forma_pago: "Contado",         // Este ejemplo no incluye credito ni cuotas.
  cliente: {
    tipo_doc: "1",               // "1" = DNI. Para factura usa "6" = RUC.
    num_doc: "00000001",         // Dato ficticio. Usa el documento real como TEXTO.
    razon_social: "CLIENTE DE EJEMPLO" // Nombre del cliente o su razon social.
  },
  items: [{
    codigo: "P001",              // Codigo de tu producto o servicio.
    descripcion: "Producto de ejemplo",
    unidad: "NIU",              // NIU = unidad de producto.
    cantidad: 1,                // Numero mayor que cero; no lleva comillas.
    precio_unitario: 118.00,     // Precio por unidad. Usa la configuracion de precios del negocio.
    tip_afe_igv: "10",           // "10" = operacion gravada con IGV.
    porcentaje_igv: 18           // Porcentaje de IGV de este ejemplo gravado.
  }]
};

// JSON.stringify convierte el objeto a JSON valido: los comentarios NO se envian.
// Para una factura: cambia /boletas por /facturas, serie por F001,
// tipo_doc por "6" y num_doc por el RUC real del cliente (11 digitos).
const respuesta = await fetch("https://api.aionvex.com/v1/boletas", {
  method: "POST",                // POST crea un comprobante.
  headers: {
    "X-Api-Key": apiKey,         // Identifica el negocio que emite.
    "X-Api-Secret": apiSecret,   // Autentica la clave de ese negocio.
    "Content-Type": "application/json",
    "Idempotency-Key": referenciaVenta // Evita crear dos veces la misma venta.
  },
  body: JSON.stringify(comprobante)
});

const resultado = await respuesta.json();
if (!respuesta.ok) {
  // HTTP 422: muestra cada campo y sus mensajes para corregir la venta.
  if (respuesta.status === 422) {
    for (const [campo, mensajes] of Object.entries(resultado.errores ?? {})) {
      console.error(campo, mensajes.join("; "));
    }
  } else {
    console.error("HTTP", respuesta.status, resultado.mensaje);
  }
  // No generes otra referencia ni hagas un reintento automatico.
  // Para 409 o 503, conserva la referencia y revisa el resultado con AIONVEX.
  throw new Error("La emision no se confirmo.");
}

console.log("ID para guardar en tu venta:", resultado.datos?.id);
console.log("Respuesta:", resultado);
// Guarda datos.id junto con referenciaVenta en tu base de datos.
// HTTP 201 significa creado; consulta GET /boletas/{id} para conocer el estado SUNAT.

{
    "estado": "exito",
    "mensaje": "Estado del comprobante consultado.",
    "datos": {
        "id": 123,
        "numero_completo": "F001-000001",
        "sunat": {
            "estado": "pendiente",
            "codigo": null,
            "descripcion": null
        }
    }
}

curl 'https://api.aionvex.com/v1/facturas/123/pdf?format=a4' --header 'X-Api-Key: TU_API_KEY' --header 'X-Api-Secret: TU_API_SECRET' --output factura.pdf

{
  "estado": "error",
  "mensaje": "Error de validación",
  "errores": {
    "cliente.num_doc": [
      "El RUC debe contener exactamente 11 digitos."
    ],
    "items.0.cantidad": [
      "La cantidad debe ser un numero mayor que cero."
    ]
  }
}