Paese (Country)

Rappresenta il livello geografico più alto nel modello organizzativo: lo Stato o equivalente sovranazionale usato per anagrafiche, fiscalità e commercio. In Flowlyze il paese non è l’indirizzo completo, ma il riferimento che determina di norma valuta predefinita, regimi fiscali (es. IVA, sales tax) e metadati utili alle integrazioni (prefissi telefonici, codici ISO, appartenenza a unioni doganali). Altri oggetti—indirizzi, sedi, magazzini—risolvono il paese per applicare regole di calcolo e conformità.

Esempio JSON completo

{
  "id": "country_IT",
  "channel": "demoipaas",
  "createdAt": "2026-01-01T00:00:00+00:00",
  "updatedAt": "2026-03-01T12:00:00+00:00",
  "iso3166_1_alpha2": "IT",
  "iso3166_1_alpha3": "ITA",
  "iso3166_1_numeric": "380",
  "name": "Italy",
  "officialName": "Italian Republic",
  "defaultCurrency": "EUR",
  "defaultTaxRegime": "VAT_STANDARD",
  "defaultTaxZoneId": "tz_eu_it_standard",
  "euMember": true,
  "phonePrefix": "+39"
}

Note

• defaultCurrency e i campi defaultTax* sono valori di default a livello paese; documenti o transazioni possono usare valute o aliquote diverse se previsto dal flusso.
• defaultTaxRegime e defaultTaxZoneId nel campione sono stringhe illustrative; in produzione devono allinearsi al piano fiscale / master dati del tenant e del connettore ERP.
• Usare codici ISO 3166-1 (alpha2 / alpha3 / numeric) per interoperabilità tra sistemi.