Branch delle anagrafiche
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:
{
"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, coniddella 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.