Objekt partnera „partner“ – RetailForce

Tento článek se zabývá objektem partner v rámci objektu Document.

Úplný popis DOM (Document Object Model) systému RetailForce, stejně jako popis jednotlivých prvků, naleznete v sekci ke stažení na webových stránkách RetailForce (Object model documentation.pdf) v příslušném adresáři s verzemi.

Objekt „partner“ obsahuje informace o příslušných (obchodních) partnerech společnosti vystavující dokument. Může se jednat například o externí partnery, jako jsou zákazníci nebo dodavatelé, ale také o interní „zákazníky“, jako je konkrétní pobočka společnosti, kam je zboží zasíláno.

partner-object

Následující objekt partner obsahuje ukázková data.

"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 následující informace.

Informace ve sloupci „Typ“:

M ... povinné / vyžadované
M* ... povinné / vyžadované v určitých zemích nebo za určitých podmínek
R ... doporučeno
O... volitelné

Prvky		Typ	Popis
id		M	ID partnera. Může to být např. číslo zákazníka / ID.
caption		O/M*	Označení partnerů (např. jméno, název společnosti). Údaje o zemi: Portugalsko: Povinné údaje
IsBusiness		M*	Uvádí, zda se jedná o transakce typu B2B (true) nebo transakce typu B2C (false). Údaje o zemi: Francie: Povinné údaje Portugalsko: Povinné údaje Québec/Kanada: Povinné údaje
partnerType		M*	Typ / druh (obchodního) partnera (výčet). Aktuálně: [0] = Zákazník [1] = Dodavatel Údaje o zemi: Portugalsko: Povinné údaje
PartnerClassification		O	Klasifikace partnera (nikoli PartnerType!).
vatNumber		M*	DIČ partnera (může být vyžadováno u některých transakcí B2B v závislosti na platných pravidlech pro DPH). Údaje o zemi: Portugalsko: Obchodní partner (IsBusiness = true) musí mít vatNumber nebo taxNumber. Pokud se kód země fakturační adresy partnera liší od země pokladny, je vatNumber povinné.
taxNumber		O	Daňové číslo partnera, např. „daňové číslo společnosti“ (NE DIČ!)
companyIdentification		O	Další identifikační údaje o zákazníkovi (B2B) pro různé účely.
	type	O	Definuje typ atributu ID. Možné hodnoty: [0] = VatNumber, [1] = daňové číslo, [2] = GlnNumber, [3] = identifikační číslo podniku, [4] = statistická klasifikace, [5] = číslo v obchodním rejstříku, [6] = Úřad pro evidenci v obchodním rejstříku, [7] = číslo v obchodním rejstříku, [8] = číslo daňového úřadu, [9] = číslo pro účely daně z přidané hodnoty, [10] = číslo QST, [11] = kód ERouting, [12] = identifikační kód sídla Význam jednotlivých prvků najdete v článku „Identifikace společnosti“. Údaje o jednotlivých zemích: Francie: Typ [12] = LocationIdentification se používá k zadání čísla SIRET zákazníka nebo partnera.
	identifikace	O	Definuje skutečnou hodnotu atributu ID (např. číslo SIRET ve Francii, je-li zadán typ [12] = LocationIdentification).
IdentificationType		M*	způsob, jakým byla ověřena totožnost partnera. Výčtový typ PartnerIdentificationType: OfficialDocument Ostatní Cestovní pas Potvrzení o trvalém pobytu
PartnerIdentification		M*	Identifikace partnera – pokud je nastaveno, musí být nastaveno také vlastnost IdentificationType.
AdditionalIdentifications		O	Další identifikační prvky pro různé účely.
	lotteryId	O	Osobní loterijní identifikační číslo zákazníka v Itálii. Je nutné pro účast v tzv. odložené loterii („Lotteria Differita“) v rámci loterie „Lotteria degli Scontrini“ („Loterie účtenek“). Údaje o zemi: Itálie: Pokud se zákazník chce zúčastnit loterie Lotteria Differita, je nutné do tohoto pole zadat jeho osobní identifikační číslo.
	additionalProp1	O	Další funkce ID pro různé účely.
	additionalProp2	O	Další funkce ID pro různé účely.
	additionalProp3	O	Další funkce ID pro různé účely.
adresy		O/M*	Umožňuje zadání více / dalších adres. Pokud má být uvedena pouze jedna adresa, použijte obecné pole „Document.Partner“. Poznámka: Obecně platí, že adresy musí být vždy uvedeny na fakturách B2B („DocumentType“: „[1] = Invoice“).
	addressType	O/M*	Vlastnost „AddressType“ definovaná na této úrovni určuje typ adresy zadané v poli „Document.Partner.Addresses“. K dispozici jsou následující typy adres: [1] = BillingAddress, [2] = DeliveryAddress, [3] = ResidentialAddress, [4] = CompanyLocation, [5] = poskytnutá služba Informace o zemi: Portugalsko: Specifikace typů adres pro faktury B2B v Portugalsku: [1] = Fakturační adresa – povinné, [2] = DeliveryAddress – nepovinné
	ulice	O/M*	Ulice Údaje o zemi: Portugalsko: Povinné pole Québec: Povinné pole, pokud je zadán „partner“ (zákazník). Revenu Québec podporuje pouze informace o kanadských zákaznících.
	číslo ulice	O/M*	Číslo domu Údaje o zemi: Portugalsko: Povinné pole Québec: Povinné pole, pokud je uveden „partner“ (zákazník). Revenu Québec podporuje pouze informace o kanadských zákaznících.
	PostalCode	O/M*	PSČ Údaje o zemi: Portugalsko: Povinné pole Québec: Povinné pole, pokud je zadán „partner“ (zákazník). Revenu Québec podporuje pouze informace o kanadských zákaznících. PSČ musí být v kanadském formátu: A9A9A9 6 znaků 1 znak (písmeno), 1 číslice, 1 znak (písmeno), 1 číslice, 1 znak (písmeno), 1 číslice.
	město	O/M*	Město / obec Údaje o zemi: Portugalsko: Povinné pole Québec: Povinné pole, pokud je uveden „partner“ (zákazník). Revenu Québec podporuje pouze informace o kanadských zákaznících.
	obec	O	V některých zemích (např. ve Slovinsku) je součástí adresy tzv. „obec“.
	CountryCode	O/M*	Kód země podle normy ISO 3166 alfa-3 (3 číslice). Údaje o zemi: Portugalsko: Povinné pole
addressType		O/M*	Vlastnost „AddressType“ nastavená na této úrovni definuje typ adresy zadané v „Document.Partner“. Pokud potřebujete zadat několik různých adres s různými typy adres, můžete tak učinit v části „Document.Partner.Addresses“. K dispozici jsou následující typy adres: [1] = BillingAddress, [2] = DeliveryAddress, [3] = ResidentialAddress, [4] = CompanyLocation, [5] = poskytnutá služba Údaje o zemi: Portugalsko: Specifikace typů adres na B2B fakturách v Portugalsku: [1] = Fakturační adresa – povinné, [2] = DeliveryAddress – nepovinné
ulice		O/M*	Ulice Údaje o zemi: Portugalsko: Povinné pole Québec: Povinné pole, pokud je zadán „partner“ (zákazník). Revenu Québec podporuje pouze informace o kanadských zákaznících.
číslo ulice		O/M*	Číslo domu Údaje o zemi: Portugalsko: Povinné pole Québec: Povinné pole, pokud je uveden „partner“ (zákazník). Revenu Québec podporuje pouze informace o kanadských zákaznících.
PostalCode		O/M*	PSČ Údaje o zemi: Portugalsko: Povinné pole Québec: Povinné pole, pokud je zadán „partner“ (zákazník). Revenu Québec podporuje pouze informace o kanadských zákaznících. PSČ musí být v kanadském formátu: A9A9A9 6 znaků 1 znak (písmeno), 1 číslice, 1 znak (písmeno), 1 číslice, 1 znak (písmeno), 1 číslice.
město		O/M*	Město / obec Údaje o zemi: Portugalsko: Povinné pole Québec: Povinné pole, pokud je uveden „partner“ (zákazník). Revenu Québec podporuje pouze informace o kanadských zákaznících.
obec		O	V některých zemích (např. ve Slovinsku) je součástí adresy tzv. „obec“.
CountryCode		O/M*	Kód země podle normy ISO 3166 alfa-3 (3 číslice). Údaje o zemi: Portugalsko: Povinné pole

Tento článek byl přeložen automaticky.

partner-object

Související články