xfep

Meta-paquete que instala el ecosistema completo de Facturación Electrónica Perú (SUNAT UBL 2.1).

Instalación

pip install xfep

Esto instala automáticamente todos los paquetes del ecosistema:

Uso rápido

from xfep.models import Invoice, Client, Detalle, Company
from xfep.xml import XmlBuilder
from xfep.sign import Certificate, XmlSigner
from xfep.ws import SunatSoap
from xfep.parser import parse_cdr

# 1. Definir empresa y documento
company = Company(
    ruc="20123456789",
    razon_social="MI EMPRESA S.A.C.",
    direccion="Av. Principal 123",
    ubigeo="150101", distrito="Lima",
    provincia="Lima", departamento="Lima",
    usuario_sol="MODDATOS", clave_sol="MODDATOS",
)

invoice = Invoice(
    company_id=1, branch_id=1, serie="F001",
    fecha_emision="2026-02-10", moneda="PEN",
    tipo_operacion="0101", forma_pago_tipo="Contado",
    client=Client(
        tipo_documento="6",
        numero_documento="20987654321",
        razon_social="CLIENTE S.A.C.",
    ),
    detalles=[
        Detalle(
            descripcion="Servicio de consultoría",
            unidad="ZZ", cantidad=1,
            mto_precio_unitario=5900,
            porcentaje_igv=18, tip_afe_igv="10",
        )
    ],
)

# 2. Generar XML
xml_bytes = XmlBuilder().build(invoice, company)

# 3. Firmar
cert = Certificate.from_file("empresa.p12", "password")
signed_xml = XmlSigner.sign(xml_bytes, cert)

# 4. Enviar a SUNAT
async with SunatSoap(company.ruc, company.usuario_sol, company.clave_sol) as ws:
    response = await ws.send_bill(signed_xml, f"{company.ruc}-01-F001-1")

# 5. Parsear CDR
if response.cdr_bytes:
    cdr = parse_cdr(response.cdr_bytes)
    print(f"Estado: {cdr.status}")  # ACEPTADO

Paquetes individuales

Si solo necesitás un componente específico:

pip install xfep-models   # Solo modelos
pip install xfep-xml      # Solo generación XML
pip install xfep-lookup   # Solo consulta RUC/DNI

Stack

• Python >= 3.13
• Pydantic v2 (modelos)
• lxml + Jinja2 (XML)
• cryptography (firma digital)
• httpx (HTTP async)
• WeasyPrint (PDF)

Licencia

Apache License 2.0 — ver LICENSE.