## id
doc_generar_factures_albarans

## nom
Facturar albarans — comportaments i casos concrets

## descripcio
Consulta aquest document quan calgui explicar amb precisió com s'agrupen els albarans en generar
factures per lot, com funciona incorporar-los a una factura ja oberta, què passa si una part del
procés falla, o aclarir per què el nombre de factures generades pot no coincidir amb el que
s'esperava. No és l'explicació general, que cobreix `flux_generar_factures_albarans`.

## contingut
### Com s'agrupen els albarans

No hi ha selecció manual d'albarans: es defineix un rang de dates (la data final per defecte és
avui; sense data inicial no hi ha límit per baix) i l'aplicació agafa tots els albarans pendents
d'aquell rang, agrupats per la combinació exacta de client + activitat. Cada grup esdevé una
factura amb una línia per cada albarà que hi ha entrat.

El Tipus de Factura i el compte comptable es trien un sol cop per a tota la tanda de generació —
s'apliquen igual a totes les factures resultants, no es pot triar un Tipus diferent per a cada
client dins d'una mateixa execució.

### Què passa si una part del procés falla

La generació **no és tot o res**: si hi ha diversos grups (clients/activitats) dins del rang de
dates, un error en un grup concret no impedeix que la resta es generin amb normalitat. El problema
és que **el missatge final només informa de quantes factures s'han creat correctament — no diu res
sobre els grups que han fallat**, encara que l'aplicació internament sí que en porta un registre. Si
el nombre de factures generades sembla més baix del que s'esperava, val la pena revisar la llista
d'albarans (per veure quins han quedat pendents encara) abans de donar per fet que tot s'ha
processat.

**Cas concret a tenir en compte**: si un albarà concret falla just en el pas d'incorporar les seves
línies a la factura ja creada, l'albarà es marca igualment com a Facturat i queda bloquejat — encara
que les seves dades no hagin quedat del tot ben incorporades a la factura. Si algú detecta un
import que no quadra en una factura generada d'aquesta manera, cal revisar si algun dels albarans
d'origen ha tingut aquest problema puntual.

### Protecció de duplicats

Un cop un albarà ja ha entrat a una factura (queda Facturat), les properes execucions de "Generar
Factures" ja no el tornen a agafar — només es consideren els albarans encara pendents. Si es fan
dos clics seguits molt ràpids abans que el primer acabi, no hi ha cap protecció explícita addicional
més enllà d'aquesta.

### Incorporar un albarà a una factura ja oberta: diferències amb el camí per lot

El botó "Incorporar albarà" dins d'una factura només ofereix els albarans pendents **del client ja
seleccionat a la factura** — si la factura encara no té client (per exemple, un tiquet sense
identificació), l'aplicació ho avisa i no deixa continuar fins que se'n triï un.

**Avisos a tenir en compte** (a diferència del camí per lot, que sí que ho comprova en algun
d'aquests punts):

- La comprovació de "la factura encara és un esborrany" només es fa a la pantalla — si per algun
  motiu s'arribés a intentar amb una factura ja no editable, no hi ha una segona comprovació al
  servidor que ho torni a validar.
- No es comprova que l'activitat de l'albarà coincideixi amb la de la factura — només es filtra
  pel client.
- No hi ha cap comprovació que l'albarà seleccionat sigui realment del client de la factura més
  enllà del que ja filtra la pròpia llista — si mai s'arribés a forçar un altre valor, l'aplicació
  no ho tornaria a comprovar pel seu compte.

En la pràctica, seguint el flux normal des de la interfície (triar sempre d'aquesta llista, sense
res estrany), aquests casos no arriben a donar-se — són avisos rellevants només si mai es detecten
incoherències que no s'expliquen d'una altra manera.

### Desassignar un albarà d'una factura

Des de la fitxa de la factura es pot desassignar un albarà concret d'una de les seves línies — això
el torna a deixar Pendent i editable, com si no s'hagués facturat mai. **Avís**: no s'ha trobat cap
comprovació que impedeixi fer-ho encara que la factura ja estigui validada i enviada a l'AEAT — cal
anar amb compte de no desassignar un albarà d'una factura que ja s'hagi enviat, ja que trencaria la
coherència entre el que consta a l'AEAT i el que queda a l'aplicació.
