Exibir origem

01. DADOS GERAIS

Linha de Produto:	TOTVS RENTAL
Segmento:	Serviços
Módulo:	SIGALOC
Função:	RetManutBem
Ticket:	Não há.
Story:	DSERLOCA-5172

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