Skip to Content
EIS
Changelog
apianagrafiche

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, 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.