Step by step of integration

The steps to follow to carry out the integration with the Via Oberta service products are as follows:

  1. Fill out the corresponding form that you will find in EACAT > Procedures > Consortium AOC, either the Via Oberta Service Request or the Via Oberta AEAT Service Request. In the “Type of query” section, you must check the “Integration via Web Services” box. As explained in the form, if you check this option, you must also fill out and attach the web services integration request form (indicating the public IPs with which you will access our environments, additionally attaching the public key (.cer) of the CDA certificate with which you will sign the XML requests via webService and the rest of the requested data and digitally signing it). Once you send the form that interests you (Via Oberta Services or AEAT Service) the AOC technicians will contact you.
  2. If you are integrating via webservice for the first time with the services of the AOC Consortium, you will need the integration documentation of the Inter-Administrative Collaboration Platform (PCI). In order 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 the services with guarantees of maximum security in the service and in the access to the data. The following documentation contains the specifications of the PCI messaging.
    The AOC Consortium, with the aim of facilitating the development of integrations, makes the following example PCI clients available to you: Generic documentation for integrating into PCI
    The Integration Documents (hereinafter, DI) of the services are in:

    DI – General State Administration (AGE) Scope Integration documentation: General State Administration (AGE) scope
    DI – Administration of the Generalitat of Catalonia Integration documentation: Administration of the Generalitat of Catalonia
    DI – Local Administration Area Integration documentation: Local Administration area
    DI – Area of Collaborating Schools and Entities Integration documentation: Scope of Schools and Collaborating Entities
  3. In the case of products that require it, it will be indicated that a certificate must be transferred or delivered to AOC for the signing of requests to the final issuer of the data.
  4. Carrying out integration tests in the pre-production environment. Before moving to Production, you will need to complete the Homologation Documents for the integrated services that you will find at: https://consorciaoc.github.io/Homologacio-Serveis/
  5. Configuration of the production environment. If you have completed the registration process for the service, you will be able to make requests to production. Throughout this process you will continue to have the support of the Integration Support Service.