/ Empezar

Primeros pasos

Qué es la API de Gavi Efact, cómo conseguir tus credenciales y cómo emitir tu primera factura en ambiente de pruebas.

Introducción

La API de Gavi Efact es una API REST para emitir comprobantes electrónicos a SUNAT: facturas, boletas, notas de crédito y débito, resúmenes diarios, comunicaciones de baja y guías de remisión. Tú envías un JSON con la venta; nosotros calculamos IGV y totales, asignamos el correlativo, generamos el XML UBL, lo firmamos con tu certificado digital y lo enviamos a SUNAT.

Las solicitudes y respuestas son JSON, los mensajes de validación vienen en español y todas las fechas usan el formato yyyy-mm-dd.

URL base

Entorno	URL
Producción y pruebas	https://apifact.gavi-cloud.com/api/v1

El ambiente (beta o producción) lo define la configuración de tu empresa, no la URL. Mientras tu empresa esté en beta, los comprobantes van al ambiente de pruebas de SUNAT y no tienen validez tributaria.

URL base

https://apifact.gavi-cloud.com/api/v1

Inicio rápido

Crea tu cuenta en el panel y configura tu empresa: RUC, usuario secundario SOL, certificado digital y ambiente.
Copia tu api_key y api_secret desde la sección «Mi API key» del panel. El secret se muestra una sola vez.
Envía tu primer comprobante con POST /facturas (ejemplo a la derecha).
Consulta el estado con GET /facturas/{id} o recibe un aviso por webhook.

El envío a SUNAT es asíncrono: la respuesta del POST trae sunat_status: "pendiente" y el comprobante se envía en segundo plano. Pasa a aceptado o rechazado cuando SUNAT responde.

curl -X POST "https://apifact.gavi-cloud.com/api/v1/facturas" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "serie": "F001",
    "fecha_emision": "2026-10-02",
    "cliente": {
      "tipo_doc": "6",
      "num_doc": "20555666777",
      "razon_social": "ACME CORP SAC"
    },
    "items": [
      {
        "descripcion": "SERVICIO DE CONSULTORIA",
        "unidad": "ZZ",
        "cantidad": 1,
        "precio_unitario": 118
      }
    ]
  }'

Respuesta201 Created

{
  "estado": "exito",
  "mensaje": "Factura creada y encolada para envío a SUNAT.",
  "datos": {
    "id": 124,
    "numero_completo": "F001-124",
    "mto_oper_gravadas": "100.00",
    "mto_igv": "18.00",
    "mto_imp_venta": "118.00",
    "sunat_status": "pendiente"
  }
}

Planes y funciones

Todos los planes incluyen acceso a la API. Algunas funciones dependen del plan; si llamas a una que tu plan no incluye, la API responde 403.

Función	Emprendedor	Negocio	Empresa
Facturas, boletas, notas, resumen diario y anulaciones	✓	✓	✓
Consulta de CPE y CDR, reportes básicos	✓	✓	✓
Guías de remisión (remitente y transportista)	—	✓	✓
Webhooks, exportación ZIP, reportes avanzados	—	✓	✓
SIRE, retenciones y percepciones	—	—	✓