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:
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:
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 firstname.lastname@example.org
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.
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:
- STEP 1. You will need to download the replacement form for electronic certificates used for the use of web services for the supply of tax information to public administrations of the Tax Agency
- STEP 2. You will have to download the public key of the certificate of mid-level electronic stamp issued by the AOC services. Your certification service manager needs to access the certification portal, specifically in the subscriber folder , where they can also check the serial number of the certificate.
- STEP 3. Send both the form and the public key of the certificate and its serial number (the public key must be in encoded X509 format - extension .cer or .crt) through the Electronic headquarters of the AEAT , choosing one of the following forms depending on whether the information is required for tax or non-tax purposes (in both cases the option you must choose in the form is Presentation of authorization forms in standardized supplies ) :
- STEP 4. Wait for confirmation from the AEAT by email indicating that the certificate has been authorized.
- STEP 5. Submit the form which can be found in EACAT/Catalogue of procedures/Consorci AOC/AOC - Request for services/ Request for the AEAT Via Oberta Service. Once downloaded, you will have to mark the option " Integration through Web Services" in the "Question type" section. You can use the step-by-step document to fill in the application form for AEAT services.
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.
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:
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.
- Meana Group
- @peiron Software
- Arctic Solutions