> For the complete documentation index, see [llms.txt](https://guias.mosaico.gov.pt/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guias.mosaico.gov.pt/guias-praticos/consumir-um-servico-pi.md).

# Consumir um serviço PI

| Passo                                       | Entidade responsável | Descrição                                                                                                                                                                                                                                               |
| ------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Selecionar o serviço que pretende consumir  | Entidade             | Escolha o serviço pretendido do [catálogo de serviços](https://www.iap.gov.pt/web/iap/plataforma-de-integracao) disponíveis na PI.                                                                                                                      |
| Pedido de adesão formal à ARTE              | ARTE                 | Preencha o [formulário de adesão](https://www.iap.gov.pt/web/iap/formulario-de-adesao?serviceId=3) a indicar o(s) serviço(s) a consumir, se possível uma estimativa do volume de invocações e o enquadramento legal para obter a informação pretendida. |
| Acordar protocolo entre entidades           | Entidade e ARTE      | Acordar protocolo entre as partes envolvidas no pedido de autorização.                                                                                                                                                                                  |
| Pedir autorização à CNPD                    | Entidade e ARTE      | Caso exista recolha ou transmissão de dados pessoais deverá ser efetuado um pedido de autorização à Comissão Nacional de Proteção de Dados (CNPD) para disponibilização dos dados à entidade consumidora.                                               |
| Criação de VPN                              | ARTE                 | Estabelecimento da ligação à Plataforma de Interoperabilidade através de *Virtual Private Network* (VPN) permanente (mais informação em Ligação VPN).                                                                                                   |
| Adaptar SI das entidades                    | Entidade aderente    | Adaptação dos sistemas de informação (SI) das entidades aderentes para integrar os dados do serviço.                                                                                                                                                    |
| Definir cenários de teste                   | Entidade e ARTE      | Definição dos cenários de teste.                                                                                                                                                                                                                        |
| Desenvolver Serviço e disponibilizar WSDL   | Entidade             | Caso o serviço ainda não esteja disponível é necessário o seu desenvolvimento pela entidade fornecedora e a disponibilização do *Web Services Description Language* (WSDL), ficheiro responsável pela descrição, métodos e operações do serviço.        |
| Aprovar WSDL                                | Entidade e ARTE      | Aprovação dos WSDL.                                                                                                                                                                                                                                     |
| Instalar em Ambiente de Qualidade           | Entidade e ARTE      | Instalação do serviço em ambiente de qualidade.                                                                                                                                                                                                         |
| Efetuar Testes Integrados                   | Entidade e ARTE      | Testes integrados do serviço.                                                                                                                                                                                                                           |
| Instalar em Produção                        | Entidade e ARTE      | Instalação do serviço em produção.                                                                                                                                                                                                                      |
| Assinar protocolo                           | Entidade e ARTE      | Assinatura do protocolo acordado entre as partes.                                                                                                                                                                                                       |
| Entrar em Produção                          | Entidade e ARTE      | Entrada em produção do serviço após validação de todos os requisitos técnicos, jurídicos e de privacidade.                                                                                                                                              |