Você está na página 1de 8

SSX

IMPORTAÇÃO DE VIAGENS

Versão Data Descrição

1.0 17/09/2018 Versão inicial

1.1 18/11/2019 Ajuste validação de nome

1.2 31/03/2020 Exemplo de valores do


pedido

1.3 29/07/2020 Torna-se obrigatório o


preenchimento do campo
“Código de integração do
aplicativo” (Antigo “Código
integração pessoa”)
Formato
O arquivo deverá ser no formato de texto com codificação ASCII. Os campos deverão ser
separados por ponto e vírgula. Quando um campo não obrigatório não for informado sua
“posição” deverá constar no arquivo mesmo assim.

Cada linha do arquivo vai representar uma ordem de serviço (O.S.) para execução de uma
entrega, coleta ou um serviço, de uma viagem. É possível executar mais de um pedido em
uma mesma O.S., bastando duplicar a linha e alterando apenas os dados referentes ao
segundo pedido.

Dados da viagem

Campo Tipo Tamanho Obrigatório Descrição

Código de integração da String 150 Sim Código identificador da viagem.


viagem Deve ser único em ambos os
sistemas integrados

Nome da viagem String 2-20 Sim Nome da viagem

Data de partida Datetime - Sim Data de partida prevista da


viagem.

Formato: AAAA-MM-DD
HH:MM:SS

Data de chegada Datetime - Sim Data de chegada prevista da


viagem.

Formato: AAAA-MM-DD
HH:MM:SS

Tolerância para Int32 - Sim Tolerância para antecipar


antecipar abertura abertura em minutos

Tolerância para atrasar Int32 - Sim Tolerância para atrasar abertura


abertura em minutos
Tempo máximo da Int32 - Sim Tempo máximo da viagem em
viagem minutos

Código de integração do String 40 Sim Código de integração do


aplicativo* aplicativo Onboard

Código de integração do String 40 Não Código de integração do veículo


veículo designado para a viagem..

Código de integração da String 40 Não Código identificador da unidade


unidade organizacional organizacional

Colaborador String - Não Lista de código de integração da


pessoa separados por “,”
(vírgula)

Cor da viagem Int16 - Sim Cor da viagem (vide ​apêndice


Cores da viagem​)

Código de integração da String 40 Não Código identificador na área de


área de partida partida

Código de integração da String 40 Não Código identificador na área de


área de chegada chegada

*antigo “Código integração pessoa”

Dados do cliente

Campo Tipo Tamanho Obrigatório Descrição

Código de integração String 40 Sim Código de integração do cliente


do cliente

Tipo do cliente Byte - Sim Tipo de cliente: 1 = Pessoa física


2 = Pessoa jurídica

Nome do cliente String 300 Sim Nome / Nome fantasia

Razão social String 300 Não Razão social. (Não utilizar para
pessoa física, mas informar o valor
em branco para esta “posição”)

CPF / CNPJ String 14 Não CPF / CNPJ (somente números)

Registro String 20 Não Inscrição estadual / Registro Geral


(RG)
Dados do pedido

Campo Tipo Tamanho Obrigatório Descrição

Número do pedido String 100 Sim Número do pedido

Nota fiscal String 100 Sim Nota fiscal do pedido

Peso Decimal - Não Peso do pedido em quilos

Volume Decimal - Não Volume do pedido em m³

Valor Decimal - Não Valor do pedido em R$ **

Colaborador responsável String 40 Não Código de integração da pessoa


do pedido

Código de integração do String 40 Não Código de integração do contato


contato

Nome de contato String 150 Não Nome do contato do pedido

DDI do telefone de contato Int16 - Não DDI do telefone de contato do


pedido

DDD do telefone de Int16 - Não DDD do telefone de contato do


contato pedido

Número do telefone de Int64 - Não Número do telefone de contato


contato do pedido

Dados do serviço do pedido

Campo Tipo Tamanho Obrigatório Descrição

Código de integração String 40 Sim Código identificador do serviço


do serviço

Código de integração String 40 Sim Código identificador do endereço do


do endereço do cliente do pedido
cliente

Nome do endereço String 150 Sim Nome descritivo do endereço do


pedido

País do endereço do Byte - Sim Código do país do endereço do


serviço serviço.
Padrão = 29 (Brasil).
(Para obter a lista de países entre em
contato com a CRC)

Estado do endereço String 50 Sim Estado do endereço do serviço


do serviço

Cidade do endereço String 100 Sim Cidade do endereço do serviço


do serviço

Bairro do endereço String 100 Sim Bairro do endereço do serviço


do serviço

Logradouro do String 150 Sim Logradouro do endereço do serviço


endereço do serviço

Complemento do String 100 Não Complemento do endereço do serviço


endereço do serviço

Número do endereço String 50 Não Número do endereço do serviço


do serviço

CEP do endereço do String 15 Não Código de endereçamento postal


serviço (CEP) do endereço do serviço.
Somente números

Latitude do endereço Double - Não* Latitude do endereço do serviço


do serviço
*​Se não forem informadas latitude e
longitude, será necessário marcar a
opção "Obter localização" na tela de
importação

Longitude do Double - Não* Longitude do endereço do serviço


endereço do serviço
*​Se não forem informadas latitude e
longitude, será necessário marcar a
opção "Obter localização" na tela de
importação

Dados da execução do serviço do pedido

Campo Tipo Tamanho Obrigatório Descrição

Ordem dos pontos do trajeto Byte - Não Ordem dos pontos do trajeto

Tempo estimado do Int32 - Não Tempo estimado do


atendimento atendimento em segundos
Número da ordem de serviço String 100 Não Número da ordem de
serviço

Observação String 500 Não Observação da O.S.

Regras e exceções
Caso exista uma viagem no arquivo com um Código de integração já existente no sistema,
a mesma será atualizada com os novos dados informados.

Durante a importação alguns erros podem ser detectados. Caso isso aconteça, o sistema
informará ao usuário as linhas que contém erros e qual o tipo. Os registros válidos serão
incluídos no banco de dados.
Exceção Descrição

Campo não informado Um campo obrigatório não foi informado.

Formato do campo incorreto O campo informado não é do tipo esperado ou não


está no formato correto.

Tamanho do campo incorreto A informação excede o tamanho do campo.

Exemplo

ViagemCod001;ViagemNome001;2018-09-17 07:01:00;2018-09-17
08:00:00;120;120;3600;;1129;UND1;00000001,00000002;1;CD1;CD2;CLI001;
1;Cli import
viagem;;12345678909;;PED00001;;10;11;12;VDE.JOSE;CLI1PES001;Pes 1
cliente
1;55;21;958458577;DELIVERY;CLI1END001;Trabalho;29;RJ;Niteroi;Vital
Brasil;Rua desembargador Aires
Itabaiana;Casa;76;24220008;-22.9078693;-43.10922360;2;600;OS0000028;
Cuidado com o cão

** Para o campo “Valor do pedido” siga os exemplos abaixo:


* Para informar R$ 1.250,50 (Hum mil, duzentos e cinquenta reais e cinquenta
centavos). Preencha o campo valor do pedido conforme abaixo:
===> ​1250.50
* Para informar R$ 250,00 (Duzentos e cinquenta reais). Preencha o campo
valor do pedido conforme abaixo:
===> ​250
* Para informar R$ 10.500,00 (Dez mil e quinhentos reais). Preencha o campo
valor do pedido conforme abaixo:
===> ​10500
* Para informar R$ 552,65 (Quinhentos e cinquenta e dois reais e sessenta e
cinco centavos). Preencha o campo valor do pedido conforme abaixo:
===> ​552.65

Ou seja, coloque ponto quando precisar informar os centavos. Caso contrário, informe o
valor diretamente sem ponto ou vírgula.
Cores da viagem
Código da cor Descrição da cor (RGB) Cor

1 #988383

2 #D65E5E

3 #D97B4C

4 #D66B98

5 #936BD6

6 #608CE0

7 #65D6B7

8 #9FD96D

9 #F0B132

10 #949191

11 #C2C0C0