> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.thais-pms.fr/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Archives

# 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](http://..../resort/NF525) onglet Archives.

Ces interfaces se présentent sous la forme suivante :

![](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/image_efi6k6.png)
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.

![](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/image_ty37nb.png)
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 :

![](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/image_ui1dbw.png)

# 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

![](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/image_oob1tp.png)
## 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`
