LOCW015 - API Retorna as Ordens der Serviços abertas por cliente para o Aplicativo Portal do Locador

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Criar API do Tipo Get para enviar o Json com a informações para visualizar as Ordens de Serviços abertas por cliente no app Portal do Locador

03. SOLUÇÃO

Foi criada a API no seguinte end point:/RetManutBem/{param1}/{param2}/{param3}/{param4}

Parâmetros de entrada:

• • param1 - Código do Cliente Logado no APP
  • param2 - Loja do Cliente Logado no APP
  • param3 - Cnpj do Cliente Logado no APP
  • param4- cnpj da empresa cadastrada no SIGAMAT (Cadastro de empresas), é obrigatório pois server para logar na empresa/filial do sistema.
• Os parâmetros acima são obrigatórios segui a regra:
• caso sejam informados código do cliente (param1) e loja do cliente (param2) não será necessa´rio informar o cnpj cliente logado no app (param3)
• caso seja informado o cnpj do cliente logado no app (param3) não será necessário informar os parâmetros param1 e param2
• aut - cnpj da empresa cadastrada no SIGAMAT (Cadastro de empresas), é obrigatório pois server para logar na empresa/filial do sistema.

Json enviado ao app para o a visualização do Ordens de Serviço abertas por cliente:

{
   "Retorno": "OK",
   "cnpj": "86780284000100",
   "Nome": "SIGALOC 94",
   "Frotas":    [
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000300",
         " equipamento": "077LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240730"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000301",
         " equipamento": "056LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20250125"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000303",
         " equipamento": "059LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240801"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000304",
         " equipamento": "059LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240801"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000305",
         " equipamento": "059LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240801"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000306",
         " equipamento": "086LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240808"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000307",
         " equipamento": "087LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240808"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000308",
         " equipamento": "088LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240809"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000309",
         " equipamento": "089LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240809"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000310",
         " equipamento": "088LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240809"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000311",
         " equipamento": "089LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240809"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000312",
         " equipamento": "088LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240809"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000313",
         " equipamento": "089LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240809"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000314",
         " equipamento": "088LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240809"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000315",
         " equipamento": "091LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240809"
      },
            {
         "projeto": "",
         " obra": "001",
         " nome_obra": "000094",
         " num_os": "000316",
         " equipamento": "089LOC",
         " tip_manutencao": "C",
         " placa": "123456",
         " dt_agendamento": "20240820"
      }
   ]
}

Retorno esperado:
Response:

{"Retorno":"OK" "}

04. DEMAIS INFORMAÇÕES

         "projeto": "",  - PROJETO QUE A ORDEM DE SERVIÇO ESTÁ AMARRADA
         " obra": "001", - OBRA QUE A ORDEM DE SERVIÇO ESTÁ AMARRADA
         " nome_obra": "000094", - NOME DA OBRA QUE A ORDEM DE SERVIÇO ESTÁ AMARRADA
         " num_os": "000300", - CÓDIGO DA ORDEM DE SERVIÇO
         " equipamento": "077LOC", - EQUIPAMENTO/BEN
         " tip_manutencao": "C", - TIPO DE MANUTENÇÃO, SE FOR "C" SERÁ CORRETIVA, SE FOR "P" SERÁ PREVENTIVA
         " placa": "123456", - PLACA DO BEM/VEÍCULO CASO INFORMADO NO CADASTRO DE BENS
         " dt_agendamento": "20240730" - DATA QUE FOI AGENDADA A MANUTENÇÃO DO BENS/EQUIPMENTO

Tabela envolvidas

STJ - Ordem de Serviço

ST9 - BENS

ST4 - SERVIÇOS DE MANUTENÇÃO

STE - TIPO DE MANUTENÇÃO

FP0 - CONTRATOS

05. ASSUNTOS RELACIONADOS

Apps RENTAL