Partnerio objektas „partner“ – RetailForce

Šiame straipsnyje aptariamas „partner“ objektas, esantis „Document“ objekte.

Išsamus „RetailForce“ DOM (dokumento objektų modelio) aprašymas, taip pat atskirų elementų aprašymai, pateikiami „RetailForce“ website atsisiuntimų skyriuje (Object model documentation.pdf) atitinkamame versijų kataloge.

Objektas „partner“ saugo informaciją apie atitinkamus (verslo) partnerius, susijusius su dokumentą išduodančia įmone. Tai gali būti, pavyzdžiui, išoriniai partneriai, tokie kaip klientai ar tiekėjai, bet taip pat ir vidiniai „klientai“, pavyzdžiui, tam tikras įmonės filialas, į kurį siunčiamos prekės.

partner-object

Toliau pateiktame „partner“ objekte yra pavyzdiniai duomenys.

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

Objekte „partner“ pateikiama ši informacija.

Informacija stulpelyje „Type“:

M ... privaloma / reikalaujama
M* ... privaloma / reikalaujama tam tikrose šalyse arba tam tikromis sąlygomis
R ... rekomenduojama
O... neprivaloma

Elementai		Tipas	Aprašymas
ID		M	Partnerio ID. Tai gali būti, pvz., kliento numeris / ID.
caption		O	Partnerių pavadinimas (pvz., vardas, pavardė, įmonės pavadinimas).
IsBusiness		M*	Nurodo, ar sandoris yra B2B sandoris (true) ar B2C sandoris (klaidinga). Duomenys apie šalį: Prancūzija: Privaloma informacija Portugalija: privaloma informacija Québec/Kanada: Privaloma informacija
PartnerType		M*	(Verslo) partnerio tipas / rūšis (enum). Šiuo metu: [0] = Klientas [1] = Tiekėjas Šalies duomenys: Portugalija: Privaloma informacija
PartnerClassification		O	Partnerio klasifikacija (ne „PartnerType“!).
VatNumber		M*	Partnerio Vat ID (būtinas B2B sandoriams).
taxNumber		O	Partnerio mokesčių mokėtojo kodas, pvz., „įmonės mokesčių mokėtojo kodas“ (NE Vat kodas!)
companyIdentification		O	Kiti kliento identifikaciniai duomenys (B2B), skirti įvairiems tikslams.
	type	O	Apibrėžia ID atributo tipą. Galimos reikšmės: [0] = VatNumber, [1] = taxNumber, [2] = GLN numeris, [3] = BusinessIdenticationNumber, [4] = statistinė klasifikacija, [5] = komercinio registro numeris, [6] = Komercinio registro numerio išdavimo įstaiga, [7] = prekybos registro numeris, [8] = Mokesčių inspekcijos numeris, [9] = PVM numeris, [10] = QST numeris, [11] = ERouting kodas, [12] = vietos identifikatorius Atskirų elementų reikšmes galite rasti straipsnyje „Įmonės identifikavimas“. Informacija apie šalis: Prancūzija: tipas [12] = LocationIdentification naudojamas nurodyti kliento arba partnerio SIRET numerį.
	identifikavimas	O	Apibrėžia ID atributo faktinę reikšmę (pvz., SIRET Prancūzijoje, kai nurodytas tipas [12] = „LocationIdentification“).
IdentificationType		M*	kokiu būdu buvo patvirtinta partnerio tapatybė. Enum PartnerIdentificationType: OfficialDocument Kita Passport Gyvenamosios vietos pažymėjimas
PartnerIdentification		M*	Partnerio identifikatorius – jei nustatytas, taip pat turi būti nustatytas „IdentificationType“ parametras.
AdditionalIdentifications		O	Papildomos ID funkcijos įvairiems tikslams.
	lotteryId	O	Asmeninis kliento loterijos ID Italijoje. Būtinas norint dalyvauti vadinamojoje atidėtoje loterijoje („Lotteria Differita“) pagal „Lotteria degli Scontrini“ („Kvitų loterija“) programą. Informacija apie šalį: Italija: Jei klientas nori dalyvauti „Lotteria Differita“, šiame laukelyje turi būti įvestas jo ID.
	papildomasParametras1	O	Papildomos ID funkcijos įvairiems tikslams.
	additionalProp2	O	Papildomos ID funkcijos įvairiems tikslams.
	additionalProp3	O	Papildomos ID funkcijos įvairiems tikslams.
adresai		O/M*	Leidžia įvesti kelis / papildomus adresus. Jei reikia nurodyti tik vieną adresą, naudokite bendrąjį lauką „Document.Partner“. Pastaba: Paprastai adresai visada turi būti nurodyti B2B sąskaitose-faktūrose („documentType“: „[1] = Invoice“).
	addressType	O/M*	Šiame lygmenyje apibrėžta „addressType“ savybė nurodo „Document.Partner.Addresses“ įvesto adreso tipą. Galimi šie adresų tipai: [1] = BillingAddress, [2] = „DeliveryAddress“, [3] = Gyvenamosios vietos adresas, [4] = Įmonės buveinė, [5] = Teiktos paslaugos Informacija apie šalį: Portugalija: Adresų tipų specifikacija B2B sąskaitoms faktūroms Portugalijoje: [1] = BillingAddress – privalomas, [2] = DeliveryAddress – neprivaloma
	gatvė	O/M*	Gatvė Šalies duomenys: Portugalija: privalomas laukas Québecas: Privalomas laukas, jei nurodytas „partneris“ (klientas). „Revenu Québec“ priima tik informaciją apie Kanados klientus.
	streetNumber	O/M*	Gatvės numeris Šalies duomenys: Portugalija: Privalomas laukas Québec: Privalomas laukas, jei nurodytas „partneris“ (klientas). „Revenu Québec“ palaiko tik informaciją apie Kanados klientus.
	PostalCode	O/M*	Pašto kodas Šalies duomenys: Portugalija: Privalomas laukas Québec: Privalomas laukas, jei nurodytas „partneris“ (klientas). „Revenu Québec“ priima tik informaciją apie Kanados klientus. Pašto kodas turi būti Kanados formatu: A9A9A9 6 simboliai 1 simbolis (raide), 1 skaitmuo, 1 simbolis (raide), 1 skaitmuo, 1 simbolis (raide), 1 skaičius.
	miestas	O/M*	Miestas / miestelis Šalies duomenys: Portugalija: Privalomas laukas Québecas: Privalomas laukas, jei nurodytas „partneris“ (klientas). „Revenu Québec“ palaiko tik informaciją apie Kanados klientus.
	bendruomenė	O	Kai kuriose šalyse (pvz., Slovėnijoje) vadinamoji „bendruomenė“ yra adreso dalis.
	CountryCode	O/M*	Šalies kodas pagal ISO 3166 alfa-3 (3 skaitmenys). Informacija apie šalį: Portugalija: Privalomas laukas
addressType		O/M*	Šiame lygmenyje nustatytas parametras „addressType“ apibrėžia „Document.Partner“ įvesto adreso tipą. Jei reikia nurodyti kelis skirtingus adresus su skirtingais adresų tipais, tai galima padaryti skyriuje „Document.Partner.Addresses“. Galimi šie adresų tipai: [1] = „BillingAddress“, [2] = „DeliveryAddress“, [3] = Gyvenamosios vietos adresas, [4] = Įmonės buveinė, [5] = Paslaugos teikimo vieta Šalies informacija: Portugalija: Adresų tipų nurodymas B2B sąskaitose faktūrose Portugalijoje: [1] = „BillingAddress“ – privaloma, [2] = DeliveryAddress – neprivaloma
gatvė		O/M*	Gatvė Šalies duomenys: Portugalija: privalomas laukas Québecas: Privalomas laukas, jei nurodytas „partneris“ (klientas). „Revenu Québec“ palaiko tik informaciją apie Kanados klientus.
streetNumber		O/M*	Gatvės numeris Šalies duomenys: Portugalija: Privalomas laukas Québecas: Privalomas laukas, jei nurodytas „partneris“ (klientas). „Revenu Québec“ palaiko tik informaciją apie Kanados klientus.
PostalCode		O/M*	Pašto kodas Šalies duomenys: Portugalija: Privalomas laukas Québec: Privalomas laukas, jei nurodytas „partneris“ (klientas). „Revenu Québec“ priima tik informaciją apie Kanados klientus. Pašto kodas turi būti pateiktas Kanados formatu: A9A9A9 6 simboliai 1 simbolis (raide), 1 skaitmuo, 1 simbolis (raide), 1 skaitmuo, 1 simbolis (raide), 1 skaičius.
miestas		O/M*	Miestas / miestelis Šalies duomenys: Portugalija: Privalomas laukas Québec: Privalomas laukas, jei nurodytas „partneris“ (klientas). „Revenu Québec“ palaiko tik informaciją apie Kanados klientus.
bendruomenė		O	Kai kuriose šalyse (pvz., Slovėnijoje) vadinamoji „bendruomenė“ yra adreso dalis.
CountryCode		O/M*	Šalies kodas pagal ISO 3166 alfa-3 (3 skaitmenys). Informacija apie šalį: Portugalija: Privalomas laukas

Šis straipsnis buvo išverstas automatiškai.

partner-object

Susiję straipsniai