Платежен обект „payments“ – RetailForce

Настоящата статия се отнася до обекта „Плащане“ („payments“) в рамките на обекта „Документ“.

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

Обектът „плащане“ може, разбира се, да съдържа няколко различни плащания (= различни начини на плащане – PaymentType) за един и същ ваучер.

обект „плащания“

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

"payments": [
    {
      "amount": 120.00,
      "currencyIsoCode": "EUR",
      "caption": "BAR",
      "uniqueReadablePaymentIdentifier": "BARZAHLUNG",
      "foreignAmount": 0,
      "foreignAmountExchangeRate": 0,
      "additionalFields": {
        "voucherId": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "paymentType": "cash",
      "createDate": "2023-04-25T15:08:11.57+01:00",
      "vatIdentification": 1,
      "vatPercent": 20,
      "vatPercent2": 10,
      "taxValue": 20.00,
      "taxValue2": 10.00,
      "externalIdentifier": [
        "string"
      ],
      "user": {
        "id": "user01",
        "caption": "user01",
        "firstName": "Manuela",
        "lastName": "Musterfrau",
        "taxNumber": "123456789"
      },
      "salesPerson": {
        "id": "VK01",
        "caption": "Franz",
        "firstName": "Franz",
        "lastName": "Österreicher",
        "taxNumber": "234567890"
      },
      "paymentTerminalReferenceId": "string",
      "cardData": {
        "receiptCopyCount": 2,
        "receipt": ["line1", "line2"],
        "cardNumberMasked": "****1234",
        "identificationToken": "token123",
        "merchantCopyCount": 1,
        "merchantReceipt": ["merchant line1"],
        "cardType": "VISA",
        "authorizationCode": "AUTH123",
        "terminalId": "TERM001",
        "merchantId": "MERCH001",
        "transactionId": "TRX123456",
        "providerSignature": "signature_string",
        "providerTransactionId": "PROV_TRX_001",
        "providerSignatureMessage": "signature_message",
        "transactionDate": "2023-04-25T15:08:11.57+01:00",
        "transactionNumber": "12345"
      }
    }
  ],

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

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

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

Елементи		Тип	Описание
количество		М	Обща сума на платежната позиция
CurrencyIsoCode		M	Валутен код по ISO 4217
caption		M	Означение на начина на плащане / платежното средство
UniqueReadablePaymentIdentifier		M	(произволен) уникален идентификатор на вида плащане. Примери: „cash“, „cash payment“, „VISA“, „cash-EUR“,... Внимание: не е възможно да се използват 2 различни валутни съкращения за един и същ UniqueReadablePaymentIdentifier в рамките на един дневен отчет (Z-отчет)! Ако се използват няколко валути, за всяка валута трябва да се използва отделен UniqueReadablePaymentIdentifier. Например: „CashEUR“, „CashUSD“, „CashDKK“, „плащане в брой EUR“,...
ForeignAmount		O	Обща сума, ако плащането е в чужда валута
ForeignAmountExchangeRate		O	Обменен курс на чуждестранната валута
AdditionalFields		M*
	VoucherId	M*	Типове: MultiPurposeVoucher, SinglePurposeVoucher. Внимание: `VoucherId` трябва да бъде вложено под обекта `AdditionalFields` обекта.
	additionalProp1-x	M*
PaymentType		M	Начин на плащане / Средство за плащане
~~IsCash~~		-	елементът „IsCash“ вече не се поддържа от 1 март 2023 г. Видът на плащането се определя от елемента PaymentType. Внимание: Свойството „IsCash“ е премахнато, считано от версия 1.7.6 на Fiscal Client!
CreateDate		O	Дата, на която е създаден видът на плащането (ако има такава)
VatIdentification		M*	Идентификационен ID на Vat класа (съгласно присвоението от RF), вижте: GET /api/v1/information/client/ {clientId}/getVatIdentification Внимание: За определени видове плащания трябва да се предостави информация за Vat. Например за авансови плащания (депозит), ваучери и др. Препоръчваме винаги да включвате данни за Vat.
VatPercent		M*	Процент / ставка на Vat
VatPercent2		O	Втори процент / ставка на Vat (за плащания със смесена ставка на Vat)
TaxValue		M*	Сума на Vat
TaxValue2		O	Втора сума на Vat (за плащания със смесена ставка на Vat)
ExternalIdentifier		O
user		O/M*	Данни за потребителя на касовия апарат (могат да се посочат, ако се различават от данните в заглавната част на документа или в отделните позиции).
	ID	O/M*	ID код на потребителя на касовия апарат
	caption	O/M*	Наименование на потребителя на касовия апарат
	firstName	O	Име на потребителя на касовия апарат
	lastName	O	Фамилия на потребителя на касовия апарат
	taxNumber	O/M*	Данъчен номер на потребителя на касовия апарат Данни за държавата: в някои държави (например Словения) трябва да се посочи данъчният номер на касиера.
SalesPerson		O/M*	Данни за SalesPerson (могат да се посочат, ако се различават от данните в header-то на документа или в отделните позиции)
	ID	O/M*	ID номер на SalesPerson
	caption	O/M*	Длъжност на SalesPerson-a
	firstName	O	Име на SalesPerson
	lastName	O	Фамилия на SalesPerson-a
	taxNumber	O/M*	Данъчен номер на SalesPerson Данни за държавата: в някои държави (например Словения) трябва да се посочи данъчният номер на касиера.
PaymentTerminalReferenceId		O/M*	Идентификационен ID на транзакцията, върнат от терминала за плащане (ако терминалът за плащане е интегриран с POS системата и идентификационният ID на транзакцията трябва да бъде отпечатан върху документа). Данни за държавата: Дания: PaymentTerminalReferenceId трябва да бъде включен в заявката при плащания с карта. Допълнителна информация може да бъде намерена в точка 7 от изискванията за касови апарати в Дания .
cardData		O	Разписките от терминали за кредитни карти (без собствена функция за печат) могат да бъдат интегрирани в разписката чрез cardData. В държави, където се използват „фискални принтери“ (= RetailForce system контролира отпечатването на документи), информацията, включена в областта cardData, се отпечатва като редове със свободен текст след фискалната разписка. Няма разграничение между двете части. Подробности за страните: Гърция: За обработката на електронни плащания в Гърция се изискват допълнителни полета, включително ProviderSignature, ProviderTransactionId и ProviderSignatureMessage, за да се спазят местните нормативни изисквания.
	ReceiptCopyCount	O	Брой копия на касовата бележка
	receipt	O	Масив от редове с текст на разписката
	CardNumberMasked	O	Маскиран номер на картата за сигурност (например, ****1234)
	IdentificationToken	O	Уникален идентификационен токен за транзакцията
	MerchantCopyCount	O	Брой копия на разписката за търговеца
	MerchantReceipt	O	Масив от текстови редове на търговската разписка
	CardType	O	Типът на картата, използвана за платежната транзакция (например VISA, MASTERCARD и др.)
	AuthorizationCode	O	Кодът за оторизация на плащането
	terminalId	O	ID-то на терминала за плащане
	MerchantId	O	ID (от придобиващата банка) на търговеца
	transactionId	O	Уникален ID на транзакцията
	подпис_на_доставчика	O/M*	Подписът на доставчика на платежни услуги за процеса на плащане в Гърция
	ProviderTransactionId	O/M*	The transactionId of the payment provider for the payment process in Greece
	ProviderSignatureMessage	O/M*	Съобщението с подписа на доставчика на платежни услуги за процеса на плащане в Гърция
	TransactionDate	O	Дата на платежната транзакция
	TransactionNumber	O	Номерът на електронната платежна транзакция

Забележка: От 1 март 2023 г. полето „IsCash“ е премахнато от обектния модел. То все още може да се предава, но вече не задейства функция. Видовете плащания се контролират чрез полето „PaymentType“.

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

обект „плащания“

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