Oggetto partner «partner» – RetailForce

Il presente articolo tratta dell’oggetto partner all’interno dell’oggetto Document.

Una descrizione completa del RetailForce DOM (Document Object Model), nonché una descrizione dei singoli elementi, è disponibile nell’area download del sito web di RetailForce (Documentazione del modello a oggetti.pdf) nella rispettiva directory delle versioni.

L’oggetto «partner» contiene informazioni sui rispettivi partner (commerciali) dell’azienda emittente del documento. Questi possono essere, ad esempio, partner esterni quali clienti o fornitori, ma anche «clienti» interni quali una determinata filiale dell’azienda alla quale vengono inviate le merci.

oggetto-partner

Il seguente oggetto partner contiene dati di esempio.

"partner": {
  "id": "2241247",
  "caption": "Jane Doe",
  "isBusiness": true,
  "partnerType": "[0] = Customer",
  "partnerClassification": "Customer",
  "vatNumber": null,
  "taxNumber": null,
  "companyIdentification": [
    {
      "type": "[12] = LocationIdentification",
      "identification": "1234567890ABC"
    }
  ],
  "identificationType": "passport",
  "partnerIdentification": null,
  "additionalIdentifications": null,
  "addresses": [
    {
      "addressType": "[1] = BillingAddress,
      "street": "Hintere Zollamtsstraße",
      "streetNumber": "4",
      "postalCode": "1030",
      "city": "Wien",
      "community": null,
      "countryCode": "AUT"
    }
  ],
  "addressType": "[1] = BillingAddress,
  "street": "Hintere Zollamtsstraße",
  "streetNumber": "4",
  "postalCode": "1030",
  "city": "Wien",
  "community": null,
  "countryCode": "AUT"
},

L’oggetto partner contiene le seguenti informazioni.

Informazioni nella colonna “Tipo”:

M ... obbligatorio / richiesto
M* ... obbligatorio / richiesto in determinati paesi o a determinate condizioni
R ... raccomandato
O... facoltativo

Elementi		Tipo	Descrizione
ID		M	ID del partner. Può essere, ad esempio, il numero cliente o l’ID.
caption		O	Denominazione del partner (ad es. nome, ragione sociale).
IsBusiness		M*	Indica se la transazione è una transazione B2B (true) o una transazione B2C (falso). Dettagli sul Paese: Francia: Informazioni obbligatorie Portogallo: Informazioni obbligatorie Québec/Canada: Informazioni obbligatorie
PartnerType		M*	Tipo/categoria di partner (aziendale) (Enum). Attualmente: [0] = Cliente [1] = Fornitore Dettagli sul Paese: Portogallo: Informazioni obbligatorie
PartnerClassification		O	Classificazione del partner (non il PartnerType!).
VatNumber		M*	Partita IVA del partner (necessaria per le transazioni B2B).
taxNumber		O	Codice fiscale del partner, ad esempio «codice fiscale aziendale» (NON il numero di partita IVA!)
companyIdentification		O	Altri dati identificativi del cliente (B2B) per vari scopi.
	tipo	O	Definisce il tipo di attributo di identificazione. Valori possibili: [0] = VatNumber, [1] = taxNumber, [2] = Numero GLN, [3] = Numero di identificazione aziendale, [4] = Classificazione statistica, [5] = Numero di iscrizione al registro delle imprese, [6] = Ufficio di registrazione commerciale, [7] = Numero di iscrizione al registro delle imprese, [8] = Numero dell'ufficio delle imposte, [9] = Numero GST, [10] = Numero QST, [11] = Codice di instradamento, [12] = Identificativo della sede Il significato dei singoli campi è illustrato nell’articolo "Identificazione aziendale". Dettagli per paese: Francia: il tipo [12] = LocationIdentification viene utilizzato per specificare il numero SIRET del cliente o del partner.
	identificazione	O	Definisce il valore effettivo dell’attributo ID (ad es. il SIRET in Francia quando è specificato il tipo [12] = LocationIdentification).
IdentificationType		M*	modo in cui è stata confermata l’identità del partner. Enum PartnerIdentificationType: OfficialDocument Altro Passaporto Certificato di residenza
PartnerIdentification		M*	Identificazione del partner – se impostata, deve essere impostata anche la proprietà IdentificationType.
AdditionalIdentifications		O	Funzionalità di identificazione aggiuntive per scopi specifici.
	lotteryId	O	Identificativo univoco di un cliente in Italia associato alla lotteria. Tale parametro è obbligatorio per la partecipazione alla cosiddetta "Lotteria Differita" della "Lotteria degli Scontrini". Dettagli per paese: Italia: qualora un cliente intenda partecipare alla Lotteria Differita, è necessario inserire il proprio ID personale in questo campo.
	additionalProp1	O	Caratteristiche aggiuntive dell’ID per vari scopi.
	additionalProp2	O	Funzionalità aggiuntive di ID per vari scopi.
	additionalProp3	O	Funzionalità aggiuntive di ID per vari scopi.
indirizzi		O/M*	Consente l’inserimento di indirizzi multipli o aggiuntivi. Qualora si debba fornire un solo indirizzo, si prega di utilizzare il campo generale “Document.Partner”. Nota: come regola generale, gli indirizzi devono sempre essere inclusi nelle fatture B2B ("documentType": "[1] = Fattura").
	addressType	O/M*	La proprietà «addressType» definita a questo livello specifica il tipo di indirizzo inserito in «Document.Partner.Addresses». Sono disponibili i seguenti tipi di indirizzo: [1] = BillingAddress, [2] = IndirizzoDiConsegna, [3] = Indirizzo di residenza, [4] = SedeAziendale, [5] = ServizioFornito Informazioni sul Paese: Portogallo: Specifiche relative ai tipi di indirizzo per le fatture B2B in Portogallo: [1] = BillingAddress - Obbligatorio, [2] = IndirizzoDiConsegna - Facoltativo
	via	O/M*	Via Dettagli sul Paese: Portogallo: campo obbligatorio Québec: Campo obbligatorio se viene specificato un «partner» (cliente). Revenu Québec supporta esclusivamente le informazioni relative ai clienti canadesi.
	streetNumber	O/M*	Numero civico Dettagli sul Paese: Portogallo: campo obbligatorio Québec: campo obbligatorio se viene specificato un «partner» (cliente). Revenu Québec supporta esclusivamente le informazioni relative ai clienti canadesi.
	PostalCode	O/M*	Codice postale Dettagli sul Paese: Portogallo: Campo obbligatorio Québec: campo obbligatorio se viene specificato un «partner» (cliente). Revenu Québec supporta esclusivamente le informazioni relative ai clienti canadesi. Il codice postale deve essere nel formato canadese: A9A9A9 6 caratteri 1 carattere (lettera), 1 numero, 1 carattere (lettera), 1 numero, 1 carattere (lettera), 1 numero.
	città	O/M*	Città / Località Dettagli sul Paese: Portogallo: campo obbligatorio Québec: Campo obbligatorio se viene specificato un «partner» (cliente). Revenu Québec supporta esclusivamente le informazioni relative ai clienti canadesi.
	Comunità	O	In alcuni paesi (ad es. la Slovenia) la cosiddetta “comunità” fa parte dell’indirizzo.
	CountryCode	O/M*	Codice paese conforme alla norma ISO 3166 alfa-3 (3 cifre). Dettagli sul Paese: Portogallo: campo obbligatorio
addressType		O/M*	La proprietà "addressType" impostata a questo livello definisce il tipo di indirizzo inserito in "Document.Partner". Se è necessario specificare diversi indirizzi con tipi di indirizzo diversi, è possibile farlo in "Document.Partner.Addresses". Sono disponibili i seguenti tipi di indirizzo: [1] = BillingAddress, [2] = IndirizzoDiConsegna, [3] = IndirizzoResidenziale, [4] = SedeAziendale, [5] = ServizioFornito Dettagli sul Paese: Portogallo: Specificazione dei tipi di indirizzo sulle fatture B2B in Portogallo: [1] = BillingAddress - Obbligatorio, [2] = IndirizzoDiConsegna - Facoltativo
via		O/M*	Via Dettagli sul Paese: Portogallo: campo obbligatorio Québec: Campo obbligatorio se viene specificato un «partner» (cliente). Revenu Québec supporta esclusivamente le informazioni relative ai clienti canadesi.
streetNumber		O/M*	Numero civico Dettagli sul Paese: Portogallo: campo obbligatorio Québec: campo obbligatorio se è specificato un «partner» (cliente). Revenu Québec supporta esclusivamente le informazioni relative ai clienti canadesi.
PostalCode		O/M*	Codice postale Dettagli sul Paese: Portogallo: Campo obbligatorio Québec: campo obbligatorio se viene specificato un «partner» (cliente). Revenu Québec supporta esclusivamente le informazioni relative ai clienti canadesi. Il codice postale deve essere nel formato canadese: A9A9A9 6 caratteri 1 carattere (lettera), 1 numero, 1 carattere (lettera), 1 numero, 1 carattere (lettera), 1 numero.
città		O/M*	Città / Località Dettagli sul Paese: Portogallo: campo obbligatorio Québec: campo obbligatorio se viene specificato un «partner» (cliente). Revenu Québec supporta esclusivamente le informazioni relative ai clienti canadesi.
Comunità		O	In alcuni paesi (ad es. la Slovenia) la cosiddetta “comunità” fa parte dell’indirizzo.
CountryCode		O/M*	Codice paese conforme alla norma ISO 3166 alfa-3 (3 cifre). Dettagli sul Paese: Portogallo: campo obbligatorio

Questo articolo è stato tradotto automaticamente.

oggetto-partner

Articoli correlati