Criar centro de custo

Este endpoint permite criar um novo centro de custo na empresa.


Campos obrigatórios

  • name: Nome. Máximo de 300 caracteres.
  • externalCode: Código externo. Máximo de 50 caracteres. Único na empresa.
  • description: Descrição. Máximo de 900 caracteres.

Exemplo de requisição (cURL)

curl --request POST \
     --url 'https://api.gupy.io/os/v1/cost-centers' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer bearer_token_value_here' \
     --data '{
       "name": "RH Cost Center",
       "externalCode": "CC-001",
       "description": "Centro de custo de RH"
     }'

Atenção: Forneça o token no cabeçalho Authorization.

Possíveis erros

Código externo já existente (409)

{
  "message": "A cost center with this external code already exists in the company"
}

Não autenticado (401)

Token ausente ou inválido.