...

Fontes e Dicionário de Dados

Para o funcionamento do app, os fontes a seguir devem ter data igual ou superior a informada. Caso não possua estes fontes no repositório ou se estiverem desatualizados acesse: pacote de atualização.

• TECM200.PRW   -   30/10/2020 ou superior;
• TECA450.PRW    -   22/10/2020 ou superior;
• TECA450A.PRW  -   22/10/2020 ou superior;

Para atualização de dicionário de dados em releases anteriores ao 12.1.33, consulte:

• Implementação APP Minhas Ordens de Serviço

Pacote de atualização

Acesse a página Pacote de atualização para ter acesso ao pacote da Expedição Contínua que contém o patch acumulado de fontes dos serviços Protheus com todas as alterações publicadas até a data da geração do pacote.

Configuração da Base de Dados

1. Faça o backup da base de dados atual e dos dicionários de dados da base atual.
2.  Copie o arquivo sdfbra.txt dentro da pasta systemload e execute o programa UPDDISTR.
3. Siga as instruções do Wizard.

• • Serão criados campos na Ordem de Serviço (AB6): 
    • Status APP (AB6_APPSTA),  Dt Ini APP (AB6_APPDTI), Hr Ini App (AB6_APPHRI), AB6_APPDCH (Dt Cheg APP) e o campo Hr Cheg APP (AB6_APPHCH) .
  • Serão criados campos no atendimento da ordem de serviço (AB9):
    • Responsável (AB9_APPRES) e Assinatura (AB9_APPASS).
  • Será criada uma tabela (TXM) com seus respectivos campos e índices para armazenar as informações das fotos geradas no atendimento da ordem de serviço.

Pré-requisitos

Para utilizar o aplicativo Minhas Ordens de Serviço, os pré-requisitos são:

Smartphone:

• Possuir um usuário e senha válidos para um ambiente Protheus.
• Um smartphone com Android 4.1 ou superior.
• Acesso à internet do dispositivo móvel.

Protheus:

Antes de utilizar o aplicativo, será necessário realizar cadastros e processos no Protheus para a geração da agendas dos técnicos, no módulo Prestadores de Serviços Terceirização. Veja a seguir como realizar os cadastros necessários:

1. Cadastro de Atendentes

No cadastro do atendente, na aba Outros, os campos de login e senha deverão ser preenchidos, pois esses serão os dados que o atendente utilizará para acessar o aplicativo.

Image Removed

Para mais informações acesse: Cadastro de Atendentes.

2. Geração da Ordem de Serviço:

...

Image Removed

Para mais informações acesse: Base de Atendimento.

3. Geração da Agenda:

...

Image Removed

Para mais informações, acesse: Agenda dos Atendentes.

4. Cadastro de Produtos

...

Fontes e Dicionário de Dados

Para o funcionamento do app, os fontes a seguir devem ter data igual ou superior a informada. Caso não possua estes fontes no repositório ou se estiverem desatualizados acesse: pacote de atualização.

• TECM200.PRW   -   30/10/2020 ou superior;
• TECA450.PRW    -   22/10/2020 ou superior;
• TECA450A.PRW  -   22/10/2020 ou superior;

Para atualização de dicionário de dados em releases anteriores ao 12.1.33, consulte:

• Implementação APP Minhas Ordens de Serviço

Pacote de atualização

Acesse a página Pacote de atualização para ter acesso ao pacote da Expedição Contínua que contém o patch acumulado de fontes dos serviços Protheus com todas as alterações publicadas até a data da geração do pacote.

Configuração da Base de Dados

1. Faça o backup da base de dados atual e dos dicionários de dados da base atual.
2.  Copie o arquivo sdfbra.txt dentro da pasta systemload e execute o programa UPDDISTR.
3. Siga as instruções do Wizard.

• • Serão criados campos na Ordem de Serviço (AB6): 
    • Status APP (AB6_APPSTA),  Dt Ini APP (AB6_APPDTI), Hr Ini App (AB6_APPHRI), AB6_APPDCH (Dt Cheg APP) e o campo Hr Cheg APP (AB6_APPHCH) .
  • Serão criados campos no atendimento da ordem de serviço (AB9):
    • Responsável (AB9_APPRES) e Assinatura (AB9_APPASS).
  • Será criada uma tabela (TXM) com seus respectivos campos e índices para armazenar as informações das fotos geradas no atendimento da ordem de serviço.

Pré-requisitos

Para utilizar o aplicativo Minhas Ordens de Serviço, os pré-requisitos são:

Smartphone:

• Possuir um usuário e senha válidos para um ambiente Protheus.
• Um smartphone com Android 4.1 ou superior.
• Acesso à internet do dispositivo móvel.

Protheus:

Antes de utilizar o aplicativo, será necessário realizar cadastros e processos no Protheus para a geração da agendas dos técnicos, no módulo Prestadores de Serviços Terceirização. Veja a seguir como realizar os cadastros necessários:

Licenciamento:

O aplicativo Minhas Ordens de Serviço possui licenciamento exclusivo, vinculado ao appId do mesmo

1. Cadastro de Atendentes

No cadastro do atendente, na aba Outros, os campos de login e senha deverão ser preenchidos, pois esses serão os dados que o atendente utilizará para acessar o aplicativo.

Image Added

Para mais informações acesse: Cadastro de Atendentes.

2. Geração da Ordem de Serviço:

No módulo Prestadores de Serviços Terceirização, para a criação de uma agenda para o técnico, é necessário realizar antes a criação de uma ordem de serviço onde serão informados o cliente para a ordem de serviço, os produtos da base de atendimento e seus respectivos Id únicos para a realização do atendimento.

Image Added

Para mais informações acesse: Base de Atendimento.

3. Geração da Agenda:

No módulo Prestadores de Serviços Terceirização, após gerar a ordem de serviço e cadastrar os atendentes, será necessário gerar uma agenda do atendente, para que seja possível utilizar o aplicativo.  Este é o momento em que será definida a agenda que o técnico irá realizar o atendimento, com os dias e horários. A realização do atendimento da ordem de serviço no aplicativo Minhas Ordens de Serviço só poderá ser feita se o técnico estiver alocado (possuir agenda).

Image Added

Para mais informações, acesse: Agenda dos Atendentes.

4. Cadastro de Produtos

No módulo Prestadores de Serviços Terceirização, pode-se definir qual produto será utilizado no APP, para isso é necessário configurar o campo Minhas O.S?(B1_TECAPP) como Sim, ou deixar o conteúdo em branco, assim o mesmo será utilizado no APP.

Image Added

Para maiores informações dessa funcionalidade clique aqui.

Primeiro acesso ao aplicativo

Com o ambiente Protheus configurado, você poderá utilizar o aplicativo. Para iniciar, baixe e instale o aplicativo para sua plataforma:

• Google Play Store.

Para realizar o primeiro acesso, será necessário um usuário e senha do Protheus, e um ALIAS através do TOTVS Mingle. Depois que você estiver logado, o aplicativo fará o login automaticamente todas as vezes que você acessá-lo. 

Para informações sobre o primeiro acesso, consulte: Primeiro Login no App.

Para informações sobre ALIAS, acesse: Como obter um ALIAS para os aplicativos da TOTVS?

Manual de utilização

Abaixo será apresentado um guia que contém as telas e botões do aplicativo para melhor entendimento.

Image Removed

Para maiores informações dessa funcionalidade clique aqui.

Primeiro acesso ao aplicativo

Com o ambiente Protheus configurado, você poderá utilizar o aplicativo. Para iniciar, baixe e instale o aplicativo para sua plataforma:

• Google Play Store.

Para realizar o primeiro acesso, será necessário um usuário e senha do Protheus, e um ALIAS através do TOTVS Mingle. Depois que você estiver logado, o aplicativo fará o login automaticamente todas as vezes que você acessá-lo. 

Para informações sobre o primeiro acesso, consulte: Primeiro Login no App.

Para informações sobre ALIAS, acesse: Como obter um ALIAS para os aplicativos da TOTVS?

Manual de utilização

Abaixo será apresentado um guia que contém as telas e botões do aplicativo para melhor entendimento.

Deck of Cards
id deck-telas
Card id card-login-do-ambiente label Login do Ambiente title Login do Ambiente Âncora login-do-ambiente login-do-ambiente Login do Ambiente Ao entrar pela primeira vez no app é necessário logar no seu ambiente Protheus com o nome e senha do Protheus e o alias do aplicativo. Image Added Imagem 1.1 - Tela de Login do Ambiente Caso o usuário a senha ou o alias estejam incorretos, será mostrado um alerta avisando sobre o erro: Image Added Imagem 1.2 - Tela de Login do Ambiente com erro A tela de login do ambiente possui campos para o usuário do Protheus, a senha e o alias configurado no Mingle, um toggle para exibir ou ocultar a senha digitada e um botão "Entrar" para realizar o login. Campo Descrição  Usuário Campo para o usuário  do Protheus. Senha Campo para a senha do Protheus. Exibir Senha Botão Toggle para exibir/ocultar a senha. Entrar Botão "Entrar" para realizar o primeiro login.
Card id card-login-do-ambienteatendente label Login do AmbienteAtendente title Login do AmbienteAtendente Âncora login-do- ambiente atendente login-do- ambiente atendente Login do Ambiente Ao entrar pela primeira vez no app é necessário logar no seu ambiente Protheus com o nome e senha do Protheus e o alias do aplicativo. Image Removed Imagem 1.1 - Tela de Login do Ambiente Caso o usuário a senha ou o alias estejam incorretos, será mostrado um alerta avisando sobre o erro: Image Removed Atendente Após realizar o primeiro login no aplicativo com as informações de usuário, senha e alias, será apresentada a tela de login para os atendentes. Nesta tela os atendentes utilizarão os dados que foram previamente cadastrados no Protheus, na rotina de cadastro de atendentes, conforme o exemplo a seguir: Image Added Imagem 2.1 - Cadastro de login e senha na rotina de Atendentes O login e a senha que foram cadastrados serão utilizados pelo atendente na segunda tela de login. Image Added Imagem 2 Imagem 1 .2 - Tela de Login do Ambiente com erro Atendente Muito parecida como a primeira Tela de Login essa tela tem A tela de login do ambiente possui campos para o usuário do Protheus, a senha e o alias configurado no Mingle, um código do atendente e senha. Ela também tem o botão toggle para exibir ou ocultar a senha digitada e um botão "Entrar" para realizar o login.. Após preencher os campos, clique no botão “Entrar” para acessar a próxima tela: a Agenda do Técnico. Caso o código do Atendente ou senha sejam inválidos, a tela apresenta um alerta, notificando o usuário que há um erro com os dados inseridos nos campos da tela, idêntico ao alerta na primeira Tela de Login. Image Added Imagem 2.3 - Tela de Login do Atendente com erro Campo Descrição Código do Atendente Campo para o código do atendente Campo Descrição  Usuário Campo para o usuário  do Protheus. Senha Campo para a senha do Protheusatendente. Exibir Senha Botão Toggle para exibir/ocultar a senha do Atendente. Entrar Botão "Entrar" para realizar o primeiro login.no aplicativo. Login do Atendente Após realizar o primeiro login no aplicativo com as informações de usuário, senha e alias, será apresentada a tela de login para os atendentes. Nesta tela os atendentes utilizarão os dados que foram previamente cadastrados no Protheus, na rotina de cadastro de atendentes, conforme o exemplo a seguir: Image Removed Imagem 2.1 - Cadastro de login e senha na rotina de Atendentes O login e a senha que foram cadastrados serão utilizados pelo atendente na segunda tela de login. Image Removed Imagem 2.2 - Tela de Login do Atendente Muito parecida como a primeira Tela de Login essa tela tem campos para o código do atendente e senha. Ela também tem o botão toggle para exibir ou ocultar a senha. Após preencher os campos, clique no botão “Entrar” para acessar a próxima tela: a Agenda do Técnico. Caso o código do Atendente ou senha sejam inválidos, a tela apresenta um alerta, notificando o usuário que há um erro com os dados inseridos nos campos da tela, idêntico ao alerta na primeira Tela de Login. Image Removed Imagem 2.3 - Tela de Login do Atendente com erro Botão "Entrar" no aplicativo. Card id card-agenda-do-tecnico label Agenda do Técnico title Agenda do Técnico Âncora agenda-do-tecnico agenda-do-tecnico Agenda do Técnico Após realizar o login será apresentada a tela principal com as ordens de serviços abertas para o técnico no dia corrente. Na tela é possível navegar entre os dias e meses. Assim, se o técnico tiver a necessidade de visualizar uma ordem de serviço de um dia anterior ou do mês seguinte, poderá utilizar os botões de navegação do calendário.  Image Added Imagem 3.1 - Tela da Agenda do Técnico As ordens de serviço serão listadas em cards com algumas informações como o nome do cliente, o horário previsto de atendimento e a ocorrência: Image Added Imagem 3.2 - Tela da Agenda do Técnico com destaque no card Card id card-login-do-atendente label Login do Atendente title Login do Atendente Âncora login-do-atendente login-do-atendente Campo Descrição Código do Atendente Campo para o código do atendente. Senha Campo para a senha do atendente. Exibir Senha Botão Toggle para exibir/ocultar a senha do Atendente. Entrar Início do Atendimento da Ordem de Serviço Ao clicar no botão Iniciar Image Removed, contido no card da ordem de serviço na tela de Agenda do Técnico, a tela de início de atendimento será aberta. Essa tela possui o número da O.S. que está sendo atendida, um card informativo com os dados (contato, endereço, telefone e e-mail) cadastrados no cliente, um botão "Iniciar Visita", um botão "Chegada ao Cliente" e um mapa integrado com o Google Maps para facilitar a visualização do endereço.Image Removed Imagem 4.1 - Clicando em "Iniciar" Image Removed Imagem 4.2 – Tela de Início do atendimento Card id card-agendainicio-do-atendimento-da-tecnicoos label Agenda do TécnicoInício do Atendimento da O.S. title Agenda do TécnicoInício do Atendimento da O.S. Âncora agenda inicio-do- tecnico atendimento agenda inicio-do- tecnico atendimento Início do Atendimento da Ordem de Serviço Ao clicar no botão Iniciar Image Added, contido no card da ordem de serviço na tela de Agenda do Técnico Após realizar o login será apresentada , a tela principal com as ordens de serviços abertas para o técnico no dia corrente. Na tela é possível navegar entre os dias e meses. Assim, se o técnico tiver a necessidade de visualizar uma ordem de serviço de um dia anterior ou do mês seguinte, poderá utilizar os botões de navegação do calendário.  Image Removed Imagem 3.1 - Tela da Agenda do Técnico As ordens de serviço serão listadas em cards com algumas informações como o nome do cliente, o horário previsto de atendimento e a ocorrência: Image Removed Imagem 3.2 - Tela da Agenda do Técnico com destaque no card Card id card-inicio-do-atendimento-da-os label Início do Atendimento da O.S. title Início do Atendimento da O.S. de início de atendimento será aberta. Essa tela possui o número da O.S. que está sendo atendida, um card informativo com os dados (contato, endereço, telefone e e-mail) cadastrados no cliente, um botão "Iniciar Visita", um botão "Chegada ao Cliente" e um mapa integrado com o Google Maps para facilitar a visualização do endereço.Image Added Imagem 4.1 - Clicando em "Iniciar" Image Added Imagem 4.2 – Tela de Início do atendimento Campo Descrição O.S. Número da Ordem de serviço a ser atendida ícone (Contato) Nome do contato cadastrado no cliente ícone (Endereço) Endereço cadastrado no cliente ícone (Telefone) Telefone cadastrado no cliente ícone (E-mail) E-mail cadastrado no cliente Botão (Iniciar Visita) Ao clicar neste botão a visita será iniciada Deck of Cards id deck-inicio-do-atendimento Card id card-iniciar-visita label Iniciar a Visita title Iniciar a Visita Âncora iniciar-visita iniciar-visita Iniciar Visita Ao clicar no botão "Iniciar Visita" irá aparecer uma confirmação para começar o deslocamento até o lugar de atendimento. Ao clicar em "Não" o aplicativo irá retornar para a tela principal a Agenda do Técnico, caso clique em "Sim" a visita será iniciada e aparecerá uma caixa de confirmação para o usuário decidir se irá utilizar o serviço Google Maps para traçar a rota até o local da prestação do serviço, tendo como base a localização do técnico e o endereço do cliente (ou o endereço da base de atendimento se cadastrado). caso clique em "Sim" irá abrir o aplicativo "Google Maps" para o usuário seguir a rota definida, caso clique em "Não" o aplicativo irá retornar para a Agenda do Técnico.   Image Added Imagem 5.1 - Iniciando a visita Card id card-cancelar-visita label Cancelar Visita title Cancelar Visita Âncora cancelar-visita cancelar-visita Cancelar Visita Ao clicar no botão "Atender" Image Added (só disponível com a O.S. no status "Em trânsito"), irá abrir a mesma tela do Início do Atendimento porém o botão "Iniciar Visita" foi substituído pelo botão "Cancelar Visita". Ao clicar em "Cancelar Visita" irá aparecer uma caixa de confirmação para cancelar a visita, caso clique em "Não" nada irá acontecer, caso clique em "Sim" o status da O.S. irá retornar para "Aberta" e o aplicativo irá para a tela da Agenda do Técnico. Image Added Imagem 6.2 - Cancelando visita Card id card-chegada-ao-cliente label Chegada ao Cliente title Chegada ao Cliente Âncora chegada-ao-cliente chegada-ao-cliente Chegada ao Cliente Ao clicar no botão Âncora inicio-do-atendimento inicio-do-atendimento Campo Descrição O.S. Número da Ordem de serviço a ser atendida ícone (Contato) Nome do contato cadastrado no cliente ícone (Endereço) Endereço cadastrado no cliente ícone (Telefone) Telefone cadastrado no cliente ícone (E-mail) E-mail cadastrado no cliente Botão (Iniciar Visita) Ao clicar neste botão a visita será iniciada Deck of Cards id deck-inicio-do-atendimento Iniciar Visita Ao clicar no botão "Iniciar Visita" irá aparecer uma confirmação para começar o deslocamento até o lugar de atendimento. Ao clicar em "Não" o aplicativo irá retornar para a tela principal a Agenda do Técnico, caso clique em "Sim" a visita será iniciada e aparecerá uma caixa de confirmação para o usuário decidir se irá utilizar o serviço Google Maps para traçar a rota até o local da prestação do serviço, tendo como base a localização do técnico e o endereço do cliente (ou o endereço da base de atendimento se cadastrado). caso clique em "Sim" irá abrir o aplicativo "Google Maps" para o usuário seguir a rota definida, caso clique em "Não" o aplicativo irá retornar para a Agenda do Técnico.   Image Removed Imagem 5.1 - Iniciando a visita Cancelar Visita Ao clicar no botão "Atender" (só disponível com a O.S. no status "Em trânsito"), irá abrir a mesma tela do Início do Atendimento porém o botão "Iniciar Visita" foi substituído pelo botão "Cancelar Visita". Ao clicar em "Cancelar Visitacom as opções "Cancelar Visita" e "Chegada ao Cliente" ao clicar em "Chegada ao Cliente" irá aparecer uma caixa de confirmação para cancelar a visita, caso clique em "Não" nada irá acontecer, caso clique em "Sim" escolha a opção "Sim" a chegada ao cliente será concluída, o status da O.S. irá retornar será alterado para "AbertaEm atendimento" e o aplicativo irá retornar para a tela da Agenda do Técnico. Image Removed Imagem 6.2 - Cancelando visita , caso clique em "Não" irá para o processo da "Visita Improdutiva", caso a opção escolhida seja "Cancelar" nada irá acontecer. Image Added Imagem 7.1 - Chegada ao cliente Card id card-iniciar-visita label Iniciar a Visita title Iniciar a Visita Âncora iniciar-visita iniciar-visita Card id card-cancelar-visita label Cancelar Visita title Cancelar Visita Âncora cancelar-visita cancelar-visita Card id card-chegada-aovisita-clienteimprodutiva label Chegada ao ClienteVisita Improdutiva title Chegada ao ClienteVisita Improdutiva Âncora chegada visita- ao-cliente improdutiva chegada visita- ao-cliente improdutiva Visita Improdutiva Ao chegar no cliente caso não tenha conseguido entrar no cliente ou por algum motivo não conseguiu realizar o atendimento e houve a necessidade de encerrar a ordem de serviço, pode-se apontar uma visita improdutiva, para isso clique no botão Chegada ao Cliente Ao clicar no botão "Atender" Image Removed (só disponível com a O.S. no status "Em trânsito"), irá abrir a mesma tela do Início do Atendimento com as opções "Cancelar Visita" e "Chegada ao Cliente" ao clicar em "Chegada ao Cliente" irá aparecer uma caixa de confirmação, caso escolha a opção "Sim" a chegada ao cliente será concluída, o status da O.S. será alterado para "Em atendimento" e o aplicativo irá retornar para a Agenda do Técnico,  e em seguida na opção "Não" depois na caixa de confirmação clique na opção "Sim", caso clique em "Não" irá iniciar o processo para o processo da "Visita Improdutiva", caso a opção escolhida seja "Cancelar" nada irá acontecer. Image Removed encerrar uma ordem de serviço improdutiva. Image Added Imagem 7.1: Navegando para a tela de visita improdutiva Na tela de Visita Improdutiva poderá apontar o motivo da visita improdutiva e uma foto para vincular com a visita improdutiva. Image Added Imagem 7.3 – Tela de Visita Improdutiva Campo Descrição Motivo Campo para informar o motivo da visita improdutiva. ícone (Foto) Ao clicar no ícone é possível vincular uma foto à visita improdutiva. Salvar Ao clicar no botão, um atendimento será gerado e a ordem de serviço encerrada. Imagem 7.1 - Chegada ao cliente Encerrar O.S. Improdutiva Ao chegar no cliente caso não tenha conseguido entrar no cliente ou por algum motivo não conseguiu realizar o atendimento e houve a necessidade de encerrar a ordem de serviço, pode-se apontar uma visita improdutiva, para isso clique no botão "Chegada ao Cliente" e em seguida na opção "Não" depois na caixa de confirmação clique na opção "Não", irá aparecer uma confirmação para o encerramento improdutivo então clique em "Sim" . Image Removed Imagem 8.1 - Encerramento improdutivo Card id card-visitaencerrar-os-improdutiva label Visita Encerrar O.S. Improdutiva title Visita Encerrar O.S. Improdutiva Âncora visita encerrar-os-improdutiva visita encerrar-os-improdutiva Visita Encerrar O.S. Improdutiva Ao chegar no cliente caso não tenha conseguido entrar no cliente ou por algum motivo não conseguiu realizar o atendimento e houve a necessidade de encerrar a ordem de serviço, pode-se apontar uma visita improdutiva, para isso clique no botão "Chegada ao Cliente" e em seguida na opção "Não" depois na caixa de confirmação clique na opção "SimNão",caso irá aparecer uma confirmação para o encerramento improdutivo então clique em "Não" irá iniciar o processo para encerrar uma ordem de serviço improdutivaSim" . Image Removed Image Added Imagem 7.1: Navegando para a tela de visita improdutiva Na tela de Visita Improdutiva poderá apontar o motivo da visita improdutiva e uma foto para vincular com a visita improdutiva. Image Removed Imagem 7.3 – Tela de Visita Improdutiva Campo Descrição Motivo Campo para informar o motivo da visita improdutiva. ícone (Foto) Ao clicar no ícone é possível vincular uma foto à visita improdutiva. Salvar Ao clicar no botão, um atendimento será gerado e a ordem de serviço encerrada. Card id card-encerrar-os-improdutiva label Encerrar O.S. Improdutiva title Encerrar O.S. Improdutiva Âncora encerrar-os-improdutiva encerrar-os-improdutiva 8.1 - Encerramento improdutivo

Após confirmar a chegada no cliente o botão "Encerrar" ficará disponível na tela de Agenda do Técnico, ao clicar no botão "Encerrar" irá abrir a tela com os itens da O.S. Na tela de Itens da Ordem de Serviço são listados os equipamentos para manutenção, sendo que para cada item será gerado um atendimento.

Nessa tela também é possível colher a assinatura do cliente e encerrar o atendimento de todos os itens da Ordem de Serviço.

Image Removed

Na tela de atendimento da O.S. será listado os itens da ordem de serviço, ao deslizar o card do item para a esquerda aparecerá duas opções: "Ver Histórico do Equipamento" e "Navegar até o Item".

Image Removed

Imagem 9.2 - Arrastando card do item para esquerda