## id
doc_nomines

## nom
Nòmines — càlcul de la Seguretat Social i de la retenció d'IRPF

## descripcio
Consulta aquest document quan calgui explicar amb precisió com calcula FiskAppCloud les quotes de
Seguretat Social d'una nòmina, d'on surten els percentatges aplicats, per què hi ha una base
general i una base d'AT/MP diferenciades, com es calcula la retenció d'IRPF que apareix a la
nòmina, o quines limitacions reals té aquest càlcul (topes, categoria professional). No és
l'explicació general, que cobreix `flux_nomines`.

## contingut
### Idea de partida: dues bases, onze percentatges

FiskAppCloud fa servir **dues bases de cotització** per nòmina — la Base general i la Base
d'Accidents de Treball i Malalties Professionals (AT/MP), que es pot editar per separat quan
difereix de la general (típicament per hores extraordinàries, que legalment computen a la base
d'AT/MP però no sempre a la de contingències comunes) — i hi aplica fins a onze percentatges
diferents, un per cada concepte de cotització, separats entre la part a càrrec del treballador i la
part a càrrec de l'empresa:

| Concepte | Base que utilitza | Treballador | Empresa |
|---|---|---|---|
| Contingències comunes | General | Sí | Sí |
| Atur | General | Sí (tipus diferent segons fix/temporal) | Sí (tipus diferent segons fix/temporal) |
| FOGASA | General | Sí | Sí |
| Formació professional | General | Sí | Sí |
| MEI (Mecanisme d'Equitat Intergeneracional) | General | Sí | Sí |
| Accidents de treball i malalties professionals (AT/MP) | **AT/MP** | — (no n'hi ha, per llei) | Sí |

Cada import surt de multiplicar la base corresponent pel percentatge: **Import = Base × Tipus**. No
hi ha cap altra fórmula ni ajust — és una multiplicació directa per a cadascun dels onze conceptes.

**Com s'omplena la Base AT/MP**: com que la lectura automàtica del PDF encara no distingeix les
dues bases, en carregar una nòmina des d'un PDF el camp de Base AT/MP es proposa igual que la Base
general — l'usuari el pot editar per separat abans de desar si sap que difereixen (per exemple, per
hores extraordinàries d'aquell període). Si totes dues coincideixen, la pantalla de detall només en
mostra una, per no confondre; si difereixen, es mostren totes dues per separat.

### D'on surten els percentatges

Els percentatges **no estan escrits al codi de l'aplicació**: es guarden en una taula de
referència pròpia, amb files vàlides per a un període de dates concret (per poder tenir
percentatges diferents any rere any, tal com marca la normativa). L'aplicació busca sola la fila
vigent per a la data de la nòmina.

**Avís important**: no s'ha trobat cap pantalla dins de l'aplicació per consultar o modificar
aquesta taula de percentatges — la seva gestió es fa directament a base de dades, fora de la
interfície. Si mai els percentatges d'un any no donen el resultat esperat, cal comprovar que
existeixi la fila corresponent a aquell període, no que hi hagi cap error de càlcul a la fórmula en
si (que és, com s'ha dit, una simple multiplicació).

### L'única cosa que varia segons el tipus de contracte: l'atur

De tots els percentatges, **només el d'Atur té dues variants** — una per a contractes Fixos i una
altra, més alta, per a contractes Temporals — i FiskAppCloud tria automàticament quina aplicar
segons el Tipus de Contracte que consti a la fitxa del treballador (vegeu
`doc_alta_treballador`). **La resta de percentatges (contingències comunes, FOGASA, formació, MEI,
AT/EP) són idèntics per a tothom, independentment del tipus de contracte.**

**La categoria professional no té cap efecte en el càlcul**: no hi ha cap camp de categoria a la
fitxa del treballador ni cap distinció per categoria en aquesta taula de percentatges — tots els
treballadors amb el mateix tipus de contracte reben exactament els mateixos percentatges.

### Autònoms (Règim RETA): sense càlcul, import manual

Si el treballador té marcat el règim d'Autònom, **tot aquest càlcul es salta completament** — no
es calcula cap dels onze conceptes. En el seu lloc, hi ha un únic camp per introduir manualment
l'import de la quota d'autònoms (el que consti al rebut o factura de la Seguretat Social d'aquell
treballador autònom), sense cap desglossament.

### Limitacions reals a tenir en compte

- **No hi ha cap tope mínim ni màxim de cotització aplicat per l'aplicació.** La base que s'utilitza
  és la que ve del PDF (que, en principi, ja hauria vingut amb els topes legals ja aplicats per qui
  va emetre la nòmina original) o la que s'introdueixi a mà — FiskAppCloud no comprova ni corregeix
  si aquesta base respecta els límits legals vigents. És responsabilitat de qui revisa la nòmina.
- **Les hores extraordinàries no es tracten com un concepte propi** — no hi ha cap camp específic
  per introduir-les. Si afecten la base d'AT/MP, cal reflectir-ho ajustant manualment aquell camp;
  l'aplicació no ho calcula ni ho proposa sola.
- **No hi ha cap exportació pròpia cap a la Seguretat Social** (ni RLC, ni RNT, ni cap format
  compatible amb el Sistema RED) — l'únic que es genera és l'assentament comptable intern. Si cal
  presentar la cotització davant la Seguretat Social, s'ha de fer per una altra via, fora de
  FiskAppCloud.

### Com es calcula la retenció d'IRPF d'una nòmina concreta

**No es calcula — es reutilitza la que ja consta al PDF original.** FiskAppCloud no aplica cap
taula ni percentatge d'IRPF propi (i, de fet, **no consulta en cap moment les dades de la pestanya
IRPF de la fitxa del treballador** per a aquest càlcul — aquelles dades només serveixen per a la
liquidació anual, vegeu `doc_alta_treballador`).

El que sí que fa és **repartir** l'import de retenció ja conegut entre dues parts, perquè
comptablement es tracten diferent: la part corresponent a retribució dinerària i la part
corresponent a retribució en espècie (per exemple, una assegurança mèdica pagada per l'empresa). El
repartiment surt d'una operació aritmètica senzilla a partir dels imports que ja constin al PDF
(brut, líquid, retenció, cotitzacions del treballador): es dedueix quant correspon a "espècie" per
diferència, i s'aplica el mateix percentatge efectiu de retenció (retenció ÷ base) a totes dues
parts proporcionalment.
