Partner-objekt „partner“ – RetailForce

Tento článok sa zaoberá objektom partner v rámci objektu Document.

Úplný popis RetailForce DOM (Document Object Model), ako aj popis jednotlivých prvkov, nájdete v sekcii na stiahnutie na RetailForce website (Object model documentation.pdf) v príslušnom adresári verzií.

Objekt „partner“ obsahuje informácie o príslušných (obchodných) partneroch spoločnosti, ktorá dokument vystavila. Môžu to byť napríklad externí partneri, ako sú zákazníci alebo dodávatelia, ale aj interní „zákazníci“, ako je konkrétna pobočka spoločnosti, do ktorej sa tovar odosiela.

partner-object

Nasledujúci objekt partnera obsahuje vzorové údaje.

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

Objekt partner obsahuje nasledujúce informácie.

Informácie v stĺpci „Type“:

M ... povinné / nevyhnutné
M* ... povinné / vyžadované v určitých krajinách alebo za určitých podmienok
R ... odporúčané
O... voliteľné

Prvky		Typ	Popis
ID		M	ID partnera. Môže to byť napr. číslo zákazníka / ID.
caption		O	Označenie partnerov (napr. meno, názov spoločnosti).
IsBusiness		M*	Uvádza, či ide o transakcia typu B2B (true) alebo transakcia typu B2C (false). Údaje o krajine: Francúzsko: Povinné informácie Portugalsko: Povinné informácie Québec/Kanada: Povinné informácie
PartnerType		M*	Typ / druh (obchodného) partnera (enum). V súčasnosti: [0] = Zákazník [1] = Dodávateľ Údaje o krajine: Portugalsko: Povinné informácie
PartnerClassification		O	Klasifikácia partnera (nie PartnerType!).
VatNumber		M*	ID partnera (potrebné pre transakcie B2B).
taxNumber		O	Daňové číslo partnera, napr. „daňové číslo spoločnosti“ (NIE je to DIČ!)
IdentificationType		M*	spôsob, akým bola overená totožnosť partnera. Enum PartnerIdentificationType: OfficialDocument Iné Passport Potvrdenie o trvalom pobyte
PartnerIdentification		M*	Identifikácia partnera – ak je nastavená, musí byť nastavená aj vlastnosť IdentificationType.
AdditionalIdentifications		O	Ďalšie ID na rôzne účely.
	lotteryId	O	Osobné ID zákazníka v Taliansku pre účasť v lotérii. Je potrebné na účasť v tzv. odloženej lotérii („Lotteria Differita“) v rámci lotérie „Lotteria degli Scontrini“ („Lotéria z pokladničných blokov“). Informácie o krajine: Taliansko: Ak sa zákazník chce zúčastniť lotérie Lotteria Differita, do tohto poľa je potrebné zadať jeho osobné ID.
	additionalProp1	O	Ďalšie funkcie ID na rôzne účely.
	additionalProp2	O	Ďalšie funkcie ID na rôzne účely.
	additionalProp3	O	Ďalšie funkcie ID na rôzne účely.
adresy		O/M*	Umožňuje zadanie viacerých / dodatočných adries. Ak sa má uviesť len jedna adresa, použite všeobecné pole „Document.Partner“. Poznámka: Spravidla musia byť adresy vždy uvedené na faktúrach B2B („documentType“: „[1] = Invoice“).
	addressType	O/M*	Vlastnosť „addressType“ definovaná na tejto úrovni určuje typ adresy zadaný v poli „Document.Partner.Addresses“. K dispozícii sú nasledujúce typy adries: [1] = BillingAddress, [2] = Doručovacia adresa, [3] = ResidentialAddress, [4] = Sídlo spoločnosti, [5] = poskytnutá služba Informácie o krajine: Portugalsko: Špecifikácia typov adries pre faktúry B2B v Portugalsku: [1] = BillingAddress – povinné, [2] = DeliveryAddress – nepovinné
	ulica	O/M*	Ulica Údaje o krajine: Portugalsko: Povinné pole Québec: Povinné pole, ak je uvedený „partner“ (zákazník). Revenu Québec podporuje iba informácie o kanadských zákazníkoch.
	streetNumber	O/M*	Číslo ulice Údaje o krajine: Portugalsko: Povinné pole Québec: Povinné pole, ak je uvedený „partner“ (zákazník). Revenu Québec podporuje iba informácie o kanadských zákazníkoch.
	PostalCode	O/M*	PSČ Údaje o krajine: Portugalsko: Povinné pole Québec: Povinné pole, ak je uvedený „partner“ (zákazník). Revenu Québec podporuje iba informácie o kanadských zákazníkoch. PSČ musí byť v kanadskom formáte: A9A9A9 6 znakov 1 znak (písmeno), 1 číslica, 1 znak (písmeno), 1 číslica, 1 znak (písmeno), 1 číslica.
	mesto	O/M*	Mesto / Obec Údaje o krajine: Portugalsko: Povinné pole Québec: Povinné pole, ak je uvedený „partner“ (zákazník). Revenu Québec podporuje iba informácie o kanadských zákazníkoch.
	komunita	O	V niektorých krajinách (napr. v Slovinsku) je súčasťou adresy tzv. „obec“.
	CountryCode	O/M*	Kód krajiny podľa normy ISO 3166 alfa-3 (3-miestny). Údaje o krajine: Portugalsko: Povinné pole
addressType		O/M*	Vlastnosť „addressType“ nastavená na tejto úrovni definuje typ adresy zadaný v „Document.Partner“. Ak potrebujete špecifikovať viacero rôznych adries s rôznymi typmi adries, môžete tak urobiť v „Document.Partner.Addresses“. K dispozícii sú nasledujúce typy adries: [1] = BillingAddress, [2] = DeliveryAddress, [3] = ResidentialAddress, [4] = CompanyLocation, [5] = poskytnutá služba Údaje o krajine: Portugalsko: Špecifikácia typov adries na faktúrach B2B v Portugalsku: [1] = BillingAddress – povinné, [2] = DeliveryAddress – nepovinné
ulica		O/M*	Ulica Údaje o krajine: Portugalsko: Povinné pole Québec: Povinné pole, ak je uvedený „partner“ (zákazník). Revenu Québec podporuje iba informácie o kanadských zákazníkoch.
streetNumber		O/M*	Číslo ulice Údaje o krajine: Portugalsko: Povinné pole Québec: Povinné pole, ak je uvedený „partner“ (zákazník). Revenu Québec podporuje iba informácie o kanadských zákazníkoch.
PostalCode		O/M*	PSČ Údaje o krajine: Portugalsko: Povinné pole Québec: Povinné pole, ak je uvedený „partner“ (zákazník). Revenu Québec podporuje iba informácie o kanadských zákazníkoch. PSČ musí byť v kanadskom formáte: A9A9A9 6 znakov 1 znak (písmeno), 1 číslica, 1 znak (písmeno), 1 číslica, 1 znak (písmeno), 1 číslica.
mesto		O/M*	Mesto / Obec Údaje o krajine: Portugalsko: Povinné pole Québec: Povinné pole, ak je uvedený „partner“ (zákazník). Revenu Québec podporuje iba informácie o kanadských zákazníkoch.
komunita		O	V niektorých krajinách (napr. v Slovinsku) je súčasťou adresy tzv. „obec“.
CountryCode		O/M*	Kód krajiny podľa normy ISO 3166 alfa-3 (3-miestny). Údaje o krajine: Portugalsko: Povinné pole

Tento článok bol preložený automaticky.

partner-object

Podobné články