SUNATIZ - Facturación Electrónica

Inicio Rápido

1. Obtén tu API Key

Ve a Configuración → API Keys en el portal y genera una nueva API Key.

2. Configura SUNAT

Sube tu certificado digital y configura tus credenciales SOL en el portal.

3. Emite documentos

Usa la API para crear facturas, boletas, notas de crédito y guías de remisión.

Autenticación

Todas las peticiones deben incluir el header X-API-Key con tu API Key:

curl -X GET "https://tu-dominio.com/api/v1/documents" \
  -H "X-API-Key: sk_live_abc123..."

Ejemplo: Crear Factura

curl -X POST "https://tu-dominio.com/api/v1/documents/invoice" \
  -H "X-API-Key: tu-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "serie": "F001",
    "fechaEmision": "2025-01-06",
    "cliente": {
      "tipoDocumento": "6",
      "numDocumento": "20123456789",
      "razonSocial": "EMPRESA CLIENTE S.A.C.",
      "direccion": "AV. EJEMPLO 123, LIMA"
    },
    "items": [
      {
        "codigo": "PROD001",
        "descripcion": "Producto de ejemplo",
        "unidad": "NIU",
        "cantidad": 2,
        "valorUnitario": 100.00,
        "tipoIgv": "10"
      }
    ]
  }'

Respuesta de ejemplo

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "documentType": "01",
  "serie": "F001",
  "correlativo": 123,
  "status": "ACCEPTED",
  "fechaEmision": "2025-01-06",
  "cliente": {
    "tipoDocumento": "6",
    "numDocumento": "20123456789",
    "razonSocial": "EMPRESA CLIENTE S.A.C."
  },
  "totals": {
    "gravadas": 200.00,
    "igv": 36.00,
    "total": 236.00
  },
  "sunatResponse": {
    "code": "0",
    "description": "La Factura numero F001-123, ha sido aceptada"
  },
  "pdfUrl": "https://storage.sunatiz.com/...",
  "xmlUrl": "https://storage.sunatiz.com/..."
}

Referencia de Endpoints

Webhooks

Configura webhooks para recibir notificaciones en tiempo real cuando ocurran eventos:

document.created- Documento creado exitosamente

document.accepted- Documento aceptado por SUNAT

document.rejected- Documento rechazado por SUNAT

document.voided- Documento anulado

Códigos de Estado SUNAT

Código	Estado	Descripción
`0`	ACCEPTED	Documento aceptado
`0100-0999`	ACCEPTED_OBS	Aceptado con observaciones
`2000-3999`	REJECTED	Rechazado - Error en documento
`4000+`	ERROR	Error técnico de SUNAT

¿Necesitas ayuda? Contacta a soporte en soporte@sunatiz.com