Encaminhamento de mensagens

Como o MOBI.Hub usa os cabeçalhos de encaminhamento OCPI para identificar a origem e o destino de cada pedido.

O MOBI.Hub baseia-se nos cabeçalhos de encaminhamento OCPI normalizados para identificar as partes de origem e de destino envolvidas em cada pedido.

São suportados os seguintes cabeçalhos HTTP, tal como definidos pela especificação OCPI:

• OCPI-to-party-id
• OCPI-to-country-code
• OCPI-from-party-id
• OCPI-from-country-code

Consoante o módulo OCPI e a operação em causa, o MOBI.Hub pode usar os cabeçalhos de encaminhamento para identificar tanto a entidade de destino como a entidade que origina o pedido.

Identificação explícita do destino

Nas operações que exigem a identificação explícita do destino, a parte que faz o pedido deve indicar a entidade de destino através dos cabeçalhos de encaminhamento OCPI normalizados.

Isto aplica-se, por exemplo, aos comandos iniciados por um EMSP, em que o CPO de destino tem de ser identificado explicitamente:

POST /commands/START_SESSION
OCPI-to-country-code: PT
OCPI-to-party-id: ABC
OCPI-from-country-code: PT
OCPI-from-party-id: XYZ

Espera-se que a parte que faz o pedido já disponha desta informação, com base no local de carregamento escolhido pelo utilizador e nas relações de interoperabilidade configuradas na plataforma MOBI.Hub.

Identificação da origem

Os cabeçalhos OCPI-from-* são também usados sempre que a Mobi.e precisa de desambiguar a entidade responsável por um pedido. Este cenário é particularmente relevante quando uma única plataforma técnica representa vários CPO ou EMSP.

Por exemplo, quando uma plataforma partilhada submete um pedido de autorização de token em nome de vários CPO, o MOBI.Hub usa os cabeçalhos OCPI-from-country-code e OCPI-from-party-id para identificar a entidade de origem e validar o pedido face às relações de interoperabilidade configuradas e à matriz de autorizações.

Destino inferido pela plataforma

Em módulos específicos, a parte de destino pode ser inferida a partir de informação já gerida pela plataforma MOBI.Hub, pelo que não é necessária informação de encaminhamento adicional para além dos cabeçalhos OCPI normalizados.

Exemplos:

• Sessions;
• CDRs;
• operações relacionadas com tokens.

Nestes casos, o MOBI.Hub determina o destino adequado com base no token associado à transação e nas relações configuradas na plataforma.

Princípios de encaminhamento

O MOBI.Hub segue os seguintes princípios de encaminhamento:

• a informação de encaminhamento é trocada através dos cabeçalhos OCPI normalizados;
• o encaminhamento explícito só é necessário quando é preciso desambiguar o destino;
• a identificação da origem pode ser necessária para processar corretamente pedidos submetidos por plataformas multientidade (multi-tenant);
• as decisões de encaminhamento estão limitadas pelas relações de interoperabilidade configuradas na plataforma MOBI.Hub;
• algumas decisões de encaminhamento podem basear-se em informação já disponível na plataforma, nomeadamente tokens, sessões e CDR.