EXPORTAÇÃO DE ESCALA DIÁRIA PARA Transdata (ITS).

Esta documentação visa instruir a equipe operacional na utilização da rotina de integração com o sistema ITS.

Transdata, destacando os mecanismos de controle implantados para garantir a consistência das escalas diárias.

enviadas.

1. Parametrização do Sistema

Antes de realizar a primeira exportação, é mandatório realizar a homologação e o cadastro das credenciais de

Comunicação WebService fornecida pela Transdata. 

Caminho de acesso: 

Utilitários > Parâmetros de Configuração do Sistema > Específico > Transdata.

Campos para preenchimento na seção "Integração WebServices > Exportação":

1. URL do WebService: Informar o endereço de endpoint válido.
2. Código da Empresa (Transdata): Identificador numérico fornecido pela Transdata (ex.: 1312802).
3. Nome da Empresa: Razão social correspondente (Ex.: VIAÇÃO PIONEIRA LTDA).
4. Usuário e Senha: credenciais exclusivas para a autenticação segura da API.

2. Acesso à tela de exportação.

Após a validação dos parâmetros técnicos, a rotina diária de geração deve ser executada por meio do módulo de

Planejamento Operacional.

Caminhos de Acesso Operacional: 

1. Escala > Escala por Período
2. Utilitários > Integrações > Transdata (acesso direto à tela ESC - Exportação Escala Transdata).

3. Preenchimento e funcionalidade da tela.

A tela opera de forma intuitiva, baseada em filtros de seleção e movimentação dinâmica de grades (grids) de

dados.

Tratamento de Erros de Digitação: O sistema possui validações automáticas de consistência (fail-fast). Se o

Operador, deixar os campos de data em branco, colocar a data fim anterior à data início ou digitar datas.

inexistentes (como 32/13/2026), o processamento será interrompido, exibindo alertas amigáveis como "Informe uma data válida" ou "data inválida!".

4. Retornos do Processamento e Mensagens de Alerta

A nova versão do software introduziu respostas mais inteligentes e descritivas para garantir o rastreamento.

completo da operação.

• A. Cenário sem movimentação no período.

Se o usuário tentar exportar um intervalo de datas em que uma determinada escala selecionada não possua nenhuma viagem ou serviço planejado, o sistema interrompe o envio de dados vazios. É exibida em tela uma

Mensagem informativa do tipo:

"Nenhum dado encontrado para esta escala neste período."

• B. Cenário de Divergência/Inconsistência de Dados (Novo Log HTML Detalhado)

Caso a estrutura de envio encontre divergências cadastrais ou validações rejeitadas na ponta da Transdata (como

inconsistências em códigos de linhas ou matrículas), o sistema não exibirá mais apenas um erro genérico.

1. Uma caixa de diálogo será exibida na tela, alertando sobre a divergência e informando a criação de um arquivo de log específico. 
2. O sistema gerará automaticamente um arquivo de auditoria formatado em HTML diretamente na raiz do diretório do módulo ESC. 
3. O nome do arquivo seguirá o padrão cronológico para evitar sobrescritas:

• Log_Erro_Exportacao_Transdata_YYYYMMDD_HHMMSS.html (Ex:
• Log_Erro_MANAGER_20260609_174930.html).

Este arquivo HTML amigável permite ao suporte técnico do cliente ou à gerência operacional identificar

imediatamente qual linha, serviço ou veículo gerou a rejeição (Ex.: Divergência na Empresa 1312802 / Linha 4030),

acelerando a correção.

5. Resultado Previsto em Cenário Ideal (Sucesso)

Quando as parametrizações estão corretas, a escala diária encontra-se devidamente aprovada no ERP Globus, e

As regras cadastrais batem com as do sistema ITS Transdata; o fluxo ocorre da seguinte forma:

Comportamento Esperado no Fluxo Perfeito:

1. O sistema processa e compila todas as informações operacionais das escalas selecionadas em um arquivo XML válido no padrão UTF-8.
2. O ERP realiza a transmissão direta do payload para a API da Transdata, recebendo um retorno técnico de sucesso HTTP 200 OK.
3. Uma mensagem amigável de confirmação é exibida ao operador na tela de processamento.
4. A operação grava de forma irrevogável um registro de auditoria na Listagem de Logs do Sistema. (Módulo CTR - Controle), preenchendo automaticamente quem executou, o dia e o horário preciso, trazendo as métricas processadas sob o seguinte padrão normatizado:

- TRANSDATA [SUCESSO]: Exportação da Emp/Fil: 009/001 no período de 08/06 a 12/06. Qtd.

Escalas: [X] | Qtd. Serviços: [Y] | Qtd. Viagens: [Z]. Código de retorno da API: HTTP

200 OK.