Cria ou atualiza o saldo de um colaborador

POST 
/v1/saldo

Atualiza o valor quando já existe exatamente um saldo para o colaborador e a competência; caso contrário, cria um registro. A competência deve ser o último dia do mês. Na criação, a vigência vai do dia 16 do mês anterior ao dia 15 do mês da competência.

Authorization

Autentique-se em POST /v1/autenticacao e informe no campo Bearer Token somente o valor da propriedade token retornada. A interface enviará o cabeçalho Authorization: Bearer TOKEN automaticamente.

Request

application/json

Body

Body

required

empCod int64required
matricula int64required
dtComp daterequired
vlrSaldo doublerequired

saldo

{
  "empCod": 1,
  "matricula": 1069,
  "dtComp": "2026-07-31",
  "vlrSaldo": 1260.28
}

Responses

200

Saldo criado ou atualizado com sucesso.

application/json

Schema

Schema

success booleanrequired
message stringnullablerequired
total int64required

data

object[]

required

Array [

id int64required

colaborador

object

required

id int64required

empCod int64required

matricula int64required

dtComp daterequired

dtIniVig daterequired

dtFimVig daterequired

vlrSaldo doublerequired

]

Example (from schema)

{
  "success": true,
  "message": "string",
  "total": 0,
  "data": [
    {
      "id": 0,
      "colaborador": {
        "id": 0,
        "empCod": 0,
        "matricula": 0
      },
      "dtComp": "2024-07-29",
      "dtIniVig": "2024-07-29",
      "dtFimVig": "2024-07-29",
      "vlrSaldo": 0
    }
  ]
}

sucesso

{
  "success": true,
  "message": null,
  "total": 1,
  "data": [
    {
      "id": 2,
      "colaborador": {
        "id": 10,
        "empCod": 1,
        "matricula": 1069
      },
      "dtComp": "2026-07-31",
      "dtIniVig": "2026-06-16",
      "dtFimVig": "2026-07-15",
      "vlrSaldo": 1260.28
    }
  ]
}

400

Regra de negócio não atendida ou chamada inválida.

application/json

Schema

Schema

success booleanrequired
message stringrequired
total int64
data undefined[]
cause stringnullable

Example (from schema)

{
  "success": false,
  "message": "Invalid call of API.",
  "total": 0,
  "data": [
    null
  ],
  "cause": "string"
}

422

Falha de binding ou validação dos parâmetros recebidos.

application/json

Schema

Schema

success booleanrequired
message stringrequired
total int64
data undefined[]
cause stringnullable

Example (from schema)

{
  "success": false,
  "message": "Invalid call of API.",
  "total": 0,
  "data": [
    null
  ],
  "cause": "string"
}

Loading...