Archives de données

Cet article fournit les informations nécessaires pour comprendre comment NP Retail exporte vers des archives .xml, comment ces archives .xml doivent être sécurisées et comment vous pouvez vérifier qu’elles n’ont pas été falsifiées.

Archives périodique

Vous devez surveiller périodiquement les périodes mensuelles fermées sur la page Workshift Summary et les exporter vers un fichier d’archive stocké sur un support sécurisé, c’est-à-dire des clés USB dans un coffre-fort. Vous créez des archives à l’aide du bouton Archiver dans la liste Workshift Summary. Notez que Business Central SaaS dispose déjà de plusieurs niveaux de sauvegarde de base de données sur les données, car elles sont toutes stockées dans la plate-forme ERP gérée par Microsoft. Cela inclut les sauvegardes géo-redondantes. Consultez leurs documents pour en savoir plus: https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/service-overview#database-and-backups

Validation des archives

Pour garantir l’intégrité des archives exportées, toutes les archives .xml sont signées avec le même certificat que toutes les signatures d’événements POS.

La méthode de canonisation XMLDSIG est XML-C14N 1.0 et la signature se fait via RSA et SHA256 comme toutes les autres signatures d’événements POS. Si vous contactez NaviPartner, nous pouvons vous fournir un fichier de certificat .cer qui inclut la clé publique du certificat utilisé par un client spécifique. NaviPartner fournit également un script PowerShell qui peut être téléchargé et exécuté pour valider à la fois le schéma du fichier XML et la validité de la signature : Script de validation d’archive.

Le script dépend du noyau PowerShell qui peut être téléchargé et installé à partir du lien suivant: https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3

Le script doit être placé dans un dossier avec les 3 fichiers nécessaires à la vérification :

  • archive.xml
  • schema.xsd
  • certificate.cer

Le fichier de schéma auquel adhèrent les archives peut être téléchargé à l’adresse Schéma d’archive

Les 3 fichiers doivent être nommés exactement comme ci-dessus. Voir l’image par exemple. Exécution de script

Structure des archives

L’archive contient la structure globale de:

<Archive>
    <GrandPeriod>
        <ArchiveSignature/>
        <SystemEntryNo/>
        <SequentialID/>
        <FromDate/>
        <ToDate/>
        <GrandTotal/>
        <PerpetualAbsoluteGrandTotal/>
        <PerpetualGrandTotal/>
        <PeriodGrandTotalSignature/>

        <Tickets/>        

        <Duplicates/>        

        <GrandTotals/>        

        <JET/>        
    </GrandPeriod>

    <Signature/>    
</Archive>

Au début il y a une section d’en-tête pour la grande période mensuelle archivée, suivie de listes de tous les événements signés au cours de cette période. Après l’élément GrandPeriod se trouve un élément Signature qui contient la signature XML du fichier, ce qui le rend inviolable.

Voir le fichier de schéma lié ci-dessus pour un aperçu détaillé de tous les éléments XML dans chacune des 4 sections de type d’événement (tickets, doublons, grands totaux, jet).

XML Tags

TagFrançais
ArchiveArchive
GrandPeriodPériode majeure
ArchiveSignatureSignature d’archive
SystemEntryNoNuméro d’entrée système
SequentialIDID séquentiel
FromDateDe la date
ToDateÀ la date
GrandTotalTotal général
PerpetualAbsoluteGrandTotalTotal absolu perpétuel
PerpetualGrandTotalTotal perpétuel
PeriodGrandTotalSignatureSignature du total de la période
TicketsBillets
TicketBillet
DocumentTypeType de document
TicketSignatureSignature du billet
SalesLineLigne de vente
TaxLineLigne de taxe
PaymentLineLigne de paiement
TypeType
ExchangeRateTaux de change
IssuedGenericVoucherBons génériques émis
AppliedGenericVoucherBons génériques appliqués
IssuedCouponCoupons émis
AppliedCouponCoupons appliqués
RelatedInfoInformations connexes
DuplicatesDuplicatas
DuplicateDuplicata
IDID
FiscalDocumentNumberNuméro de document fiscal
ReprintNumberNuméro de réimpression
DuplicateSignatureSignature du duplicata
RelatedInfoInformations connexes
GrandTotalsTotals généraux
GrandTotalTotal général
PerpetualAbsoluteGrandTotalTotal absolu perpétuel
PerpetualGrandTotalTotal perpétuel
GrandTotalSignatureSignature du total général
JETJET
JETEntryEntrée JET
JETSignatureSignature JET
SystemEntryKeyClé d’entrée système
DocumentNumberNuméro de document
NoOfPrintsNombre d’impressions
SalespersonCodeCode du vendeur
POSCodeCode POS
DateDate
TimeHeure
OperationTypeType d’opération
NoOfSalesLinesNombre de lignes de vente
TotalInclTaxTotal TTC
TotalExclTaxTotal HT
LineNoNuméro de ligne
ProductCodeCode de produit
ProductLabelLibellé du produit
QuantityQuantité
TaxIdentifierIdentifiant de taxe
TaxRateTaux de taxe
UnitPriceInclTaxPrix unitaire TTC
DiscountCodeCode de réduction
DiscountPercentagePourcentage de réduction
DiscountAmountMontant de réduction
TotalExclTaxTotal HT
TotalInclTaxTotal TTC
BaseQuantityQuantité de base
UnitOfMeasureCodeCode de l’unité de mesure
CreatedCréé
DescriptionDescription
AmountMontant
CurrencyDevise
CurrencyAmountMontant en devise
ExchangeRateTaux de change
CreatedAtCréé à
SoftwareVersionVersion du logiciel
StoreNameNom du magasin
StoreName2Nom du magasin 2
StoreAddressAdresse du magasin
StoreAddress2Adresse du magasin 2
StorePostCodeCode postal du magasin
StoreCityVille du magasin
StoreCountryPays du magasin
IntraCommVATIdentifierIdentifiant de TVA intracommunautaire
SalespersonNameNom du vendeur
UserCodeCode d’utilisateur
GrandTotalTypeType de total général
SequenceNumberNuméro de séquence
AdditionalInfoInformations supplémentaires

Héritage

Avant la version fiscale 11 de NPRetail, les fichiers d’archives n’étaient pas signés et suivaient un schéma différent. L’ancien schéma peut être téléchargé depuis Ancien schéma d’archive

Avant la version fiscale 21.6 de NPRetail, les fichiers d’archives suivaient un schéma différent téléchargeable ici: Ancien schéma d’archive