sunat_cpe_core library

Entidades de dominio, catálogos oficiales SUNAT, validador matemático passthrough, generador XML UBL 2.1, firmador digital XAdES-BES en Dart puro y contratos OSE/PSE.

Classes

Address
Dirección física o domicilio fiscal con código de Ubigeo INEI y código de establecimiento anexo SUNAT.
AgentCpeDocument
Clase base sellada para Comprobantes de Retención (20) y Percepción (40).
AgentDocumentLine
Ítem de detalle dentro de un Comprobante de Retención o de Percepción.
AllowanceCharge
Descuento o cargo a nivel de ítem o global (Catálogo 53).
BaseUblOseProvider
Implementación base con patrón Template Method para todos los proveedores OSE SOAP 1.1 UBL 2.1 (Bizlinks, Digiflow, TCI, Sovos, Cavali/Gosocket, EFACT SOAP).
CarrierParty
CashPaymentTerms
CdrData
Constancia de Recepción (CDR) extraída de R-{RUC}-{TIPO}-{SERIE}-{NUM}.zip o JSON de un PSE.
CompanyParty
Empresa emisora (Emisor electrónico).
CpeCertificateCredentials
Contiene la clave privada RSA y el certificado X.509 para la firma XML-DSig / XAdES-BES.
CpeDocument
Jerarquía sellada base para todos los Comprobantes de Pago Electrónicos (CPE) de SUNAT.
CpeEmissionResponse
Respuesta de emisión unificada para operaciones CPE síncronas y diferidas.
CpeFailure<T>
CpeHttpClient
Abstracción de transporte que desacopla el núcleo y los proveedores de paquetes HTTP específicos.
CpeHttpInterceptor
Interfaz de interceptor para autenticación, cabeceras SOAP, registro de trazas y reintentos.
CpeHttpRequest
Representación inmutable de una solicitud HTTP para llamadas REST y SOAP.
CpeHttpResponse
Representación inmutable de una respuesta HTTP.
CpeLineItem
Ítem de detalle de traspaso directo (strict passthrough) para comprobantes de venta UBL 2.1.
CpeMathValidator
Validador de reglas matemáticas y de negocio de traspaso directo (strict passthrough) para CPE SUNAT.
CpeResult<T>
Tipo de resultado sellado que soporta tanto programación funcional (fold/switch) como lanzamiento imperativo de excepciones (getOrThrow()).
CpeStatusQueryResponse
Resultado de consultar el estado de un comprobante emitido previamente (queryDocumentStatus).
CpeSuccess<T>
CpeZipCodec
Comprime documentos XML UBL en archivos .zip conformes a SUNAT y decodifica respuestas CDR .zip.
CreditNoteDocument
Nota de Crédito Electrónica (07).
CreditPaymentTerms
CustomerParty
Cliente o receptor del comprobante (Adquirente o Usuario).
DailySummaryDocument
Resumen Diario de Boletas de Venta y Notas Electrónicas (RC).
DailySummaryLine
Línea individual dentro de un DailySummaryDocument (sac:SummaryDocumentsLine).
DebitNoteDocument
Nota de Débito Electrónica (08).
Decimal
A number that can be exactly written with a finite number of digits in the decimal system.
DefaultCpeHttpClient
Implementación predeterminada de CpeHttpClient respaldada por package:http.
DespatchAdviceDocument
Guía de Remisión Electrónica (09 Remitente y 31 Transportista) - UBL 2.1.
DespatchLineItem
DetractionInfo
Información de detracción SPOT (Catálogos 54 y 59).
DocumentId
Identificador único para cualquier documento electrónico de SUNAT.
DocumentReference
Referencia a un documento relacionado o modificado (ej. factura afectada en Nota de Crédito/Débito o Guía de Remisión).
DocumentStatusQuery
Parámetros de consulta para verificar el estado y obtener el CDR de un CPE emitido previamente.
DriverPerson
InvoiceDocument
Factura Electrónica (01) y Boleta de Venta Electrónica (03).
MonetaryTotals
Totales monetarios de traspaso directo (strict passthrough) para comprobantes de venta UBL 2.1.
OseProvider
Contrato unificado implementado por los 9 paquetes de proveedores OSE / PSE.
PaymentInstallment
PaymentTerms
Condiciones de pago de la operación (Contado vs Crédito según RS 000193-2020/SUNAT).
PerceptionDocument
Comprobante de Percepción Electrónico (40).
PerceptionSummary
Resumen de Percepción dentro de una Factura o Boleta.
PollingConfig
Configuración de retroceso exponencial (exponential backoff) para el sondeo asíncrono de Tickets.
PrepaidPayment
Deducción por pago anticipado (Anticipo).
PurchaseSettlementDocument
Liquidación de Compra Electrónica (04).
RetentionDocument
Comprobante de Retención Electrónico (20).
RetentionSummary
Resumen de Retención del IGV dentro de una Factura (Código '62').
SalesCpeDocument
Clase base sellada para comprobantes de venta (01 Factura, 03 Boleta, 04 Liquidación, 07 NC, 08 ND).
SignedXmlOutput
Resultado de firmar digitalmente un documento XML UBL.
SunatWarning
Observación no bloqueante devuelta por SUNAT/OSE (Códigos 4000+).
TicketResponse
Respuesta inmediata para operaciones asíncronas (RC, RA, RR, GRE, EFACT REST).
TicketStatusResponse
Respuesta de estado al consultar un Ticket asíncrono (checkTicket).
TransportVehicle
UblXmlBuilder
Genera documentos XML oficiales SUNAT UBL 2.1 y UBL 2.0 listos para firma digital XAdES-BES.
ValidationIssue
Incidencia específica de validación detectada antes de la transmisión por red.
VoidedDocument
Comunicación de Baja (RA) o Resumen de Reversiones (RR).
VoidedLine
Línea de detalle dentro de un VoidedDocument (sac:VoidedDocumentsLine).
XadesBesSigner
Firmador XML-DSig Enveloped (RSA-SHA256) en Dart puro compatible con SUNAT UBL 2.1.

Enums

CpeDocumentType
Catálogo 01: Código de Tipo de Documento.
CpeProcessStatus
Estado de procesamiento de un comprobante CPE o Ticket.
CreditNoteReasonCode
Catálogo 09: Códigos de Tipo de Nota de Crédito Electrónica.
CurrencyCode
Catálogo 02: Códigos de Tipo de Moneda (ISO 4217).
DebitNoteReasonCode
Catálogo 10: Códigos de Tipo de Nota de Débito Electrónica.
DespatchReasonCode
Catálogo 20: Motivo de Traslado (Guías de Remisión).
IdentityDocumentType
Catálogo 06: Códigos de Tipos de Documentos de Identidad.
IgvAffectationType
Catálogo 07: Códigos de Tipo de Afectación del IGV.
OperationType
Catálogo 51: Código de Tipo de Operación.
PerceptionRegimeCode
Catálogo 22: Régimen de Percepción.
ProviderCapability
Capacidades funcionales soportadas por un adaptador OSE o PSE específico.
RetentionRegimeCode
Catálogo 23: Régimen de Retención.
SummaryLineStatus
Catálogo 19: Estado de Ítem en Resumen Diario de Boletas.
TaxCategoryCode
Catálogo 05: Códigos de Tipos de Tributos.
TransportModeCode
Catálogo 18: Modalidad de Traslado (Guías de Remisión).

Mixins

TicketPollingMixin
Mixin que provee la implementación predeterminada de OseProvider.pollTicketUntilDone.

Exceptions / Errors

CpeException
Jerarquía sellada para todas las excepciones de CPE, OSE y SUNAT.
CpeValidationException
  • Error local de validación aritmética o estructural previo a la llamada de red.
  • OseAuthException
  • Error de autenticación (Token inválido, OAuth2 401/403, rechazo WS-Security).
  • OseTransportException
  • Error de transporte de red, tiempo de espera (timeout), TLS o HTTP 5xx.
  • SunatExceptionError
  • Excepción técnica de SUNAT/OSE (Códigos 0100 a 1999). El comprobante NO fue registrado; es seguro corregirlo y reintentar con el mismo correlativo.
  • SunatRejectionException
  • Rechazo definitivo de negocio por SUNAT/OSE (Códigos 2000 a 3999). El comprobante queda RECHAZADO; incluye el CDR de rechazo si fue generado por el OSE.