Proposals & Invoices · Article 5.1
La familia de documentos de facturación de Clozo: DEP, INV, STR, DCR, CRN, REC
Seis tipos de documentos componen la cadena completa de facturación de Clozo. Cada uno tiene un papel legal distinto conforme al Art. 220 de la Directiva del IVA de la UE y el §14 UStG. Este artículo mapea qué documento se activa en qué momento y qué referencia.
Una sola propuesta de Clozo puede producir hasta seis tipos de documentos diferentes a lo largo de su ciclo de vida, dependiendo de lo que ocurra (enmiendas, reembolsos, correcciones manuales de anticipo). Este artículo es el mapa. Para la mecánica detallada de cada uno, véanse los artículos 6.2–6.4 y la Sección 7 (enmiendas) / Sección 8 (reembolsos).
En el menú desplegable de Documentos en cada página de detalle de la propuesta, los tipos de documentos relevantes aparecen a medida que se generan. Etiquetas de filtro en el menú desplegable: «Propuesta», «Acuerdo firmado», «Factura de anticipo», «Factura final», «Aviso de cancelación» (Storno), «Nota de crédito», «Recibo». Cada uno es un enlace R2 descargable (CORS habilitado, sin autenticación requerida para la URL — el enlace es indeducible).
Why this works this way
¿Por qué tantos tipos de documentos? La ley del IVA de la UE (Directiva 2006/112/CE, Título XI Capítulo 3) trata diferentes eventos como distintos puntos imponibles: un pago anticipado es un hecho imponible, la prestación de servicios es otro, una reducción parcial del alcance es otro. Cada evento necesita su propio registro porque cada uno desplaza una obligación de IVA. La mayoría de las herramientas para autónomos colapsan esto en «una factura» y arriesgan incumplir las normas nacionales (especialmente el §14 UStG en Alemania, el Art. 220 de la Directiva de la UE, el BTW Art. 35a en los Países Bajos, el CGI Art. 271-II en Francia).
La familia completa de documentos (de apps/pdf/service.py y HELP_LIFECYCLE_MAP.md Sección 5):
| Tipo | Prefijo | Renderizador | Activador | Propósito |
|---|---|---|---|---|
| PDF de propuesta | PRO- | render_proposal_pdf | Enviar propuesta | La oferta (no es una factura) |
| Contrato de servicios | AGR- | (renderizado PDF firmado) | El cliente firma | El contrato (no es una factura) |
| Factura de anticipo | DEP- | render_deposit_invoice_pdf | El cliente firma (anticipo > 0) | Anzahlungsrechnung — IVA exigible sobre el pago anticipado |
| Factura final | INV- | render_final_invoice_pdf | Emitir factura final | Schlussrechnung — liquida el proyecto, hace referencia al DEP |
| Storno | STR- | render_storno_invoice_pdf | Enmienda con reducción de coste | Cancela/anula la factura anterior; «Rechnungskorrektur» en DE |
| Corrección de anticipo | DCR- | render_deposit_correction_pdf | La enmienda cambia el importe del anticipo | Documenta el ajuste del anticipo |
| Nota de crédito | CRN- | render_credit_note_pdf | Reembolso iniciado | Registra el reembolso + razón + desglose del IVA |
| Recibo | REC- | render_receipt_pdf | Pago recibido | Confirma la recepción de fondos |
La cadena del flujo estándar satisfactorio (sin enmiendas, sin reembolsos):
``
Propuesta enviada → PRO-2026-0042
Cliente firma → AGR-2026-0042 + DEP-2026-0042
Anticipo pagado → REC-2026-0042 (fase anticipo)
Proyecto terminado → INV-2026-0042 (hace referencia a DEP-2026-0042)
Pago final → REC-2026-0042 (fase final)
``
La cadena de enmienda con reducción (Δ−):
``
… flujo estándar hasta Anticipo pagado …
Enmienda firmada → STR-2026-NNNN (anula el INV anterior)
+ INV-2026-NNNN (revisión=2, alcance reducido)
+ CRN-2026-NNNN (nota de crédito para reembolso)
+ Reembolso de Stripe O reembolso SEPA manual
+ REC-2026-NNNN (recibo de reembolso, cuando el reembolso se liquida)
``
La numeración de documentos es secuencial por autónomo por año por tipo, atómica (SELECT FOR UPDATE en DocumentCounter). Sin huecos — una vez asignado un número es permanente. El año se restablece el 1 de enero: INV-2025-0099 es seguido por INV-2026-0001. Véase el artículo 6.9 para la mecánica exacta.
Retención: cada documento de la familia se almacena en Cloudflare R2 con el indicador legal_hold durante 10 años para cumplir el GoBD §147 AO (DE), Wet OB Art. 52 (NL), CGI Art. L102 B (FR) y normas paralelas en todos los Estados miembros de la UE.
Troubleshooting
Keep reading
Proposals & Invoices
The deposit invoice (DEP-) — Anzahlungsrechnung, facture d'acompte
The deposit invoice is the legal artefact that records VAT liability on an advance payment. Under EU VAT Directive Art. 65, the deposit becomes chargeable the moment the client pays — the deposit invoice is what the law requires you issue.
Proposals & Invoices
The final invoice (INV-) — Schlussrechnung, facture de solde
The final invoice closes the project. It states the full work value, then explicitly references the deposit invoice and **deducts both the deposit amount and the deposit VAT**, so you don't pay tax twice. This deduction is mandated by §14 UStG and parallel rules across the EU.
Proposals & Invoices
Receipts (REC-) — payment confirmation, single-stage vs split
A receipt confirms that a payment was actually received. Clozo issues one receipt per payment event: one for the deposit, one for the final balance, or a single receipt if the project was 100% prepaid.
Refunds & Notifications
EU invoice compliance — Art. 226 mandatory fields, sequence numbering, retention
Every invoice Clozo issues complies with EU VAT Directive Art. 226: 14 mandatory fields, sequential numbering with no gaps, immutability after issue, and 10-year retention.
Proposals & Invoices
Invoice numbering — sequential per year per type, atomic, no gaps
Every invoice gets a sequential number from an atomic counter scoped per freelancer per year per document type. No gaps allowed under EU VAT Directive Art. 226(2); enforced by a row-level database lock so concurrent operations cannot collide.