Write Profile

PUT /api/autopilot/profile body — a partial update.

Every field is optional and None means "leave it alone", so the client can send one step of the onboarding wizard at a time. onboarding_complete is deliberately absent: the store derives it from whether the fields the first invoice needs are present, rather than trusting the client to say so.

forfettario_rate and coefficient are absent for the same reason and a sharper one. The coefficient is statutory — fixed by the ATECO division under L. 190/2014 Allegato 4 — and the rate has conditions no field here records, so both are computed by the store on every write (derived_regime_params). They used to be accepted here and were the only way to set them, which is how every real profile ended up with neither and the year's payment calendar refused to compute. A body that still sends them is ignored rather than refused: they were never anyone's to send, so a 422 would punish a client for a field this API should not have offered.

The stored profile as the API returns it (GET /api/autopilot/profile).

Carries the two derived numbers the write model does not: they are part of the tax position the user is entitled to see — and to check against their commercialista — even though nothing they send can set them. The bounds are the engine's own: a rate or coefficient outside 0–1 is not a rate.