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.
Ambiente de pruebas (test / SUNAT beta)
Sección titulada «Ambiente de pruebas (test / SUNAT beta)»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.
API key
Sección titulada «API key»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.
Boleta de venta electrónica (03)
Sección titulada «Boleta de venta electrónica (03)»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").
CDR (Constancia de Recepción)
Sección titulada «CDR (Constancia de Recepción)»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 digital
Sección titulada «Certificado digital»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.
Comunicación de baja (RA)
Sección titulada «Comunicación de baja (RA)»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.
Correlativo (number)
Sección titulada «Correlativo (number)»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).
Detracción (SPOT)
Sección titulada «Detracción (SPOT)»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.
Estados del comprobante (status)
Sección titulada «Estados del comprobante (status)»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 ensunat.notes.rejected: rechazado por SUNAT (código2000–3999); no tiene validez tributaria.failed: no pudo enviarse por una causa de configuración del emisor (credenciales SOL o certificado); se reenvía conPOST /v1/documents/{id}/retry.
Detalle completo en Estados y envío a SUNAT.
Factura electrónica (01)
Sección titulada «Factura electrónica (01)»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.
Idempotencia (Idempotency-Key)
Sección titulada «Idempotencia (Idempotency-Key)»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.
IGV (Impuesto General a las Ventas)
Sección titulada «IGV (Impuesto General a las Ventas)»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.
Neto pendiente de pago (net_payable)
Sección titulada «Neto pendiente de pago (net_payable)»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.
Nota de crédito electrónica (07)
Sección titulada «Nota de crédito electrónica (07)»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).
Nota de débito electrónica (08)
Sección titulada «Nota de débito electrónica (08)»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).
Padrón reducido de RUC
Sección titulada «Padrón reducido de RUC»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.
Recargo al consumo (service_charge)
Sección titulada «Recargo al consumo (service_charge)»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.
Representación impresa (PDF)
Sección titulada «Representación impresa (PDF)»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 diario de boletas (RC)
Sección titulada «Resumen diario de boletas (RC)»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.
Retención del IGV (retention)
Sección titulada «Retención del IGV (retention)»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.
RUC y RUC 10
Sección titulada «RUC y RUC 10»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).
SEE del contribuyente
Sección titulada «SEE del contribuyente»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.
Serie (series)
Sección titulada «Serie (series)»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.
UBL 2.1 (Universal Business Language)
Sección titulada «UBL 2.1 (Universal Business Language)»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.
Usuario SOL secundario
Sección titulada «Usuario SOL secundario»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.
Valor resumen (sunat.hash / DigestValue)
Sección titulada «Valor resumen (sunat.hash / DigestValue)»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.
Webhook
Sección titulada «Webhook»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.