Mudanças nas mensagens representam: implicações para integradores

Tal como vos comunicamos no passado dia 4 de setembro, desde o serviço Representa foram realizados novas funções e diversas mudanças para melhorar o funcionamento da plataforma. Esses novos recursos e mudanças significaram mudanças nas mensagens, com implicações para os integradores.

Essas mudanças estão operacionais desde 16 de outubro passado no ambiente de pré-produção e no próximo 15 de janeiro eles entrarão em produção, por esse motivo, revise-os com atenção, especialmente a alteração do esquema, que você precisará modificar se validá-la.

Modificação do esquema: obrigatória se você validá-la

IMPORTANTE: Houve diversas alterações no esquema (listadas nos pontos a seguir) que podem afetar o modo como você funciona quando nos liga, caso você valide o esquema. São campos opcionais (sempre colocamos assim para não afetar), portanto, se você estiver protegido, não haverá impacto. Mas se você fizer uma validação de esquema, e mesmo que sejam opcionais, retornar um erro, precisaremos revisá-los e confirmar se suas chamadas estão funcionando corretamente.

Abaixo está o diagrama para que você possa ver esses novos campos, discutidos nos pontos seguintes.

Extensão dos dados de contacto com o campo “Telemóvel” (campo opcional)

Com o intuito de ampliar os avisos enviados aos cidadãos, foram incorporados na base de dados os campos “Prefixo” e “Telemóvel”, para poder enviar avisos por SMS relativamente a possíveis alterações de estado das representações.

Ambos os campos são opcionais.

Modificação do campo “Sobrenome” para adequação ao REA NTI (campo opcional)

Em relação às tarefas decorrentes da adaptação da plataforma Represent à nova Norma Técnica de Interoperabilidade dos Registos Eletrónicos de Procurações (ainda em fase de projeto) para a integração com Apodera, o Registo Eletrónico de Procurações da Administração Geral do Estado , os campos referentes a “Sobrenomes” na base de dados Representa foram ampliados. Portanto, os campos “Sobrenome1” e “Sobrenome2” foram adicionados ao campo atual “Sobrenomes” (que incluía ambos os sobrenomes).

Neste sentido, os três campos coexistirão, sendo possível continuar enviando o campo “Apelido” incluindo os dois apelidos como antes, sendo este campo enviado como “Apelido1” quando estiver em vigor a integração com Apodera. Assim, embora o campo “Sobrenomes” possa continuar sendo enviado no lugar dos novos campos, recomenda-se migrar para dois sobrenomes para o envio de informações mais precisas.

Extensão dos dados pessoais com o campo “Nome enviado” (campo opcional)

Com o intuito de abordar os cidadãos com o nome com que se sentem identificados, foi incorporado na base de dados o campo “Nome ouvido”, para poder enviar avisos com este nome, além do nome que consta do DNI/NIE ou Passaporte.

O campo do nome enviado é um campo opcional.

Modificação em relação à consulta de representações ativas

Para melhorar as consultas realizadas na plataforma, foram incluídas na consulta as representações ativas, aquelas que estão no status "Assinatura pendente" e adicionalmente, será adicionado o campo "Atual" à resposta para reportar aquelas representações que, além de serem considerados ativos, estão em vigor no momento da consulta.

Você pode consultá-lo mensagens para todos os detalhes e para qualquer dúvida ou comentário você pode contatá-lo Suporte para Integradores.