POST

api/servicos/gs/Apontamento/CriarEditarApontamentoProjeto

Notas de Implementação:

Cria apontamento para o técnico

Esse método suporta a passagem de parâmetros de consultas OData para restringir os resultados. Mais informações em: https://learn.microsoft.com/pt-br/odata/overview

Informações de Envio:

Cabeçalhos de Envio:

Parâmetro Valor Descrição Tipo de parâmetro Tipo de dados
Authorization Bearer Hash gerado no login Header String

Acesse o método de login para mais informações: api/genericos/ge/Login/Autenticar

Direitos:

MNPJMOV,PJ54GF7U90,MNGMMOV

Itens de Menu:

PJ00047,PJ00048,GS07958

Modelo:

Dados do apontamento

ApontamentoDTO

NomeDescriçãoTipoInformação Adicional
Codigo

decimal number

Opcional
CodigoOrdemServico

integer

Opcional
CodigoItem

integer

Opcional
CodigoAtividade

integer

Opcional
Cliente

string

Opcional
TempoTotal

decimal number

Opcional
TempoAdicional

decimal number

Opcional
SubAtividade

string

Opcional
Situacao

string

Opcional
Tecnico

string

Opcional
DataInicio

date

Opcional
DataFim

date

Opcional
DataInicioUltimaContagem

date

Opcional
HoraInicioUltimaContagem

date

Opcional
HoraInicio

string

Opcional
HoraFim

string

Opcional
PercentualConcluido

decimal number

Opcional
Observacao

string

Opcional
DataCriacao

date

Opcional
UsuarioCriacao

string

Opcional
UsuarioModificacao

string

Opcional
Atualizacao

string

Opcional
CodigoRetorno

integer

Opcional
SeqDocumentoVersao

integer

Opcional
CodigoAtividadeFreq

string

Opcional
FinalidadeObservacao

string

Opcional
Faturar

string

Opcional
TipoApontamento

string

Opcional
TipoAlocacao

string

Opcional
ConsiderarCalendario

string

Opcional
TipoOrdemServico

string

Opcional
Solicitante

string

Opcional
Produto

string

Opcional
Solucao

string

Opcional
Causa

string

Opcional
SequenciaContato

integer

Opcional
Projeto

integer

Opcional
EtapaProjeto

integer

Opcional
IdProjetoAtividade

integer

Opcional
SeqApontamentoPai

decimal number

Opcional
Equipe

string

Opcional
Versao

string

Opcional
CausaApontamento

string

Opcional
ConsiderarHorasPlanejadas

boolean

Opcional
DescricaoSolucao

string

Opcional
DescricaoCausa

string

Opcional
Selecionado

boolean

Opcional
AdicionarObservacaoSolucao

boolean

Opcional
TipoCriacaoOrdemServico

integer

Opcional

Formato de Envio:

application/json, text/json

Exemplo: 
{
  "Codigo": 1.1,
  "CodigoOrdemServico": 2,
  "CodigoItem": 3,
  "CodigoAtividade": 4,
  "Cliente": "string 5",
  "TempoTotal": 6.1,
  "TempoAdicional": 7.1,
  "SubAtividade": "string 8",
  "Situacao": "string 9",
  "Tecnico": "string 10",
  "DataInicio": "2026-01-13",
  "DataFim": "2026-01-13",
  "DataInicioUltimaContagem": "2026-01-13",
  "HoraInicioUltimaContagem": "2026-01-13",
  "HoraInicio": "string 15",
  "HoraFim": "string 16",
  "PercentualConcluido": 17.1,
  "Observacao": "string 18",
  "DataCriacao": "2026-01-13",
  "UsuarioCriacao": "string 20",
  "UsuarioModificacao": "string 21",
  "Atualizacao": "string 22",
  "CodigoRetorno": 23,
  "SeqDocumentoVersao": 24,
  "CodigoAtividadeFreq": "string 25",
  "FinalidadeObservacao": "string 26",
  "Faturar": "string 27",
  "TipoApontamento": "string 28",
  "TipoAlocacao": "string 29",
  "ConsiderarCalendario": "string 30",
  "TipoOrdemServico": "string 31",
  "Solicitante": "string 32",
  "Produto": "string 33",
  "Solucao": "string 34",
  "Causa": "string 35",
  "SequenciaContato": 36,
  "Projeto": 37,
  "EtapaProjeto": 38,
  "IdProjetoAtividade": 39,
  "SeqApontamentoPai": 40.1,
  "Equipe": "string 41",
  "Versao": "string 42",
  "CausaApontamento": "string 43",
  "ConsiderarHorasPlanejadas": true,
  "DescricaoSolucao": "string 45",
  "DescricaoCausa": "string 46",
  "Selecionado": true,
  "AdicionarObservacaoSolucao": true,
  "TipoCriacaoOrdemServico": 49
}

Informações de Retorno:

Cabeçalhos Adicionais:

Nome Descrição Valor
cigam-api-version Versão do build/compilação dessa versão da API 2.1.8565.21067

Modelo:

HttpCustomResponse

NomeDescriçãoTipoInformação Adicional
success

boolean

Opcional
hash

string

Opcional
messages

string

Opcional
data

Object

Opcional
tipoLogin

string

Opcional

Formato de Resposta:

Objeto JSON com o response da requisição

Código de status HTTP Descrição Modelo de resposta
200 OK

application/json, text/json

Exemplo: 
{
  "success": true,
  "hash": "string 2",
  "messages": [
    "string 1"
  ],
  "data": {},
  "tipoLogin": "string 4"
}
400 Requisição inválida

application/json, text/json

Exemplo:
{ 
                    "success": false,
                    "hash": "string 2",
                    "messages": [
                     "string 1"
                    ],
                     "data": {},
                     "tipoLogin": "string 4"
}
401 Não autorizado

application/json, text/json

Exemplo:
{ 
                    "success": false,
                    "hash": "string 2",
                    "messages": [
                     "string 1"
                    ],
                     "data": {},
                     "tipoLogin": "string 4"
}
500 Requisição falhou

application/json, text/json

Exemplo:
{ 
                    "success": false,
                    "hash": "string 2",
                    "messages": [
                     "string 1"
                    ],
                     "data": {},
                     "tipoLogin": "string 4"
}
502 Falha de comunicação

application/json, text/json

Exemplo:
{ 
                    "success": false,
                    "hash": "string 2",
                    "messages": [
                     "string 1"
                    ],
                     "data": {},
                     "tipoLogin": "string 4"
}