Archives

Archives

Écrit par Support - Thais PMS
Dernière mise à jour :  mardi 03 décembre 2024

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


NF525

Documentation NF525

3 articles dans cette catégorie.
Écrit par Alexandre FABRE et Support - Thais PMS.