Árvore de páginas

Versões comparadas

Chave

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

...

Apontamento do Comprovante de Entrega/Coleta, possibilitando obter os dados do recebedor Recebedor ou Expedidor (Nome, Documento e a Imagem do documento assinado);

...

Informações
titleIMPORTANTE

O motorista deverá estar integrado ao Portal do Checklist com perfil executor para que a integração ocorra corretamente.

Deverá existir na configuração do Portal do Checklist um roteiro/script denominado "Data_Entrega" e um denominado "Data_Coleta", o TMS Protheus não irá enviar o cadastro do roteiro para que o aplicativo crie automaticamente, essa inserção deve ser manual.

Segue abaixo demonstração, da criação do processo do roteiro denominado "Data_Coleta", o processo de roteiro/script denominado "Data_Entrega" permanece o mesmo da documentação de integração checklist x ocorrência automática x comprovante de entrega eletrônico:

  1. Acessar a opção "Roteiro" no Portal do Checklist:
    1.1 Inserir novo roteiro;


    1.2 Realizar a inserção de dados conforme imagem abaixo, importante - nomenclatura deverá ser "Data_Coleta", clique em Avançar (lado superior direito):



    1.3 Será apresentada a tela a seguir, clique em "Incluir item";



    1.4 Na opção 2 "Criação de roteiro", clique em Incluir Item, será apresentada a seguinte tela, selecione a opção Positivo/Negativo e em seguida clique em Criar:

1.5 Inserir primeiro item conforme detalhamento abaixo:
    1.5.1 Inserir1 Inserir/digitar a primeira pergunta: "Coleta Efetuada?";

    Obs: Existem apenas três perguntas validas para a Primeira Pergunta do Roteiro, "DOCUMENTO ENTREGUE?", "CTE ENTREGUE?" e "COLETA EFETUADA?".

    1.5.2 Clique em opção "Inserir Evidência", na opção Mínimo = 1 e Máximo = 2;
    1.5.3 Em opções de resposta inserir "OK" e "NOK";
    1.5.4 A opção de "Desvio" será preenchido ao término da inclusão de todos os itens/perguntas.
    1.5.5 Clique em Incluir item.

       1.5 Será apresentada novamente a tela de Tipos de Item, escolha a opção "Texto":
       

 1.6 Na caixa pergunta, digite "Motivo":
        Importante: Neste momento o SIGATMS Protheus não faz uso da resposta negativa (Coleta/Entrega NÃO efetuada), e portanto do motivo configurado no item 2 abaixo. A configuração do item 2 se faz necessário por padrão do Portal          Meu Checklist, para que ocorra o correto funcionamento da integração.
Clique em Incluir item.



1.6 Será apresentada novamente a tela de Tipos de Item, escolha a opção "Texto":
       

1.7 Na caixa pergunta, digite "Expedidor":

Clique em Incluir item.

1.8 Será apresentada novamente a tela de Tipos de Item, escolha a opção "Texto":
       

1.9 Na caixa pergunta, digite "Documento":
Clique em Incluir item.


Clique em Incluir item.

2.0 Após isto, será necessário voltar ao Item 1, para a configuração dos itens de Desvio.
      Devem ser inseridos os Itens/Perguntas 2-Motivo e 3-Expedidor.
Image Removed

2.1 As configurações devem ficar conforme a imagem a seguir, após o ajuste clique em Salvar:

Valide:

Para a opção OK o desvio será 3 - Expedidor;
Para a opção NOK, o desvio será 2 - Motivo;

Após a inserção, clique em Avançar;

Image Removed

2.2 Será apresentada tela com a prévia da configuração efetuada, após validar, clique em "Publicar", (lado superior direito):

Image Removed

2.3 Será apresentada tela com a Confirmação:

Image Removed

2.4 A partir deste momento o roteiro "Data_Coleta" esta pronto para utilização:

     Importante: O Status deverá estar "Publicado".

Image Removed

4. Acessar Atualizações > Ocorrências > Configurações CheckList (TMSAC10), deverá ser incluído o cadastro de configuração para uso no app Meu Checklist - neste cadastro serão informados dados como filial para integração, URL's responsáveis pela conexão da integração, usuário e senha autorizados a validar e alterar dados no Portal Checklist, entre outras informações.

Os novos campos abaixo circulados foram criados para o processo dos documentos Não Fiscais:

  • Roteiro Coleta;
  • Roteiro Entrega;

Image Removed

Configuração Appserver.ini

O arquivo appserver.ini deve conter as chaves abaixo:

Na sessão [Environment] :

...

Será apresentada novamente a tela de Tipos de Itens, selecione a opção "Numérico";

Image Added


2.1 Na caixa pergunta, digite "Peso Coletado?"

Image Added


Clique em Incluir item.

2.2 Será apresentada novamente a tela de Tipos de Itens, selecione a opção "Numérico";

Image Added


2.3 Na caixa pergunta, digite "Volume Coletado?"

Image Added


Clique em Incluir item.


Informações
titleImportante:

Este item não é obrigatório.

Porém, para a automatização do processo de seleção de código de barras e integração com a rotina de Conferência de Coleta do TMS (TMSA461) é necessário  inserção deste novo item.


2.4 Será apresentada novamente a tela de Tipos de Itens, selecione a opção "Código de Barras";

Image Added

2.5 Na caixa pergunta, digite "CHAVES DAS DANFES"

Image Added

Aviso

Importante:

Este item deverá ser repetido de acordo com a quantidade notas a serem coletadas, ou seja, se houver necessidade de coleta de 20 NFs - haverá necessidade de repetição (utilizando a opção copiar itens) do item 20 vezes, para utilização da leitura de código de barras e registro em cada caixa de seleção.

Image Added

Isso se faz necessário, pois hoje a Integração entre SIGATMS e o App Meu Checklist no que se refere a informações de leitura de código de barras possui uma limitação de até 100 itens.


2.6 Após isto, será necessário voltar ao Item 1, para a configuração dos itens de Desvio.
      Devem ser inseridos os Itens/Perguntas 2-Motivo e 3-Expedidor.
Image Added


2.7 As configurações devem ficar conforme a imagem a seguir, após o ajuste clique em Salvar:

Valide:

Para a opção OK o desvio será 3 - Expedidor;
Para a opção NOK, o desvio será 2 - Motivo;

Após a inserção, clique em Avançar;

Image Added


2.8 Será apresentada tela com a prévia da configuração efetuada, após validar, clique em "Publicar", (lado superior direito):

Image Added

2.9 Será apresentada tela com a Confirmação:

Image Added

3.0 A partir deste momento o roteiro "Data_Coleta" esta pronto para utilização:

     Importante: O Status deverá estar "Publicado".

Image Added

4. Acessar Atualizações > Ocorrências > Configurações CheckList (TMSAC10), deverá ser incluído o cadastro de configuração para uso no app Meu Checklist - neste cadastro serão informados dados como filial para integração, URL's responsáveis pela conexão da integração, usuário e senha autorizados a validar e alterar dados no Portal Checklist, entre outras informações.

Os novos campos abaixo circulados foram criados para o processo dos documentos Não Fiscais:

  • Roteiro Coleta;
  • Roteiro Entrega;

Image Added

Configuração Appserver.ini

O arquivo appserver.ini deve conter as chaves abaixo:

Na sessão [Environment] :

MemoMega>1
TopMemoMega=2

Aviso
titleImportante

Existe uma Tag no arquivo Appserver.ini do Protheus denominada MaxStringSize. Esta Tag determina o tamanho máximo de uma variável do tipo character em megabytes. Assim quando esta Tag estiver configurada com "MaxStringSize = 10", por exemplo, o Protheus aceitará variáveis de no máximo 10 megabytes. Dependendo da configuração do aparelho mobile que irá registrar o checklist e sua evidência (foto), esta variável pode exceder seu tamanho causando erro fatal no sistema. Sendo assim, é necessário que se ajuste a configuração no aparelho mobile, do tamanho da foto que será registrada. Para isso acesse as configurações do aplicativo de foto de seu aparelho mobile, ajustando para um tamanho inferior ao da Tag MaxStringSize de seu  Appserver.ini.

No caso de Envio de Imagem com Tamanho Incorreto:

Quando for detectado que houve o envio de imagem com tamanho incorreto (falha na configuração do tamanho da imagem) será necessário seguir os seguintes procedimentos para devida correção e para que o processo de integração não fique "travado", pois uma vez encaminhada imagem/foto com tamanho superior ao configurado no Appserver.ini , todos os demais Checklists encaminhados posteriormente na integração não serão atualizados no TMS Protheus até que a configuração seja corrigida.

Passo à passo:

  1. Ajustar a configuração no Appserver.ini e no aparelho mobile (devem estar configurados com o mesmo tamanho de qualidade de imagem);
  2. Deverá ser acessado o Portal Meu Checklist e localizado no histórico a integração efetuada com imagem com tamanho superior ao configurado no Appserver.ini - esse registro deverá ser excluído.


Além disso segue abaixo exemplo de configuração REST que deverá ser configurada:

...

Para melhor aproveitamento e em caso de dúvidas recomendamos a leitura da documentação sobre REST.

...

Aviso
titleAlerta de risco

Fique atento ao utilizar o parâmetro de configuração com a chave Security=0, pois isso fará com que as integrações (APIs) não exijam autenticação, consequentemente dados do seu ambiente poderão ser consultados sem qualquer controle de autorização.

              Processo Básico de Viagem no Protheus

1. Inclusão de Documentos

...