Abrir Ordem de Serviço
POST {{url}}/api/v1/integracao/ordem_servico/abrir_os?id_atendimento=16069
No método POST, será possível adicionar uma Ordem de Serviço a partir de um Atendimento em que o Tipo de Atendimento permita abrir uma O.S. O retorno será em formato JSON e os seguintes parâmetros podem/devem ser utilizados:
Atributo | Descrição | Obrigatório |
---|---|---|
id_atendimento | Define o Identificador do Atendimento que servirá como ponto de partida para abrir a O.S | Sim |
idagendaordem_servico | Define o identificador da Agenda da O.S | Não |
idtipoordem_servico | Define o Tipo da Ordem de Serviço | Não |
datainicioprogramado | Define a data de início programada para a O.S | Não |
dataterminoprogramado | Define a data termino programada para a O.S | Não |
horainicioprogramado | Define o horário de início programado | Não |
horaterminoprogramado | Define o horário termino programado | Não |
status | Define o status da O.S | Não |
prioridade | Define a prioridade da O.S | Não |
descricao_servico | Define a descrição do Serviço | Não |
tecnicos | Define os técnicos da O.S | Não |
disponibilidade | Define a disponibilidade da O.S | Não |
Os atributos podem conter os seguintes valores:
Atributo | Descrição | Valor Default |
---|---|---|
id_atendimento | Número Inteiro | Nenhum |
idagendaordem_servico | Número Inteiro | Nenhum |
idtipoordem_servico | Número Inteiro | ABERTURA VIA API |
datainicioprogramado | Formato date (2024-04-01) | Nenhum |
dataterminoprogramado | Formato date (2024-04-01) | Nenhum |
horainicioprogramado | Formato de horário (H:i:s) | Nenhum |
horaterminoprogramado | Formato de horário (H:i:s) | Nenhum |
status | Texto (string) | aguardando_agendameto |
prioridade | Texto (string) | normal |
descricao_servico | Texto (string) | O.S aberta via API. |
tecnicos | Um array que vai conter os ids dos tecnios da O.S: "tecnicos": { "0": {"id": 5249}, "1": {"id": 7600} } | SAC (Atendimento) |
disponibilidade | Um array que vai conter os prefixos dos periodos do dia da disponibilidades da O.S: "disponibilidade": { "0": "manha", "1": "tarde" } | manha e tarde |
Observação: Se o parâmetro idtipoordem_servico não for enviado, a O.S será aberta com o tipo padrão ATENDIMENTO VIA API assim como se não for adicionado nenhum técnico, o técnico definido será SAC (Atendimento). Além deles, as datas inicio e termino terão o dia de hoje como padrão e o horário de início e termino terão 1 hora a mais do horário de abertura da O.S e 1 hora de duração, o status virá como aguardando_agendamento e a disponibilidade deve ser preenchida em um array com o parâmetro de cada disponibilidade, se não for preenchida, ela virá como manhã e tarde definidas.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
id_atendimento | number |