Articles sur : NF525

Interface des archives

Thaïs a prévu une interface web afin de faciliter les récupérations et contrôles des archives fiscales.

Celle-ci est accessible grâce à une URL sur chacune des instances : http://..../resort/NF525 onglet Archives.

Ces interfaces se présentent sous la forme suivante :

Cette interface permet à l'utilisateur de :

télécharger les archives fiscales générées automatiquement tous les mois
générer une archive fiscale entre deux dates
contrôler l’intégrité d’une archive fiscale

Signature des archives

Lors de la création d’une archive, qu’elle soit automatique ou manuelle, l’intégralité du zip est signé via l’outil openssl et cette signature est stockée en base de données. La signature (le checksum de l'archive) peut être validée via la commande openssl md5 nom_archive.zip.

L’archive peut également être validée via l’outil d’interface des archives.

La première ligne du fichier archive.txt de l’archive est utilisée pour identifier l’archive en base de données. Le checksum de l’archive obtenue via openssl md5 nom_archive.zip est ensuite comparé à la signature enregistrée en base de données lors de la création de l’archive.

Si les deux valeurs correspondent, alors l’archive est valide. Sinon l'archive est invalide, ce qui signifie que des données de l'archive ont été modifiées.

Dans ce cas, l’interface affichera :

Composition des archives

Chaque archive fiscale comporte une liste de fichiers .csv, .txt et .html (formats ouverts et portables).

Chaque fichier est composé par les éléments présentés ci-dessous.

archive.txt

id de l’archive
dates : période couverte par cette archive

invoices.csv

id
reference
date
docType (INVOICE = facture de vente ; CREDIT_NOTE = facture d’avoir)
typology
software.name
software.version
issuer.legalName
issuer.address
issuer.postcode
issuer.city
issuer.country
issuer.legalForm
issuer.shareCapital
issuer.vatNumber
issuer.siren
issuer.siret
issuer.rcsNumber
issuer.rcsCity
issuer.naf
user.id
user.username
customer.type
customer.id
customer.lastName
customer.firstName
customer.addressOpposition
customer.address
customer.postCode
customer.city
customer.country
customer.numTvaIntra
customer.siren
customer.siret
customer.numTvaHorsEu
customer
totalDiscount
totalExcludingTaxesByRates
totalTaxesByRates.0.00
totalTaxesByRates.5.50
totalTaxesByRates.20.00
totalTaxesByRates.10.00
totalExcludingTaxes
totalTaxes
totalIncludingTaxes
netToPay
signature

invoices_purchases.csv

id
consumedAt
invoice.id
invoice.reference
order.reference
article_id
label
quantity
taxesRates
unitPriceIncludingTaxes
discountRate
unitAmountExcludingTaxes
amountExcludingTaxes
taxes
amountIncludingTaxes
isPackage

receipts.csv

id
reference
date
software.name
software.version
issuer.legalName
issuer.address
issuer.postcode
issuer.city
issuer.country
issuer.siret
issuer.naf
issuer.vatNumber
user.id
user.username
desk.id
desk.label
docType(RECEIPT = ticket de vente ; CREDIT_NOTE = ticket d’annulation)
nbLine
totalDiscount
totalExcludingTaxesByRates
totalTaxesByRates
totalExcludingTaxes
totalTaxes
totalIncludingTaxes
signature

receipts_purchases.csv

id
consumedAt
receipt.id
receipt.reference
order.reference
article_id
label
quantity
taxesRates
unitPriceIncludingTaxes
discountRate
unitAmountExcludingTaxes
amountExcludingTaxes
taxes
amountIncludingTaxes
isPackage

payments.csv

id
date
amount
type
user.id
user.username
desk.id
desk.label
invoice.id
invoice.reference
receipt.id
receipt.reference
order.id
order.label

duplicates.csv

id
reference
software.name
software.version
type
nbPrint
user.id
reason
date
signature

proof_of_payments_invoices.csv

proof_of_payments_receipts.csv

gtp.csv

id
type
period
totalIncludingTaxesByRates.0.00
totalIncludingTaxesByRates.5.50
totalIncludingTaxesByRates.10.00
totalIncludingTaxesByRates.20.00
totalIncludingTaxes
perpetualTotal
perpetualTotalAsbolute
date
signature

gtt.csv

id
type
reference
totalIncludingTaxesByRates
totalIncludingTaxes
perpetualTotal
perpetualTotalAsbolute
date
signature

jet.csv

signable.id
signable.date
signable.code
signable.username
signable.userId
signable.deskId
signable.description
signable.information
signable.signature
verify

jet.html

provider.txt

informations de l’entité émettrice à date de l’archive
- désignation commerciale
- adresse postale
- code postal, ville, pays (code ISO2)
- raison sociale
- numéro Siren
- numéro Siret
- RCS
- code APE/NAF
- numéro de TVA intracommunautaire
informations sur le logiciel et la version à date de l’archive
dates de la période couverte par l’archive
date de la production de l’archive

README

Ce fichier contient une documentation pour faciliter la lecture de l’archive comme présenté ci-dessous.

Cette archive fiscale contient :

invoices.csv : liste de toutes les factures de la période
invoices_purchases.csv : liste de toutes les ventes facturées de la période
receipts.csv : liste de tous les tickets de la période
receipts_purchases.csv : liste de toutes les ventes sur tickets de la période
duplicates.csv : liste de tous les duplicatas de la période
proof_of_payments_invoices.csv : liste de tous les justificatifs de paiements sur factures de la période
proof_of_payments_receipts.csv : liste de tous les justificatifs de paiements sur tickets de la période
payments.csv : liste de tous les paiements de la période
jet.csv : liste de tous les évènement du JET de la période
jet.html : liste de tous les évènement du JET de la période au format HTML
gtt.csv : liste de tous les Grand Totaux Ticket de la période
gtp.csv : liste de tous les Grand Totaux Période de la période
provider.txt : informations du logiciel, de l'émetteur des factures/tickets, de la période d'archivage et de la date de l'archive
archive.txt : informations de l'archive (id interne) et la période d'archivage
README: ce document

Le séparateur "," est utilisé sur les fichiers .csv

La signature (le checksum de l'archive) peut être validée via la commande openssl md5 nom_archive.zip

Mis à jour le : 16/07/2025

Cet article a-t-il répondu à vos questions ?

Merci !