I seguenti esempi JSON illustrano il caso d’uso relativo al versamento o alla ricarica di una carta cliente (“buono multiuso”) e al successivo utilizzo di tale credito durante una vendita.

1. Ricarica della carta cliente

La prima ricevuta mostra la ricarica del buono multiuso. L’importo viene pagato in contanti e registrato nel registratore di cassa come entrata, al netto del Vat. Con questa ricarica non si verifica ancora alcuna operazione imponibile, poiché non è ancora stato determinato come verrà utilizzato il credito.

{
  "ModelVersion": "1.4.0",
  "UniqueClientId": "2a296a14-f644-4f3f-9ea2-d3f00a3b587c",
  "fiscalDocumentNumber": "8",
  "fiscalDocumentStartTime": 1743161079,
  "fiscalDocumentRevision": 1,
  "AdditionalFields": {},
  "AutomaticVatCalculation": 0,
  "DocumentGuid": "a5f35b65-b5fc-45c8-9b8f-10543c19fa68",
  "DocumentId": "946398c5-d72c-450d-9cdd-8f4d49c5643d",
  "CreateDate": "2025-03-28T12:26:28.4312186+01:00",
  "BookDate": "2025-03-28T12:26:28.4322612+01:00",
  "DocumentType": "[0] = Receipt",
  "User": {
    "Id": "123",
    "Caption": "TestUser",
    "firstName": "Test",
    "lastName": "Test",
    "dateOfEntry": "2020-01-01T08:00:00+01:00"
  },
  "Positions": [
    {
      "Type": "[0] = Item",
      "ItemId": "MPV-0001",
      "ItemCaption": "Deposit via Loyalty Card (MultiPurposeVoucher)",
      "BusinessTransactionType": "[4] = MultiPurposeVoucher",
      "Quantity": 1,
      "VatIdentification": 5,
      "VatPercent": 0.0,
      "NetValue": 100.0,
      "GrossValue": 100.00,
      "TaxValue": 0.00,
      "PositionNumber": 0,
      "AdditionalFields": {
        "VoucherId": "MPV-0001"
      },
      "ExternalIdentifier": []
    }
  ],
  "Payments": [
    {
      "Amount": 100.00,
      "CurrencyIsoCode": "EUR",
      "UniqueReadablePaymentIdentifier": "CASH",
      "caption": "Cash+Euro",
      "AdditionalFields": {},
      "PaymentType": 0,
      "ExternalIdentifier": []
    }
  ],
  "FiscalAdditionalFields": {}
}

In questo esempio, la voce «Deposito tramite carta loyalty» è contrassegnata come buono multiuso. Il pagamento viene effettuato in contanti (100 EUR) e non viene applicata alcuna aliquota Vat.

I seguenti elementi sono fondamentali:

2. Utilizzo tramite la Carta Clienti

La seconda ricevuta documenta la vendita di beni (ad es. fiori), pagati in parte tramite il credito precedentemente caricato e in parte in contanti.

{
  "UniqueClientId": "2a296a14-f644-4f3f-9ea2-d3f00a3b587c",
  "AdditionalFields": {},
  "DocumentGuid": "4dc6f469-4481-4ae3-9b7e-f9b729901698",
  "DocumentId": "4dc6f469-4481-4ae3-9b7e-f9b729901698",
  "CreateDate": "2025-03-28T12:32:28.4312186+01:00",
  "BookDate": "2025-03-28T12:32:28.4322612+01:00",
  "DocumentNumber": "001",
  "DocumentType": "[0] = Receipt",
  "User": {
    "Id": "123",
    "Caption": "TestUser"
  },
  "fiscalDocumentNumber": "9",
  "fiscalDocumentStartTime": 1743161104,
  "fiscalDocumentRevision": 1,
  "Positions": [
    {
      "ItemCaption": "Flower green",
      "ItemShortCaption": null,
      "Discounts": [],
      "Type": 0,
      "UseSubItemVatCalculation": true,
      "SubItems": null,
      "InHouse": false,
      "Quantity": 9.0,
      "QuantityUnit": null,
      "ItemId": "000714",
      "BaseNetValue": 32.52,
      "BaseGrossValue": 38.70,
      "BaseTaxValue": 6.18,
      "GTIN": null,
      "BusinessTransactionType": 0,
      "VatIdentification": 1,
      "VatPercent": 19.0,
      "NetValue": 32.52,
      "GrossValue": 38.70,
      "TaxValue": 6.18,
      "AccountingIdentifier": null,
      "PositionNumber": 0,
      "PositionReference": null,
      "CancellationPosition": false
    },
    {
      "ItemCaption": "Wedding bouquet",
      "ItemShortCaption": null,
      "Discounts": [],
      "Type": 0,
      "UseSubItemVatCalculation": true,
      "SubItems": null,
      "InHouse": false,
      "Quantity": 3.0,
      "QuantityUnit": null,
      "ItemId": "001180",
      "BaseNetValue": 57.48,
      "BaseGrossValue": 68.40,
      "BaseTaxValue": 10.92,
      "GTIN": "8718274490558",
      "BusinessTransactionType": 0,
      "VatIdentification": a1,
      "VatPercent": 19.0,
      "NetValue": 57.48,
      "GrossValue": 68.40,
      "TaxValue": 10.92,
      "AccountingIdentifier": null,
      "PositionNumber": 1,
      "PositionReference": null,
      "CancellationPosition": false
    }
  ],
  "Payments": [
    {
      "Amount": 100.00,
      "PaymentType": "MultiPurposeVoucher",
      "CurrencyIsoCode": "EUR",
      "Caption": "Loyalty Card",
      "UniqueReadablePaymentIdentifier": "MPV-0001",
      "VatIdentification": 5,
      "TaxValue": 0.0,
      "VatPercent": 0.0,
      "AdditionalFields": {
        "VoucherId": "MPV-0001"
      }
    },
    {
      "Amount": 7.10,
      "PaymentType": "cash",
      "CurrencyIsoCode": "EUR",
      "Caption": "Cash+Euro",
      "UniqueReadablePaymentIdentifier": "CASH",
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
    }
  ]
}

Solo in questo momento, al momento dell’utilizzo tramite l’acquisto di beni, si verifica l’operazione imponibile e il Vat diventa esigibile. Il pagamento viene effettuato in parte tramite il buono multiuso (carta cliente) e in parte in contanti. In questo scenario, l’importo precedentemente caricato (primo esempio) viene ora effettivamente utilizzato, il che diventa rilevante ai fini del Vat al momento dell’utilizzo.

I seguenti elementi sono fondamentali:

Note importanti sull’implementazione

Quando si implementano buoni multiuso o pagamenti con carte cliente nel sistema POS, è necessario tenere conto dei seguenti punti:

1. Per la ricarica della carta cliente:
   • La transazione commerciale deve essere contrassegnata come buono multiuso (BusinessTransactionType = 4)
   • L’ID del buono deve essere memorizzato nel campo «AdditionalFields» con la chiave «VoucherId»
2. Per l’utilizzo del credito:
   • Lo stesso ID del buono deve essere utilizzato nel pagamento nei campi “UniqueReadablePaymentIdentifier” e “AdditionalFields”
   • L’aliquota VAT viene applicata ai beni venduti
   • L’utilizzo del buono è contrassegnato come PaymentType: «[4] = MultiPurposeVoucher»

Questo articolo è stato tradotto automaticamente.