GATEWAY OFICIAL: https://api.mint.atalaya.pe

API de Facturación SUNAT — Mint Atalaya

La API de Mint Atalaya desacopla por completo la complejidad técnica de la facturación electrónica peruana. Gestiona la estructura UBL 2.1, la firma digital X.509 en memoria, la transmisión SOAP y el almacenamiento de constancias CDR de SUNAT a través de un endpoint REST 100% en JSON.

Entorno Sandbox (Beta) Inicial: Tu cuenta comienza en entorno BETA con credenciales de homologación preconfiguradas. Puedes emitir sin riesgo comprobantes de prueba. Cuando estés listo para facturar legalmente, basta con subir tu certificado y activar el modo PRODUCCIÓN desde tu panel.

Autenticación (API Keys)

Todas las peticiones a la API REST requieren un token de autenticación Bearer emitido desde tu panel. Inclúyelo en la cabecera HTTP de cada solicitud:

HTTP Headers Requeridos

Authorization: Bearer 2|mint_live_vTlJPWQPLACotuG6qLxpGQ8onSICIJ5pMg...
Accept: application/json
Content-Type: application/json

Genera y administra tus API Keys desde tu Dashboard seguro. Ir al Gestor de API Keys

POST /api/v1/invoices

Emitir Factura Electrónica (01)

Emite una Factura UBL 2.1 con ítems, cantidades, valores unitarios y datos fiscales del receptor (RUC obligatorio).

JSON Payload de Ejemplo (Factura Gravada con IGV 18%)

{
  "serie": "F001",
  "fecha_emision": "2026-10-20",
  "moneda": "PEN",
  "forma_pago_tipo": "Contado",
  "client": {
    "tipo_documento": "6",
    "numero_documento": "20600055511",
    "razon_social": "DISTRIBUIDORA COMERCIAL S.A.C.",
    "direccion": "CALLE LOS NEGOCIOS 456, SURQUILLO, LIMA"
  },
  "detalles": [
    {
      "codigo": "SERV-01",
      "descripcion": "Licencia Mint Atalaya Facturación Cloud",
      "unidad": "ZZ",
      "cantidad": 1,
      "mto_valor_unitario": 200.00,
      "porcentaje_igv": 18.00,
      "tip_afe_igv": "10"
    }
  ]
}

Respuesta Exitosa (HTTP 201 Created):

{
  "success": true,
  "message": "Factura creada correctamente",
  "data": {
    "id": 15,
    "serie": "F001",
    "correlativo": "00000015",
    "fecha_emision": "2026-10-20",
    "mto_oper_gravadas": 200.00,
    "mto_igv": 36.00,
    "mto_imp_venta": 236.00,
    "estado_sunat": "REGISTRADO"
  }
}

POST /api/v1/boletas

Emitir Boleta de Venta (03)

Registra una boleta para consumidores finales. Admite DNI (tipo documento `1`) o cliente sin documento para montos menores a S/ 700.00.

JSON Payload (Boleta con DNI)

{
  "serie": "B001",
  "fecha_emision": "2026-10-20",
  "moneda": "PEN",
  "client": {
    "tipo_documento": "1",
    "numero_documento": "45879854",
    "razon_social": "JUAN PEREZ MENDOZA",
    "direccion": "AV. AREQUIPA 1230, LIMA"
  },
  "detalles": [
    {
      "codigo": "ART-99",
      "descripcion": "Teclado Mecánico Inalámbrico",
      "unidad": "NIU",
      "cantidad": 1,
      "mto_valor_unitario": 84.75,
      "porcentaje_igv": 18.00,
      "tip_afe_igv": "10"
    }
  ]
}

Descargas Oficiales: PDF, XML y CDR

Endpoints directos para recuperar los comprobantes y constancias oficiales exigidos por SUNAT:

GET

/api/v1/invoices/{id}/download-pdf

Usa ?format=a4 o ?format=ticket (80mm térmico con tu logo).

GET

/api/v1/invoices/{id}/download-xml

Descarga directa del archivo XML firmado con certificado X.509 y UBL 2.1.

GET

/api/v1/invoices/{id}/download-cdr

Archivo ZIP oficial con la Constancia de Recepción emitida por SUNAT (Código 0 = Aceptado).

GUÍA OFICIAL

Certificados Digitales (PEM / PFX) y Clave SOL SUNAT

Para emitir comprobantes con plena validez legal en MODO PRODUCCIÓN, SUNAT exige que cada documento sea firmado digitalmente con un Certificado Digital X.509 asociado a tu RUC. A continuación te explicamos cómo obtenerlo de forma gratuita.

1 Solicitar el Certificado Digital Tributario (CDT) Gratuito

SUNAT otorga a todas las empresas peruanas (RUC 20 o RUC 10 con negocio) un Certificado Digital Tributario gratuito por 3 años:

Ingresa al portal de SUNAT Operaciones en Línea con tu RUC, Usuario y Clave SOL principal.
Navega al menú: Empresas > Comprobantes de Pago > Certificado Digital Tributario > Solicitar Certificado Digital Tributario.
Acepta los términos y condiciones de la entidad certificadora (RENIEC / SUNAT).
Descarga el archivo .pfx en tu computadora y anota la contraseña asignada (la necesitarás en Mint Atalaya).

2 Crear un Usuario Secundario SOL para Facturación

Por normativa y seguridad bancaria, nunca utilices tu Clave SOL principal en APIs de facturación. Crea un usuario secundario exclusivo:

En SUNAT SOL, ve a Administración de Usuarios Secundarios.
Haz clic en Crear Usuario (ejemplo: FACTURADOR) y asígnale una contraseña segura.
Haz clic en Asignar Perfiles y marca la casilla: Comprobantes de Pago > Comprobantes de Pago Electrónicos.
Guarda los cambios. Tu usuario de emisión será: RUC + USUARIO_SECUNDARIO (o solo el usuario secundario según solicite el formulario).

3 Cargar el Certificado en Mint Atalaya (.pfx o .pem)

Nuestra plataforma acepta directamente tanto archivos .pfx como .pem:

Opción A (Recomendada): Sube tu archivo .pfx directamente en tu panel de Configuración de Empresa e ingresa la contraseña del certificado.
Opción B (Conversión manual a .pem con OpenSSL): Si prefieres extraer la clave y el certificado en texto plano:
```
openssl pkcs12 -in mi_certificado.pfx -out certificado.pem -nodes
```

TABLAS OFICIALES

Catálogos Oficiales de SUNAT

Códigos estandarizados por la Resolución de Superintendencia N° 097-2012/SUNAT para la emisión de comprobantes UBL 2.1:

Catálogo N° 01: Código de Tipo de Documento

Código	Descripción del Comprobante	Serie Habitual
01	Factura Electrónica	F001 - F999
03	Boleta de Venta Electrónica	B001 - B999
07	Nota de Crédito Electrónica	FC01 / BC01
08	Nota de Débito Electrónica	FD01 / BD01
09	Guía de Remisión Remitente	T001 - T999

Catálogo N° 06: Tipo de Documento de Identidad

Código	Tipo de Documento	Longitud
1	DNI (Documento Nacional de Identidad)	8 dígitos
6	RUC (Registro Único de Contribuyentes)	11 dígitos
4	Carnet de Extranjería	Hasta 12 caracteres
7	Pasaporte	Hasta 12 caracteres
0	Doc. Trib. No Domiciliado Sin RUC	-

Catálogo N° 07: Códigos de Afectación al IGV (`tip_afe_igv`)

Código	Descripción de la Operación	Tasa IGV
10	Gravado - Operación Onerosa	18.00%
20	Exonerado - Operación Onerosa (Apéndice I y II)	0.00%
30	Inafecto - Operación Onerosa	0.00%
11	Gravado - Retiro por premio	0.00% (Gratuito)
12	Gravado - Retiro por donación	0.00% (Gratuito)
40	Exportación de Bienes o Servicios	0.00%

Catálogo N° 02: Monedas

PEN Soles (Perú)
USD Dólares Americanos
EUR Euros

Catálogo N° 09: Tipos de Nota de Crédito

01 Anulación de la operación
02 Anulación por error en el RUC
03 Corrección por error en descripción
04 Descuento global
06 Devolución total
07 Devolución por ítem