Linha Microsiga Protheus

Árvore de páginas




Objetivo

Determinar os serviços que serão consumidos pelo aplicativo Minhas Ordens de Serviço

GET / rest / meutecnico / getAttendant


  • Retorna os dados do técnico que está sendo logado na aplicação.

Request


{
    "attendant": {
        "codtec": "D0MG0020000036",
        "nomtec": "LUIZ GABRIEL GOMES DE JESUS   "
    }
}

Exemplo: ...rest/meutecnico/getAttendant?cAttendant=gabriel&cPswd=12


GET / rest / meutecnico/ getSchedule


  • Retorna as Ordens de serviço cadastrada para o técnico e todas as suas configurações

Request


{
    "schedule": [
        {
            "horaIni": "08:00",
            "horaFim": "10:00",
            "numOS": "000018",
            "filialOS": "D MG 01",
            "cliente": "RS SERVIÇOS",
            "endereco": {
                "logradouro": "R. CATÃO, 732",
                "bairro": "VILA ROMANA",
                "cidade": "SAO PAULO",
                "uf": "SP",
                "cep": "05049000",
                "contato": "Diego",
                "email": "[email protected]",
                "tel": "011 - 3803-8853"
            },
            "statusOs": "Encerrada",
            "enviado": "true",
            "tipoOs": "TROCA",
            "itensOs": [
                {
                    "numeroItem": "01",
                    "produto": "FLD0101",
                    "ID": "5G019088HNB55B4DF",
                    "atendido": "true",
                    "dataAgend": "02/09/2020",
                    "solicitaPeca": "false",
                    "PecaBaixada": "false",
                    "apontamento": {
                        "produtos": [],
                        "fotos": [],
                        "requisicao": "",
                        "laudo": ""
                    }
                }
            ],
            "dtIniVisita": "20201006",
            "hrIniVisita": "16:57",
            "dtIniChegada": "20201006",
            "hrIniChegada": "16:57",
            "compartilhado": "false"
        },
        {
            "horaIni": "10:05",
            "horaFim": "12:00",
            "numOS": "000019",
            "filialOS": "D MG 01",
            "cliente": "EMPÓRIO ROSA - ZONA CEREALISTA",
            "endereco": {
                "logradouro": "R. SANTA ROSA, 68",
                "bairro": "BRAS",
                "cidade": "SAO PAULO",
                "uf": "SP",
                "cep": "03007000",
                "contato": "Rosa",
                "email": "[email protected]",
                "tel": "011 - 3315-0662"
            },
            "statusOs": "Em Atendimento",
            "enviado": "true",
            "tipoOs": "SEM SINAL",
            "itensOs": [
                {
                    "numeroItem": "01",
                    "produto": "FLD0102",
                    "ID": "OIK776665592313213GB",
                    "atendido": "false",
                    "dataAgend": "02/09/2020",
                    "solicitaPeca": "false",
                    "PecaBaixada": "false",
                    "apontamento": {
                        "produtos": [],
                        "fotos": [],
                        "requisicao": "",
                        "laudo": ""
                    }
                }
            ],
            "dtIniVisita": "20201007",
            "hrIniVisita": "23:00",
            "dtIniChegada": "20201014",
            "hrIniChegada": "11:05",
            "compartilhado": "false"
        },
        {
            "horaIni": "14:00",
            "horaFim": "15:00",
            "numOS": "000020",
            "filialOS": "D MG 01",
            "cliente": "EMPRESA CISPER",
            "endereco": {
                "logradouro": "AV. OLAVO EGÍDIO DE SOUZA ARANHA, 2270",
                "bairro": "ERMELINO MATARAZZO",
                "cidade": "SAO PAULO",
                "uf": "SP",
                "cep": "03822900",
                "contato": "Olavo",
                "email": "[email protected]",
                "tel": "011 - 2542-8000"
            },
            "statusOs": "Em Transito",
            "enviado": "true",
            "tipoOs": "TROCA",
            "itensOs": [
                {
                    "numeroItem": "01",
                    "produto": "FLD0101",
                    "ID": "JHNN6655232GFVA312",
                    "atendido": "false",
                    "dataAgend": "02/09/2020",
                    "solicitaPeca": "false",
                    "PecaBaixada": "false",
                    "apontamento": {
                        "produtos": [],
                        "fotos": [],
                        "requisicao": "",
                        "laudo": ""
                    }
                }
            ],
            "dtIniVisita": "20201023",
            "hrIniVisita": "20:16",
            "dtIniChegada": "",
            "hrIniChegada": "",
            "compartilhado": "false"
        },
        {
            "horaIni": "15:15",
            "horaFim": "17:00",
            "numOS": "000021",
            "filialOS": "D MG 01",
            "cliente": "HOSPITAL SANTA MARCELINA",
            "endereco": {
                "logradouro": "R. SANTA MARCELINA, 177",
                "bairro": "VILA CARMOSINA",
                "cidade": "SAO PAULO",
                "uf": "SP",
                "cep": "08270070",
                "contato": "Marcelo",
                "email": "[email protected]",
                "tel": "011 - 2070-6000"
            },
            "statusOs": "Encerrada",
            "enviado": "true",
            "tipoOs": "ELEVADOR TRAVADO",
            "itensOs": [
                {
                    "numeroItem": "01",
                    "produto": "FLD0103",
                    "ID": "66YYHHBDS3423423R",
                    "atendido": "true",
                    "dataAgend": "02/09/2020",
                    "solicitaPeca": "false",
                    "PecaBaixada": "false",
                    "apontamento": {
                        "produtos": [],
                        "fotos": [],
                        "requisicao": "",
                        "laudo": ""
                    }
                }
            ],
            "dtIniVisita": "20201103",
            "hrIniVisita": "11:29",
            "dtIniChegada": "20201103",
            "hrIniChegada": "11:30",
            "compartilhado": "false"
        }
    ],
    "count": 4
}

Exemplo: ...rest/meutecnico/getSchedule?cAttendant=D0MG0020000036&cDate=20200902


GET / rest / meutecnico / getProduct


  • Retorna os produtos cadastrados no protheus para serem utilizados no apontamento da ordem de serviço no APP Minhas Ordens de Serviço

Response


 "Produto": [
        {
            "codigo": "LOC03",
            "nome": "ACABADORA DE PISO"
        },
        {
            "codigo": "FLD0104",
            "nome": "AR CONDICIONADA BTU15000"
        },
        {
            "codigo": "FLD0108",
            "nome": "AR CONDICIONADO MULTI-SPLIT LG"
        },
        {
            "codigo": "LOC02",
            "nome": "BETONEIRA 150 LITROS"
        },
        {
            "codigo": "UNIF07",
            "nome": "BLAZER AZUL"
        },
        {
            "codigo": "UNIF04",
            "nome": "BLAZER PRETO"
        },
        {
            "codigo": "COL02",
            "nome": "BLINTEC NÍVEL II"
        },
        {
            "codigo": "COL01",
            "nome": "BLINTEC NÍVEL II A"
        },
        {
            "codigo": "COL03",
            "nome": "BLINTEC NÍVEL III A"
        },
        {
            "codigo": "UNIF02",
            "nome": "CALÇA SOCIAL AZUL"
        },
        {
            "codigo": "UNIF06",
            "nome": "CALÇA SOCIAL PRETA"
        },
        {
            "codigo": "UNIF01",
            "nome": "CAMISA SOCIAL BRANCA"
        },
        {
            "codigo": "UNIF05",
            "nome": "CAMISA SOCIAL PRETA"
        },
        {
            "codigo": "MI01",
            "nome": "CARRINHO DE LIMPEZA MOP"
        },
        {
            "codigo": "MC02",
            "nome": "DESINFETANTE CLORADO"
        },
        {
            "codigo": "MC01",
            "nome": "DESINFETANTE MULTIUSO"
        },
        {
            "codigo": "FLD0103",
            "nome": "ELEVADOR TK"
        },
        {
            "codigo": "FLD0105",
            "nome": "EMBALADORA PLASTICA"
        },
        {
            "codigo": "LOC01",
            "nome": "ENCERADEIRA"
        },
        {
            "codigo": "FLD0112",
            "nome": "FILTRO HEPA CARBONO"
        },
        {
            "codigo": "FLD0101",
            "nome": "MODEM 5G"
        },
        {
            "codigo": "MUN02",
            "nome": "MUNIÇÃO CALIBRE .380"
        },
        {
            "codigo": "MUN01",
            "nome": "MUNIÇÃO CALIBRE 38"
        },
        {
            "codigo": "MUN03",
            "nome": "MUNIÇÃO CALIBRE 7,65MM"
        },
        {
            "codigo": "ARM03",
            "nome": "PISTOLAS SEMI-AUTOMÁT 7,65 MM"
        },
        {
            "codigo": "ARM02",
            "nome": "PISTOLAS SEMI-AUTOMÁTICAS .380"
        },
        {
            "codigo": "FLD0110",
            "nome": "PRENSA DOBRADEIRA HIDR AHK 321"
        },
        {
            "codigo": "MI03",
            "nome": "PULVERIZADOR MANUAL COM GATILH"
        },
        {
            "codigo": "FLD0102",
            "nome": "RECEPTOR TV"
        },
        {
            "codigo": "ARM01",
            "nome": "REVÓLVER CALIBRE 38"
        },
        {
            "codigo": "MI02",
            "nome": "RODO DE ALUMÍNIO 40 E 60 CM"
        },
        {
            "codigo": "FLD0106",
            "nome": "ROTEADOR CISCO ISR 900 SERIES"
        },
        {
            "codigo": "MC03",
            "nome": "SABONETE DESENGRAXANTE"
        },
        {
            "codigo": "UNIF03",
            "nome": "SAPATO SOCIAL"
        },
        {
            "codigo": "FLD0111",
            "nome": "SENSOR RLK91-6-IR/25/31/115"
        },
        {
            "codigo": "SERV02",
            "nome": "SERVIÇO DE LIMPEZA"
        },
        {
            "codigo": "SERV01",
            "nome": "SERVIÇO DE PORTARIA"
        },
        {
            "codigo": "SERV03",
            "nome": "SERVIÇO DE VIGILANCIA"
        },
        {
            "codigo": "FLD0107",
            "nome": "SMART SWITCH CISCO SG200-08P"
        },
        {
            "codigo": "FLD0109",
            "nome": "TORNO CNC INDEX MC 200"
        }
    ],
    "count": 40
}

Exemplo: ... rest/meutecnico/getProduct


GET / rest / meutecnico / getService


  • Retorna os serviços cadastrados no protheus módulo Gestão de serviços para serem utilizados no apontamento da ordem de serviço no APP Minhas Ordens de Serviço

Response


{
    "Service": [
        {
            "codigo": "000001",
            "nome": "TROCA DE EQUIPAMENTO"
        },
        {
            "codigo": "000002",
            "nome": "MANUTENÇÃO PREVENTIVA"
        },
        {
            "codigo": "000003",
            "nome": "CABEAMENTO"
        },
        {
            "codigo": "000004",
            "nome": "CONFIGURAÇÃO DE EQUIPAMENTO"
        },
        {
            "codigo": "000005",
            "nome": "TROCA DE SENSORES"
        },
        {
            "codigo": "000006",
            "nome": "LIMPEZA"
        }
    ],
    "count": 6
}

Exemplo: ... /rest/meutecnico/getService



GET / rest / meutecnico / getHistoric


  • Retorna as ordens de serviços que foram abertas e atendidas para o equipamento, com isso o técnico tem a possibilidade de visualizar o histórico do equipamento 

Response


{
    "Historic": [
        {
            "dataAbertura": "20201022",
            "statusOs": "Encerrada",
            "numOs": "000051",
            "itemOS": "01",
            "equipamento": "FLD0101",
            "nomeEquipamento": "MODEM 5G",
            "idUnico": "NJKHJFS786F78SD6FSHB",
            "ocorrencia": "SEM INTERNET"
        },
        {
            "dataAbertura": "20201027",
            "statusOs": "Encerrada",
            "numOs": "000068",
            "itemOS": "01",
            "equipamento": "FLD0101",
            "nomeEquipamento": "MODEM 5G",
            "idUnico": "NJKHJFS786F78SD6FSHB",
            "ocorrencia": "NÃO LIGA"
        },
        {
            "dataAbertura": "20201103",
            "statusOs": "Encerrada",
            "numOs": "000079",
            "itemOS": "01",
            "equipamento": "FLD0101",
            "nomeEquipamento": "MODEM 5G",
            "idUnico": "NJKHJFS786F78SD6FSHB",
            "ocorrencia": "ELEVADOR TRAVADO"
        }
    ],
    "count": 3
}

Exemplo: .../rest/meutecnico/getHistoric?cEquipament=FLD0101&cID=NJKHJFS786F78SD6FSHB


GET / rest / meutecnico/ getDetail


  • Retorna os detalhes da ordem de serviço selecionada pelo serviço GetHistoric, assim, o técnico vai visualizar detalhes do atendimento da ordem de serviço selecionada

Response


{
    "Detail": [
        {
            "atendente": "LUIZ GABRIEL GOMES DE JESUS",
            "dtInicio": "20201028",
            "hrInicio": "14:24",
            "dtFim": "20201028",
            "hrFim": "14:31",
            "laudo": "serviço realizado com sucesso!",
            "itensApontados": [
                {
                    "produto": "FLD0105",
                    "nomeProduto": "EMBALADORA PLASTICA",
                    "id": "",
                    "quantidade": "1",
                    "houveTroca": "true",
                    "produtoTroca": "FLD0106",
                    "nomeProdutoTroca": "ROTEADOR CISCO ISR 900 SERIES",
                    "IdTroca": "",
                    "servico": "TROCA DE EQUIPAMENTO"
                },
                {
                    "produto": "FLD0104",
                    "nomeProduto": "AR CONDICIONADA BTU15000",
                    "id": "",
                    "quantidade": "1",
                    "houveTroca": "true",
                    "produtoTroca": "FLD0104",
                    "nomeProdutoTroca": "AR CONDICIONADA BTU15000",
                    "IdTroca": "",
                    "servico": "TROCA DE EQUIPAMENTO"
                }
            ],
            "ocorrencia": "ELEVADOR TRAVADO"
        }
    ],
    "count": 1
}

Exemplo: ... rest/meutecnico/getDetail?cNumOS=000071&cItemOS=01


PUT/ rest / meutecnico/ putStatus


  • Atualiza o status da ordem de serviço de acordo com o serviço realizado

Response


{
    "status": 
        {
            "numOS": "000013",
            "statusOs": "2",
            "dtIniVisita": "",
            "hrIniVisita": ""
        } 
}

Exemplo: .../rest/meutecnico/putStatus


PUT / rest / meutecnico/ putEnceramento


  • Realiza o atendimento da ordem de serviço

Response


{
   "CodTec":"D0MG0020000036",
   "numOS":"000043",
   "statusOs":"5",
   "dtIniChegada":"20200915",
   "hrIniChegada":"09:56",
   "dtIniEncerra":"20200915",
   "hrIniEncerra":"10:43",
   "assinatura": "hjdhasjkdhakjshdjahdkjahdjahsdkjahdkjashdkajhsdkajhdkajsdhkasjdhasjhdkajdhkadhsa",
   "responsavel": "nome do responsável",
   "itensOs":[
      {
         "numeroItem":"01",
         "solicitaPeca": "true"
         "apontamento":{
            "laudo":"visita improdutiva para a ordem de serviço ",
            "produtos":[
               
            ],
            "foto":[
               {    
                   "base64": "",
                  "description":"visita improdutiva"
               }
            ]
         }
      }
   ]
}

Exemplo: ... /rest/meutecnico/putEnceramento


PUT / rest / meutecnico/ putRequest


  • Realiza a requisição de peças para a ordem de serviço

Request


{
   "CodTec":"D0MG0020000036",
   "numOS":"000042",
   "itensOs":[
      {
         "numeroItem":"01",
         "requisicao":{
            "produtos":[
               {
                  "uid":0,
                  "codigo":"FLD0104",
                  "nome":"AR CONDICIONADA BTU15000",
                  "quantidade":1,
                  "codService":"000002",
                  "nomeService":"100% CLIENTE"
               }
            ]
         }
      }
   ]
}

Exemplo: ... rest/meutecnico/putRequest


POST / rest / meutecnico/ postsolicitation


  • Atualiza e sinaliza que o técnico recebeu todas as peças para dar prosseguimento no atendimento da ordem de serviço 

Request


{
   "CodTec":"D0MG0020000036",
   "numOS":"000037",
   "itemOS":"01"
}

Exemplo: ... rest/meutecnico/postsolicitation