Split payments for specific purposes

In certain countries, you must specify the purpose for which a particular payment method is being used.

In Croatia, for example, it is necessary to specify which payment method was used for tips.

The current version of RetailForce (1.11.23) only supports this specific scenario (flagging payments as tips) and will be expanded where necessary.

Payment used for tips

Whether it is necessary in a particular country to indicate payment of a tip separately from the settlement amount is specified in the "fiscalCountryProperties".

If the property "mustIndicateTipCompanyTipPayment" is 'true', 

• the upstream system must include the property "isTip": 'true' in the "payments" section to show which of the payments is used for tips,
• in case the "positions" object contains positions with "businessTransactionType": "[5] = Tip" AND/OR "businessTransactionType": "[6] = CompanyTip".

Splitting payments

As multiple payment methods can be used, the upstream system (cash register) must define, which payment method is being used for tipping.

The reason for this is that the Croatian fiscalisation system requires tips and the method of their payment to be indicated separately from the amount paid for goods and services.

• <tns:NacinPlac> which is the payment method used for the invoice settlement, and
• <tns:nacinPlacanjaNapojnice> which indicates the payment method used for tips only.

Not only the payment menthod must be indicated but also the resp. amounts:

• <tns:IznosUkupno> - invoice settlement amount
• <tns:iznosNapojnice> - tips amount

Example:

• consumption amount is EUR 36,40 - customer pays via credit card
• customer also leaves EUR 3,60 in cash as tips

If "fiscalCountryProperties.mustIndicateTipCompanyTipPayment" is TRUE, the payload for this case needs to include the flag "isTip": true as in the example below:

"Payments": [
   {
      "Amount": 36.40,
      "CurrencyIsoCode": "EUR",
      "Caption": "CreditCard",
      "UniqueReadablePaymentIdentifier": "CCARD/EUR",
      "PaymentType": "CreditCard"
   },
   {
      "Amount": 3.60,
      "CurrencyIsoCode": "EUR",
      "Caption": "Cash",
      "UniqueReadablePaymentIdentifier": "CASH/EUR",
      "PaymentType": "Cash",
      "isTip": true
   }
]

If only one payment method is used, the payment split is done automatically by the RetailForce system. However, the flag "isTips" still would need to be included in the "payments" object.