Le but de cette documentation est de définir les modalités de l'archivage fiscal :
Documentation en français
COMMENT LIRE LES ARCHIVES
L'archive fiscale est créée pour les factures et les tickets créés dans la plage de dates sélectionnée avant de créer une archive. Un fichier zip est créé avec plusieurs fichiers Excel qui contiennent les détails des factures et des tickets concernés. En outre, ce fichier explicatif fait partie de l'archive fiscale créée.
L'intégrité du fichier est contrôlée par la signature électronique créée qui est ajoutée séparément dans le fichier. Pour générer la signature électronique, les paramètres d'entrée suivants sont nécessaires :
Taxes comprises, montants décomposés par taux de tva
Montants TTC de la période
Horodatage de l'opération
Code terminal/POS
Type d'opération
Signature précédente O/N
Si présente, signature électronique précédente
L'ARCHITECTURE DE L'ARCHIVE
Pour chaque archive générée, un fichier zip est créé. Ce fichier est enregistré dans un Google Cloud Storage Bucket et rendu accessible par le logiciel en tant qu'option de téléchargement.
Avant la création du fichier zip, tous les fichiers requis sont constitués. Principalement en exportant les données de la base de données Oracle dans un fichier csv, combiné avec ce pdf, le tout est rassemblé dans une archive zip. Pour ce fichier zip, nous générons un hash de signature et l'enregistrons dans la base de données.
LE CONTENU DES ARCHIVES
Les fichiers de l'archive sont les suivants :
*Reservation_Tax_Total_Report: Il s'agit du principal fichier des archives fiscales, qui contient presque tous les détails relatifs aux factures, aux tickets et aux totaux de clôture périodiques.
*Reservation_Tax_Report: Ce document contient les spécificités de la TVA au niveau des tickets/factures.
*Eventlog_Report: Ce document contient les données JET pour la gamme sélectionnée, qui sont enregistrées dans la table nf525_eventlog.
*Reservation_Bill_Snapshot_Report: Ce document contient un extrait de la facture, chaque fois qu'une transaction sur la réservation est effectuée. Les données sont enregistrées dans la table reservation_bill_snapshot.
*Payment: Ce document contient les détails des paiements reçus.
*signature_file: Ce document contient la signature électronique de l'archive, ainsi que la signature électronique de l'archive fiscale précédente ( si elle existe).
Pour chaque fichier, une explication plus détaillée des principales colonnes est donnée :
*Reservation_tax_total_report
Ce fichier contient tous les grands totaux (GTT, GTF, GTP, GTM, GTA) pour l'archive créée, qui est enregistrée dans nf525_reservation_tax_total et les valeurs et montants des taxes applicables provenant de la table reservation_tax_total.
En outre, les détails suivants du ticket et de la facture sont inclus : type d'opération, signatures électroniques, détails du client, détails de l'entité émettrice, type d'opération, version NF, nom du logiciel.
*Reservation_tax_report
Les principales colonnes sont les suivantes :
RESERVATION_TAX_TOTAL_ID : ID de l'enregistrement correspondant dans Reservation_tax_total_report.
TAX_PERCENTAGE : identifiant du taux de TVA pour l'enregistrement.
TAX_AMOUNT : Montant de la TVA pour le taux de TVA
RESOURCE_AMOUNT_INCL_TAX : Montant total de la facture incluant la TVA pour le taux de TVA
RESOURCE_AMOUNT_EXCL_TAX : montant total de la facture hors TVA pour le taux de TVA.
*Eventlog_report
Les principales colonnes sont les suivantes :
EVENTLOG_ID : ID de l'enregistrement dans la base de données.
EMPLOYEE : Employé exécutant l'événement qui conduit à l'enregistrement dans le journal des événements
EVENT_TYPE : Eventcodes NF525
EVENT_TYPE_DESCRIPTION : Désignation du type d'événement NF525
EVENT_TIME : Heure de l'événement
OLD_VALUE_VARCHAR2 : ID de l'enregistrement initial de l'événement dans la clé primaire de la table particulière.
OLD_VALUE_DESCRIPTION : Ancienne valeur, si applicable.
NEW_VALUE_VARCHAR2 : ID de l'enregistrement de l'événement dans la clé primaire de la table particulière.
NEW_VALUE_DESCRIPTION : Nouvelle valeur, si applicable.
SIGNATURE : Signature électronique du numéro de l'événement
PREVIOUS_SIGNATURE : Signature électronique du numéro de l'événement précédent.
EVENT_NUMBER : Numéro séquentiel de l'événement.
*Reservation_Bill_Snapshot
Les principales colonnes sont les suivantes :
RESERVATION_ID : ID de référence interne du backend pour la réservation.
CASHFLOWRULE_NAME : Identificateur des lignes de facturation
VALUE : Montant de base de la ressource
QUANTITY : Quantité de la ressource dans la facture
TOTAL : Montant total par ressource dans la facture
VIRTUAL_OVERRIDE_VALUE : Montants de la facture actualisés, y compris la TVA, après le remplacement du prix.
VAT_RATE : Taux de TVA par ressource dans la facture
TOTAL_EXCL_VAT : Montant de la facture hors TVA.
*Payment details report
MUTATION_ID : ID backend interne pour la transaction
RESERVATION_ID : ID de référence interne du backend pour la réservation
RESERVATION_NUMBER : Numéro de réservation
PAYER_TYPE : Paiement effectué par le client, le client payeur ou l'agent.
DEBIT : Montant de la transaction entrante
CREDIT : Montant de la transaction sortante
MUTATION_DATE : Date d'enregistrement de la transaction dans le système
DEBIT_PAYER_CURRENCY AMOUNT : Montant de la transaction entrante dans la devise de réservation
CREDIT_PAYER_CURRENCY AMOUNT : Montant de la transaction sortante dans la devise de réservation
EMPLOYEE_ID : ID de l'entité qui enregistre la transaction.
EMPLOYEE_NAME : Nom de l'entité qui enregistre la transaction
ACCOUNT_NAME : Nom du mode de paiement
ADMINORGANISATION_NAME : Nom de l'entité juridique pour laquelle l'archive est créée
*signature_file
SIGNATURE : Signature électronique créée pour l'archive fiscale créée sur la base des paramètres d'entrée tels que décrits précédemment dans ce document.
PREVIOUS_SIGNATURE : Signature électronique créée précédemment.
------ENGLISH TEXT BELOW------
English Documentation
HOW TO READ THE ARCHIVE
The fiscal archive is created for invoices and tickets created within the date range selected before creating an archive. A zipfile is created with multiple Excel files which hold the details of relevant invoices and tickets. Furthermore, this explanatory file is part of the created fiscal archive.
The integrity of the file is controlled via the created electronic signature which is added separately in the file. To generate the electronic signature, there are the following input parameters:
Tax incl. amounts broken down per vat rate
Tax incl. amounts of the period
Operation timestamp
Terminal/POS code
Operation type
Previous signature Y/N
If present, previous electronic signature
THE ARCHITECTURE OF THE ARCHIVE
For each generated archive a zip file is created. That file is stored in a Google Cloud Storage Bucket and made accessible through the software as a download option.
Before the zipfile is created, all required files are being build up. Mostly by exporting data from the Oracle database into a csv file, combined with this pdf, it’s packaged together in a zip archive. For this zip file we generate a signature hash and store this in the database.
THE CONTENT OF THE ARCHIVE
The files in the archive are:
*Reservation_Tax_Total_Report: This is the main file in the fiscal archive with almost all details related to invoices, tickets and periodical closing totals.
*Reservation_Tax_Report: This document holds VAT specifics on ticket/invoice level.
*Eventlog_Report: This document holds JET data for selected daterange, which is stored in nf525_eventlog table.
*Reservation_Bill_Snapshot_Report: This document contains a snapshot of the bill, everytime a transaction on the reservation performed. Data is stored in reservation_bill_snapshot table.
*Payment: This file holds received payment details.
*signature_file: This document contains the electronic signature of the archive, as well as electronic signature of previous fiscal archive (if applicable).
Per file, a more detailed explanation of the main columns is given:
Document Name | Main Columns | Details |
|---|---|---|
Reservation_tax_total_report | GTT, GTF, GTP, GTM, GTA, | This file holds all grand totals for the archive created, which is stored in nf525_reservation_tax_total and the applicable tax values and amounts from reservation_tax_total table |
Operation type, electronic signatures, customer details, issueing entity details, operation type, NF version, software name | Furthermore, the following ticket and invoice details are included | |
Reservation_tax_report | RESERVATION_TAX_TOTAL_ID | ID for corresponding record in Reservation_tax_total_report |
TAX_PERCENTAGE | Identifier of VAT rate for the record | |
TAX_AMOUNT | VAT amount for VAT rate | |
RESOURCE_AMOUNT_INCL_TAX | Total bill amount including VAT for the VAT rate | |
RESOURCE_AMOUNT_EXCL_TAX | Total bill amount excluding VAT for the VAT rate | |
Eventlog_report | EVENTLOG_ID | ID for record in database |
EMPLOYEE | Employee executing the event which leads to registration in eventlog | |
EVENT_TYPE, | NF525 eventcodes | |
EVENT_TYPE_DESCRIPTION | NF525 naming of event type | |
EVENT_TIME | Time of event | |
OLD_VALUE_VARCHAR2 | Initial record ID of event in particular table primary key. | |
OLD_VALUE_DESCRIPTION | Old value, if applicable | |
NEW_VALUE_VARCHAR2 | Record ID of event in particular table primary key. | |
NEW_VALUE_DESCRIPTION | New value, if applicable | |
SIGNATURE | Electronic signature of event number | |
PREVIOUS_SIGNATURE | Electronic signature of previous event number | |
EVENT_NUMBER | Sequential event number. | |
Reservation_Bill_Snapshot | RESERVATION_ID | Internal backend reference ID for reservation |
CASHFLOWRULE_NAME | Identifyer of bill lines | |
VALUE | Base amount of resource | |
QUANTITY | Quantity of resource in bill | |
TOTAL | Total amount per resource in bill | |
VIRTUAL_OVERRIDE_VALUE | Updated bill amounts including VAT after price override | |
VAT_RATE | VAT rate per resource in bill | |
TOTAL_EXCL_VAT | Bill amounts excluding VAT | |
Payment details report | MUTATION_ID | Internal backend ID for transaction |
RESERVATION_ID | Internal backend reference ID for reservation | |
RESERVATION_NUMBER | Reservation number | |
PAYER_TYPE | Payment made by Customer, Paying Customer or Agent | |
DEBIT | Amount for incoming transaction | |
CREDIT | Amount for outgoing transaction | |
MUTATION_DATE | Date of registering transaction in system | |
DEBIT_PAYER_CURRENCY AMOUNT | Amount for incoming transaction in reservation currency | |
CREDIT_PAYER_CURRENCY AMOUNT | Amount for outgoing transaction in reservation currency | |
EMPLOYEE_ID | ID of entity registering the transaction | |
EMPLOYEE_NAME | Name of entity registering the transaction | |
ACCOUNT_NAME | Name of payment method | |
ADMINORGANISATION_NAME | Name of the legal entity the archive is created for | |
Signature_file | SIGNATURE, | Created electronic signature for the created fiscal archive based on the input parameters as described earlier in this document |
PREVIOUS_SIGNATURE | Previously created electronic signature |
BETA - NEW DOCUMENTATION AFTER THIS POINT: DETAILS FOR EACH FILE
Reservation_tax_total_report:
Main Columns | Details |
|---|---|
RESERVATION_TAX_TOTAL_ID | |
ENTRYDATE | |
ADMIN_ORGANISATION_ID | |
ADMIN_ORGANISATION_NAME | |
ADMIN_ORGANISATION_DESCRIPTION | |
LEGAL_NAME | |
VAT_NUMBER | |
CHAMBER_OF_COMMERCE_NUMBER | |
RCS_CITY_OF_REGISTRATION | |
SOCIAL_CAPITAL | |
NAF_CODE | |
APE_CODE | |
SIRET | |
SIREN | |
ADDRESS1 | |
HOUSENUMBER | |
HOUSENUMBER_SUFFIX | |
ZIPCODE | |
CITY | |
COUNTRY | |
PAYERTYPE | |
GRAND_TOTAL_TYPE | |
RESERVATION_ID | |
RESERVATION_NUMBER | |
GRAND_TOTAL | |
ABSOLUTE_TOTAL | |
RELATIVE_TOTAL | |
SIGNATURE | |
PREVIOUS_SIGNATURE | |
EMPLOYEE_ID | |
DOCUMENT_ID | |
DOCUMENT_TYPE | |
INVOICE_TYPE | |
CUMULATIVE_DAY | |
CUMULATIVE_MONTH | |
CUMULATIVE_YEAR | |
OPERATION_TYPE | |
TOTAL_NO_OF_BILL_LINES | |
TOTAL_VAT | |
INVOICE_DATE | |
SERVICE_EXECUTION_DATE | |
CUSTOMER_ID | |
CUSTOMER_NAME | |
CUSTOMER_ADDRESS1 | |
CUSTOMER_ZIPCODE | |
CUSTOMER_CITY | |
CUSTOMER_COUNTRY_NAME | |
PAYING_CUSTOMER_COMPANY_NAME | |
PAYING_CUSTOMER_VAT_NUMBER | |
INVOICE_CREATOR_ID | |
NF525_VERSION | |
SOFTWARE_NAME |
Reservation_Tax_Report:
Main Columns | Details |
|---|---|
RESERVATION_TAX_ID | |
RESERVATION_TAX_TOTAL_ID | ID for corresponding record in Reservation_tax_total_report |
TAX_PERCENTAGE | Identifier of VAT rate for the record |
TAX_AMOUNT | VAT amount for VAT rate |
RESOURCE_AMOUNT_INCL_TAX | Total bill amount including VAT for the VAT rate |
RESOURCE_AMOUNT_EXCL_TAX | Total bill amount excluding VAT for the VAT rate |
Eventlog_report
Main Columns | Details |
|---|---|
EVENTLOG_ID | ID for record in database |
EMPLOYEE | Employee executing the event which leads to registration in eventlog |
EVENT_TYPE, | NF525 eventcodes |
EVENT_TYPE_DESCRIPTION | NF525 naming of event type |
EVENT_TIME | Time of event |
OLD_VALUE_VARCHAR2 | Initial record ID of event in particular table primary key. |
OLD_VALUE_DESCRIPTION | Old value, if applicable |
NEW_VALUE_VARCHAR2 | Record ID of event in particular table primary key. |
NEW_VALUE_DESCRIPTION | New value, if applicable |
SIGNATURE | Electronic signature of event number |
PREVIOUS_SIGNATURE | Electronic signature of previous event number |
EVENT_NUMBER | Sequential event number. |
Reservation_Bill_Snapshot
Main Columns | Details |
|---|---|
RESERVATION_BILL_SNAPSHOT_ID | |
RESERVEDRESOURCE_ID | |
RESERVATION_ID | Internal backend reference ID for reservation |
RESOURCE_TYPE | |
RESOURCE_NAME | |
CASHFLOWRULE_NAME | Identifyer of bill lines |
START_DATE | |
END_DATE | |
VALUE | Base amount of resource |
QUANTITY | Quantity of resource in bill |
MULTIPLIER | |
TOTAL | Total amount per resource in bill |
OVERRIDE_VALUE | |
VIRTUAL_OVERRIDE_VALUE | Updated bill amounts including VAT after price override |
VAT_RATE | VAT rate per resource in bill |
EXTRA_ISWARRANT | |
PAY_AT_RESORT | |
STAY_ARTICLE | |
WITHHOLDINGARTICLE | |
OVERRIDE_EMPLOYEE_ID | |
OVERRIDE_EMPLOYEE_NAME | |
OVERRIDE_REASON | |
BILL_LINE_TYPE | |
TOTAL_EXCL_VAT | Bill amounts excluding VAT |
ADMIN_ORGANISATION_ID | |
PAYER_TYPE | |
CODE | |
ENTRY_DATE | |
VALUE_EXCL_VAT | |
TOTAL_VAT | |
SEQUENCE_NUMBER |
Payment details report
Main Columns | Details |
|---|---|
MUTATION_ID | Internal backend ID for transaction |
RESERVATION_ID | Internal backend reference ID for reservation |
RESERVATION_NUMBER | Reservation number |
PAYER_TYPE | Payment made by Customer, Paying Customer or Agent |
AMOUNT | Amount of the mutation |
MUTATION_DATE | Date of the mutation |
AMOUNT_IN_PAYER_CURRENCY | Amount of the mutation in payer currency |
STATEMENT_NUMBER | Statement number |
ORIGIN_MUTATION_ID | Internal ID for original mutation |
BANKSTATEMENT_ID | Internal ID for bank statement |
PAYMENTREFERENCE_NUMBER | Payment reference number |
PAYMENT_NUMBER | Payment number |
CHEQUE_NUMBER | Cheque number |
MONEYORDER_NUMBER | Money order number |
EMPLOYEE_ID | ID of entity registering the transaction |
EMPLOYEE_NAME | Name of entity registering the transaction |
ACCOUNT_ID | Internal ID for account |
ACCOUNT_NAME | Name of payment method |
ADMIN_ORGANISATION_ID | Internal ID for admin organization |
ADMIN_ORGANISATION_NAME | Name of the legal entity the archive is created for |
Signature_file
Main Columns | Details |
|---|---|
SIGNATURE | Created electronic signature for the created fiscal archive based on the input parameters as described earlier in this document |
PREVIOUS_SIGNATURE | Previously created electronic signature |