Objetivo

A finalidade deste método é possibilitar a inclusão de lançamentos orçamentários.

Chamada

POST/api/v1/lancamentos

Informações para Requisição (Request Information)

{
  "origem": "NFDESP",
  "identificadorUnicoOrigem": "001",
  "identificador": "12425",
  "tipoConsumo": 2,
  "dataSolicitacao": "2022-11-18",
  "dataLancamento": "2022-11-18",
  "solicitante": "Usuário da Silva",
  "codUsuario": "USUARIO1"
  "justificativa": "Necessário troca de equipamento queimado.",
  "lancamentoValores": [
    {
      "empresaId": 1,
      "contaContabil": 90101010001,
      "centroResultado": 111101,
      "valor": 100
    },
 
    {
      "empresaId": 1,
      "contaContabil": 90101010001,
      "centroResultado": 111102,
      "valor": 200
    }
  ]
}


Parâmetros body

ParâmetroTipoDescriçãoValores
origemstring

Identificador do módulo de origem dentro do Gestão Orçamentária

-
identificadorUnicoOrigemstringIdentificador único que faz referência ao item no módulo de origem.-
identificadorstringIdentificador do lançamento no módulo origem.-
tipoConsumointTipo de consumo que será realizado na Gestão Orçamentária.

1 - Previsto;

2 - Realizado.

dataSolicitacaodateData da solicitação do lançamento.-
dataLancamentodateData que será efetivado o lançamento.-
solicitantestringNome do usuário solicitante.-
codUsuariostringCódigo do usuário solicitante.-
justificativastringJustificativa para lançamento.-
lancamentoValoresarrayLista contendo informações do lançamento de conta e centro.

-

Parâmetros body: lancamentoValores

ParâmetroTipoDescriçãoValores
empresaIdlong

Numero da empresa que irá receber o lançamento.

-
contaContabillongNumero da conta contábil que irá receber o lançamento.-
centroResultadolongNumero do centro de resultado que irá receber o lançamento.-
valordecimalValor do lançamento.-


Informações para Resposta (Response Information)

Descrição do Recurso (Resource Description)

Não há. 

Formatos de Resposta (Response Formats)

Código (Code)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
201CreatedNão háNão há

application/json, text/json 

{
  "id": 0,
  "situacao": 0
}

Response

ParâmetroTipoDescriçãoValores
idlong

Identificador único do lançamento no Gestão Orçamentária

-
situacaointSituação do lançamento

0 - Rejeitado; 

1 - Efetivado;

2 - Aguardando aprovação de verba.



Código (Code)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
400Bad RequestNão háPropriedade code poderá apresentar o seguinte status: "Rejeitado sem verba" ou "Rejeitado sem justificativa"

application/json, text/json 

{
  "code": "1",
  "message": "string",
  "detailedMessage": "string",
  "helpUrl": "string",
  "details": [
    {
      "guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "notificationType": 0,
      "code": "string",
      "message": "string",
      "detailedMessage": "string",
      "status": 0
    }
  ]
}

Response

ParâmetroTipoDescriçãoValores
codeint

Código de falha

1 - Conta/Centro não possui verba disponível;

2 - Não foi informado justificativa para estouro;

3 - Não foi encontrado nenhum registro;

4 - Não foi possível localizar um usuário aprovador;
6 - Campo não informado;

messagestringMensagem de erro

-

detailedMessagestringDetalhamento do erro-
helpUrlstringLink para documentação de ajuda do erro-
detailsarrayLista de erros -
  • Sem rótulos