„partner” partnerobjektum – RetailForce

Ez a cikk a Document objektumon belüli partner objektummal foglalkozik.

A RetailForce DOM (Document Object Model) teljes leírása, valamint az egyes elemek leírása megtalálható a RetailForce website letöltési részében (Object model documentation.pdf) a megfelelő verzió könyvtárában.

A „partner” objektum a dokumentumot kiállító vállalat megfelelő (üzleti) partnereire vonatkozó információkat tartalmazza. Ezek lehetnek például külső partnerek, mint például ügyfelek vagy beszállítók, de belső „ügyfelek” is, például a vállalat egy adott fiókja, ahová az árukat szállítják.

partner-objektum

Az alábbi partnerobjektum mintadatokat tartalmaz.

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

A partner-objektum a következő információkat tartalmazza.

A „Type” oszlopban szereplő információk:

M ... kötelező / előírt
M* ... kötelező / bizonyos országokban vagy bizonyos feltételek mellett kötelező
R ... ajánlott
O... opcionális

Elemek		Típus	Leírás
ID		M	A partner ID-ja. Lehet például az ügyfélszám vagy azonosító.
caption		O	A partnerek megnevezése (pl. név, cégnév).
IsBusiness		M*	Jelzi, hogy a tranzakció B2B tranzakció (true) vagy B2C tranzakció (hamis). Országadatok: Franciaország: Kötelezően megadandó adatok Portugália: Kötelezően megadandó adatok Québec/Kanada: Kötelező adatok
PartnerType		M*	(Üzleti) partner típusa / fajtája (enum). Jelenleg: [0] = Ügyfél [1] = Beszállító Országadatok: Portugália: Kötelezően megadandó adatok
PartnerClassification		O	A partner besorolása (nem a PartnerType!).
VatNumber		M*	A partner Vat-ID-je (B2B tranzakciókhoz szükséges).
taxNumber		O	A partner adószáma, pl. „cégadószám” (NEM a Vat-szám!)
companyIdentification		O	Egyéb ügyfélazonosító adatok (B2B) különböző célokra.
	type	O	Meghatározza az ID attribútum típusát. Lehetséges értékek: [0] = VatNumber, [1] = taxNumber, [2] = GlnNumber, [3] = cégazonosítószám, [4] = Statisztikai besorolás, [5] = cégjegyzékszám, [6] = cégjegyzékszám-kiadó hatóság, [7] = kereskedelmi nyilvántartási szám, [8] = Adóhivatal száma, [9] = ÁFA-szám, [10] = QST-szám, [11] = ERouting-kód, [12] = Helyazonosító Az egyes elemek jelentését a „Cégazonosító” című cikkben találja meg. Országspecifikus részletek: Franciaország: A [12] = LocationIdentification típus az ügyfél vagy partner SIRET-számának megadására szolgál.
	azonosító	O	Meghatározza az ID attribútum tényleges értékét (pl. Franciaországban a SIRET-számot, ha a [12] típus = LocationIdentification van megadva).
IdentificationType		M*	hogy milyen módon erősítették meg a partner személyazonosságát. PartnerIdentificationType enum: OfficialDocument Egyéb Passport Lakcímigazolás
PartnerIdentification		M*	A partner azonosítója – ha be van állítva, az IdentificationType tulajdonságot is be kell állítani.
AdditionalIdentifications		O	Különféle célokra szolgáló további ID-jellemzők.
	lotteryId	O	Egy olaszországi ügyfél személyes lottó ID-je. Szükséges az úgynevezett halasztott lottóban („Lotteria Differita”) való részvételhez a „Lotteria degli Scontrini” („Nyugtalottó”) keretében. Országspecifikus részletek: Olaszország: Ha az ügyfél részt kíván venni a Lotteria Differita-ban, személyi ID-jét be kell írni ebbe a mezőbe.
	additionalProp1	O	Különféle célokra szolgáló további ID-jellemzők.
	additionalProp2	O	Különféle célokra szolgáló további ID-jellemzők.
	additionalProp3	O	Különféle célokra szolgáló további ID-jellemzők.
címek		O/M*	Lehetővé teszi több / további cím megadását. Ha csak egy címet kell megadni, használja az általános „Document.Partner” mezőt. Megjegyzés: Általános szabály, hogy a B2B számlákon mindig fel kell tüntetni a címeket („documentType”: „[1] = Invoice”).
	addressType	O/M*	Az ezen a szinten meghatározott „addressType” tulajdonság határozza meg a „Document.Partner.Addresses” alatt megadott cím típusát. A következő címtípusok állnak rendelkezésre: [1] = BillingAddress, [2] = Szállítási cím, [3] = Lakcím, [4] = CompanyLocation, [5] = Szolgáltatásnyújtási hely Országra vonatkozó információk: Portugália: A címtípusok meghatározása a portugáliai B2B számlák esetében: [1] = BillingAddress – Kötelező, [2] = DeliveryAddress – Opcionális
	utca	O/M*	Utca Országadatok: Portugália: Kötelező mező Québec: Kötelező mező, ha „partner” (ügyfél) van megadva. Revenu Québec csak a kanadai ügyfelekre vonatkozó információkat támogatja.
	streetNumber	O/M*	Házszám Országadatok: Portugália: Kötelező mező Québec: Kötelező mező, ha „partner” (ügyfél) van megadva. A Revenu Québec csak a kanadai ügyfelekre vonatkozó információkat támogatja.
	PostalCode	O/M*	Irányítószám Országadatok: Portugália: Kötelező mező Québec: Kötelező mező, ha „partner” (ügyfél) van megadva. Revenu Québec csak a kanadai ügyfelekre vonatkozó információkat támogatja. Az irányítószámnak kanadai formátumban kell szerepelnie: A9A9A9 6 karakter 1 karakter (betű), 1 szám, 1 karakter (betű), 1 szám, 1 karakter (betű), 1 szám.
	város	O/M*	Város / település Országadatok: Portugália: Kötelező mező Québec: Kötelező mező, ha „partner” (ügyfél) van megadva. A Revenu Québec csak a kanadai ügyfelekre vonatkozó információkat támogatja.
	közösség	O	Egyes országokban (pl. Szlovénia) az úgynevezett „közösség” a cím része.
	CountryCode	O/M*	Országkód az ISO 3166 alfa-3 szabvány szerint (3 számjegyű). Országadatok: Portugália: Kötelező mező
addressType		O/M*	Az ezen a szinten beállított „addressType” tulajdonság határozza meg a „Document.Partner” alatt megadott cím típusát. Ha több különböző címet kell megadnia különböző címtípusokkal, azt a „Document.Partner.Addresses” alatt teheti meg. A következő címtípusok állnak rendelkezésre: [1] = BillingAddress, [2] = Szállítási cím, [3] = Lakcím, [4] = CompanyLocation, [5] = Szolgáltatásnyújtási cím Országadatok: Portugália: A címtípusok megadása a portugál B2B számlákon: [1] = BillingAddress – Kötelező, [2] = DeliveryAddress – opcionális
utca		O/M*	Utca Országadatok: Portugália: Kötelező mező Québec: Kötelező mező, ha „partner” (ügyfél) van megadva. Revenu Québec csak a kanadai ügyfelekre vonatkozó információkat támogatja.
streetNumber		O/M*	Házszám Országadatok: Portugália: Kötelező mező Québec: Kötelező mező, ha „partner” (ügyfél) van megadva. A Revenu Québec csak a kanadai ügyfelekre vonatkozó információkat támogatja.
PostalCode		O/M*	Irányítószám Országadatok: Portugália: Kötelező mező Québec: Kötelező mező, ha „partner” (ügyfél) van megadva. Revenu Québec csak kanadai ügyfelekre vonatkozó információkat támogat. Az irányítószámnak kanadai formátumban kell lennie: A9A9A9 6 karakter 1 karakter (betű), 1 szám, 1 karakter (betű), 1 szám, 1 karakter (betű), 1 szám.
város		O/M*	Város Országadatok: Portugália: Kötelező mező Québec: Kötelező mező, ha „partner” (ügyfél) van megadva. A Revenu Québec csak a kanadai ügyfelekre vonatkozó információkat támogatja.
közösség		O	Egyes országokban (pl. Szlovénia) az úgynevezett „közösség” a cím része.
CountryCode		O/M*	Országkód az ISO 3166 alfa-3 szabvány szerint (3 számjegyű). Országadatok: Portugália: Kötelező mező

Ezt a cikket automatikusan lefordították.

partner-objektum

Kapcsolódó cikkek