Contacts

Set an address

Writes one address of an anagrafica: sede legale, sede operativa, fatturazione or spedizione. Omit address_id and the party’s address in that role is updated if it has one and created if it does not, so calling this twice with the same arguments is the same as calling it once; pass address_id when the party has more than one address in that role. null clears a field. A party may hold at most 20 addresses.

post/api/v1/rest/anagrafiche/parties/{id}/addresses

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/anagrafiche/parties/{id}/addresses
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The anagrafica’s id, from anagrafiche_search_parties or anagrafiche_get_party.

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Request body

role'sede_legale' | 'sede_operativa' | 'fatturazione' | 'spedizione' required

What the address IS: sede_legale (the registered office an invoice must carry), sede_operativa (where the work happens), fatturazione, spedizione.

address_idstring uuid

Change THIS address, from anagrafiche_get_party. Omit it and the party’s address in that role is updated, or created when it has none.

streetstring nullable

Via and number. null clears it.

citystring nullable

The comune. null clears it.

provincestring nullable

The sigla, never the name: «MI», not «Milano». Stored uppercase.

postal_codestring nullable

The CAP. null clears it.

countrystring

ISO-3166-1 alpha-2, stored uppercase. IT on a new address; left alone on an existing one.

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.