Version: 1.0.11

Factura Electrónica

Descripción General

La API de Facturas Electrónicas permite la generación, validación y envío de facturas que cumplen con las especificaciones técnicas de SUNAT. Por cada operación, obtendrá los tres archivos reglamentarios: XML firmado digitalmente, representación impresa en PDF y la Constancia de Recepción (CDR).

Tipos de Facturas Disponibles

En esta sección encontrará endpoints para los siguientes tipos de facturas:

• Factura Gravada - Para operaciones afectas a IGV
• Factura Gravada sin Enviar - Generación sin envío inmediato a SUNAT
• Factura Exonerada - Para operaciones exoneradas de IGV
• Factura Inafecta - Para operaciones no afectas a IGV
• Factura Gratuita - Para transferencias gratuitas
• Factura de Contingencia - Para emisión durante caídas del sistema de SUNAT
• Factura Generada Offline - Para emisión sin conexión a internet

Funcionalidades Principales

• Emisión de facturas con múltiples ítems y diferentes tasas impositivas
• Soporte para descuentos a nivel de ítem y documento
• Cálculo automático de impuestos según normativa vigente
• Generación de representación impresa personalizable
• Historial y trazabilidad de documentos emitidos
• Consulta de estado de documentos enviados a SUNAT

Beneficios

• Cumplimiento de la normativa vigente de facturación electrónica
• Agilización del proceso de emisión de comprobantes
• Reducción de errores en cálculos tributarios
• Integración sencilla con su sistema de ventas o ERP existente

Autenticación

API Key

Security Scheme Type:	oauth2
OAuth Flow (implicit):	Authorization URL: https://empresa1.demo3pro6.ibu.pe Scopes: write:pets: modify pets in your account read:pets: read your pets

Implementación

Para implementar la emisión de facturas electrónicas en su sistema, siga estos pasos:

1. Obtener Credenciales: Solicite sus credenciales de API en el panel de administración de Pro 7
2. Validar Conexión: Utilice el endpoint de prueba para verificar la correcta configuración
3. Preparar Payload: Estructure los datos según el tipo de factura a emitir
4. Realizar Petición: Envíe la solicitud al endpoint correspondiente
5. Procesar Respuesta: Almacene los archivos generados (XML, PDF, CDR)

Estructura Base de Petición

Todas las solicitudes de facturas comparten una estructura base similar:

{
  "serie_documento": "F001",
  "numero_documento": "#",
  "fecha_de_emision": "2023-04-22",
  "hora_de_emision": "13:05:00",
  "codigo_tipo_operacion": "0101",
  "codigo_tipo_documento": "01",
  "codigo_tipo_moneda": "PEN",
  "fecha_de_vencimiento": "2023-05-22",
  "numero_orden_de_compra": "OC-00001",
  "datos_del_cliente": {
    "codigo_tipo_documento_identidad": "6",
    "numero_documento": "20600695771",
    "apellidos_y_nombres_o_razon_social": "EMPRESA CLIENTE S.A.C.",
    "codigo_pais": "PE",
    "ubigeo": "150101",
    "direccion": "Av. República de Argentina 2530",
    "correo_electronico": "cliente@empresa.com",
    "telefono": "01-4503400"
  },
  "totales": {
    "total_exportacion": 0.00,
    "total_operaciones_gravadas": 100.00,
    "total_operaciones_inafectas": 0.00,
    "total_operaciones_exoneradas": 0.00,
    "total_operaciones_gratuitas": 0.00,
    "total_igv": 18.00,
    "total_impuestos": 18.00,
    "total_valor": 100.00,
    "total_venta": 118.00
  },
  "items": [
    {
      "codigo_interno": "P001",
      "descripcion": "Producto de prueba",
      "codigo_producto_sunat": "43231513",
      "unidad_de_medida": "NIU",
      "cantidad": 2,
      "valor_unitario": 50,
      "codigo_tipo_precio": "01",
      "precio_unitario": 59,
      "codigo_tipo_afectacion_igv": "10",
      "total_base_igv": 100.00,
      "porcentaje_igv": 18,
      "total_igv": 18.00,
      "total_impuestos": 18.00,
      "total_valor_item": 100.00,
      "total_item": 118.00
    }
  ],
  "informacion_adicional": {
    "tipo_operacion": "VENTA INTERNA",
    "observaciones": "Observaciones de la factura"
  }
}

Ejemplos por Tipo de Factura

Factura Gravada

La factura gravada es el tipo más común, aplicable a operaciones afectas a IGV. Para su emisión, utilice el endpoint /api/documents con el método POST.

Factura Exonerada

Para operaciones exoneradas de IGV, modifique los siguientes campos:

• codigo_tipo_operacion: "0200"
• codigo_tipo_afectacion_igv: "20"
• Ajuste los totales eliminando valores en campos de IGV

Factura de Contingencia

Se utiliza cuando SUNAT presenta problemas en sus servicios. Requiere incluir en su payload:

• is_contingencia: true
• motivo_contingencia: "Caída de servicios de SUNAT"

Consideraciones Importantes

• Verifique siempre el código de respuesta de SUNAT en el CDR
• Las facturas rechazadas deben ser corregidas y reenviadas
• Conserve los tres archivos (XML, PDF, CDR) según la normativa vigente
• Las facturas pueden ser consultadas posteriormente mediante el endpoint /api/documents/{id}

Referencias y Soporte

Para más información sobre códigos de producto SUNAT, tipos de afectación IGV y otros catálogos requeridos, consulte la sección de Referencias.

Si experimenta problemas con la implementación, contacte a nuestro equipo de soporte a través del canal oficial indicado en su panel de administración.