LGS - API SUNAT

Plataforma SaaS de Facturación Electrónica UBL 2.1 | LGS Anden Perú
v2.1 UBL Active
Stellar
Cyberpunk
Vaporwave
Glosario Técnico de Variables
Referencia Rápida

Comprende cómo enviar los parámetros correctos en el JSON para evitar rechazos de SUNAT.

Entorno (modo)
  • "0" (Pruebas / Beta SUNAT): Ideal para desarrollo. Usa credenciales MODDATOS automáticas. Sin valor tributario.
  • "1" (Producción): Emisión real. Requiere Usuario Secundario (Clave SOL) en los campos usu_secundario_produccion_user y password.
Código de Unidad (codigo_unidad)
  • "NIU" (Bienes): Productos físicos, mercadería o artículos cuantificables.
  • "ZZ" (Servicios): Servicios profesionales, instalaciones, mantenimientos o intangibles.
POST /post.php
Factura Electrónica (01)

Emisión estándar UBL 2.1 con RUC emisor, datos del cliente con RUC y cálculo de IGV 18%.

Payload JSON (Factura) 
{
  "empresa": {
    "ruc": "20612999121",
    "razon_social": "BENATIVUS S.A.C.",
    "nombre_comercial": "BE NATIVUS",
    "domicilio_fiscal": "CAL.CALLE 8 LOTE. 2 URB. SANTA ROSA",
    "ubigeo": "150114",
    "urbanizacion": "SANTA ROSA PROV. DEL CALLAO ",
    "distrito": "CALLAO",
    "provincia": "CALLAO",
    "departamento": "CALLAO",
    "modo": "0",
    "usu_secundario_produccion_user": "MODDATOS",
    "usu_secundario_produccion_password": "MODDATOS"
  },
  "cliente": {
    "razon_social_nombres": "BODEGAS DON PEPE",
    "numero_documento": "20102010202",
    "codigo_tipo_entidad": "6",
    "cliente_direccion": "Av. Morales Duarez 168"
  },
  "venta": {
    "serie": "F001",
    "numero": "100",
    "fecha_emision": "2026-08-10",
    "hora_emision": "12:12:12",
    "fecha_vencimiento": "",
    "moneda_id": "2",
    "forma_pago_id": "1",
    "total_gravada": "500",
    "total_igv": "216",
    "total_exonerada": "",
    "total_inafecta": "",
    "tipo_documento_codigo": "01",
    "nota": "Venta de bienes y servicio"
  },
  "items": [
    {
      "producto": "AIRE ACONDICIONADO LG DE 12MIL BTU - INSTALACION",
      "cantidad": "1",
      "precio_base": "200",
      "codigo_sunat": "-",
      "codigo_producto": "cc1",
      "codigo_unidad": "ZZ",
      "tipo_igv_codigo": "10"
    },
    {
      "producto": "LAPTOP LENOVO I3 10 GEN 8GB RAM 256GB SSD",
      "cantidad": "2",
      "precio_base": "500",
      "codigo_sunat": "46171606",
      "codigo_producto": "H-003001981 22-10",
      "codigo_unidad": "NIU",
      "tipo_igv_codigo": "10"
    }
  ]
}
POST /post.php
Boleta Electrónica (03)

Emisión de boletas a personas naturales con DNI o sin documento (ventas menores a S/ 700).

Payload JSON (Boleta) 
{
  "empresa": {
    "ruc": "20612999121",
    "razon_social": "BENATIVUS S.A.C.",
    "nombre_comercial": "BE NATIVUS",
    "domicilio_fiscal": "CAL.CALLE 8 LOTE. 2 URB. SANTA ROSA",
    "ubigeo": "150114",
    "urbanizacion": "SANTA ROSA PROV. DEL CALLAO ",
    "distrito": "CALLAO",
    "provincia": "CALLAO",
    "departamento": "CALLAO",
    "modo": "0",
    "usu_secundario_produccion_user": "MODDATOS",
    "usu_secundario_produccion_password": "MODDATOS"
  },
  "cliente": {
    "razon_social_nombres": "JUAN PEREZ ROJAS",
    "numero_documento": "45879632",
    "codigo_tipo_entidad": "1",
    "cliente_direccion": "Av. Los Proceres 450"
  },
  "venta": {
    "serie": "B001",
    "numero": "500",
    "fecha_emision": "2026-08-12",
    "hora_emision": "10:10:01",
    "fecha_vencimiento": "",
    "moneda_id": "2",
    "forma_pago_id": "1",
    "total_gravada": "100",
    "total_igv": "18",
    "total_exonerada": "",
    "total_inafecta": "",
    "tipo_documento_codigo": "03",
    "nota": "Venta al mostrador"
  },
  "items": [
    {
      "producto": "MANTENIMIENTO PREVENTIVO DE LAPTOP",
      "cantidad": "1",
      "precio_base": "100",
      "codigo_sunat": "-",
      "codigo_producto": "SERV-01",
      "codigo_unidad": "ZZ",
      "tipo_igv_codigo": "10"
    }
  ]
}
POST /post.php
Nota de Crédito (07)

Anulación o corrección de facturas/boletas referenciando documento y motivo SUNAT.

Payload JSON (Nota de Crédito) 
{
  "empresa": {
    "ruc": "20612999121",
    "razon_social": "BENATIVUS S.A.C.",
    "modo": "0",
    "usu_secundario_produccion_user": "MODDATOS",
    "usu_secundario_produccion_password": "MODDATOS"
  },
  "cliente": {
    "razon_social_nombres": "BODEGAS DON PEPE",
    "numero_documento": "20102010202",
    "codigo_tipo_entidad": "6"
  },
  "venta": {
    "serie": "FC01",
    "numero": "15",
    "fecha_emision": "2026-08-14",
    "hora_emision": "11:00:00",
    "tipo_documento_codigo": "07",
    "relacionado_serie": "F001",
    "relacionado_numero": "100",
    "relacionado_motivo_codigo": "01",
    "relacionado_tipo_documento": "01",
    "nota": "Anulación de la operación por devolución de mercadería"
  },
  "items": [ ... ]
}
POST /baja.php
Comunicación de Baja (Anulaciones)

Envío de resumen de anulación directa para facturas emitidas en el plazo permitido.

Payload JSON (Baja) 
{
  "empresa": {
    "ruc": "20612999121",
    "modo": "0"
  },
  "baja": {
    "serie": "F001",
    "numero": "100",
    "motivo": "Error en digitación de RUC de cliente"
  }
}
GET /tipo_cambio.php
Tipo de Cambio SUNAT

Obtén la cotización oficial de compra y venta del dólar para cualquier fecha.

Ejemplo de Solicitud & Respuesta 
// GET /tipo_cambio.php?fecha=2026-08-10

{
  "data": {
    "origen": "SUNAT",
    "fecha": "2026-08-10",
    "moneda": "USD",
    "compra": 3.374,
    "venta": 3.391
  }
}
GET / POST /consulta_ruc.php
Consulta de RUC

Obtén razón social, estado, condición tributaria y domicilio fiscal del contribuyente.

Ejemplo de Solicitud & Respuesta 
// GET /consulta_ruc.php?ruc=20102020511
// O POST {"ruc": "20102020511"}

{
  "data": {
    "ruc": "20102020511",
    "razon_social": "CENTRO SUIZO RELOJERO SAN ISIDRO S.A.C.",
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "direccion": "AV. PASEO DE LA REPUBLICA NRO 3440 INT. B42A",
    "ubigeo": "150131",
    "distrito": "SAN ISIDRO",
    "provincia": "LIMA",
    "departamento": "LIMA"
  }
}
GET / POST /consulta_dni.php
Consulta de DNI

Recupera nombres, apellidos completos y dígito de verificación para personas naturales.

Ejemplo de Solicitud & Respuesta 
// GET /consulta_dni.php?dni=44203391
// O POST {"dni": "44203391"}

{
  "data": {
    "dni": "44203391",
    "nombre_completo": "ARANDA AMBICHO DADNER YOHAD",
    "nombres": "DADNER YOHAD",
    "apellido_paterno": "ARANDA",
    "apellido_materno": "AMBICHO",
    "codigo_verificacion": null
  }
}

Configuración de Empresa

Sube el certificado digital otorgado por tu entidad certificadora (Llamasoft, Reniec, etc.) y el logotipo corporativo para la emisión de comprobantes PDF y firma UBL 2.1.

Archivos soportados: .pfx, .p12 únicamente.
Formatos: PNG, JPG. Si no se adjunta, se mostrará el logo genérico de TU_EMPRESA.