Histórico da Página
Introdução
draw.io Diagram | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Sistemas EnvolvidosEnvolvidos
Integração
Escopo
Pré-requisitos instalação/implantação/utilização
Layout de Requisição
Âncora doUnblockReleasedTrip doUnblockReleasedTrip
doUnblockReleasedTrip: Integração SOAP, Assíncrona com a publishReleasedTrip; | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
unblockReleasedTrips | unblockReleasedTrips[] | Sim | N/A | Elemento de agrupamento de todas as solicitações de desbloqueio de viagens; |
Âncora unblockReleasedTrips unblockReleasedTrips
unblockReleasedTrip, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
unblockReleasedTrips | unblockReleasedTrip[] | Sim | N/A | Elemento de agrupamento de todas as solicitações de desbloqueio de viagens; |
Âncora | ||||
---|---|---|---|---|
|
unblockReleasedTrip, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
identifier (unblock release trip) | Numérico (inteiro) | Sim | 10 | ID da mensagem de solicitação de liberação da viagem; | Este campo deve ser de uma mensagem de solicitação de liberação de viagem válida ou -1 quando ocorrer algum erro no sistema externo ao tentar recriar as viagens do CPL (neste caso, a requisição feita neste serviço será ignorada pelo CPL); no caso de erro no sistema externo, o detalhe deste erro pode ser enviado no elemento "ERPMessageResponses"; |
ERPMessageResponses | eRPMessageResponseList[] | Não | N/A | Entidade de agrupamento das respostas do sistema externo; | |
orderBreakResponses | Não | N/A | Entidade de agrupamento de uma resposta do sistema externo para uma quebra do CPL; | Observação: se todas as quebras, menos 1, foram aprovadas, a última será aprovada automaticamente; | |
tripReleaseResponses | tripReleaseResponseList[] | Sim | N/A | Entidade de agrupamento de uma resposta do sistema externo para as liberações de uma viagem do CPL; | |
tripLoadsSourceIds | tripLoadsSourceIdList[] | Sim | N/A | Entidade de agrupamento para envio dos source ids das cargas do sistema externo para o CPL; |
Âncora eRPMessageResponseList eRPMessageResponseList
eRPMessageResponseList, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
ERPMessageResponses | eRPMessageResponse[] | Sim | N/A | Elemento de agrupamento de todas as solicitações de desbloqueio de viagens; |
Âncora eRPMessageResponse eRPMessageResponse
eRPMessageResponse, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
msg | Alfanumérico | Sim | N/A | Mensagem de resposta do sistema externo; |
Âncora orderBreakResponses orderBreakResponses
orderBreakResponses, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
orderBreakResponses | orderBreakResponse[] | Sim | N/A | Elemento de agrupamento de todas as solicitações de desbloqueio de viagens; |
Âncora orderBreakResponse orderBreakResponse
orderBreakResponse , tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
regionSourceId | Alfanumérico | Sim | 30 | Identificador da regional; | Deve ser uma regional válida; |
breakId | Numérico (inteiro) | Sim | 10 | ID da quebra do CPL; | Este campo deve receber um ID de quebra válido; não se deve re-enviar IDs de quebra que já foram liberados; o sistema externo deverá dar um retorno para todos os breakIds gerados pelo CPL na interface de liberação de viagem para que esta seja liberada; |
orderId | Alfanumérico | Sim | 30 | ID do pedido de transporte associado à quebra; | Importante: - Caso o sistema externo deseja que esta quebra seja vinculada a um novo pedido, basta informar o nome do novo pedido neste campo; as unidades relacionadas a esta quebra serão associadas ao novo pedido; os dados do novo pedido serão copiados do pedido original; - Esta alteração do pedido apenas será realizada se o campo status for enviado com o valor "1"; |
orderItemId | Alfanumérico | Sim | 30 | ID do item do pedido de transporte associado à quebra; | Importante: - Caso o sistema externo deseja que esta quebra seja vinculada a um novo item de pedido, basta informar o nome do novo item pedido neste campo; as unidades relacionadas a esta quebra serão associadas ao novo item de pedido; os dados do novo item de pedido serão copiados do item de pedido original; - Esta alteração do item do pedido apenas será realizada se o campo status for enviado com o valor "1"; - Se o código do item de pedido for alterado mas o código de pedido permanecer o mesmo do pedido original, a mensagem será rejeitada; |
status | Booleano | Sim | 1 | Status de resposta do sistema externo sobre a quebra do CPL; | 0=Quebra não realizada; 1=Quebra realizada; |
msg | Alfanumérico | Não | 500 | Mensagem de resposta do sistema externo sobre a quebra do CPL; |
Âncora tripReleaseResponseList tripReleaseResponseList
tripReleaseResponseList, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
tripReleaseResponseList | tripReleaseResponse[] | Sim | N/A | Elemento de agrupamento de todas as solicitações de desbloqueio de viagens; |
Âncora | ||||
---|---|---|---|---|
|
tripReleaseResponse, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
regionSourceId | Alfanumérico | Sim | 30 | Identificador da regional; | Deve ser uma regional válida; |
tripCode | Numérico (inteiro) | Sim | 10 | ID da viagem do CPL; | Este campo deve receber um ID de viagem válido; não se deve enviar IDs de viagens que já foram liberadas; |
orderSourceId | Alfanumérico | Sim | 30 | ID do pedido de transporte associado à viagem; | Este campo deve receber um ID de pedido válido para a viagem; |
itemId | Alfanumérico | Sim | 30 | ID do item do pedido de transporte associado ao pedido da viagem; | Este campo deve receber um ID de item de pedido válido para o pedido da viagem; o sistema externo deverá dar um retorno para todos os itens de pedido existentes na viagem para que esta seja liberada; |
status | Booleano | Não | 1 | Status de resposta do sistema externo sobre a viagem do CPL; | 0=Não desbloqueia a viagem; 1=Desbloqueia a viagem; se este campo não for preenchido, ele será considerado como 0; |
msg | Alfanumérico | Não | 500 | Mensagem de resposta do sistema externo sobre a viagem do CPL; |
Âncora tripLoadsSourceIdList tripLoadsSourceIdList
tripLoadsSourceIdList, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
tripLoadsSourceIds | tripLoadsSourceId[] | Sim | N/A | Entidade de agrupamento para envio dos source ids das cargas do sistema externo para o CPL; |
Âncora tripLoadsSourceId tripLoadsSourceId
tripLoadsSourceId, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
regionSourceId | Alfanumérico | Sim | 30 | Identificador da regional; | Deve ser uma regional válida; |
tripId | Numérico (inteiro) | Sim | 10 | ID de uma viagem do CPL; | |
loads | load[] | Sim | N/A | Elemento de agrupamento de todas as cargas da viagem; | Quando enviada, esta seção deverá retornar todas as cargas da viagem; |
Âncora load load
load, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
loadId | Numérico (inteiro) | Sim | 10 | ID da carga da viagem no CPL; | Estes campos são apenas para que se possa ter uma referência do ID de uma carga do sistema externo no CPL; se o loadId não for válido (ex.: vazio ou um código inexistente no CPL) ou estiver associada a uma viagem distinta da informada, o CPL deverá retornar uma mensagem de erro e a requisição deverá ser ignorada; |
loadSourceId | Numérico (inteiro) | Sim | 30 | ID da carga da viagem no sistema externo; |
Layout de Resposta
tripLoadsSourceIdList, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
result | results[] | Sim | N/A | Entidade de agrupamento para envio dos resultados |
Âncora | ||||
---|---|---|---|---|
|
results, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
results | result[] | Sim | N/A | Entidade de agrupamento para envio dos resultados |
Âncora | ||||
---|---|---|---|---|
|
result, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
errorCodes | errcode[] | Não | N/A | Lista de erros | |
errorMessage | Alfanumérico | Não | N/A | Mensgem de erro | |
identifier | Alfanumérico | Sim | N/A | ID da mensagem de solicitação de liberação da viagem; | |
sucess | Alfanumérico | Sim | 1 | TRUE or FALSE |
Âncora | ||||
---|---|---|---|---|
|
errcode, tipo de dado utilizado nas integrações do TRE | |||||
---|---|---|---|---|---|
Nome | Tipo | Obrigatório | Tamanho | Descrição | Observações |
value | Alfanumérico | Não | N/A | Código do erro |
Catalogo de erros
Anexos
Anexos