01. DADOS GERAIS
| Linha de Produto: | TOTVS RENTAL |
|---|---|
| Segmento: | Serviços |
| Módulo: | SIGALOC |
| Função: | RETOS |
| Ticket: | Não há. |
| Story: | DSERLOCA-5962 |
02. SITUAÇÃO/REQUISITO
Criar API do Tipo Get para retornar um Json com a informações para das ordem serviço geradas no app.
03. SOLUÇÃO
Foi criada a API no seguinte end point:/RETOS?cod=000006&loja=01&aut=53485215000106&cdtini=20250620&cdtfim=20250620
Parâmetros de entrada:
- cod=18209965 - Código do Fornecedor
- loja=0001 - Loja do Fornecedor
- aut=12279184000150 - Cnpj da Filial - SIGAMAT
- cdtini=20250620 - Data inicial para busca de Ordens de serviço, tem que ser no formato americano yyyymmdd
- cdtfim=20250620 - Data final para busca de Ordens de serviço, tem que ser no formato americano yyyymmdd
Retorno esperado:
Response:
{
"Retorno": "OK",
"CodFor": "18209965",
"Nome": "BAMAQ SA BANDEIRANTES MAQUINAS E EQUIPAM",
"Ordens": [
{
"projeto": "202500001 ",
"obra": "001",
"AS": "30000010010010401",
"Observ": "",
"Contador": "",
"Servico": "CORELE",
"dt_abertura": "20250620",
"Bem": "RNW7A09",
"Ordem": "000278",
"Plano": "000000",
"tarefa": "0",
"tipo_re": "P", - F=Ferramenta;M=Mão de Obra;P=Produto;T=Terceiro;E=Especialidade
"codigo": "000000000000000000000000000010",
"desc_cod": "PRODUTO WMS ",
"quanti": "10",
"seq_rel": "0",
"seq_tar": "001",
"aprovador": "00001",
"nome_apr": "A",
"dat_apro": "",
"hora_apro": "09:00",
"dt_enc": "",
"hr_enc": "09:00",
"ped_com": "999999",
"valor_uni": "50",
"valor_tot": "500",
"valor_uni_apr": "50",
"valor_tot_apr": "500",
"cod_finalidade": "000001",
"desc_finalidade": "10",
"cobra": "S", - S=SIM;N=NAO
"custo_extra": "500",
"arquivo": "base64string",
"status_apr": "2" - 1=PENDENTE;2=APROVADO;3=REPROVADO
},
{
"projeto": "202500001 ",
"obra": "001",
"AS": "30000010010010401",
"Observ": "",
"Contador": "",
"Servico": "CORELE",
"dt_abertura": "20250620",
"Bem": "RNW7A09",
"Ordem": "000278",
"Plano": "000000",
"tarefa": "0",
"tipo_re": "P", - F=Ferramenta;M=Mão de Obra;P=Produto;T=Terceiro;E=Especialidade
"codigo": "000000000000000000000000000010",
"desc_cod": "PRODUTO WMS ",
"quanti": "10",
"seq_rel": "0",
"seq_tar": "002",
"aprovador": "00001",
"nome_apr": "A",
"dat_apro": "",
"hora_apro": "09:00",
"dt_enc": "",
"hr_enc": "09:00",
"ped_com": "999999",
"valor_uni": "50",
"valor_tot": "500",
"valor_uni_apr": "50",
"valor_tot_apr": "500",
"cod_finalidade": "000001",
"desc_finalidade": "10",
"cobra": "S", - S=SIM;N=NAO
"custo_extra": "500",
"arquivo": "base64string",
"status_apr": "2" - 1=PENDENTE;2=APROVADO;3=REPROVADO
},
{
"projeto": "202500001 ",
"obra": "001",
"AS": "30000010010010401",
"Observ": "",
"Contador": "",
"Servico": "CORELE",
"dt_abertura": "20250620",
"Bem": "RNW7A09",
"Ordem": "000278",
"Plano": "000000",
"tarefa": "0",
"tipo_re": "P", - F=Ferramenta;M=Mão de Obra;P=Produto;T=Terceiro;E=Especialidade
"codigo": "000000000000000000000000000010",
"desc_cod": "PRODUTO WMS ",
"quanti": "10",
"seq_rel": "0",
"seq_tar": "003",
"aprovador": "00001",
"nome_apr": "A",
"dat_apro": "",
"hora_apro": "09:00",
"dt_enc": "",
"hr_enc": "09:00",
"ped_com": "999999",
"valor_uni": "50",
"valor_tot": "500",
"valor_uni_apr": "50",
"valor_tot_apr": "500",
"cod_finalidade": "000001",
"desc_finalidade": "10",
"cobra": "S", - S=SIM;N=NAO
"custo_extra": "500",
"arquivo": "base64string",
"status_apr": "2" - 1=PENDENTE;2=APROVADO;3=REPROVADO
},
{
"projeto": "202500001 ",
"obra": "002",
"AS": "30000010020020401",
"Observ": "",
"Contador": "",
"Servico": "CORELE",
"dt_abertura": "20250620",
"Bem": "RNO8G56",
"Ordem": "000279",
"Plano": "000000",
"tarefa": "0",
"tipo_re": "P", - F=Ferramenta;M=Mão de Obra;P=Produto;T=Terceiro;E=Especialidade
"codigo": "000000000000000000000000000010",
"desc_cod": "PRODUTO WMS ",
"quanti": "10",
"seq_rel": "0",
"seq_tar": "001",
"aprovador": "00001",
"nome_apr": "A",
"dat_apro": "",
"hora_apro": "09:00",
"dt_enc": "",
"hr_enc": "09:00",
"ped_com": "999999",
"valor_uni": "50",
"valor_tot": "500",
"valor_uni_apr": "50",
"valor_tot_apr": "500",
"cod_finalidade": "000001",
"desc_finalidade": "10",
"cobra": "S", - S=SIM;N=NAO
"custo_extra": "500",
"arquivo": "base64string",
"status_apr": "2" - 1=PENDENTE;2=APROVADO;3=REPROVADO
},
{
"projeto": "202500001 ",
"obra": "002",
"AS": "30000010020020401",
"Observ": "",
"Contador": "",
"Servico": "CORELE",
"dt_abertura": "20250620",
"Bem": "RNO8G56",
"Ordem": "000279",
"Plano": "000000",
"tarefa": "0",
"tipo_re": "P",
"codigo": "000000000000000000000000000010",
"desc_cod": "PRODUTO WMS ",
"quanti": "10",
"seq_rel": "0",
"seq_tar": "002",
"aprovador": "00001",
"nome_apr": "A",
"dat_apro": "",
"hora_apro": "09:00",
"dt_enc": "",
"hr_enc": "09:00",
"ped_com": "999999",
"valor_uni": "50",
"valor_tot": "500",
"valor_uni_apr": "50",
"valor_tot_apr": "500",
"cod_finalidade": "000001",
"desc_finalidade": "10",
"cobra": "S", - S=SIM;N=NAO
"custo_extra": "500",
"arquivo": "base64string",
"status_apr": "2" - 1=PENDENTE;2=APROVADO;3=REPROVADO
},
{
"projeto": "202500001 ",
"obra": "002",
"AS": "30000010020020401",
"Observ": "",
"Contador": "",
"Servico": "CORELE"1,
"dt_abertura": "20250620",
"Bem": "RNO8G56",
"Ordem": "000279",
"Plano": "000000",
"tarefa": "0",
"tipo_re": "P", - F=Ferramenta;M=Mão de Obra;P=Produto;T=Terceiro;E=Especialidade
"codigo": "000000000000000000000000000010",
"desc_cod": "PRODUTO WMS ",
"quanti": "10",
"seq_rel": "0",
"seq_tar": "003",
"aprovador": "00001",
"nome_apr": "A",
"dat_apro": "",
"hora_apro": "09:00",
"dt_enc": "",
"hr_enc": "09:00",
"ped_com": "999999",
"valor_uni": "50",
"valor_tot": "500",
"valor_uni_apr": "50",
"valor_tot_apr": "500",
"cod_finalidade": "000001",
"desc_finalidade": "10",
"cobra": "S", - S=SIM;N=NAO
"custo_extra": "500",
"arquivo": "base64string",
"status_apr": "2" - 1=PENDENTE;2=APROVADO;3=REPROVADO
}
]
}
04. DEMAIS INFORMAÇÕES
Tabela envolvida STL - DETALHES DA ORDEM DE SERVIÇO
STJ - Ordens de Serv de Manutenção
05. ASSUNTOS RELACIONADOS
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas