Data Archives

This article provides information needed to understand how NP Retail exports to .xml archives, how these .xml archives must be secured, and how you can validate that they have not been tampered with.

Period Archives

You must periodically monitor closed monthly periods on the Workshift Summary page and export these to an archive file stored on a secure media i.e. usb keys in a safe. You create archives by using the archive button on Workshift Summary list. Note that Business Central SaaS already has multiple levels of database backup on the data as it’s all stored inside the ERP platform maintained by Microsoft. This includes geo-redundant backups. For more information, see their docs

Archive Validation

To ensure integrity of exported archives, all .xml archives are signed with the same certificate as all POS event signings.

The XMLDSIG canonicalization method is XML-C14N 1.0, and the signing is done via RSA & SHA256 as all the other POS event signings. If you reach out to NaviPartner we can supply you with a .cer certificate file that includes the public key of the cert used by a specific customer. NaviPartner also provides a powershell script that can be downloaded from and executed to validate both the schema of the XML file and the signature validity: Archive Validation Script.

The script depends on powershell core which can be downloaded and installed from the following link

The script must be placed inside a folder together with the 3 files needed for verification:

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

The schema file that archives adhere to can be downloaded at Archive Schema.

The 3 files must be named exactly like above. See image for example.

Archive Structure

The overall structure of the archive is as follows:

`<Archive>`
    `<GrandPeriod>`
        <ArchiveSignature/>
        <SystemEntryNo/>
        <SequentialID/>
        <FromDate/>
        <ToDate/>
        <GrandTotal/>
        <PerpetualAbsoluteGrandTotal/>
        <PerpetualGrandTotal/>
        <PeriodGrandTotalSignature/>
        <Tickets/>        
        <Duplicates/>        
        <GrandTotals/>        
        <JET/>        
    `</GrandPeriod>`
    <Signature/>    
`</Archive>`

The first segment is a header for the monthly grand period that is archived, followed by lists of all the events signed in that period. After the GrandPeriod element there is a Signature element that contains the XML signature for the file, making it tamper-proof.

See the schema file linked above for an in-depth overview of all XML elements in each of the 4 event type sections (tickets, duplicates, grandtotals, and JET).

XML Tags

List of archive tags, with french name and description

Legacy

Prior to the fiscal version 11 of NPRetail, the archive files were not signed and they followed a different schema. The old schema can be downloaded from Old Archive Schema.

Prior to the fiscal version 21.6 of NPRetail, the archive files followed a different schema that can be downloaded here: Old Archive Schema.