Partner-objekt »partner« – RetailForce

Ta članek obravnava partnerski objekt znotraj objekta »Document«.

Celoten opis modela RetailForce DOM (Document Object Model) sistema RetailForce ter opis posameznih elementov najdete v rubriki za prenose na RetailForce website (Object model documentation.pdf) v ustreznem imeniku različic.

Objekt »partner« vsebuje informacije o posameznih (poslovnih) partnerjih podjetja, ki izdaja dokument. To so lahko na primer zunanji partnerji, kot so stranke ali dobavitelji, pa tudi notranje »stranke«, kot je določena podružnica podjetja, kamor se pošilja blago.

partner-object

Naslednji objekt »partner« vsebuje vzorčne podatke.

"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"
},

Objekt partner vsebuje naslednje informacije.

Podatki v stolpcu »Type«:

M ... obvezno / zahtevano
M* ... obvezno / zahtevano v nekaterih državah ali pod določenimi pogoji
R ... priporočeno
O... neobvezno

Elementi		Tip	Opis
ID		M	ID partnerja. Lahko je npr. številka stranke / ID.
caption		O	Oznaka partnerja (npr. ime, ime podjetja).
IsBusiness		M*	Označuje, ali gre pri transakciji za transakcija B2B (true) ali transakcija B2C (false). Podatki o državi: Francija: Obvezni podatki Portugalska: Obvezni podatki Québec/Kanada: Obvezni podatki
PartnerType		M*	Vrsta/tip (poslovnega) partnerja (enum). Trenutno: [0] = Stranka [1] = Dobavitelj Podatki o državi: Portugalska: Obvezne informacije
PartnerClassification		O	Razvrstitev partnerja (ne PartnerType!).
VatNumber		M*	Vat ID partnerja (potrebna za transakcije med podjetji).
taxNumber		O	Davčna številka partnerja, npr. »davčna številka podjetja« (NE številka Vat!)
companyIdentification		O	Drugi identifikacijski podatki stranke (B2B) za različne namene.
	type	O	Opredeljuje vrsto atributa ID. Možne vrednosti: [0] = VatNumber, [1] = taxNumber, [2] = številka GLN, [3] = identifikacijska številka podjetja, [4] = statistična klasifikacija, [5] = številka vpis v trgovinski register, [6] = Urad za vpis v trgovinski register, [7] = številka v trgovinskem registru, [8] = številka davčnega urada, [9] = številka za DDV, [10] = številka QST, [11] = ERoutingCode, [12] = identifikacijska številka lokacije Pomen posameznih elementov najdete v članku »Identifikacija podjetja«. Podatki po državah: Francija: Tip [12] = LocationIdentification se uporablja za navedbo številke SIRET stranke ali partnerja.
	identifikacija	O	Določa dejansko vrednost atributa ID (npr. številko SIRET v Franciji, kadar je določen tip [12] = LocationIdentification).
IdentificationType		M*	na kakšen način je bila potrjena identiteta partnerja. Enum PartnerIdentificationType: OfficialDocument Drugo Passport Potrdilo o stalnem prebivališču
PartnerIdentification		M*	Identifikacija partnerja – če je nastavljena, mora biti nastavljena tudi lastnost IdentificationType.
AdditionalIdentifications		O	Dodatne ID značilnosti za različne namene.
	lotteryId	O	Osebno ID stranke v Italiji za loterijo. Potrebno je za sodelovanje v tako imenovani odloženi loteriji („Lotteria Differita“) v okviru loterije „Lotteria degli Scontrini“ („Loterija računov“). Podatki o državi: Italija: Če stranka želi sodelovati v Lotteria Differita, je treba v to polje vnesti njeno osebno ID.
	additionalProp1	O	Dodatne funkcije ID številke za različne namene.
	additionalProp2	O	Dodatne funkcije ID za različne namene.
	additionalProp3	O	Dodatne funkcije ID za različne namene.
naslovi		O/M*	Omogoča vnos več / dodatnih naslovov. Če je treba navesti le en naslov, uporabite splošno polje »Document.Partner«. Opomba: Na splošno morajo biti naslovi vedno vključeni na B2B računih („documentType“: „[1] = Invoice“).
	addressType	O/M*	Lastnost »addressType«, opredeljena na tej ravni, določa vrsto naslova, vnesenega v polju »Document.Partner.Addresses«. Na voljo so naslednje vrste naslovov: [1] = BillingAddress, [2] = Naslov za dostavo, [3] = ResidentialAddress, [4] = CompanyLocation, [5] = opravljena storitev Podatki o državi: Portugalska: Določitev vrst naslovov za račune B2B na Portugalskem: [1] = BillingAddress – obvezno, [2] = Naslov za dostavo – neobvezno
	ulica	O/M*	Ulica Podatki o državi: Portugalska: obvezno polje Québec: Obvezno polje, če je naveden »partner« (stranka). Revenu Québec podpira le podatke o kanadskih strankah.
	streetNumber	O/M*	Številka ulice Podatki o državi: Portugalska: Obvezno polje Québec: Obvezno polje, če je naveden »partner« (stranka). Revenu Québec podpira le podatke o kanadskih strankah.
	PostalCode	O/M*	Poštna številka Podatki o državi: Portugalska: Obvezno polje Québec: Obvezno polje, če je naveden »partner« (stranka). Revenu Québec podpira le podatke o kanadskih strankah. Poštna številka mora biti v kanadskem formatu: A9A9A9 6 znakov 1 znak (črka), 1 številka, 1 znak (črka), 1 številka, 1 znak (črka), 1 številka.
	mesto	O/M*	Mesto / kraj Podatki o državi: Portugalska: Obvezno polje Québec: Obvezno polje, če je naveden »partner« (stranka). Revenu Québec podpira le podatke o kanadskih strankah.
	skupnost	O	V nekaterih državah (npr. v Sloveniji) je tako imenovana »skupnost« del naslova.
	CountryCode	O/M*	Koda države v skladu s standardom ISO 3166 alpha-3 (3-mestna). Podrobnosti o državi: Portugalska: Obvezno polje
addressType		O/M*	Lastnost »addressType«, nastavljena na tej ravni, opredeljuje vrsto naslova, vnesenega v »Document.Partner«. Če morate navesti več različnih naslovov z različnimi vrstami naslovov, lahko to storite v »Document.Partner.Addresses«. Na voljo so naslednje vrste naslovov: [1] = BillingAddress, [2] = Naslov za dostavo, [3] = ResidentialAddress, [4] = CompanyLocation, [5] = opravljena storitev Podatki o državi: Portugalska: Navajanje vrst naslovov na B2B računih v Portugalski: [1] = BillingAddress – obvezno, [2] = Naslov za dostavo – neobvezno
ulica		O/M*	Ulica Podatki o državi: Portugalska: obvezno polje Québec: Obvezno polje, če je naveden »partner« (stranka). Revenu Québec podpira le podatke o kanadskih strankah.
streetNumber		O/M*	Številka ulice Podatki o državi: Portugalska: Obvezno polje Québec: Obvezno polje, če je naveden »partner« (stranka). Revenu Québec podpira le podatke o kanadskih strankah.
PostalCode		O/M*	Poštna številka Podatki o državi: Portugalska: Obvezno polje Québec: Obvezno polje, če je naveden »partner« (stranka). Revenu Québec podpira le podatke o kanadskih strankah. Poštna številka mora biti v kanadskem formatu: A9A9A9 6 znakov 1 znak (črka), 1 številka, 1 znak (črka), 1 številka, 1 znak (črka), 1 številka.
mesto		O/M*	Mesto / kraj Podatki o državi: Portugalska: Obvezno polje Québec: Obvezno polje, če je naveden »partner« (stranka). Revenu Québec podpira le podatke o kanadskih strankah.
skupnost		O	V nekaterih državah (npr. v Sloveniji) je tako imenovana »skupnost« del naslova.
CountryCode		O/M*	Koda države v skladu s standardom ISO 3166 alfa-3 (3-mestna). Podrobnosti o državi: Portugalska: Obvezno polje

Ta članek je bil samodejno preveden.

partner-object

Sorodni sklopi