## id
flux_alta_factura_venda

## nom
Alta d'una factura de venda

## descripcio_activacio
Fes servir quan l'usuari vulgui registrar el document comptable d'una factura de venda (amb IVA)
a FiskAppCloud, o pregunti com introduir-la — manualment, pujant el PDF/XML, o quan li arribi per
correu automàticament. Per rebuts d'ingrés sense IVA, vegeu flux_alta_rebut_ingres. Això registra
el document comptable de la venda, no la factura comercial que es lliura al client — per crear una
factura de veritat, vegeu flux_crear_factura_manual.

## relacionats
- flux_alta_rebut_ingres
- flux_alta_factura_compra
- flux_crear_factura_manual

## explicacio
Comptabilitat → Llibres → Vendes i Ingressos (botó "Afegir") és la porta d'entrada compartida per
a factures de venda i rebuts d'ingrés — mateix mecanisme exacte que a compres (mateix modal, mateix
mecanisme d'ingesta), amb el client en lloc del proveïdor.

Dues maneres reals d'introduir-la:

1. **Amb fitxer (PDF o XML/UBL)** — es puja el document i FiskAppCloud en fa una lectura
   automàtica que proposa client, dates, línies de concepte i IVA. L'usuari revisa i corregeix
   abans de desar.
2. **Manual, sense fitxer** — es pot continuar sense pujar cap document i emplenar totes les dades
   a mà.

En els dos casos, calen sempre dues intervencions humanes: crear el document (queda "pendent de
validar") i, després, validar-lo.

La fiscalitat (IVA) de cada línia la determina el **compte comptable** triat, no el Tipus de
Factura.

A més d'aquests dos camins manuals, hi ha un tercer camí completament automàtic — vegeu
`doc_ingesta_documents_comptables` per al detall.

Sempre cal triar el **Tipus de Factura** — vegeu `doc_concepte_tipus_factura` per entendre com
s'organitzen les seves categories (nacional/intracomunitària/internacional, amb o sense retenció,
els casos d'exportació, OSS i Canàries/Ceuta/Melilla).

Un cop triat, cal omplir tres parts — Capçalera, Conceptes i Fiscal — vegeu
`doc_estructura_document_comptable` per al detall de cada camp.

## consulta
Si l'usuari vol saber quins Tipus de Factura té configurats la seva empresa per a vendes, cal
consultar-ho en viu — són dades pròpies de cada empresa, no fixes.

## font_tecnica
- Vista llista: `Views/Factures/FacturesVenda.cshtml`
- Modal de creació: `Views/Shared/Modals/Factures.cshtml` (compartit amb compres)
- JS: `wwwroot/js/documents/factures/factura-create.js`, `factura-fiscal.js`
- Controller: `Controllers/FacturesController.cs` — `FacturesVenda`, `GetFacturesVenda`,
  `AnalitzarFacturaAzure`, `GuardarFactura`, `CrearRegistresDetall`, `ValidarFactura`
- Servei: `Services/DocumentComptabilitzacioService.cs` — `GuardarFacturaAsync`,
  `AfegirDiariGeneralInternAsync`

## accions_futures
- crear_factura_venda
- validar_factura_venda