Les exemples JSON suivants illustrent le cas d’utilisation d’un dépôt ou d’une recharge sur une carte client (« bon d’achat polyvalent »), ainsi que l’utilisation ultérieure de ce crédit lors d’une vente.

1. Recharge de la carte client

Le premier ticket de caisse illustre le rechargement du bon d’achat polyvalent. Le montant est réglé en espèces et enregistré dans la caisse comme recette, hors Vat. Lors de ce rechargement, aucune opération imposable n’a encore lieu, car l’utilisation du crédit n’est pas encore déterminée.

{
  "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": {}
}

Dans cet exemple, la ligne « Dépôt via la carte de fidélité » est identifiée comme un bon d’achat polyvalent. Le paiement est effectué en espèces (100 EUR) et aucun taux de Vat n’est appliqué.

Les éléments suivants sont essentiels :

2. Utilisation via la carte client

Le deuxième ticket de caisse indique la vente de marchandises (par exemple, des fleurs), qui sont désormais payées en partie à l’aide du crédit précédemment chargé et en partie en espèces.

{
  "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
    }
  ]
}

Ce n’est qu’à ce moment-là, lors de l’utilisation du bon d’achat pour l’achat de marchandises, que la transaction imposable a lieu et que la TVA devient exigible. Le paiement s’effectue en partie via le bon d’achat polyvalent (carte client) et en partie en espèces. Dans ce scénario, le montant précédemment chargé (premier exemple) est désormais effectivement utilisé, ce qui devient pertinent au regard de la TVA au moment de l’utilisation.

Les éléments suivants sont essentiels :

Remarques importantes concernant la mise en œuvre

Lors de l’implémentation de bons d’achat polyvalents ou de paiements par carte client dans le système de point de vente, les points suivants doivent être pris en compte :

1. Pour le chargement de la carte client :
   • La transaction commerciale doit être identifiée comme un bon d’achat polyvalent (BusinessTransactionType = 4)
   • L’ID du bon doit être enregistré dans le champ « AdditionalFields » avec la clé « VoucherId »
2. Pour l'utilisation du crédit :
   • Le même ID de bon d’achat doit être utilisé dans le paiement sous « UniqueReadablePaymentIdentifier » et dans « AdditionalFields »
   • Le taux de TVA s’applique aux marchandises vendues
   • L’utilisation du bon est identifiée par le PaymentType : « [4] = MultiPurposeVoucher ».

Cet article a été traduit automatiquement.