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 partner 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 „Typ“:
- 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/M* |
Označenie partnerov (napr. meno, názov spoločnosti). Údaje o krajine:
|
|
| IsBusiness | M* |
Uvádza, či ide o
Údaje o krajine:
|
|
| PartnerType | M* |
Typ / druh (obchodného) partnera (enum). V súčasnosti:
Údaje o krajine:
|
|
| PartnerClassification | O | Klasifikácia partnera (nie PartnerType!). | |
| VatNumber | M* |
ID partnera (môže byť vyžadované pri určitých transakciách B2B v závislosti od platných pravidiel týkajúcich sa DPH). Údaje o krajine:
|
|
| 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:
Významy jednotlivých prvkov nájdete v článku „Identifikácia spoločnosti“. Údaje o krajine:
|
|
| 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:
|
|
| 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 účteniek“). Informácie o krajine:
|
|
| 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:
Informácie o krajine:
|
|
| ulica | O/M* |
Ulica Údaje o krajine:
|
|
| streetNumber | O/M* |
Číslo ulice Údaje o krajine:
|
|
| PostalCode | O/M* |
PSČ Údaje o krajine:
|
|
| mesto | O/M* |
Mesto / Obec Údaje o krajine:
|
|
| 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:
|
|
| 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:
Údaje o krajine:
|
|
| ulica | O/M* |
Ulica Údaje o krajine:
|
|
| streetNumber | O/M* |
Číslo ulice Údaje o krajine:
|
|
| PostalCode | O/M* |
PSČ Údaje o krajine:
|
|
| mesto | O/M* |
Mesto / Obec Údaje o krajine:
|
|
| 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:
|
|
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.