Reagendar¶
Necessário
Para fazer requisições nos dados de ordem de serviço, é necessário que você já possua o TOKEN, conseguido na etapa (Autenticação)
A requisição de reagendamento da ordem de serviço, deve ser feita na rota:
/api/v1/integracao/ordem_servico/reagendar
O endereço completo, ficará da seguinte forma:
https://endereco_do_servidor/api/v1/integracao/ordem_servico/reagendar
Endpoint (Rota)
Neste endpoint, será possível reagendar a ordem de serviço, obtendo o retorno no formato JSON como resposta. Os seguintes parâmetros podem/devem ser utilizados:
Atributo | Descrição | Obrigatório |
---|---|---|
id_ordem_servico | Identificador da ordem de serviço | Sim |
data_inicio_programado | Data inicial programada para iniciar a execução da ordem de serviço | Sim |
hora_inicio_programado | Hora inicial programada para iniciar a execução da ordem de serviço | Sim |
data_termino_programado | Data final programada para finalizar a execução da ordem de serviço | Sim |
hora_termino_programado | Hora final programada para finalizar a execução da ordem de serviço | Sim |
id_usuario_antigo | Identificador do usuário (técnico) responsável pela ordem de serviço | Sim, se o id_usuario_novo for especificado |
id_usuario_novo | Identificador do usuário (técnico) responsável pela ordem de serviço | Sim, se o id_usuario_antigo for especificado |
Os atributos podem conter os seguintes valores:
Atributo | Descrição | Valor Default |
---|---|---|
id_ordem_servico | Número Inteiro | Nenhum |
data_inicio_programado | Timestamp (2020-01-01) | Nenhum |
hora_inicio_programado | Texto (12:00:00) | Nenhum |
data_termino_programado | Texto (2020-01-01) | Nenhum |
hora_termino_programado | Texto (13:00:00) | Nenhum |
id_usuario_antigo | Número Inteiro | Nenhum |
id_usuario_novo | Número Inteiro | Nenhum |
Exemplo de requisição POST na rota de consulta da ordem de serviço:
curl -X POST
--header "Accept:application/json"
--header "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6Ijg0MTM2O"
https://endereco_servidor/api/v1/integracao/ordem_servico/reagendar -d
'{
"id_ordem_servico": "1493",
"data_inicio_programado": "2020-11-23",
"hora_inicio_programado": "08:00:00",
"data_termino_programado": "2020-11-23",
"hora_termino_programado": "09:30:00",
"id_usuario_antigo": 4,
"id_usuario_novo": 1
}' -k
Veja que os paramêtros enviados na requisição POST devem obedecer a estrutura no formato JSON:
{
"id_ordem_servico": "1493",
"data_inicio_programado": "2020-11-23",
"hora_inicio_programado": "08:00:00",
"data_termino_programado": "2020-11-23",
"hora_termino_programado": "09:30:00",
"id_usuario_antigo": 4,
"id_usuario_novo": 1
}
Retorno da requisição POST:
{
"status": "success",
"msg": "Reagendamento salvo com sucesso",
"ordem_servico": {
"id_ordem_servico": 1493,
"numero": "1262",
"tipo": "INSTALAÇÃO FIBRA - VALORES OBRIGATÓRIOS: R$ 280.00",
"data_inicio_programado": "2020-11-23 08:00",
"data_termino_programado": "2020-11-23 09:30",
"data_inicio_executado": null,
"data_termino_executado": null,
"data_cadastro": "2020-11-18 13:35:31",
"descricao_abertura": "TESTE",
"descricao_servico": "TESTE",
"descricao_fechamento": null,
"status": "Pendente",
"tecnicos": [
{
"id": 1,
"name": "Master",
"pivot": {
"id_ordem_servico": 1493,
"id_usuario": 1
}
}
],
"disponibilidade": "Manhã, Tarde",
"cliente": "(1395) GUILHERME COUTO",
"servico": "(1) PLANO 5 MBPS RAP10 E FIXO EM DOBRO",
"endereco_instalacao": "PRAÇA GETÚLIO VARGAS, 77, SALA 411(SHOPPING WORK) - CENTRO, SANTO ANTÔNIO DO MONTE\/MG | CEP: 35560-000"
}
}