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 sul 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 spedite 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,
  "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) oppure 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*	Vat ID del partner (campo necessario per le transazioni B2B).
taxNumber		O	Codice fiscale del partner, ad esempio «codice fiscale aziendale» (NON il numero di partita IVA!)
IdentificationType		M*	Modalità con cui è stata verificata l’identità del partner. Enum PartnerIdentificationType: Documento Ufficiale Altro Passport Certificato di residenza
PartnerIdentification		M*	Identificazione del partner – se impostato, deve essere impostata anche la proprietà IdentificationType.
AdditionalIdentifications		O	Funzionalità di identificazione aggiuntive per scopi specifici.
	lotteryId	O	Identificativo univoco di partecipazione alla lotteria associato a un cliente in Italia. È obbligatorio per l’accesso alla cosiddetta “Lotteria Differita” della “Lotteria degli Scontrini”. Dettagli sul 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 relative all'ID per vari scopi.
indirizzi		O/M*	Consente l’inserimento di più indirizzi o di indirizzi aggiuntivi. Se deve essere fornito 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] = IndirizzoResidenziale, [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 secondo la 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] = Servizio fornito 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 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 secondo la norma ISO 3166 alfa-3 (3 cifre). Dettagli sul paese: Portogallo: campo obbligatorio

Questo articolo è stato tradotto automaticamente.

oggetto-partner

Articoli correlati