MultiPortal - Webcol Consulta de Lat/Long e Envio de ocorrência

Nome da Integração ou customização:

MultiPortal - Webcol Consulta de Lat/Long e Envio de ocorrência

Finalidade: 

Finalidade de Importar posições dos veículos cadastrados no MultiPortal, a cada X minutos e salvar no banco de dados. Também juntamente a ela há uma integração com a Webcol, aonde enviamos ocorrências, entregas e comprovantes. 

Funcionamento: 

1: A cada X minutos buscamos as lat/long dos veículos. 

2: A cada 30 minutos enviamos uma ocorrência (00 - Nota em trânsito) para a Webcol, somente de veículos que estejam com MDF-e em aberto e sem nenhuma ocorrência.

3: Ao chegar no cliente será inserida a ocorrência "Chegada no cliente" ou "Devolução", e enviaremos para a Webcol o código de ocorrência (98 – Chegada no cliente) ou (25 – Devolução).

4: Ao concluir a Entrega será informada a data de entrega, com isso será enviado o código de ocorrência (01 – Entrega realizada normalmente) .

5: Ao inserir o comprovante no CT-e, enviará a Webcol.

Critérios para envio:

• Nota precisa ter sido vinculada pelo embarcador ou pela transportadora no portal da Webcol.

• Os veículos devem ser cadastrados no Multiportal e no Movtrans. A placa deve ser IDÊNTICA.

• Para começar a enviar dados de Em trânsito, o MDF-e atrelado ao CT-e deverá estar em autorizado e não encerrado.

• Para envio de comprovante, o único formato aceito é JPG.

• Somente serão enviadas requisições dos registros cuja data de ocorrência consta nos últimos 7 dias.

• Somente serão enviados os comprovantes de cargas cuja entrega foi registrada com sucesso no WEBCOL.

Configuração:

• Necessário configurar no servidor interno o código do cadastro do tomador que será utilizado como base (Procedimento feito pelo Desenvolvimento). Somente serão enviados os dados dos ct-es desse tomador configurado.

• Necessário efetuar o cadastro das Ocorrências de integração e vinculá-las ao cadastro das Ocorrências de entrega (Procedimento feito pelo Suporte).

Fluxo de uso:

1. Cadastro da nota no portal Webcol.pelo embarcador ou pela transportadora.

2. Geração de ct-e e vínculo do ct-e ao mdf-e.

3. Ao chegar no cliente, inserir no ct-e a ocorrência "Chegada no cliente" (98 – Chegada no cliente) ou "Devolução" (25 – Devolução)..

4. Ao concluir a entrega, inserir da data de entrega no ct-e.

5. Anexar Comprovante de entrega ao ct-e.

Consulta de Logs:

Acessar um dos servidores de produção (44, 45 ou 55);

No navegador, utilize a URL base: [http://192.168.1.233:7014/api/webcol_iff/] ;

Para indicar qual dos logs deseja acessar, informe o parâmetro de tipo "t" (o = ocorrências | c = comprovantes), como no exemplo: [http://192.168.1.233:7014/api/webcol_iff/?t=c] ; PS: Logs de Entrega constam junto com as ocorrências.

Para indicar qual a data dos logs deseja acessar, informe o parâmetro de data "d", utilizando o formato ANO-MÊS-DIA (AAAA-MM-DD), como no exemplo: [http://192.168.1.233:7014/api/webcol_iff/?t=c&d=2024-04-17] ;

OBS: No momento, só pode ser acessado à partir de nossos servidores (44, 45 e 55).

Principais Rejeições: "Erro" - Resolutiva:

1. Erro: "data da geolocalizacao inválida"
   Resolução: data não pode ser antes da emissão da nota fiscal.
   A data não pode ser depois da data atual (dia de hoje).
   Formato inválido (formato permitido AAAA- MM-DD)

2. "Erro: "previsão de entrega inválida"
   Resolução: A previsão de entrega não pode ser antes da emissão da nota fiscal.

3. "Erro: "data de entrega inválida"
   Resolução: A data de entrega não pode ser antes da Data de Emissão da nota fiscal.
   A data de entrega não pode ser antes da chegada no cliente (ocorrência 98)
   A data de entrega não pode ser depois da data atual (dia de hoje).

4. "Erro: "data de devolução inválida"
   Resolução: A data de devolução não pode ser antes da data de emissão da nota fiscal
   A data de devolução não pode ser depois da data atual (dia de hoje).

5. "Erro: "ocorrência inválida"
   Resolução: O código da ocorrência não existe no cadastro padrão de ocorrência – PROCEDA.

6. "Erro: "transportadora não encontrada"
   Resolução: O cadastro da transportadora não existe na WebCOL.

7. "Erro: "a nota fiscal não pertence à esta transportadora"
   Resolução: A nota fiscal pertence à outra transportadora.