Aller au contenu principal

Processus de base de transfert de documents

Harald Krondorfer
  • Mise à jour

Création du module fiscal

Pour transférer des documents fiscaux (données fiscales), vous devez d’abord créer un module fiscal. Cela peut se faire de plusieurs manières :

  • Si vous utilisez le service fiscal certifié (service Windows ou Linux), le module fiscal sera automatiquement créé pour vous par ce service.
  • Si vous prévoyez d’intégrer le module fiscal via une intégration directe de la DLL .NET, vous devez instancier le module fiscal vous-même. Vous trouverez ci-dessous une description détaillée :
    Créer / instancier le module fiscal
Attention : le module fiscal initialise plusieurs sous-modules et ne doit pas être recréé à chaque reçu (par exemple, l’autotest du matériel TSS (Allemagne) nécessite au moins 30 secondes). De plus, vous devez appeler CloudConnect avant de transférer les documents, faute de quoi l’archivage dans le cloud échouera (cette étape n’est nécessaire que si l’archivage dans le cloud est activé).

Transfert des documents

Pour transférer des documents fiscaux vers le module fiscal, vous devez suivre au moins deux étapes :

  • createDocument
  • storeDocument

Quel que soit le pays, nous vous recommandons d’appeler la méthode CreateDocument dans tous les cas.

Attention : la méthode CreateDocument doit être appelée au début du document (lors de l’enregistrement d’un article). Cette étape est absolument nécessaire pour mettre en œuvre la fiscalisation conformément à la législation (par exemple : en Allemagne). Vous devez définir la propriété FiscalResponse du document à enregistrer à l’aide de la valeur FiscalResponse obtenue lors de l’appel de la méthode CreateDocument.

Exemple de document de reçu au format JSON :

{
"UniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
"DocumentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
"DocumentId": "2021-02-02T05:31:08.9450964+01:00",
"CreateDate": "2021-02-02T05:31:08.9450964+01:00",
"BookDate": "2021-02-02T05:31:08.9450964+01:00",
"DocumentNumber": null,
"CancellationDocument": false,
"DocumentReference": null,
"IsTraining": false,
"DocumentType": 0,
"DocumentTypeCaption": null,
"User": {
   "Id": "1234",
   "Caption": "Testuser"
},
"AllocationGroups": [],
"Partner": null,
"FiscalResponse": null, 
"FiscalDocumentNumber": 0, // set fiscaldocument of create document here
"FiscalDocumentRevision": 0, // set fisacldocument revision of create document here
"Positions": [
   {
      "ItemCaption": "Blume grün", // the caption of the item
      "ItemShortCaption": null,
      "Discounts": [],
      "Type": 0,
      "UseSubItemVatCalculation": true,
      "SubItems": null,
      "Quantity": 1.0,
      "QuantityUnit": null,
      "ItemId": "000714", // the item id
      "BaseNetValue": 3.61, // base value (without discounts)
      "BaseGrossValue": 4.3,
      "BaseTaxValue": 0.69,
      "GTIN": null,
      "BusinessTransactionType": 0,
      "VatIdentification": 1, 
      "VatPercent": 19.0, 
      "NetValue": 3.61, // net value (quantity * price)
      "GrossValue": 4.3, // gross value of the position
      "TaxValue": 0.69,
      "AccountingIdentifier": null,
      "PositionNumber": 0,
      "PositionReference": null,
      "CancellationPosition": false
   }
],
"Payments": [
   {
      "Amount": 5.0, // payment with over payment
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   },
   {
      "Amount": -0.7, // cash return (second payment)
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   }
]
}

Ce reçu contient :

  • une position avec l'article « 000714 », « Blume grün », au prix de 4,3 EUR TTC (1 pièce).
  • 2 paiements : un montant de 5 EUR en espèces et une monnaie de 0,7 EUR
Remarque : pour comprendre la structure attendue d’un document, vous pouvez consulter l’exemple de client du Fiscal Service (C#) disponible dans la section de téléchargement (http://www.RetailForceCloud.com/downloads ). Il affiche également le JSON résultant lorsque vous lancez l’application d’exemple. Veuillez vous assurer que le service fiscal est installé et en cours d’exécution sur la même machine.

Pour annuler un document créé précédemment, vous pouvez appeler la méthode :

  • cancelDocument
Attention : chaque document créé (à l’aide de CreateDocument) doit être clôturé avec StoreDocument ou annulé avec CancelDocument.

Pour valider un document avant de le transférer vers le module fiscal, vous pouvez appeler

  • ValidateDocument
Remarque : le document lui-même sera toujours validé avant d’être enregistré (même s’il est annulé). Si une erreur de validation survient, la méthode StoreDocument échouera et générera une exception.

Détails des processus

Processus de vente au détail

La vente de marchandises, par exemple dans le commerce de détail, se déroule comme suit :

Opérateur Système de caisse Service de fiscalisation RetailForce
1. L’opérateur (utilisateur de la caisse) saisit le premier article que le client souhaite acheter.    
  2. Le système de caisse envoie une requête au service fiscal (createDocument) afin d’enregistrer le début de la transaction correspondante.  
    3. Le service de fiscalisation reçoit la demande du système en amont et la traite conformément aux exigences spécifiques au pays (par exemple, signature, etc.).
    4. Le service de fiscalisation renvoie une réponse (fiscalResponse) au système en amont.
  5. Le système de caisse (système en amont) réceptionne la réponse et en persiste certaines parties (ou l’objet de réponse dans son intégralité) en vue d’une utilisation ultérieure (référence) une fois la transaction terminée.  
6. L’opérateur scanne l’ensemble des articles du client et initialise le processus de paiement.    
 

7. Une fois l’ensemble des données de la transaction déterminées (articles, mode de paiement, etc.), le système de point de vente génère le payload de la transaction (JSON) et envoie une nouvelle requête au service fiscal (storeDocument), ce qui finalise (enregistre) la transaction.

Certaines informations issues de la réponse fiscale (fiscalResponse) reçue lors de l’appel createDocument doivent être incluses dans la payload (« fiscalDocumentNumber », « fiscalDocumentStartTime » et, le cas échéant, des éléments spécifiques au pays tels que « fiscalDocumentRevision » en Allemagne).

Attention : seuls les éléments énumérés ci-dessus peuvent être inclus dans la payload et NON l’objet fiscalResponse dans son intégralité !
  
    8. Le service fiscal reçoit les requêtes du système en amont et les traite conformément aux exigences spécifiques au pays (par exemple, la signature, etc.).
    9. Le service fiscal renvoie une réponse (fiscalResponse) au système en amont.
  10. Le système de caisse enregistreuse reçoit la « fiscalResponse », extrait les informations nécessaires à la création du document (par exemple, la signature du document, le code QR, etc.) et imprime le document.  
11. L’opérateur remet le ticket imprimé au client    

Processus de vente dans le commerce de détail avec annulation d’une transaction

Si, comme décrit ci-dessus, au cours de l’étape 6, c’est-à-dire APRÈS l’envoi de createDocument (étape 2) et AVANT l’envoi de storeDocument (étape 7), le système de caisse envoie un cancelDocument AU LIEU d’un storeDocument.

Attention : la commande « cancelDocument » sert à annuler (abandonner) une transaction incomplète et NON (!) à prendre en compte les retours.

Les retours sont gérés de la même manière que les transactions de vente normales, à l’aide des commandes createDocument et storeDocument.

 

Cet article a été traduit automatiquement.

Articles associés

Commentaires

0 commentaire

Vous devez vous connecter pour laisser un commentaire.

Réalisé par Zendesk