How to integrate with Via Oberta?

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

For each Via Oberta service you have a service letter where each type of consultation is explained in detail, the information that can be obtained, how to make the consultations and where you will find examples of use cases that can be very useful to you.  

You will find the different service letters on the Via Obierta Support Portal depending on the data provider:  

• Professional associations  
• Local administration  
• Government of Catalonia  
• General State Administration  

In the case of the   local administrations and entities that depend on them ,   To access and consult the data in the data and document catalogue, it is necessary to adhere to the Interoperability Framework Agreement (CMI), or to have signed a collaboration agreement with the AOC Consortium.

Below, you will find the steps to adhere to the Interoperability Framework Agreement , which you must attach in its corresponding section within the application forms for the Via Oberta services.

In the case of an? body of the Administration of the Generalitat de Catalunya , adherence to the aforementioned Agreement is not required. 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). SIAD must be contacted through the email address administraciódigital.presidencia@gencat.cat

Once you have identified the procedure and Via Oberta service to request according to the information in the first section,   You must complete and send the registration application found at EACAT/Catalog of procedures/Consortium AOC/AOC - Service request/ Service request Via Oberta. Once downloaded, you must select the option “Integration through Web Services” in the “Type of query” section.

To fill out the application, you can use the document with step-by-step instructions for filling out the application form for Via Oberta services . The most important points to consider to obtain authorization to access the data and not be required by the data issuers are:  

• Legal rule: ?Regarding 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 is also necessary to take into account that? the current policy of issuers is not to accept generic regulations that do not expressly establish the data to be consulted, therefore the specific regulation that regulates the specific procedure where the obtaining of the data or document that is intended to be consulted is required must be indicated.  
• Consent: This can be " No opposition ", " Yes " or " Law ", you can consult each case in the document with the 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 one form. Otherwise, you can submit one for each procedure.  

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

If you have already applied   the electronic seal of the AOC and we have confirmed the download 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 provision of tax information to public administrations   from the Tax Agency.
• STEP 2. You will need to   download the certificate's public key   of a medium-level electronic seal issued by the services of AOC. The person responsible for the certification service of your entity must access the certification portal, specifically the subscriber folder , where they will also be able to consult the serial number of the certificate.
• STEP 3. Send both the form and the certificate's public key and its serial number (the public key must be in encoded X509 format - .cer or .crt extension) through the   Electronic office 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   Submission of authorization forms for standardized supplies :
  • Tax purposes
  • Non-tax purposes
• STEP 4. Wait for confirmation from the AEAT via email indicating that the certificate has been authorized.
• STEP 5. Submit the form   which is located at EACAT/Catalog of procedures/Consortium AOC/AOC - Service request/ Request for AEAT Service Via Oberta. Once downloaded, you must mark the option “ Integration through Web Services” in the “Type of query” section. You can use the document to help you step by step to fill out the AEAT service request form.  

There are two possible scenarios:

• If you have not yet requested registration , when filling out the application form you must check the option “Integration through web services” :

• If you already have the registration , you can request integration by attaching the integration document (duly completed and digitally signed, in PDF format) to the integration support contact form . Once done, we will contact you to inform you of the steps to follow later and we will require the information we need to continue with the integration work.