Ir para o conteúdo

Web service Portolog: Envio de Informações de Contingência

Serviço web do portolog que encaminha aos web services dos sistemas externos interessados, a informação das contingências ocorridas nos terminais, locais de acesso do porto e pontos de controle de puxada de carga, e que impedem o fluxo dos transportes até o seu destino.

Para utilizar esse serviço os sistemas externos devem implementar um web service para recebimento destas informações e informar a sua respectiva URI no campo "Caminho do serviço(URI) para recebimento de informações de contingência", no "Cadastro de Integração com Sistemas Externos" do módulo Cadastro.

Atenção:

1. O sistema externo deve criar um serviço web baseado na autenticação mútua via certificados digitais, sendo portanto obrigatório o caminho possuir o protocolo "https" no início de sua URI. Também será necessário que o sistema externo possua salvo na máquina que fará essa comunicação com o Portolog as cadeias de certificados do SERPRO, para que possam reconhecer a autenticidade do Servidor do Porto Sem Papel. As cadeias de certificados são as mesmas disponíveis na página de autenticação.

2. O portolog só encaminhará as informações de contingência via requisição web service no formato XML.

3. As informações de contingência também serão encaminhadas através de uma mensagem para o e-mail cadastrado no "Cadastro de Integração com Sistemas Externos".

4. Importante informar que, a partir do momento da criação de uma contingência até o seu devido encerramento, todos os DL-es que tenham como destino algum dos pontos de controle afetados pela contingência não poderão ser sequenciados. Após o encerramento da contingência o sequenciamento é novamente liberado.

5. Ressaltamos ainda que, no momento do encerramento de uma contingência, todos os DL-es que estavam sequenciados e que foram afetados pela contingência serão resequenciados automaticamente pelo sistema. Para ter acesso aos dados de sequenciamento de todos os DL-es resequenciados por motivo de contingência, o sistema externo deve encaminhar uma requisição, informando o campo de filtro específico, ao Web service de consulta de agendamento de transporte.

Atores que podem utilizar o Serviço:

  • Operador Portuário
  • Terminal Portuário
  • Autoridade Portuária
  • Ponto de Controle
  • ANTT

Content-Type:

application/xml

Requisições com Informações de Contingência Encaminhadas pelo Portolog:

Nome Descrição Tipo Observação
versao versão do arquivo de retorno da consulta de informações de DL-es Futuros String(Obrigatório) Versão Atual: 1.00
porto Bitrigrama do porto afetado pela contingência String(Obrigatório)
locais Locais de acesso do porto afetados pela contingência String(Opcional)
terminais Nomes dos terminais afetados pela contingência String(Opcional)
pontos Descrição dos Pontos de Controle de Puxada de Carga afetados pela contingência String(Opcional)
dataInicio Data/Hora de início da contingência Data/Hora(Obrigatório) Formato: AAAA-MM-DDTHH:MM:SS.
dataTermino Data/Hora de encerramento da contingência Data/Hora(Opcional) Formato: AAAA-MM-DDTHH:MM:SS.

(*)Campo exibido somente no encerramento da contingência.
motivo Motivo da inclusão da contingência String(Obrigatório)
acoes Ações executadas para o encerramento da contingência String(Opcional) (*)Campo exibido somente no encerramento da contingência.

Observações:

Os sistemas externos devem receber as informações de contingência de acordo com o seguinte critério:

              - Todos os terminais do porto da contingência receberão informações de contingência deste porto.
              - Todos os pontos de controle que atendem ao porto da contingência receberão informações de contingência deste porto
              - A autoridade portuária do porto da contingência receberá informações de contingência do seu porto
              - A ANTT receberá informações de contingência de todos os portos

 

Exemplo dos Arquivos XML Encaminhados:

 

Exemplo do arquivo XML encaminhado na criação de uma contingência:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<contingencia versao="1.00">
    <dataInicio>2020-03-02T14:31:17.572-03:00</dataInicio>
    <motivo>Alagamento ao longo da Rodovia dos Bandeirantes.</motivo>
    <porto>BRSSZ</porto>
    <locais>Local de Acesso ao Porto pela Zona Norte</locais>
    <pontos>Ponto de Puxada Km 15</pontos>
    <pontos>Ponto de Puxada Km 300</pontos>
    <terminais>TERMINAL DA CONSOLAÇÃO</terminais>
    <terminais>TERMINAL DOS AFOGADOS</terminais>
</contingencia>

 

Exemplo do arquivo XML encaminhado no encerramento de uma contingência:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<contingencia versao="1.00">
    <dataInicio>2020-03-02T14:31:17.572-03:00</dataInicio>
    <dataTermino>2020-03-02T14:32:46.075-03:00</dataTermino>
    <motivo>Alagamento ao longo da Rodovia dos Bandeirantes.</motivo>
    <acoes>Foram liberadas rotas alternativas para os transportes acessarem aos terminais.</acoes>
    <porto>BRSSZ</porto>
    <locais>Local de Acesso ao Porto pela Zona Norte</locais>
    <pontos>Ponto de Puxada Km 15</pontos>
    <pontos>Ponto de Puxada Km 300</pontos>
    <terminais>TERMINAL DA CONSOLAÇÃO</terminais>
    <terminais>TERMINAL DOS AFOGADOS</terminais>
</contingencia>