Endpoints DSFinV-K

Endpoints DSFinV-K

Cette page présente une vue d’ensemble des endpoints DSFinV-K les plus pertinents, ainsi que les endpoints optionnels.

Endpoints optionnels

Les Définitions de TVA et les Agences d’achat sont décrites comme « optionnelles » car elles ne sont pas pertinentes pour la plupart des contribuables. La plupart des clients peuvent commencer directement avec l’endpoint Insérer ou mettre à jour un système de caisse.

Créer ou mettre à jour une Définition de TVA (optionnel)

Les taux de TVA couramment utilisés définis par la loi sont fournis via l’API dans le même ordre que dans les documents DSFinV-K émis par l’Office fédéral central des impôts allemand (Bundeszentralamt für Steuern — BZSt), voir Anlage 2 zur DSFinV-K.

Certains contribuables peuvent avoir besoin de créer des Définitions de TVA supplémentaires avec un vat_definition_export_id supérieur à 1000.

Les Définitions de TVA individuelles supplémentaires doivent être définies pour chaque Organisation gérée et pour l’environnement concerné (LIVE ou TEST). Cela signifie qu’une Définition de TVA créée dans une Organisation gérée n’existera que dans cette organisation spécifique et dans l’environnement pour lequel elle a été définie.

Créer ou mettre à jour une Agence d’achat (optionnel)

Les Agences d’achat ne sont pas nécessaires pour tous les contribuables. Une Agence d’achat est requise lorsque des montants sont enregistrés pour le compte d’un tiers (ex. : « boutique dans la boutique »).

Pour plus d’informations, veuillez consulter le chapitre Annexe A — Définitions des termes dans le document DSFinV-K émis par l’Office fédéral central des impôts allemand (BZSt).

Insérer ou mettre à jour un système de caisse

Pour chaque appareil de système de caisse utilisé, vous devez créer un Système de caisse. Les Clôtures journalières sont effectuées au niveau de chaque système de caisse individuel. L’insertion d’un système de caisse ne fait pas partie des opérations quotidiennes ; cependant, les systèmes de caisse existants doivent être mis à jour en cas de modifications, par exemple lors de mises à jour de la version logicielle du système de caisse.

Relation maître-terminal dans les systèmes de caisse

Dans la plupart des cas, le cash_register_type sera ‘MASTER’. Ce type de système de caisse est considéré comme un système d’enregistrement individuel fonctionnant de manière indépendante. Il doit être directement connecté à un TSS (voir Client dans SIGN DE).

Dans certains scénarios, des systèmes de caisse terminaux sont utilisés en complément du système de caisse ‘MASTER’ décrit ci-dessus. Les détails sur cette configuration maître-terminal sont donnés dans le document DSFinV-K émis par l’Office fédéral central des impôts allemand (BZSt) à la page 39. Les FAQ publiées par le Ministère fédéral des Finances allemand peuvent également être utiles (en particulier le n° 7 concernant les appareils mobiles dans la section Anwendungsbereich).

	Fonctionne de manière indépendante en mode hors ligne	Doit être directement connecté à un TSS
Système de caisse maître	Oui	Oui
Système de caisse terminal	Non	Non

Insérer une clôture journalière

Cet endpoint fait partie des opérations quotidiennes. Une Clôture journalière est un récapitulatif de tous les processus pertinents — voir Types de processus (reçus) et types de transactions commerciales — au sein d’un système de caisse (de type ‘MASTER’) pour une période donnée. Elle doit être créée au moins une fois par jour, par exemple après la fermeture du magasin.

D’un point de vue technique, certains champs sont marqués comme « obligatoires » tandis que d’autres ne le sont pas. Cela ne signifie cependant pas qu’ils peuvent être laissés vides d’un point de vue juridique. Chaque fois que des transactions ont été effectuées un jour donné, les données pertinentes doivent être incluses dans la clôture journalière dans les sections transactions et cash_statement.

Structure d’une clôture journalière

Une Clôture journalière se compose de 3 parties principales :

• Head : Cette section définit le périmètre de la clôture journalière en indiquant le jour spécifique et la plage de transactions couvertes.

• Cash Statement : Cette partie est l’agrégation de toutes les transactions représentées en deux blocs :

  • business_cases comprend le flux de paiement total au système de caisse, réparti par cas commercial.

  • payment_type comprend le flux de paiement total au système de caisse, réparti par type de paiement.

• Transactions : Cette partie comprend des informations détaillées sur chaque transaction individuelle au sein de la clôture journalière :

  • head contient des informations essentielles sur la transaction.

  • data fournit les détails de la transaction.

  • security crée le lien vers la signature TSS. Si aucune signature TSS correspondante n’existe, un message d’erreur doit être fourni.

Déclencher un fichier d’exportation

Utilisez cet endpoint pour déclencher un Fichier d’exportation DSFinV-K incluant les Clôtures journalières. Bien qu’il soit également possible de déclencher des fichiers d’exportation via le fiskaly HUB, nous recommandons d’implémenter cet endpoint de manière à permettre au contribuable d’obtenir les fichiers d’exportation directement via votre système.

Vous avez deux options pour sélectionner les clôtures journalières à inclure dans le fichier d’exportation : ByCreationDate et ByBusinessDate. La date de création fait référence au jour où les clôtures journalières ont été soumises à l’API DSFinV-K. La date commerciale fait référence au jour pour lequel les clôtures journalières sont destinées.

Vous pouvez choisir TAR ou ZIP comme formats d’exportation. Nous recommandons le format ZIP, car il est pris en charge par les outils de validation courants.

Selon la quantité de données, la génération des fichiers d’exportation peut prendre de quelques secondes à une heure.

Télécharger directement un fichier d’exportation

Une fois les fichiers d’exportation terminés, ils peuvent être téléchargés via l’endpoint Télécharger directement un fichier d’exportation dans le format spécifié à l’étape précédente.