# Branch delle anagrafiche

[Versione web](https://docs.eis.it/changelog/2026/11/11)

## Sedi principali e branch

Per creare una nuova sede secondaria con `POST /v1/customers/add`, usa `type: BRANCH` e `mainCustomerId` con l’ID della sede principale. I campi già richiesti per creare un’anagrafica restano necessari. Con multisede abilitato, le sedi devono avere la stessa partita IVA.

Per collegare anagrafiche già esistenti, usa `PUT /v1/customers/update/{id}/{organizationId}/main-customer/branches`, dove `id` è la sede principale:

```json
{
  "secondaryCustomerIds": [102, 103]
}
```

L’operazione mantiene le altre branch già collegate. Gli ID devono essere distinti e diversi dalla sede principale; le anagrafiche devono appartenere alla stessa organizzazione e non avere proprie branch. Un collegamento può spostare una branch da un’altra sede principale.

Sono documentati anche:

- `GET /v1/customers/{id}/{organizationId}/branches`: elenco delle branch visibili; restituisce 404 anche se non ne sono presenti.
- `POST /v1/customers/{id}/{organizationId}/main-customer/branches/check-duplicates`: controllo preliminare con lo stesso body, senza modifiche. Segnala duplicati, collegamenti esistenti e incompatibilità.
- `PUT /v1/customers/update/{id}/{organizationId}/main-customer/branches/replace`: sostituzione dell’intero elenco. Le sedi escluse vengono scollegate; un elenco vuoto tenta di scollegarle tutte. Le regole multisede possono impedire l’operazione.
- `PUT /v1/customers/update/{id}/{organizationId}/main-customer`: collegamento di una singola branch, con `id` della branch e body `{"mainCustomerId": 101}`.
- `DELETE /v1/customers/update/{id}/{organizationId}/main-customer`: rimozione del collegamento della branch indicata, se consentita dalle regole multisede.

La consultazione e il controllo preliminare richiedono `customers_view`; le modifiche richiedono `customers_edit`. Le risposte delle anagrafiche documentano ora anche `type` e il campo canonico `mainCustomerId`.
