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}.zipo 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
.zipconformes 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.