Obiekt partnera „partner” – RetailForce

Niniejszy artykuł dotyczy obiektu partnera w ramach obiektu Document.

Pełny opis modelu obiektowego dokumentu (RetailForce DOM) RetailForce, a także opis poszczególnych elementów, można znaleźć w sekcji plików do pobrania na RetailForce website (dokumentacja modelu obiektowego.pdf) w odpowiednim katalogu wersji.

Obiekt „partner” zawiera informacje dotyczące poszczególnych partnerów (biznesowych) firmy wystawiającej dokument. Mogą to być na przykład partnerzy zewnętrzni, tacy jak klienci lub dostawcy, ale także „klienci” wewnętrzni, tacy jak konkretny oddział firmy, do którego wysyłane są towary.

Obiekt „partner”

Poniższy obiekt „partner” zawiera przykładowe dane.

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

Obiekt partner zawiera następujące informacje.

Informacje w kolumnie „Typ”:

M … obowiązkowe / wymagane
M* ... obowiązkowe / wymagane w niektórych krajach lub pod pewnymi warunkami
R … zalecane
O... opcjonalne

Elementy		Typ	Opis
ID		M	ID partnera. Może to być np. numer klienta / ID.
caption		O	Nazwa partnera (np. imię i nazwisko, nazwa firmy).
IsBusiness		M*	Wskazuje, czy transakcja jest transakcja B2B (true) czy transakcja B2C (fałsz). Szczegóły dotyczące kraju: Francja: Informacje obowiązkowe Portugalia: Informacje obowiązkowe Québec/Kanada: Informacje obowiązkowe
PartnerType		M*	Typ / rodzaj partnera (biznesowego) (enum). Obecnie: [0] = Klient [1] = Dostawca Szczegóły dotyczące kraju: Portugalia: Informacje obowiązkowe
PartnerClassification		O	Klasyfikacja partnera (nie PartnerType!).
VatNumber		M*	Numer ID VAT partnera (wymagany w przypadku transakcji B2B).
taxNumber		O	Numer podatkowy partnera, np. „numer podatkowy firmy” (NIE jest to numer Vat!)
IdentificationType		M*	sposób, w jaki potwierdzono tożsamość partnera. Lista enum PartnerIdentificationType: OfficialDocument Inne Passport Zaświadczenie o miejscu zamieszkania
PartnerIdentification		M*	Dane identyfikacyjne partnera – jeśli ta opcja jest ustawiona, należy również ustawić właściwość IdentificationType.
AdditionalIdentifications		O	Dodatkowe funkcje ID do różnych celów.
	lotteryId	O	Osobisty ID loteryjny klienta we Włoszech. Jest wymagany do udziału w tzw. loterii odroczonej („Lotteria Differita”) w ramach „Lotteria degli Scontrini” („Loteria paragonów”). Szczegóły dotyczące kraju: Włochy: Jeśli klient pragnie wziąć udział w Lotterii Differita, w tym polu należy wprowadzić jego osobisty ID.
	additionalProp1	O	Dodatkowe funkcje ID do różnych celów.
	additionalProp2	O	Dodatkowe funkcje ID do różnych celów.
	additionalProp3	O	Dodatkowe funkcje ID do różnych celów.
adresy		O/M*	Umożliwia wprowadzenie wielu / dodatkowych adresów. Jeśli ma zostać podany tylko jeden adres, należy skorzystać z pola ogólnego „Document.Partner”. Uwaga: Zasadniczo adresy muszą zawsze znajdować się na fakturach B2B („documentType”: „[1] = Invoice”).
	addressType	O/M*	Właściwość „addressType” zdefiniowana na tym poziomie określa typ adresu wprowadzonego w polu „Document.Partner.Addresses”. Dostępne są następujące typy adresów: [1] = BillingAddress, [2] = Adres dostawy, [3] = ResidentialAddress, [4] = Siedziba firmy, [5] = ŚwiadczonaUsługa Informacje o kraju: Portugalia: Określenie typów adresów dla faktur B2B w Portugalii: [1] = BillingAddress – obowiązkowe, [2] = DeliveryAddress – opcjonalne
	ulica	O/M*	Ulica Dane dotyczące kraju: Portugalia: Pole obowiązkowe Québec: Pole obowiązkowe w przypadku wskazania „partnera” (klienta). Revenu Québec obsługuje wyłącznie informacje dotyczące klientów kanadyjskich.
	streetNumber	O/M*	Numer domu Dane dotyczące kraju: Portugalia: Pole obowiązkowe Québec: Pole obowiązkowe w przypadku wskazania „partnera” (klienta). Revenu Québec obsługuje wyłącznie informacje dotyczące klientów kanadyjskich.
	PostalCode	O/M*	Kod pocztowy Dane dotyczące kraju: Portugalia: Pole obowiązkowe Québec: Pole obowiązkowe w przypadku wskazania „partnera” (klienta). Revenu Québec obsługuje wyłącznie informacje dotyczące klientów kanadyjskich. Kod pocztowy musi być podany w formacie kanadyjskim: A9A9A9 6 znaków 1 znak (litera), 1 cyfra, 1 znak (litera), 1 cyfra, 1 znak (litera), 1 cyfra.
	miasto	O/M*	Miasto / Miejscowość Dane dotyczące kraju: Portugalia: Pole obowiązkowe Québec: Pole obowiązkowe, jeśli wskazano „partnera” (klienta). Revenu Québec obsługuje wyłącznie informacje dotyczące klientów kanadyjskich.
	społeczność	O	W niektórych krajach (np. w Słowenii) tzw. „gmina” stanowi część adresu.
	CountryCode	O/M*	Kod kraju zgodnie z normą ISO 3166 alpha-3 (3 cyfry). Szczegóły dotyczące kraju: Portugalia: Pole obowiązkowe
addressType		O/M*	Właściwość „addressType” ustawiona na tym poziomie określa typ adresu wprowadzonego w sekcji „Document.Partner”. Jeśli konieczne jest podanie kilku różnych adresów o różnych typach, można to zrobić w sekcji „Document.Partner.Addresses”. Dostępne są następujące typy adresów: [1] = BillingAddress, [2] = Adres dostawy, [3] = ResidentialAddress, [4] = Siedziba firmy, [5] = usługa-wykonana Szczegóły dotyczące kraju: Portugalia: Określanie typów adresów na fakturach B2B w Portugalii: [1] = BillingAddress – obowiązkowe, [2] = Adres dostawy – opcjonalne
ulica		O/M*	Ulica Dane dotyczące kraju: Portugalia: Pole obowiązkowe Québec: Pole obowiązkowe w przypadku wskazania „partnera” (klienta). Revenu Québec obsługuje wyłącznie informacje dotyczące klientów kanadyjskich.
streetNumber		O/M*	Numer domu Dane dotyczące kraju: Portugalia: Pole obowiązkowe Québec: Pole obowiązkowe w przypadku wskazania „partnera” (klienta). Revenu Québec obsługuje wyłącznie informacje dotyczące klientów kanadyjskich.
PostalCode		O/M*	Kod pocztowy Dane dotyczące kraju: Portugalia: Pole obowiązkowe Québec: Pole obowiązkowe w przypadku wskazania „partnera” (klienta). Revenu Québec obsługuje wyłącznie informacje dotyczące klientów kanadyjskich. Kod pocztowy musi być podany w formacie kanadyjskim: A9A9A9 6 znaków 1 znak (litera), 1 cyfra, 1 znak (litera), 1 cyfra, 1 znak (litera), 1 cyfra.
miasto		O/M*	Miasto / Miejscowość Dane dotyczące kraju: Portugalia: Pole obowiązkowe Québec: Pole obowiązkowe, jeśli wskazano „partnera” (klienta). Revenu Québec obsługuje wyłącznie informacje dotyczące klientów kanadyjskich.
społeczność		O	W niektórych krajach (np. w Słowenii) tzw. „gmina” stanowi część adresu.
CountryCode		O/M*	Kod kraju zgodnie z normą ISO 3166 alpha-3 (3 cyfry). Szczegóły dotyczące kraju: Portugalia: Pole obowiązkowe

Ten artykuł został przetłumaczony automatycznie.

Obiekt „partner”

Powiązane artykuły