xhandler 6.0.0a1__py3-none-any.whl

xhandler/xbuilder/models.py

@@ -0,0 +1,707 @@
+"""Code generated by xhandler-wasm/codegen.py from xhandler.schema.json. DO NOT EDIT."""
+
+from __future__ import annotations
+
+from datetime import date, time
+from decimal import Decimal
+from enum import Enum
+from typing import Annotated, ClassVar, Union
+
+from pydantic import BaseModel, ConfigDict, Field, PlainSerializer
+
+__all__ = ['Anticipo', 'Atributo', 'Cargo', 'Chofer', 'Cliente', 'CodigoGs1', 'Contacto', 'CreditNote', 'CuotaPago', 'DOCUMENT_KINDS', 'DebitNote', 'Defaults', 'Descuento', 'DespatchAdvice', 'DespatchAdviceAtributo', 'DespatchAdviceDocumentoBaja', 'DespatchAdviceDocumentoRelacionado', 'DespatchAdviceItem', 'Destinatario', 'Detalle', 'Detraccion', 'Direccion', 'Document', 'DocumentoAdicional', 'DocumentoRelacionado', 'Envio', 'Firmante', 'FormaPago', 'Guia', 'GuiaEmbebida', 'Invoice', 'Partida', 'Percepcion', 'PercepcionRetencionComprobanteAfectado', 'PercepcionRetencionOperacion', 'Perception', 'Proveedor', 'Puerto', 'Remitente', 'Retention', 'Reversion', 'SummaryDocuments', 'SummaryDocumentsCliente', 'SummaryDocumentsComprobanteAfectado', 'SummaryDocumentsImpuestos', 'SummaryDocumentsItem', 'SummaryDocumentsItemComprobante', 'SummaryDocumentsPercepcion', 'SummaryDocumentsValorVenta', 'TipoCambio', 'TipoFormaPago', 'TotalImporteInvoice', 'TotalImporteNote', 'TotalImpuestos', 'Transportista', 'Vehiculo', 'VoidedDocuments', 'VoidedDocumentsItem']
+
+PlainDecimal = Annotated[
+    Decimal, PlainSerializer(lambda d: format(d, "f"), return_type=str, when_used="json")
+]
+"""A Decimal sent as plain text with its scale: "118.00", never "1.18E+2"."""
+
+
+class _Model(BaseModel):
+    model_config = ConfigDict(extra="forbid", validate_assignment=True)
+
+
+class Anticipo(_Model):
+    """Anticipo asociado a un documento"""
+    tipo: str | None = None
+    """Catalog53. Valores válidos: "04", "05", "06\""""
+    comprobante_serie_numero: str
+    """Serie y número de comprobante del detalle, por ejemplo "F123-4\""""
+    comprobante_tipo: str | None = None
+    """Catalog12."""
+    monto: PlainDecimal
+
+
+class Atributo(_Model):
+    """Atributo adicional de un detalle"""
+    nombre: str = ''
+    codigo: str = ''
+    valor: str | None = None
+    fecha_inicio: date | None = None
+    fecha_fin: date | None = None
+    duracion: int | None = None
+
+
+class Cargo(_Model):
+    """Cargo global (AllowanceCharge con ChargeIndicator true)"""
+    tipo: str
+    """Catalog53, e.g. "49" (afecta la base imponible) or "50" (no la afecta)"""
+    monto: PlainDecimal
+    monto_base: PlainDecimal | None = None
+    """`monto` when missing"""
+    factor: PlainDecimal | None = None
+
+
+class Chofer(_Model):
+    """Conductor del vehiculo"""
+    tipo: str | None = None
+    """Free text rendered as JobTitle, e.g. "CONDUCTOR_PRINCIPAL", "COPILOTO\""""
+    tipo_documento_identidad: str = ''
+    """Catalog6"""
+    numero_documento_identidad: str = ''
+    nombres: str | None = None
+    apellidos: str | None = None
+    licencia: str | None = None
+
+
+class Direccion(_Model):
+    """Direccion"""
+    ubigeo: str | None = None
+    codigo_local: str | None = None
+    urbanizacion: str | None = None
+    departamento: str | None = None
+    provincia: str | None = None
+    distrito: str | None = None
+    direccion: str | None = None
+    codigo_pais: str | None = None
+
+
+class Contacto(_Model):
+    """Contacto"""
+    telefono: str | None = None
+    email: str | None = None
+
+
+class Cliente(_Model):
+    """Quien es el cliente de la transaccion"""
+    tipo_documento_identidad: str = ''
+    """Catalog6"""
+    numero_documento_identidad: str = ''
+    nombre: str = ''
+    direccion: Direccion | None = None
+    contacto: Contacto | None = None
+
+
+class CodigoGs1(_Model):
+    """Código estándar GS1/GTIN para identificación de producto"""
+    codigo: str
+    """Código GS1/GTIN del producto"""
+    tipo: str
+    """Tipo de estructura GTIN: e.g. "GTIN-8", "GTIN-13", "GTIN-14\""""
+
+
+class Proveedor(_Model):
+    """Quien provee el documento electronico. Quien genera o crea el documento."""
+    ruc: str = ''
+    razon_social: str = ''
+    nombre_comercial: str | None = None
+    direccion: Direccion | None = None
+    contacto: Contacto | None = None
+
+
+class Firmante(_Model):
+    """Quien firma electronicamente el XML"""
+    ruc: str
+    razon_social: str
+
+
+class Detalle(_Model):
+    """Detalle de las ventas en Boleta/Factura/Nota Credito/Nota Debito"""
+    descripcion: str = ''
+    cantidad: PlainDecimal = Decimal("0")
+    unidad_medida: str | None = None
+    codigo: str | None = None
+    """Código del producto del vendedor (SellersItemIdentification)"""
+    codigo_sunat: str | None = None
+    """Código de producto SUNAT - Catalog25 (CommodityClassification)"""
+    codigo_gs1: CodigoGs1 | None = None
+    """Código estándar GS1/GTIN (StandardItemIdentification).
+    Incluye el código y el tipo de estructura GTIN (e.g. "GTIN-8", "GTIN-13", "GTIN-14")."""
+    precio: PlainDecimal | None = None
+    """Precio unitario sin impuestos; se calcula de `precio_con_impuestos` si no se da"""
+    precio_con_impuestos: PlainDecimal | None = None
+    """Precio unitario con impuestos; se calcula de `precio` si no se da"""
+    precio_referencia: PlainDecimal | None = None
+    precio_referencia_tipo: str | None = None
+    """Catalog16"""
+    igv_tasa: PlainDecimal | None = None
+    icb_tasa: PlainDecimal | None = None
+    isc_tasa: PlainDecimal | None = None
+    igv_tipo: str | None = None
+    """Catalog7"""
+    isc_tipo: str | None = None
+    """Catalog8"""
+    icb_aplica: bool = False
+    icb: PlainDecimal | None = None
+    igv: PlainDecimal | None = None
+    igv_base_imponible: PlainDecimal | None = None
+    isc: PlainDecimal | None = None
+    isc_base_imponible: PlainDecimal | None = None
+    total_impuestos: PlainDecimal | None = None
+    atributos: list[Atributo] = Field(default_factory=list)
+
+
+class TotalImporteNote(_Model):
+    importe: PlainDecimal
+    importe_sin_impuestos: PlainDecimal
+
+
+class TotalImpuestos(_Model):
+    """Total impuestos"""
+    total: PlainDecimal
+    ivap_importe: PlainDecimal
+    ivap_base_imponible: PlainDecimal
+    exportacion_importe: PlainDecimal
+    exportacion_base_imponible: PlainDecimal
+    gravado_importe: PlainDecimal
+    gravado_base_imponible: PlainDecimal
+    inafecto_importe: PlainDecimal
+    inafecto_base_imponible: PlainDecimal
+    exonerado_importe: PlainDecimal
+    exonerado_base_imponible: PlainDecimal
+    gratuito_importe: PlainDecimal
+    gratuito_base_imponible: PlainDecimal
+    icb_importe: PlainDecimal
+    isc_importe: PlainDecimal
+    isc_base_imponible: PlainDecimal
+
+
+class Guia(_Model):
+    """Guia asociada a un documento"""
+    tipo_comprobante: str
+    """Catalog1. Valores válidos: "09", "31\""""
+    serie_numero: str
+
+
+class DocumentoRelacionado(_Model):
+    """Documento relacionado"""
+    tipo_documento: str
+    """Catalog12."""
+    serie_numero: str
+
+
+class CreditNote(_Model):
+    """Nota de credito"""
+    kind: ClassVar[str] = 'CreditNote'
+    leyendas: dict[str, str] = Field(default_factory=dict)
+    serie_numero: str = ''
+    moneda: str | None = None
+    fecha_emision: date | None = None
+    hora_emision: time | None = None
+    proveedor: Proveedor = Field(default_factory=Proveedor)
+    cliente: Cliente = Field(default_factory=Cliente)
+    firmante: Firmante | None = None
+    icb_tasa: PlainDecimal | None = None
+    igv_tasa: PlainDecimal | None = None
+    ivap_tasa: PlainDecimal | None = None
+    tipo_nota: str | None = None
+    """Catalog9"""
+    comprobante_afectado_serie_numero: str = ''
+    comprobante_afectado_tipo: str | None = None
+    """Catalog1"""
+    descripcion_sustento: str = ''
+    detalles: list[Detalle] = Field(default_factory=list)
+    total_importe: TotalImporteNote | None = None
+    total_impuestos: TotalImpuestos | None = None
+    guias: list[Guia] = Field(default_factory=list)
+    documentos_relacionados: list[DocumentoRelacionado] = Field(default_factory=list)
+    orden_compra: str | None = None
+
+
+class CuotaPago(_Model):
+    """Cuota de pago"""
+    importe: PlainDecimal
+    fecha_pago: date
+
+
+class DebitNote(_Model):
+    """Nota de debito"""
+    kind: ClassVar[str] = 'DebitNote'
+    leyendas: dict[str, str] = Field(default_factory=dict)
+    serie_numero: str = ''
+    moneda: str | None = None
+    fecha_emision: date | None = None
+    hora_emision: time | None = None
+    proveedor: Proveedor = Field(default_factory=Proveedor)
+    cliente: Cliente = Field(default_factory=Cliente)
+    firmante: Firmante | None = None
+    icb_tasa: PlainDecimal | None = None
+    igv_tasa: PlainDecimal | None = None
+    ivap_tasa: PlainDecimal | None = None
+    tipo_nota: str | None = None
+    """Catalog10"""
+    comprobante_afectado_serie_numero: str = ''
+    comprobante_afectado_tipo: str | None = None
+    """Catalog1"""
+    descripcion_sustento: str = ''
+    detalles: list[Detalle] = Field(default_factory=list)
+    total_importe: TotalImporteNote | None = None
+    total_impuestos: TotalImpuestos | None = None
+    guias: list[Guia] = Field(default_factory=list)
+    documentos_relacionados: list[DocumentoRelacionado] = Field(default_factory=list)
+    orden_compra: str | None = None
+
+
+class Defaults(_Model):
+    """Values used when the document does not set them; every field is optional."""
+    fecha_emision: date | None = None
+    """Today in Peru by default"""
+    icb_tasa: PlainDecimal | None = None
+    """The current SUNAT rate by default"""
+    igv_tasa: PlainDecimal | None = None
+    """The current SUNAT rate by default"""
+    ivap_tasa: PlainDecimal | None = None
+    """The current SUNAT rate by default"""
+
+
+class Descuento(_Model):
+    """Descuento asociado a un documento o item"""
+    tipo: str | None = None
+    """Catalog53."""
+    monto: PlainDecimal
+    monto_base: PlainDecimal | None = None
+    factor: PlainDecimal | None = None
+
+
+class DespatchAdviceDocumentoBaja(_Model):
+    """Documento de baja asociado"""
+    tipo_comprobante: str
+    """Catalog1"""
+    serie_numero: str
+
+
+class DespatchAdviceDocumentoRelacionado(_Model):
+    """Documento relacionado"""
+    tipo_documento: str
+    serie_numero: str
+
+
+class DocumentoAdicional(_Model):
+    """Documento adicional relacionado al transporte"""
+    tipo_documento: str = ''
+    """Catalog61"""
+    tipo_documento_descripcion: str | None = None
+    numero: str = ''
+    ruc_emisor: str | None = None
+
+
+class Remitente(_Model):
+    """Remitente (emisor de la guia)"""
+    ruc: str = ''
+    razon_social: str = ''
+    numero_registro_mtc: str | None = None
+
+
+class Destinatario(_Model):
+    """Persona identificada por su documento y nombre: el destinatario de la
+    mercancia, y tambien el comprador y el tercero"""
+    tipo_documento_identidad: str = ''
+    """Catalog6"""
+    numero_documento_identidad: str = ''
+    nombre: str = ''
+
+
+class Transportista(_Model):
+    """Transportista (transporte publico)"""
+    tipo_documento_identidad: str = ''
+    """Catalog6"""
+    numero_documento_identidad: str = ''
+    nombre: str = ''
+    numero_registro_mtc: str | None = None
+
+
+class Vehiculo(_Model):
+    """Vehiculo principal, o secundario dentro de `secundarios`"""
+    placa: str = ''
+    numero_circulacion: str | None = None
+    """Tarjeta unica de circulacion (TUC)"""
+    numero_autorizacion: str | None = None
+    codigo_emisor: str | None = None
+    """Entidad que emite la autorizacion"""
+    secundarios: list[Vehiculo] = Field(default_factory=list)
+
+
+class Puerto(_Model):
+    """Puerto o aeropuerto"""
+    codigo: str = ''
+    nombre: str = ''
+
+
+class Partida(_Model):
+    """Punto de partida"""
+    ubigeo: str = ''
+    direccion: str = ''
+    codigo_local: str | None = None
+    """Codigo de establecimiento anexo, del `ruc` indicado"""
+    ruc: str | None = None
+
+
+class Envio(_Model):
+    """Informacion del envio"""
+    tipo_traslado: str = ''
+    """Catalog20: motivo de traslado"""
+    motivo_traslado: str | None = None
+    sustento_peso: str | None = None
+    peso_total: PlainDecimal = Decimal("0")
+    peso_total_unidad_medida: str = ''
+    peso_items: PlainDecimal | None = None
+    """Peso neto de los items, en KGM"""
+    numero_bultos: int | None = None
+    indicadores: list[str] = Field(default_factory=list)
+    """Indicadores especiales (SpecialInstructions)"""
+    tipo_modalidad_traslado: str = ''
+    """Catalog18: modalidad de traslado (01=publico, 02=privado)"""
+    fecha_traslado: date | None = None
+    """Fecha de inicio del traslado; obligatoria"""
+    transportista: Transportista | None = None
+    choferes: list[Chofer] = Field(default_factory=list)
+    vehiculo: Vehiculo | None = None
+    contenedores: list[str] = Field(default_factory=list)
+    puerto: Puerto | None = None
+    """Catalog63"""
+    aeropuerto: Puerto | None = None
+    """Catalog64, used when there is no puerto"""
+    partida: Partida | None = None
+    destino: Partida | None = None
+
+
+class DespatchAdviceAtributo(_Model):
+    """Propiedad adicional de un item (AdditionalItemProperty)"""
+    codigo: str = ''
+    nombre: str = ''
+    valor: str | None = None
+
+
+class DespatchAdviceItem(_Model):
+    """Item de la guia de remision"""
+    unidad_medida: str = ''
+    cantidad: PlainDecimal = Decimal("0")
+    descripcion: str | None = None
+    codigo: str = ''
+    codigo_sunat: str | None = None
+    atributos: list[DespatchAdviceAtributo] = Field(default_factory=list)
+
+
+class DespatchAdvice(_Model):
+    """Guia de Remision (GRE)"""
+    kind: ClassVar[str] = 'DespatchAdvice'
+    serie_numero: str = ''
+    version: str | None = None
+    """UBL CustomizationID, "2.0" when missing"""
+    fecha_emision: date | None = None
+    hora_emision: time | None = None
+    tipo_comprobante: str | None = None
+    """Catalog1: auto-filled from serie prefix (T->"09", V->"31")"""
+    observaciones: str | None = None
+    documento_baja: DespatchAdviceDocumentoBaja | None = None
+    documento_relacionado: DespatchAdviceDocumentoRelacionado | None = None
+    documentos_adicionales: list[DocumentoAdicional] = Field(default_factory=list)
+    firmante: Firmante | None = None
+    remitente: Remitente = Field(default_factory=Remitente)
+    destinatario: Destinatario = Field(default_factory=Destinatario)
+    comprador: Destinatario | None = None
+    tercero: Destinatario | None = None
+    """Remitente original when a third party issues the guia (e.g. the carrier in a "31")"""
+    proveedor: Proveedor | None = None
+    """Rendered as SellerSupplierParty when there is no tercero"""
+    envio: Envio = Field(default_factory=Envio)
+    detalles: list[DespatchAdviceItem] = Field(default_factory=list)
+
+
+class Detraccion(_Model):
+    """Detraccion"""
+    medio_pago: str
+    """Catalog59"""
+    cuenta_bancaria: str
+    tipo_bien_detraido: str
+    """Catalog54"""
+    porcentaje: PlainDecimal
+    monto: PlainDecimal | None = None
+
+
+class TipoFormaPago(str, Enum):
+    """Tipo de forma de pago"""
+    CREDITO = 'Credito'
+    CONTADO = 'Contado'
+
+
+class FormaPago(_Model):
+    """Forma de pago. A missing `tipo` is filled in by the enricher, and
+    payment in full ("contado") has no `cuotas`."""
+    tipo: TipoFormaPago | None = None
+    cuotas: list[CuotaPago] = Field(default_factory=list)
+    total: PlainDecimal | None = None
+
+
+class GuiaEmbebida(_Model):
+    """Datos del traslado de una factura guia"""
+    partida: Direccion
+    destino: Direccion
+    transportista: Cliente
+    licencia: str
+    """Licencia de conducir del chofer"""
+    placa: str
+    """Placa del vehiculo"""
+    tipo_modalidad_traslado: str
+    """Catalog18: modalidad de traslado"""
+    peso_bruto: PlainDecimal
+    peso_bruto_unidad_medida: str
+
+
+class Percepcion(_Model):
+    """Percepcion asociada a un documento"""
+    tipo: str
+    """Catalog53"""
+    porcentaje: PlainDecimal | None = None
+    monto: PlainDecimal | None = None
+    monto_base: PlainDecimal | None = None
+    monto_total: PlainDecimal | None = None
+
+
+class TotalImporteInvoice(_Model):
+    """Total Importe Invoice"""
+    anticipos: PlainDecimal
+    descuentos: PlainDecimal
+    cargos: PlainDecimal = Decimal("0")
+    """Cargos que no afectan la base imponible (ChargeTotalAmount)"""
+    importe: PlainDecimal
+    importe_sin_impuestos: PlainDecimal
+    importe_con_impuestos: PlainDecimal
+
+
+class Invoice(_Model):
+    """Boleta o Factura"""
+    kind: ClassVar[str] = 'Invoice'
+    leyendas: dict[str, str] = Field(default_factory=dict)
+    serie_numero: str = ''
+    moneda: str | None = None
+    fecha_emision: date | None = None
+    hora_emision: time | None = None
+    fecha_vencimiento: date | None = None
+    proveedor: Proveedor = Field(default_factory=Proveedor)
+    cliente: Cliente = Field(default_factory=Cliente)
+    firmante: Firmante | None = None
+    icb_tasa: PlainDecimal | None = None
+    igv_tasa: PlainDecimal | None = None
+    ivap_tasa: PlainDecimal | None = None
+    tipo_comprobante: str | None = None
+    """Catalog1"""
+    tipo_operacion: str | None = None
+    """Catalog51"""
+    detraccion: Detraccion | None = None
+    percepcion: Percepcion | None = None
+    direccion_entrega: Direccion | None = None
+    guia_embebida: GuiaEmbebida | None = None
+    """Factura guia: the invoice also works as the guia de remision"""
+    forma_pago: FormaPago | None = None
+    anticipos: list[Anticipo] = Field(default_factory=list)
+    descuentos: list[Descuento] = Field(default_factory=list)
+    cargos: list[Cargo] = Field(default_factory=list)
+    detalles: list[Detalle] = Field(default_factory=list)
+    total_importe: TotalImporteInvoice | None = None
+    total_impuestos: TotalImpuestos | None = None
+    guias: list[Guia] = Field(default_factory=list)
+    documentos_relacionados: list[DocumentoRelacionado] = Field(default_factory=list)
+    observaciones: str | None = None
+    orden_compra: str | None = None
+
+
+class PercepcionRetencionComprobanteAfectado(_Model):
+    """Comprobante afectado por la percepcion o retencion"""
+    tipo_comprobante: str
+    serie_numero: str
+    fecha_emision: date
+    importe_total: PlainDecimal
+    moneda: str | None = None
+
+
+class TipoCambio(_Model):
+    """Tipo de cambio"""
+    valor: PlainDecimal
+    fecha: date
+
+
+class PercepcionRetencionOperacion(_Model):
+    """Operacion de percepcion o retencion"""
+    numero_operacion: int
+    fecha_operacion: date
+    importe_operacion: PlainDecimal
+    comprobante_afectado: PercepcionRetencionComprobanteAfectado
+    tipo_cambio: TipoCambio | None = None
+
+
+class Perception(_Model):
+    """Comprobante de Percepcion"""
+    kind: ClassVar[str] = 'Perception'
+    serie: str = ''
+    numero: int = 0
+    fecha_emision: date | None = None
+    moneda: str | None = None
+    proveedor: Proveedor = Field(default_factory=Proveedor)
+    cliente: Cliente = Field(default_factory=Cliente)
+    firmante: Firmante | None = None
+    tipo_regimen: str = ''
+    """Catalog22"""
+    tipo_regimen_porcentaje: PlainDecimal = Decimal("0")
+    importe_total_percibido: PlainDecimal = Decimal("0")
+    importe_total_cobrado: PlainDecimal = Decimal("0")
+    observaciones: str | None = None
+    operacion: PercepcionRetencionOperacion | None = None
+    documento_id: str | None = None
+    """Computed during enrichment: "{serie}-{numero}\""""
+
+
+class Retention(_Model):
+    """Comprobante de Retencion"""
+    kind: ClassVar[str] = 'Retention'
+    serie: str = ''
+    numero: int = 0
+    fecha_emision: date | None = None
+    moneda: str | None = None
+    proveedor: Proveedor = Field(default_factory=Proveedor)
+    cliente: Cliente = Field(default_factory=Cliente)
+    firmante: Firmante | None = None
+    tipo_regimen: str = ''
+    """Catalog23"""
+    tipo_regimen_porcentaje: PlainDecimal = Decimal("0")
+    importe_total_retenido: PlainDecimal = Decimal("0")
+    importe_total_pagado: PlainDecimal = Decimal("0")
+    observaciones: str | None = None
+    operacion: PercepcionRetencionOperacion | None = None
+    documento_id: str | None = None
+    """Computed during enrichment: "{serie}-{numero}\""""
+
+
+class VoidedDocumentsItem(_Model):
+    """Detalle de un comprobante dado de baja"""
+    tipo_comprobante: str | None = None
+    """Catalog1: auto-filled from serie prefix (F->"01", B->"03", T->"09", V->"31", P->"40", R->"20")"""
+    serie: str = ''
+    numero: int = 0
+    descripcion_sustento: str = ''
+
+
+class Reversion(_Model):
+    """Comunicacion de reversion: same content as a [`VoidedDocuments`] (and
+    rendered with its template), used to revert perception (P) and retention
+    (R) documents. Its ID is "RR-YYYYMMDD-{numero}"."""
+    kind: ClassVar[str] = 'Reversion'
+    numero: int = 0
+    fecha_emision: date | None = None
+    fecha_emision_comprobantes: date | None = None
+    proveedor: Proveedor = Field(default_factory=Proveedor)
+    firmante: Firmante | None = None
+    comprobantes: list[VoidedDocumentsItem] = Field(default_factory=list)
+    documento_id: str | None = None
+    """Computed during enrichment: "RA-YYYYMMDD-{numero}\""""
+
+
+class SummaryDocumentsCliente(_Model):
+    """Cliente simplificado para SummaryDocuments"""
+    numero_documento_identidad: str = ''
+    tipo_documento_identidad: str = ''
+
+
+class SummaryDocumentsComprobanteAfectado(_Model):
+    """Comprobante afectado (para NC/ND en el resumen)"""
+    tipo_comprobante: str
+    serie_numero: str
+
+
+class SummaryDocumentsPercepcion(_Model):
+    """Percepcion aplicada a una boleta del resumen"""
+    tipo_regimen: str
+    """Catalog22: regimen de percepcion"""
+    porcentaje: PlainDecimal
+    """Porcentaje de percepcion (e.g. 2 para 2%)"""
+    monto_base: PlainDecimal
+    """Base imponible (TaxableAmount)"""
+    monto: PlainDecimal
+    """Importe percibido (TotalInvoiceAmount)"""
+    monto_total: PlainDecimal
+    """Total cobrado incluida la percepcion (SUNATTotalCashed)"""
+
+
+class SummaryDocumentsValorVenta(_Model):
+    """Valor de venta de un comprobante en el resumen"""
+    importe_total: PlainDecimal = Decimal("0")
+    gravado: PlainDecimal | None = None
+    exonerado: PlainDecimal | None = None
+    inafecto: PlainDecimal | None = None
+    gratuito: PlainDecimal | None = None
+    otros_cargos: PlainDecimal | None = None
+
+
+class SummaryDocumentsImpuestos(_Model):
+    """Impuestos de un comprobante en el resumen"""
+    igv: PlainDecimal | None = None
+    """Filled with 0 when missing"""
+    igv_tasa: PlainDecimal | None = None
+    """IGV rate as percentage (e.g., 18 for 18%). Required by SUNAT; filled from the defaults when missing."""
+    icb: PlainDecimal | None = None
+    isc: PlainDecimal | None = None
+    ivap: PlainDecimal | None = None
+    otros: PlainDecimal | None = None
+
+
+class SummaryDocumentsItemComprobante(_Model):
+    """Comprobante dentro de SummaryDocumentsItem"""
+    tipo_comprobante: str = ''
+    """Catalog1: "03"=Boleta, "07"=NC, "08"=ND"""
+    serie_numero: str = ''
+    moneda: str | None = None
+    cliente: SummaryDocumentsCliente = Field(default_factory=SummaryDocumentsCliente)
+    comprobante_afectado: SummaryDocumentsComprobanteAfectado | None = None
+    percepcion: SummaryDocumentsPercepcion | None = None
+    valor_venta: SummaryDocumentsValorVenta = Field(default_factory=SummaryDocumentsValorVenta)
+    impuestos: SummaryDocumentsImpuestos = Field(default_factory=SummaryDocumentsImpuestos)
+
+
+class SummaryDocumentsItem(_Model):
+    """Detalle de un comprobante en el resumen"""
+    tipo_operacion: str = ''
+    """Catalog19: "1"=Adicionar, "2"=Modificar, "3"=Anulado"""
+    comprobante: SummaryDocumentsItemComprobante = Field(default_factory=SummaryDocumentsItemComprobante)
+
+
+class SummaryDocuments(_Model):
+    """Resumen diario de boletas"""
+    kind: ClassVar[str] = 'SummaryDocuments'
+    numero: int = 0
+    fecha_emision: date | None = None
+    fecha_emision_comprobantes: date | None = None
+    moneda: str | None = None
+    proveedor: Proveedor = Field(default_factory=Proveedor)
+    firmante: Firmante | None = None
+    comprobantes: list[SummaryDocumentsItem] = Field(default_factory=list)
+    documento_id: str | None = None
+    """Computed during enrichment: "RC-YYYYMMDD-{numero}\""""
+
+
+class VoidedDocuments(_Model):
+    """Comunicacion de Baja"""
+    kind: ClassVar[str] = 'VoidedDocuments'
+    numero: int = 0
+    fecha_emision: date | None = None
+    fecha_emision_comprobantes: date | None = None
+    proveedor: Proveedor = Field(default_factory=Proveedor)
+    firmante: Firmante | None = None
+    comprobantes: list[VoidedDocumentsItem] = Field(default_factory=list)
+    documento_id: str | None = None
+    """Computed during enrichment: "RA-YYYYMMDD-{numero}\""""
+
+
+Document = Union[Invoice, CreditNote, DebitNote, DespatchAdvice, Perception, Retention, SummaryDocuments, VoidedDocuments, Reversion]
+"""Any document xbuilder can enrich and render."""
+
+DOCUMENT_KINDS = ('Invoice', 'CreditNote', 'DebitNote', 'DespatchAdvice', 'Perception', 'Retention', 'SummaryDocuments', 'VoidedDocuments', 'Reversion')