Partnerio objektas „partner“ – RetailForce

Šiame straipsnyje aptariamas partnerio objektas („partner“) dokumento objekte
.

Išsamų „RetailForce DOM“ (dokumento objektų modelio) aprašymą bei atskirų elementų aprašymą rasite „RetailForce“ svetainės atsisiuntimų skyriuje (Object model documentation.pdf) atitinkamoje versijų kataloge.

Objekte „partner“ pateikiama informacija apie atitinkamus (verslo) partnerius, su kuriais bendradarbiauja dokumentą išduodanti įmonė. Tai gali būti, pavyzdžiui, išoriniai partneriai, tokie kaip klientai ar tiekėjai, bet taip pat ir vidiniai „klientai“, pvz., tam tikras savo įmonės filialas, į kurį siunčiamos prekės.

partneris objektas

Toliau pateiktame partnerio objekte yra pavyzdiniai duomenys.

"partner": {
  "id": "2241247",
  "caption": "Franz Österreicher",
  "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"
},

Partnerio objektas apima toliau nurodytą informaciją.

Informacija stulpelyje „Tipas“:

M ... privaloma („mandatory“)
M* ... privaloma tam tikrose šalyse arba tam tikromis sąlygomis
R ... rekomenduojama („recommended“)
O ... neprivaloma

Elementas		Tipas	Aprašymas
id		M	Partnerio ID. Tai gali būti, pvz., kliento numeris / ID.
caption		O	Partnerio pavadinimas (pvz., vardas, pavadinimas).
isBusiness		M*	Nurodo, ar tai yra B2B sandoris (true), ar B2C sandoris (false). Informacija apie šalį: Prancūzija: privaloma informacija Portugalija: privaloma informacija Kvebekas/Kanada: privaloma nurodyti
partnerType		M*	(Verslo) partnerio tipas / rūšis (Enum). Dabartinis: [0] = Klientas [1] = Tiekėjas Informacija apie šalį: Portugalija: privaloma nurodyti
partnerClassification		O	Partnerio klasifikacija (ne partnerio tipas!)
vatNumber		M*	Partnerio PVM kodas (būtinas B2B sandoriams).
taxNumber		O	Partnerio mokesčių mokėtojo numeris, pvz., „Mokesčių inspekcijos mokesčių mokėtojo numeris“ (NE PVM mokėtojo numeris!)
identificationType		M	kaip buvo patvirtinta partnerio tapatybė. Enum PartnerIdentificationType: OfficialDocument Other Passport Gyvenamosios vietos pažymėjimas
partnerIdentification		M*	Partnerio identifikacija – jei nustatyta, taip pat turi būti nustatyta savybė „IdentificationType“.
papildomas identifikavimas		O	Papildomi identifikavimo požymiai įvairiems tikslams.
	lotteryId	O	Asmeninis kliento loterijos ID Italijoje. Reikalingas norint dalyvauti vadinamojoje atidėtoje loterijoje („Lotteria Differita“) „Lotteria degli Scontrini“ (kvito loterija). Informacija apie šalį: Italija: Jei klientas nori dalyvauti „Lotteria Differita“, šiame laukelyje reikia įvesti jo asmeninį ID.
	additionalProp1	O	Papildomi ID požymiai įvairiems tikslams.
	additionalProp2	O	Papildomi identifikavimo požymiai įvairiems tikslams.
	additionalProp3	O	Papildomi identifikavimo požymiai įvairiems tikslams.
addresses		O/M*	Leidžia nurodyti kelis adresus. Jei reikia nurodyti tik vieną adresą, naudokite bendrąjį lauką „Document.Partner“. Pastaba: Paprastai adresų nurodymas B2B sąskaitose („DocumentType“: „[1] = Invoice“) visada yra privalomas.
	addressType	O/M*	Šiame lygmenyje nustatyta savybė „AddressType“ apibrėžia „Document.Partner.Addresses“ įvesto adreso tipą. Galimi šie adresų tipai: [1] = BillingAddress, [2] = DeliveryAddress, [3] = Gyvenamoji adresas, [4] = CompanyLocation, [5] = Paslaugos teikimo vieta Informacija apie šalį: Portugalija: Adresų tipų nurodymas B2B sąskaitose Portugalijoje: [1] = BillingAddress - Privaloma, [2] = DeliveryAddress - Neprivaloma
	gatvė	O/M*	Gatvė Informacija apie šalį: Portugalija: privalomas laukas Kvebekas/Kanada: privalomas laukas, jei nurodytas „partneris“ (klientas). Revenu Québec palaiko tik duomenis apie Kanados klientus.
	streetNumber	O/M*	Namų numeris Informacija apie šalį: Portugalija: privalomas laukas Kvebekas/Kanada: privalomas laukas, jei nurodytas „partneris“ (klientas). Revenu Québec palaiko tik duomenis apie Kanados klientus.
	pašto kodas	O/M*	Pašto kodas Informacija apie šalį: Portugalija: privalomas laukas Kvebekas/Kanada: privalomas laukas, jei nurodytas „partneris“ (klientas). Revenu Québec palaiko tik duomenis apie Kanados klientus. Pašto kodas turi atitikti Kanados formatą: A9A9A9 6 simboliai 1 simbolis (raide), 1 skaičius, 1 simbolis (raide), 1 skaičius, 1 simbolis (raide), 1 skaičius.
	miestas	O/M*	Miestas / vietovė Informacija apie šalį: Portugalija: privalomas laukas Kvebekas/Kanada: privalomas laukas, jei nurodytas „partneris“ (klientas). Revenu Québec palaiko tik duomenis apie Kanados klientus.
	bendruomenė	O	Kai kuriose šalyse (pvz., Slovėnijoje) vadinamoji „bendruomenė“ yra adreso dalis.
	countryCode	O/M*	Šalies kodas pagal ISO 3166 alpha-3 (3 simboliai). Informacija apie šalį: Portugalija: privalomas laukas
addressType		O/M*	Šiame lygmenyje nustatyta savybė „AddressType“ apibrėžia „Document.Partner“ įvesto adreso tipą. Jei reikia nurodyti kelis skirtingus adresus su skirtingais adresų tipais, tai galima padaryti „Document.Partner.Addresses“. Galimi šie adresų tipai: [1] = BillingAddress, [2] = DeliveryAddress, [3] = Gyvenamoji adresas, [4] = CompanyLocation, [5] = Paslaugos teikimo vieta Informacija apie šalį: Portugalija: Adresų tipų nurodymas B2B sąskaitose Portugalijoje: [1] = BillingAddress - Privaloma, [2] = DeliveryAddress - Neprivaloma
gatvė		O/M*	Gatvė Informacija apie šalį: Portugalija: privalomas laukas Kvebekas/Kanada: privalomas laukas, jei nurodytas „partneris“ (klientas). Revenu Québec palaiko tik duomenis apie Kanados klientus.
streetNumber		O/M*	Namų numeris Informacija apie šalį: Kvebekas/Kanada: privalomas laukas, jei nurodytas „partneris“ (klientas). „Revenu Québec“ palaiko tik duomenis apie Kanados klientus.
pašto kodas		O/M*	Pašto kodas Informacija apie šalį: Portugalija: privalomas laukas Kvebekas/Kanada: privalomas laukas, jei nurodytas „partneris“ (klientas). Revenu Québec palaiko tik duomenis apie Kanados klientus. Pašto kodas turi atitikti Kanados formatą: A9A9A9 6 simboliai 1 simbolis (raide), 1 skaičius, 1 simbolis (raide), 1 skaičius, 1 simbolis (raide), 1 skaičius.
miestas		O/M*	Miestas / vietovė Informacija apie šalį: Portugalija: privalomas laukas Kvebekas/Kanada: privalomas laukas, jei nurodytas „partneris“ (klientas). Revenu Québec palaiko tik duomenis apie Kanados klientus.
bendruomenė		O	Kai kuriose šalyse (pvz., Slovėnijoje) vadinamoji „bendruomenė“ yra adreso dalis.
countryCode		O/M*	Šalies kodas pagal ISO 3166 alpha-3 (3 simboliai). Informacija apie šalį: Portugalija: privalomas laukas

partneris objektas

Susiję straipsniai