NOM-151 Constancies Validation

Sovos (Advantage Security, S. de R.L. de C.V.) as an Certification Services Provider (PSC) offers the service to validate NOM-151 Constancies.

Content

In this document, you will find detailed information about the SOAP webservice to perform the following functions:

• validaFolioNOM151
• validaNOM151

Audience

This document is aimed at system personnel in charge of develop the applications that will connect to the webservices provided by Sovos to obtain validation constancies for the digestion of an electronic document and a NOM-151 preservation constancy issued by Sovos.

Background

Sovos service for validation of constancies can process requests that have the digital fingerprint value (digestion) belonging to their original file and its preservation constancy file.

You can get the fingerprint through any of the digestion functions (HASH) allowed by the Ministry of Economy and must match the one used when you requested a NOM-151 Constancy.

This service allows to perform the validation through 2 options: * Requester has the file of the preservation constancy. * Requester gives the certificate folio of the issued constancy.

As a result of the validation, the service returns a PDF document called a Validation Constancy containing an evidence sheet of the results.

The evidence sheet is divided into 5 sections: * Section 1. Indicates the date and time at validation time, and the result of the 3 verification processes performed. - Correlation between the given digestion value and the digestion value in the certificate. - Validity of the seal of the constancy. Indicates that the constancy is valid and authentic in respect of the seal on it. - Issuance by the PSC. Indicates the constancy was issued by Sovos. There's also a QR Code in the first section with the summary of the validation process.

• Section 2. Describes the name of the validated file and the value of its digital fingerprint.
• Section 3. Indicates the information in the validated preservation constancy.
• Section 4. Provides the policy identifier and the name of the PSC stated in the validated preservation constancy.
• Section 5. Provides the value of the electronic signature of the time stamping seal of the validation constancy.

Here is an example of the Evidence Sheet of the validation constancy with sample data. In the production environment the data will change.

SOAP webservice for NOM-151 certificate validation description

The SOAP webservice to obtain validation constancies is available for institutions that have been enrolled and authorized based on the contract procedures established by Sovos.

The functions or methods available through the webservice are:

• validaFolioNOM151
• validaNOM151

Each method is intended for a specific functionality. The description of the functionalities is:

• validaFolioNOM151.- This method performs the validation of the document's fingerprint and the folio number of the constancy that the requester institution provided. Only the folios of constancies issued for the institution will be validated.
• validaNOM151.- This method performs the validation of the document fingerprint and the NOM-151 preservation constancy file.

Requirements for the interaction with the SOAP Web Service

The requirements the institutions asking for a preservation constancy must fulfill are:

• Have an internet connection to access the service web location.
• Request Sovos for the credentials to access the service.
• Confirm with Sovos the addresses to access the webservice in the test and production environment.

Location of the service

The URLs where you can find the webservice definition for each environment are:

Description of the webservice methods

validaFolioNOM151

Request to validaFolioNOM151

Header

Body

Example of request to validaFolioNom151:

   <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:tem="http://tempuri.org/">
       <soap:Header>
          <tem:AuthSoapHd>
             <tem:Entidad>Entidad</tem:Entidad>
             <tem:Usuario>nombre_usuario</tem:Usuario>
             <tem:Clave>Contraseña</tem:Clave>
          </tem:AuthSoapHd>
       </soap:Header>
       <soap:Body>
          <tem:validaFolioNOM151>
             <tem:nombreArchivoOriginal>Especificaciones.pdf</tem:nombreArchivoOriginal>
             <tem:huellaDigitalArchivo>VinEQ+AIl4M3MIasYVlWjPQZ9GnnlW0b81IEqgAsohw=</tem:huellaDigitalArchivo>
             <tem:folio>10526380</tem:folio>
          </tem:validaFolioNOM151>
       </soap:Body>
    </soap:Envelope>
    

Response from validaFolioNOM151

Example of response from validaFolioNom151:

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <validaFolioNOM151Response xmlns="http://tempuri.org/">
         <validaFolioNOM151Result>
            <Estado>0</Estado>
            <Descripcion>Satisfactorio</Descripcion>
            <validaFecha>2022/01/31 12:27:39</validaFecha>
            <validaRelacion>true</validaRelacion>
            <validaSello>true</validaSello>
            <validaPSC>true</validaPSC>
            <documentoNombre>Especificaciones.pdf</documentoNombre>
            <documentoHuellaDigital>VinEQ+AIl4M3MIasYVlWjPQZ9GnnlW0b81IEqgAsohw=</documentoHuellaDigital>
            <constanciaSerie>10526380</constanciaSerie>
            <constanciaHuellaDigital>VinEQ+AIl4M3MIasYVlWjPQZ9GnnlW0b81IEqgAsohw=</constanciaHuellaDigital>
            <contanciaFecha>20220131182502.115Z</contanciaFecha>
            <constanciaAlgoritmo>SHA-256</constanciaAlgoritmo>
            <pscPolitica>1.16.484.101.10.316.1.2</pscPolitica>
            <pscNombre>PSC Advantage Security (Pruebas)</pscNombre>
            <qrPDF>||10526380|Especificaciones.pdf|PSC Advantage Security (Pruebas)|2022/01/31 12:27:39|true|true|true||</qrPDF>
            <constanciaSello>UWMFZHkm7LetSmx2xrDstZn1Gx+OI8pGrxKtapGLLdsfZWyDbnPlu8OHOIfDVf6Opx7gMCZm78MVrFyuppXc8uZ+GBMPsGc+Sa7by7Y=...</constanciaSello>
            <reportePDF>JVBERi0xLjQKJdP0zOEKMSAwIG9iago8PAovQ3JlYXRpb25EYXRlKEQ6MjAyMjAxMzExM...</reportePDF>
         </validaFolioNOM151Result>
      </validaFolioNOM151Response>
   </soap:Body>
</soap:Envelope>

validaNOM151

Request to validaNOM151

Header

Body

Example of request to validaNOM151:

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:tem="http://tempuri.org/">
   <soap:Header>
      <tem:AuthSoapHd>
         <tem:Entidad>Entidad</tem:Entidad>
         <tem:Usuario>nombre_usuario</tem:Usuario>
         <tem:Clave>Contraseña</tem:Clave>
      </tem:AuthSoapHd>
   </soap:Header>
   <soap:Body>
      <tem:validaFolioNOM151>
         <tem:nombreArchivoOriginal>Especificaciones.pdf</tem:nombreArchivoOriginal>
         <tem:huellaDigitalArchivo>VinEQ+AIl4M3MIasYVlWjPQZ9GnnlW0b81IEqgAsohw=</tem:huellaDigitalArchivo>
         <tem:folio>10526380</tem:folio>
      </tem:validaFolioNOM151>
   </soap:Body>
</soap:Envelope>

Response from validaNOM151

Example of response from validaNOM151:

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <validaFolioNOM151Response xmlns="http://tempuri.org/">
         <validaFolioNOM151Result>
            <Estado>0</Estado>
            <Descripcion>Satisfactorio</Descripcion>
            <validaFecha>2022/01/31 12:27:39</validaFecha>
            <validaRelacion>true</validaRelacion>
            <validaSello>true</validaSello>
            <validaPSC>true</validaPSC>
            <documentoNombre>Especificaciones.pdf</documentoNombre>
            <documentoHuellaDigital>VinEQ+AIl4M3MIasYVlWjPQZ9GnnlW0b81IEqgAsohw=</documentoHuellaDigital>
            <constanciaSerie>10526380</constanciaSerie>
            <constanciaHuellaDigital>VinEQ+AIl4M3MIasYVlWjPQZ9GnnlW0b81IEqgAsohw=</constanciaHuellaDigital>
            <contanciaFecha>20220131182502.115Z</contanciaFecha>
            <constanciaAlgoritmo>SHA-256</constanciaAlgoritmo>
            <pscPolitica>1.16.484.101.10.316.1.2</pscPolitica>
            <pscNombre>PSC Advantage Security (Pruebas)</pscNombre>
            <qrPDF>||10526380|Especificaciones.pdf|PSC Advantage Security (Pruebas)|2022/01/31 12:27:39|true|true|true||</qrPDF>
            <constanciaSello>UWMFZHkm7LetSmx2xrDstZn1Gx+OI8pGrxKth7o8MLMTQ1VL2W6XBn08FP66E2LDY=..</constanciaSello>
            <reportePDF>JVBERi0xLjQKJdP0zOEKMSAwIG9iago8PAovQ3JlYXRpb25EYXRlKEQ6MjAyMjAxMzExM...</reportePDF>
         </validaFolioNOM151Result>
      </validaFolioNOM151Response>
   </soap:Body>
</soap:Envelope>

Error codes