🔄 Alterações de roteiros no Access
Procedimento para editar um ponto no aplicativo e devolver a alteração com segurança ao banco compartilhado do Access.
Como a integração funciona
A alteração é salva primeiro neste computador. Depois, o aplicativo a entrega ao GAS, onde ela aguarda a importação pelo operador do Access.
1. AplicativoSalva e envia a alteração
2. GASMantém a fila pendente
3. AccessValida, aplica e confirma
O que pode ser alterado
- Roteiro do ponto;
- Ordem dentro do roteiro;
- Status ativo ou inativo.
Somente pontos existentes com um ID Rota numérico vindo do Access são devolvidos. Nome, endereço e pontos novos permanecem apenas no aplicativo nesta primeira versão.
Configuração inicial
- Abra Admin → Sincronização Google.
- Confira a URL do Web App do Google Apps Script.
- Informe o token fornecido pelo administrador no campo Token para alterações de roteiros.
- Clique em Verificar agora.
- Confirme que aparece
API GAS v3: compatível e que a integração de roteiros não mostra erro.
O token é confidencial. Não envie por mensagem, não coloque em planilhas e não o grave junto ao código do aplicativo.
Editar e enviar pelo aplicativo
- Abra Roteiros e localize o ponto pelo cliente ou pelo
ID Rota.
- Clique em Editar.
- Para uma edição individual, altere o roteiro ou o status e clique em Salvar.
- O aplicativo tenta enviar imediatamente. Se a internet estiver indisponível, a alteração fica segura na fila local.
- Em Admin, use Verificar agora para tentar novamente.
Organizar a ordem de um roteiro inteiro
- Em Roteiros, selecione um roteiro no filtro.
- Clique em Organizar roteiro.
- Arraste um ponto pela alça, use as setas ou digite diretamente a posição desejada.
- A lista desloca os demais pontos automaticamente e mostra quantos registros serão atualizados.
- Use a busca para localizar um cliente ou ID sem alterar a sequência.
- Clique em Salvar alterações e confirme o lote.
A ordem de um ponto existente não é editada no formulário individual. A sequência final é normalizada de 1 até o último ponto pelo organizador. O salvamento acontece em uma única transação local e todos os registros afetados são enviados ao GAS, mesmo quando o roteiro possui mais de 100 pontos.
Cancelar ou fechar o organizador não grava alterações. Pontos criados somente no aplicativo precisam ser cadastrados no Access antes de participarem de uma reorganização.
Entender os indicadores
Alterações de Roteiro Pendentes: 0 significa que todas chegaram ao GAS. Ainda podem estar aguardando o Access.
PENDENTE na aba AlteracoesRoteiros significa que o GAS recebeu, mas o Access ainda não confirmou.
PROCESSADO significa que o Access aplicou e confirmou a alteração.
Importar no Access 365
- Abra o frontend integrado do ColetaFlex.
- No formulário de roteiros, clique em Importar alterações do app.
- Na primeira utilização, informe o mesmo token configurado no GAS.
- Confira a prévia com ID, roteiro, ordem e status.
- Clique em Sim somente se todas as linhas estiverem corretas.
- Aguarde a mensagem informando que as alterações foram aplicadas, confirmadas no GAS e exportadas.
Antes de gravar, o Access verifica se todos os IDs e roteiros existem. O lote inteiro é aplicado em uma transação: se uma linha for inválida, nenhuma alteração é gravada.
Quando ocorrer uma falha
- Alteração salva, mas não enviada: confira URL, token e internet na tela Admin; depois clique em Verificar agora.
- Token recusado no Access: aceite apagar o token salvo e informe o token atual na próxima tentativa.
- Validação recusada pelo Access: nada foi aplicado. Corrija o ID ou o nome do roteiro antes de tentar novamente.
- Access aplicou, mas não confirmou no GAS: execute a importação novamente. Reaplicar os mesmos valores é seguro.
- Lote grande: aguarde o envio terminar antes de fechar o app. O Access apresenta todos os itens pendentes em uma única prévia.
Cuidados importantes
- Não edite manualmente a aba AlteracoesRoteiros.
- Não compartilhe o token da integração.
- Confira sempre a prévia antes de confirmar no Access.
- Para um primeiro teste, abra um ponto existente e salve sem mudar os valores. Assim todo o percurso é validado sem alterar o cadastro.