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 vystavujúcej dokument. 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,
  "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 obsahuje nasledujúce informácie.

Informácie v stĺpci „Type“:

M ... povinné / vyžadované
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 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Č!)
companyIdentification		O	Ďalšie identifikačné údaje zákazníka (B2B) na rôzne účely.
	type	O	Určuje typ atribútu ID. Možné hodnoty: [0] = VatNumber, [1] = taxNumber, [2] = GlnNumber, [3] = identifikačné číslo podniku, [4] = štatistická klasifikácia, [5] = číslo v obchodnom registri, [6] = úrad, ktorý vydal číslo v obchodnom registri, [7] = číslo v obchodnom registri, [8] = Číslo daňového úradu, [9] = Číslo pre daň z tovarov a služieb, [10] = číslo QST, [11] = kód smerovania ER, [12] = Identifikačný kód sídla Významy jednotlivých prvkov nájdete v článku „Identifikácia spoločnosti“. Údaje o krajine: Francúzsko: Typ [12] = LocationIdentification sa používa na špecifikovanie čísla SIRET zákazníka alebo partnera.
	identifikácia	O	Definuje skutočnú hodnotu atribútu ID (napr. číslo SIRET vo Francúzsku, ak je špecifikovaný typ [12] = LocationIdentification).
IdentificationType		M*	spôsob, akým bola potvrdená identita 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 pokladničných blokov“). Informácie o krajine: Taliansko: Ak sa zákazník chce zúčastniť na 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	Dodatočné 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 položke „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. „komunita“.
	CountryCode	O/M*	Kód krajiny podľa 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ť niekoľko 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. „komunita“.
CountryCode		O/M*	Kód krajiny podľa normy ISO 3166 alpha-3 (3-miestny). Údaje o krajine: Portugalsko: Povinné pole

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

partner-object

Podobné články