Партньорски обект „partner“ – RetailForce

Настоящата статия разглежда обекта „partner“ в рамките на обекта „Document“.

Пълно описание на RetailForce DOM (Document Object Model), както и описание на отделните елементи, можете да намерите в раздела за изтегляне на RetailForce website (Object model documentation.pdf) в съответната директория с версии.

Обектът „partner“ съдържа информация за съответните (бизнес) партньори на компанията, издала документа. Това могат да бъдат, например, външни партньори като клиенти или доставчици, но също и вътрешни „клиенти“, като конкретен клон на компанията, към който се изпращат стоките.

partner-object

Следващият обект „партньор“ съдържа примерни данни.

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

Обектът „partner“ съдържа следната информация.

Информация в колоната „Тип“:

M ... задължително / изисквано
M* ... задължително / изисквано в определени държави или при определени условия
R ... препоръчително
O... по избор

Елементи		Тип	Описание
ID		M	ID на партньора. Може да бъде например номерът на клиента / ID-то.
caption		O	Наименование на партньорите (например име, фирмено наименование).
IsBusiness		M*	Показва дали транзакцията е B2B транзакция (true) или B2C транзакция (false). Данни за държавата: Франция: Задължителна информация Португалия: Задължителна информация Québec/Канада: Задължителна информация
PartnerType		M*	Тип/вид (бизнес) партньор (enum). Понастоящем: [0] = Клиент [1] = Доставчик Данни за държавата: Португалия: Задължителна информация
PartnerClassification		O	Класификация на партньора (не PartnerType!).
VatNumber		M*	Vat ID на партньора (необходим за B2B транзакции).
taxNumber		O	Данъчен номер на партньора, например „данъчен номер на дружеството“ (НЕ номерът по Vat!)
IdentificationType		M*	по какъв начин е потвърдена самоличността на партньора. Enum PartnerIdentificationType: OfficialDocument Друго Passport Удостоверение за местоживеене
PartnerIdentification		M*	Идентификация на партньора – ако е зададена, трябва да бъде зададен и атрибутът IdentificationType.
AdditionalIdentifications		O	Допълнителни ID характеристики за различни цели.
	lotteryId	O	Личен лотарен ID на клиент в Италия. Необходим е за участие в т.нар. отложена лотария („Lotteria Differita“) на „Lotteria degli Scontrini“ („Лотария на касовите бележки“). Данни за страната: Италия: Ако клиент желае да участва в „Lotteria Differita“, в това поле трябва да бъде въведен неговият личен ID.
	additionalProp1	O	Допълнителни функции на ID-то за различни цели.
	additionalProp2	O	Допълнителни функции за ID за различни цели.
	additionalProp3	O	Допълнителни функции за ID за различни цели.
адреси		O/M*	Позволява въвеждането на няколко / допълнителни адреса. Ако трябва да се посочи само един адрес, използвайте общото поле „Document.Partner“. Забележка: Като общо правило адресите трябва винаги да бъдат включени във фактурите B2B („documentType“: „[1] = Invoice“).
	addressType	O/M*	Свойството „addressType“, дефинирано на това ниво, определя типа на адреса, въведен в „Document.Partner.Addresses“. Налични са следните типове адреси: [1] = BillingAddress, [2] = Адрес за доставка, [3] = ResidentialAddress, [4] = Местоположение на фирмата, [5] = ServiceRendered Информация за държавата: Португалия: Спецификация на типовете адреси за B2B фактури в Португалия: [1] = BillingAddress – задължително, [2] = DeliveryAddress – Незадължително
	улица	O/M*	Улица Данни за държавата: Португалия: Задължително поле Québec: Задължително поле, ако е посочен „партньор“ (клиент). Revenu Québec поддържа само информация за канадски клиенти.
	streetNumber	O/M*	Номер на улицата Данни за държавата: Португалия: Задължително поле Québec: Задължително поле, ако е посочен „партньор“ (клиент). Revenu Québec поддържа само информация за канадски клиенти.
	PostalCode	O/M*	Пощенски код Данни за държавата: Португалия: Задължително поле Québec: Задължително поле, ако е посочен „партньор“ (клиент). Revenu Québec поддържа само информация за канадски клиенти. Пощенският код трябва да бъде в канадски формат: A9A9A9 6 символа 1 символ (буква), 1 цифра, 1 символ (буква), 1 цифра, 1 символ (буква), 1 цифра.
	град	O/M*	Град / Село Данни за държавата: Португалия: Задължително поле Québec: Задължително поле, ако е посочен „партньор“ (клиент). Revenu Québec поддържа само информация за канадски клиенти.
	общност	O	В някои държави (например Словения) т.нар. „община“ е част от адреса.
	CountryCode	O/M*	Код на държавата съгласно ISO 3166 алфа-3 (3 цифри). Подробности за държавата: Португалия: Задължително поле
addressType		O/M*	Свойството „addressType“, зададено на това ниво, определя типа на адреса, въведен в „Document.Partner“. Ако трябва да посочите няколко различни адреса с различни типове адреси, можете да го направите в „Document.Partner.Addresses“. Налични са следните типове адреси: [1] = BillingAddress, [2] = Адрес за доставка, [3] = ResidentialAddress, [4] = CompanyLocation, [5] = ServiceRendered Данни за държавата: Португалия: Посочване на видовете адреси във фактурите B2B в Португалия: [1] = BillingAddress – задължително, [2] = DeliveryAddress – Незадължително
улица		O/M*	Улица Данни за държавата: Португалия: Задължително поле Québec: Задължително поле, ако е посочен „партньор“ (клиент). Revenu Québec поддържа само информация за канадски клиенти.
streetNumber		O/M*	Номер на улицата Данни за държавата: Португалия: Задължително поле Québec: Задължително поле, ако е посочен „партньор“ (клиент). Revenu Québec поддържа само информация за канадски клиенти.
PostalCode		O/M*	Пощенски код Данни за държавата: Португалия: Задължително поле Québec: Задължително поле, ако е посочен „партньор“ (клиент). Revenu Québec поддържа само информация за канадски клиенти. Пощенският код трябва да бъде в канадски формат: A9A9A9 6 символа 1 символ (буква), 1 цифра, 1 символ (буква), 1 цифра, 1 символ (буква), 1 цифра.
град		O/M*	Град / Село Данни за държавата: Португалия: Задължително поле Québec: Задължително поле, ако е посочен „партньор“ (клиент). Revenu Québec поддържа само информация за канадски клиенти.
общност		O	В някои държави (например Словения) т.нар. „община“ е част от адреса.
CountryCode		O/M*	Код на държавата съгласно ISO 3166 алфа-3 (3 цифри). Подробности за държавата: Португалия: Задължително поле

Тази статия е преведена автоматично.

partner-object

Подобни статии