Ir al contenido

Glosario

Términos fiscales de la facturación electrónica en el Perú (SUNAT) y conceptos técnicos de la API de Faktura, ordenados alfabéticamente.

Entorno en el que toda petición autenticada con una clave sk_test_ firma el XML y lo envía a los servidores de homologación y pruebas de SUNAT (SUNAT beta). No tiene validez tributaria y su numeración es independiente de la de producción. Ver Introducción.

Credencial secreta que identifica a tu empresa emisora y define el ambiente al que van las llamadas: sk_test_… apunta a SUNAT beta y sk_live_… a SUNAT producción. Se envía en la cabecera Authorization: Bearer <api key>. Puede tener alcance full (emitir y consultar) o lookup (solo consultas de RUC y DNI). Ver Autenticación.

Comprobante de pago emitido a consumidores finales (POST /v1/receipts). Usa series que empiezan con B (B001). En soles y hasta S/ 700.00 admite cliente sin documento (customer.doc_type: "NONE").

Archivo ZIP firmado digitalmente por SUNAT (p. ej. R-20000000001-01-F001-1.zip) que contiene el XML ApplicationResponse con el veredicto oficial sobre un comprobante (0 aceptado, con o sin observaciones, o código de rechazo). Es el sustento legal de aceptación y se descarga en GET /v1/documents/{id}/cdr.

Certificado X.509 (archivo .pfx o .p12) emitido por una entidad de certificación acreditada ante INDECOPI a nombre del RUC del emisor. Faktura lo usa para firmar digitalmente (XMLDSig) cada comprobante antes de enviarlo a SUNAT.

Resumen firmado (RA-YYYYMMDD-#####) mediante el cual se comunica a SUNAT la anulación de facturas y notas electrónicas con serie F dentro de los 7 días calendario desde su emisión. Faktura lo genera y consulta su ticket automáticamente cuando llamas a POST /v1/documents/{id}/void.

Número entero secuencial asignado por Faktura dentro de una serie (1, 2, 3…) en la misma transacción en que se registra el comprobante. Junto con la serie forma full_number (F001-1).

Sistema de Pago de Obligaciones Tributarias (leyenda 2006, tipo de operación 1001). En facturas de bienes o servicios afectos (Catálogo 54), el comprador deposita un porcentaje del total en la cuenta del Banco de la Nación del emisor y paga el resto (net_payable). Ver la guía de detracción.

Ciclo de vida del envío a SUNAT:

  • pending: creado, numerado y firmado; en cola para enviarse a SUNAT.
  • sending: envío en curso.
  • uncertain: la conexión se cortó sin saber si SUNAT recibió el envío; Faktura consulta el estado antes de reenviar.
  • accepted: aceptado por SUNAT (sunat.code: "0").
  • observed: aceptado por SUNAT con advertencias en sunat.notes.
  • rejected: rechazado por SUNAT (código 2000–3999); no tiene validez tributaria.
  • failed: no pudo enviarse por una causa de configuración del emisor (credenciales SOL o certificado); se reenvía con POST /v1/documents/{id}/retry.

Detalle completo en Estados y envío a SUNAT.

Comprobante de pago emitido a clientes con RUC (POST /v1/invoices) que sustenta costo, gasto y crédito fiscal del IGV. Usa series que empiezan con F (F001) y admite pago al contado o al crédito con cuotas.

Guía de remisión relacionada (despatch_references)

Sección titulada «Guía de remisión relacionada (despatch_references)»

Referencia a una guía de remisión remitente (09) o transportista (31) vinculada con el traslado de los bienes facturados (Catálogos).

ICBPER (Impuesto al Consumo de las Bolsas de Plástico)

Sección titulada «ICBPER (Impuesto al Consumo de las Bolsas de Plástico)»

Tributo de monto fijo por unidad (S/ 0.50 por bolsa) que se activa enviando "icbper": true en el ítem. Ver Cálculo de impuestos.

Mecanismo por el cual repetir una petición de emisión con la misma cabecera Idempotency-Key y el mismo cuerpo dentro de las 24 horas devuelve exactamente el mismo comprobante (200 OK, Idempotent-Replayed: true) sin crear un duplicado ni consumir otro correlativo. Ver Idempotencia.

Impuesto al valor agregado en el Perú (18 % general: 16 % de IGV + 2 % de IPM). Cada ítem indica su afectación en igv_type: gravado, exonerado, inafecto, gratuito, gratuito_exonerado o gratuito_inafecto. Ver Cálculo de impuestos.

Monto efectivo que el cliente debe abonar al emisor tras descontar del totals.total la detracción o la retención del IGV. En una factura al crédito, la suma de las cuotas (payment.installments) debe coincidir exactamente con net_payable.

Comprobante que disminuye o anula el valor de una factura o boleta aceptada por SUNAT, o reprograma sus cuotas con el motivo 13 (POST /v1/credit-notes).

Comprobante que incrementa el valor de una factura o boleta aceptada por SUNAT por intereses moratorios, aumento de valor o penalidades (POST /v1/debit-notes).

Archivo oficial publicado diariamente por SUNAT con el estado, condición de domicilio, ubigeo y dirección de millones de contribuyentes. Faktura lo actualiza diariamente para responder en milisegundos en Consultar un RUC, Consultar varios RUC y Consultar un DNI.

Cargo adicional (en porcentaje o monto fijo) que aplican establecimientos de hospedaje o restaurantes sobre el valor de venta. No forma parte de la base imponible del IGV. Ver Cálculo de impuestos.

Versión legible del comprobante electrónico en formato A4 o ticket térmico (80 mm y 58 mm) con código QR, valor resumen (hash), importe en letras y leyendas de SUNAT (GET /v1/documents/{id}/pdf).

Resumen firmado (RC-YYYYMMDD-#####) que SUNAT exige para comunicar la anulación (estado 3) de boletas y notas con serie B. Faktura lo envía y consulta su ticket automáticamente al llamar a POST /v1/documents/{id}/void.

Régimen aplicable cuando el comprador ha sido designado por SUNAT como Agente de Retención: retiene el 3 % del importe total de la operación (en soles y cuando supera S/ 700.00). Ver la guía de retención.

El Registro Único de Contribuyentes (11 dígitos) identifica a empresas (20…) y personas naturales con negocio (10 + 8 dígitos del DNI + 1 dígito verificador).

Sistema de Emisión Electrónica desde los sistemas del contribuyente: modalidad de SUNAT en la que los comprobantes se firman con el certificado digital de la empresa emisora y se transmiten con su usuario SOL secundario.

Código de 4 caracteres alfanuméricos que identifica el punto de emisión y el tipo de documento: F### para facturas (F001), B### para boletas (B001), FC##/BC## para notas de crédito y FD##/BD## para notas de débito. Se consultan en GET /v1/series.

Estándar XML internacional exigido por SUNAT para todos los comprobantes electrónicos. Faktura lo genera y firma automáticamente a partir del JSON que envías.

Credencial creada dentro de SUNAT Operaciones en Línea con permisos acotados exclusivamente al envío de comprobantes electrónicos, sin acceso a declaraciones ni clave SOL principal.

Resumen criptográfico SHA-256 en Base64 generado al firmar el XML del comprobante. Aparece impreso en el PDF y forma parte del código QR oficial de SUNAT.

Notificación HTTP POST firmada con HMAC-SHA256 (Faktura-Signature) que Faktura envía a tu servidor apenas SUNAT acepta, observa, rechaza o anula un comprobante. Ver Cómo funcionan los webhooks.