01. DADOS GERAIS
| Produto: | TOTVS Prestadores de Serviços Terceirização
|
|---|---|
| Linha de Produto: | Linha Protheus |
| Segmento: | Serviços |
| Módulo: | Prestadores de Serviços Terceirização |
| Função: | TECM200.PRW |
| Ticket: | Não há |
| Requisito/Story/Issue (informe o requisito relacionado) : | DSERSGS-9904 |
02. SITUAÇÃO/REQUISITO
Criação de um serviço para a integração entre o Protheus e o APP Minhas Ordens de Serviço, para visualizar as ordens de serviço do técnico e realizar apontamentos das ordens de serviços e também a possibilidade de visualização de histórico de um equipamento.
03. SOLUÇÃO
Foi realizado a criação de uma API para a integração entre o módulo Prestadores de Serviços e o APP Minhas Ordens de Serviço.
Importante
Para essa integração entre o APP e o Protheus alguns campos de dicionário de dados serão necessários, esses campos só serão disponibilizados no release 12.1.33
Para a utilização em um release anterior ao informado, segue abaixo instruções para a criação de campos no módulo Configurador.
Na tabela AB6 - Ordens de Serviço crie os seguintes campos.
Crie o campo AB6_APPSTA
Esse campo é responsável pelo status das ordens de serviço no APP Minhas Ordens de Serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB6_APPSTA |
| X3_TIPO | Caractere |
| X3_TAMANHO | 1 |
| X3_TITULO | Status APP |
| X3_DESCRIC | status atendimento APP |
| X3_PICTURE | @! |
| X3_RELAÇÃO | "1" |
| X3_VLDUSER | Pertence("123456") |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
| X3_CBOX | 1=Aberto;2=Em Atendimento;3=Encerrada;4=Pendente;5=Improdutiva;6=Em Transito |
Crie o campo AB6_APPDTI
Esse campo é responsável por armazenar a data de inicio do atendimento da ordem de serviço no APP Minhas Ordens de Serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB6_APPDTI |
| X3_TIPO | Data |
| X3_TAMANHO | 8 |
| X3_TITULO | Dt Ini APP |
| X3_DESCRIC | Dt Ini Atendimento APP |
| X3_RELAÇÃO | "1" |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Crie o campo AB6_APPHRI
Esse campo é responsável por armazenar o horário de inicio do atendimento da ordem de serviço no APP Minhas Ordens de Serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB6_APPHRI |
| X3_TIPO | Caractere |
| X3_TAMANHO | 5 |
| X3_TITULO | Hr Ini App |
| X3_DESCRIC | Hr Ini Atendimento APP |
| X3_PICTURE | 99:99 |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Crie o campo AB6_APPDCH
Esse campo é responsável por armazenar a data de chegada ao cliente no atendimento da ordem de serviço no APP Minhas Ordens de Serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB6_APPDCH |
| X3_TIPO | Data |
| X3_TAMANHO | 8 |
| X3_TITULO | Dt Cheg APP |
| X3_DESCRIC | Dt Chegada atendimento |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Crie o campo AB6_APPHCH
Esse campo é responsável por armazenar o horário de chegada ao cliente no atendimento da ordem de serviço no APP Minhas Ordens de Serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB6_APPHCH |
| X3_TIPO | Caracter |
| X3_TAMANHO | 5 |
| X3_TITULO | Hr Cheg APP |
| X3_DESCRIC | Hr Cheg atendimento app |
| X3_PICTURE | 99:99 |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Na tabela AB9 - Apontamento Atendimento crie os seguintes campos.
Crie o campo AB9_APPRES
Esse campo é responsável por armazenar o responsável da assinatura no atendimento da ordem de serviço no APP Minhas Ordens de Serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB9_APPRES |
| X3_TIPO | Caracter |
| X3_TAMANHO | 50 |
| X3_TITULO | Responsável |
| X3_DESCRIC | Responsável assinatura |
| X3_PICTURE | @! |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Crie o campo AB9_APPASS
Esse campo é responsável por armazenar o responsável da assinatura no atendimento da ordem de serviço no APP Minhas Ordens de Serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB9_APPASS |
| X3_TIPO | Memo |
| X3_TAMANHO | 10 |
| X3_TITULO | Assinatura |
| X3_DESCRIC | Assinatura atendimento |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Campo AB7_APPSTA
Campo responsável por armazenar o status da ordem de serviço, atendida utilizando o app Minhas Ordens de Serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB7_APPSTA |
| X3_TIPO | Caractere |
| X3_TAMANHO | 1 |
| X3_TITULO | Status App Item |
| X3_DESCRIC | Status Atendimento App |
| X3_PICTURE | @! |
| X3_RELAÇÃO | "1" |
| X3_VLDUSER | Pertence("123456") |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
| X3_CBOX | 1=Aberto;2=Em Atendimento;3=Encerrada;4=Pendente;5=Improdutiva;6=Em Transito |
Campo AB7_APPDTI
Campo responsável por armazenar a data de início do atendimento do item da ordem de serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB7_APPDTI |
| X3_TIPO | Data |
| X3_TAMANHO | 8 |
| X3_TITULO | Dt Ini App |
| X3_DESCRIC | Dt Ini Atendimento APP |
| X3_RELAÇÃO | "1" |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Campo AB7_APPHRI
Armazena o horário de início do atendimento do item da ordem de serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB7_APPHRI |
| X3_TIPO | Caractere |
| X3_TAMANHO | 5 |
| X3_TITULO | Hr Ini App |
| X3_DESCRIC | Hr Ini Atendimento APP |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Campo AB7_APPDCH
Armazena a data de chegada ao cliente, no atendimento do item da ordem de serviço
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB7_APPDCH |
| X3_TIPO | Data |
| X3_TAMANHO | 8 |
| X3_TITULO | Dt Cheg APP |
| X3_DESCRIC | Dt Chegada atendimento |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Campo AB7_APPHCH
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB7_APPHCH |
| X3_TIPO | Caractere |
| X3_TAMANHO | 5 |
| X3_TITULO | Hr Cheg APP |
| X3_DESCRIC | Hr Cheg atendimento APP |
| X3_PICTURE | 99:99 |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Campo AB7_ASSINA
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | AB7_ASSINA |
| X3_TIPO | Memo |
| X3_TAMANHO | 10 |
| X3_TITULO | Assinatura |
| X3_DESCRIC | Assinatura atendimento |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Crie a tabela TXM - Fotos/Atendimento OS no configurador
| Campo | Conteúdo |
|---|---|
| X2_CHAVE | TXM |
| X2_NOME | Fotos/Atendimento OS |
| X2_MODO | Exclusivo |
| X2_MODOUN | Exclusivo |
| X2_MODOEMP | Exclusivo |
Importante
O compartilhamento da tabela TXM(Fotos/Atendimento OS) devem seguir o mesmo compartilhamento da tabela AB6(Ordens de Serviço).
Após a criação da tabela, crie os seguintes campos
Crie o campo TXM_NUMOS
Esse campo é responsável por armazenar o código da ordem de serviço que foi realizado o atendimento, esse campo só é gravado quando há fotos.
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | TXM_NUMOS |
| X3_TIPO | Caractere |
| X3_TAMANHO | 6 |
| X3_PICTURE | @! |
| X3_TITULO | Num. O.S |
| X3_DESCRIC | Numero Ordem serviço |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Importante
O Tamanho do campo TXM_NUMOS deve ter o mesmo tamanho do campo AB6_NUMOS
Crie o campo TXM_ITEM
Esse campo é responsável por armazenar o item da ordem de serviço que foi realizado o atendimento, esse campo só é gravado quando há fotos.
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | TXM_ITEM |
| X3_TIPO | Caractere |
| X3_TAMANHO | 2 |
| X3_PICTURE | @! |
| X3_TITULO | Item O.S |
| X3_DESCRIC | Item ordem de serviço |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Crie o campo TXM_STATUS
Esse campo é responsável por armazenar o status da ordem de serviço que foi realizado o atendimento, esse campo só é gravado quando há fotos.
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | TXM_STATUS |
| X3_TIPO | Caractere |
| X3_TAMANHO | 1 |
| X3_PICTURE | @! |
| X3_TITULO | Status O.S |
| X3_DESCRIC | status ordem de serviço |
| X3_CBOX | 1=Aberto;2=Em Atendimento;3=Encerrada;4=Pendente;5=Improdutiva;6=Em Transito |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Crie o campo TXM_ITFOTO
Esse campo é responsável por armazenar o item foto na ordem de serviço que foi realizado o atendimento, esse campo só é gravado quando há fotos.
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | TXM_ITFOTO |
| X3_TIPO | Caractere |
| X3_TAMANHO | 2 |
| X3_PICTURE | @! |
| X3_TITULO | It Foto |
| X3_DESCRIC | Item foto ordem serviço |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Crie o campo TXM_FOTO
Esse campo é responsável por armazenar a foto do atendimento na ordem de serviço.
| Campo | Conteúdo |
|---|---|
| X3_CAMPO | TXM_FOTO |
| X3_TIPO | Memo |
| X3_TAMANHO | 10 |
| X3_TITULO | Foto |
| X3_DESCRIC | Foto ordem serviço |
| X3_BROWSE | Não |
| X3_VISUAL | Visual |
| X3_CONTEXTO | Real |
Crie o Índice para a tabela TXM conforme as instruções abaixo.
| Campo | Conteúdo |
|---|---|
| INDICE | TXM |
| CHAVE | TXM_FILIAL+TXM_NUMOS+TXM_ITEM+TXM_ITFOTO |
| DESCRIÇÃO | Num. OS+Item O.S+It. Foto |
Após a criação de todos os campos e tabela TXM para conseguir utilizar o APP Minhas Ordens de Serviço os seguintes campos devem estar compilados no seu repositório.
| Fonte | Data |
|---|---|
| TECM200.PRW | ou superior |
| TECA450.PRW | ou superior |
| TECA450A.PRW | ou superior |
Com todas os requisitos atendidos, ao utilizar o APP Minhas Ordens de Serviço, ele já vai estar integrado e refletindo no protheus todas as atividades criadas dentro do APP.
04. DEMAIS INFORMAÇÕES
Não há
05. ASSUNTOS RELACIONADOS
- Não há
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas