Access through integration allows access to information without losing either the traceability of the operations or the electronic evidence that gives legal validity to the data and documents exchanged.

In this case, Via Oberta is presented as a neural point of information distribution within a SOA (Service Oriented Architecture) network architecture, homogenizing both security mechanisms and XML messaging and hiding the diversity and technical complexity associated with each of the issuers of information.

Below we explain in detail the steps to follow to consume the service through integracón with web services:

Identify the associated Via Oberta procedures and service

Once you have identified a procedure for which you need to consult data held by another or other administrations, you can consult the catalog of available services to determine which Via Oberta service(s) you should request. In the Via Oberta service of the AOC website (section "Request the service") you will find the Catalog of data and documents currently available . 

For each Via Oberta service, you have a service letter that explains in detail each type of consultation, the information that can be obtained, how to carry out the consultation and where you will find examples of use cases that can be of great help to you utility 

You will find the different service letters in the Open Via Open Support Portal depending on the transferor of the data: 

Adherence to the Interoperability Framework Convention

In the case of local administrations and entities that depend on them , for access to the data consultation of the catalog of data and documents, adherence to the Interoperability Framework Agreement (CMI) is necessary, or to have signed a collaboration agreement with the AOC Consortium.

Next, you will find the steps to adhere to the Interoperability Framework Agreement , which you must attach in the corresponding section of the Via Oberta service application forms

In the case of a body of the Administration of the Generalitat de Catalunya , adherence to the aforementioned Convention is not necessary. The request for access to the data provided by the Via Oberta service of the AOC must be made through PICA, which is managed by the Sub-Directorate of Innovation and Digital Administration (SIAD). You must contact the SIAD via the email address administraciondigital.presidencia@gencat.cat

Request enrollment in Via Oberta services

Once you have identified the Via Oberta procedure and service to request according to the information in the first section, you must fill in and send the registration request found in EACAT/Catalogue of procedures/Consorci AOC/AOC - Request for services/ Request for services Via Oberta. Once downloaded, you must check the "Integration through Web Services" option in the "Query type" section.

To fill in the request, you can use the step-by-step document to fill in the Via Oberta services request form . The most important points to consider in order to obtain data access authorization and not be required by data issuers are:  

  • Legal rule: With regard to the data requested through the PID, remember that at this time the publication, contribution or translation into Spanish is requested both the applicable regulations and the form where the consent is collected. It should also be borne in mind that the issuers' current policy is not to accept generic regulations that do not expressly establish the data to be consulted, therefore the specific rule that regulates the specific procedure where obtaining the the data or document that is intended to be consulted.  
  • Consent: This can be " No opposition ", " Yes " or " Law ", you can consult each case in the document with step-by-step instructions for filling out the form.  

If you need to request several Via Oberta services for the same procedure, you only need to fill out a single form. Otherwise, you can send one for each procedure.  

Request enrollment in Via Oberta - AEAT services

Once you have identified the Via Oberta procedure and service to request according to the information in the first section, you must fill in and send the registration request, but before that, in the case of the AEAT there is a requirement indispensable and it is to have issued a mid-level electronic stamp in exclusivity for use of AOC services , you can consult how to do it at how to apply for an Electronic Seal of the AOC.

If you have already applied the electronic seal of the AOC and we have confirmed the download for you or you already had it on loan you can continue with the following steps:

Request integration

Once you have requested registration for Via Oberta services, you must request integration by filling in the integration request form through web services and attaching it to the Via Oberta form.

mceclip0.png

The requesting entities must have the entity's Security Document, in order to certify that access to the hardware where this certificate is stored is restricted and protected to avoid possible fraudulent use of it.

Inter-administrative collaboration platform (PCI)

In case you integrate via webservice for the first time with the services of the AOC Consortium, you will need the integration documentation of the Interadministrative Collaboration Platform (PCI).

To be able to consume the services of the AOC Consortium, you must do so through the PCI. The PCI is a set of systems and components aimed at the total availability of services with guarantees of maximum security in the service and in access to data. The following documentation contains the PCI messaging specifications.
The AOC Consortium, with the aim of facilitating the development of integrations, makes available to you the following sample PCI clients.

The Integration Documents (hereafter, DI) of the services are in:

Testing and configuration in the pre-production environment

Implementation of integration tests in the pre-production environment. Before moving to Production, you will have to fill out the Homologation Documents for the integrated services that you will find at: https://consorciaoc.github.io/Homologacio-Serveis/

Setting up the production environment. If you have completed the service registration process, you will be able to make production requests. Throughout this process you will continue to have the support of the Integration Support Service.

Integrated software
  • Meana Group
  • T-Systems
  • Indra
  • Stop
  • sum
  • SEMI
  • Textile
  • everis
  • Audiofilm
  • @peiron Software
  • united
  • Synerplus
  • CSC
  • Arctic Solutions