Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Introdução

Sistemas Envolvidos

Integração

Escopo

  • A interface “PublishReprogrammingService” PublishReprogrammingService serve apenas para solicitar ao sistema externo permissão para a reprogramação da carga no CPL TRE.
  • Para solicitar esta permissão, o CPL TRE irá mandar uma mensagem ao sistema externo através da estrutura “publishReprogrammingServiceRequest” e publishReprogrammingServiceRequest e o sistema externo deverá retornar uma mensagem de resposta ao CPL ao TRE na estrutura “publishReprogrammingServiceResponse”  publishReprogrammingServiceResponse
  • Se o sistema externo retornar um status de que a reprogramação é possível (campo status=0), o CPL permitirá TRE permitirá ao usuário a alteração da carga.
  • Se o sistema externo retornar um status de que reprogramação não é possível (campo status=1 ou 2 ou 3), o CPL não TRE não permitirá ao usuário a alteração da carga.
  • Caso o sistema externo retorne que a reprogramação é possível (campo status=0), após a reprogramação da carga no CPL TRE, o CPL TRE irá enviar novamente ao sistema externo (através da interface “ReleasedTripPublishRequestService” publishReleasedTrip) uma mensagem de publicação de viagens com as alterações feitas pelo usuário na reprogramação.
  • Neste cenário, quando o sistema externo permitir a reprogramação da carga, é importante que o sistema externo volte o status do documento de transporte para uma condição que permita uma futura edição pelo CPL TRE (que será feita através da interface “ReleasedTripPublishRequestService” publishReleasedTrip).

Pré-requisitos instalação/implantação/utilização

Layout de Requisição

Âncora
publishReprogrammingServiceRequest
publishReprogrammingServiceRequest

publishReprogrammingServiceRequest, Integração SOAP, Síncrona
NomeTipoObrigatórioTamanhoDescriçãoObservações
publishReprogrammingService (início)EntidadeSimN/A
Elemento de agrupamento das solicitações de reprogramação de viagens do CPL ao sistema legado;
regionSourceIdAlfanuméricoSim30Identificador da regional;Deve ser uma regional válida;
basketSourceIdAlfanuméricoNão30ID da cesta onde esta operação foi realizada manualmente pelo usuário no CPL;Este campo poderá não ser enviado nos casos em que a solicitação de reprogramação foi feita de forma automática e não através da tela do CPL (nestes casos, não se pode identificar a cesta do usuário);
trips (início)ListaSimN/AElemento de agrupamento de todas as viagens do CPL que se quer reprogramar;Deverá haver pelo menos 1 viagem do CPL nesta lista;
trip (início)EntidadeSimN/A
Elemento de agrupamento de uma viagem do CPL;tripIdNumérico (inteiro)Sim10ID da viagem cuja reprogramação está sendo solicitada pelo CPL ao sistema legado;












loads (início)ListaSimN/AElemento de agrupamento de todas as cargas da viagem;
load (início)EntidadeSimN/AElemento de agrupamento de uma carga da viagem;
loadIdNumérico (inteiro)Sim10Identificador de uma carga da viagem;
loadSourceIdAlfanuméricoNão30Identificador externo de uma carga da viagem;
load (fim)EntidadeSimN/A

loads (fim)ListaSimN/A

trip (fim)EntidadeSimN/A

trips (fim)ListaSimN/A

publishReprogrammingService (fim)EntidadeSimN/A

Âncora
trip
trip

publishReprogrammingServiceResponse, tipo de dado utilizado nas integrações do TRE
NomeTipoObrigatórioTamanhoDescriçãoObservações
tripIdintSim10ID da viagem cuja reprogramação está sendo solicitada pelo CPL ao sistema legado;

Âncora
load
load

Layout de Resposta

Âncora
publishReprogrammingServiceResponse
publishReprogrammingServiceResponse

publishReprogrammingServiceResponse, tipo de dado utilizado nas integrações do TRE
NomeTipoObrigatórioTamanhoDescriçãoObservações
publishReprogrammingServiceResponse (início)EntidadeSimN/AElemento de agrupamento das respostas às solicitações de reprogramação de viagens do CPL ao sistema legado;
result (início)ListaSimN/AElemento de agrupamento de todas as viagens do CPL que se quer reprogramar com os respectivos status das solicitações;Deverá haver pelo menos 1 viagem do CPL nesta lista;
regionSourceIdAlfanuméricoSim30Identificador da regional;Deve ser uma regional válida;
tripIdNumérico (inteiro)Sim10ID da viagem cuja reprogramação foi solicitada pelo CPL ao sistema legado;
statusNumérico (inteiro)Sim1Status da solicitação de reprogramação de viagem enviada pelo CPL ao sistema legado;0=Reprogramação autorizada; 1=Viagem cancelada; 2=Viagem não encontrada; 3=Viagem já despachada/Reprogramação não autorizada;

Importante:
- Se o sistema externo retornar o código 0, a viagem será colocada no seu último status antes da liberação (Observação: notar que alguns destes status podem não permitir a reprogramação! Ex.: "Viagem Ofertada");
- Se o sistema externo retornar o código 1, o CPL irá efetuar o cancelamento da viagem automaticamente e o sistema externo
não será novamente notificado deste cancelamento pelo CPL (como foi o sistema externo que informou que a viagem já está cancelada, esta notificação extra do CPL é desnecessária;
- Se o sistema externo retornar os códigos 2 ou 3, não será possível reprogramar a viagem no CPL;
result (fim)ListaSimN/AElemento de agrupamento de todas as viagens do CPL que se quer reprogramar com os respectivos status das solicitações;Deverá haver pelo menos 1 viagem do CPL nesta lista;
publishReprogrammingServiceResponse (fim)EntidadeSimN/A

Elemento de agrupamento das respostas às solicitações de reprogramação de viagens do CPL ao sistema legado;


Catalogo de mensagens

Âncora
catmsg
catmsg

CódigoMensagemDescrição

Anexos

Anexos