iopoint
Referência

Departamentos

Listar e criar departamentos.

URL Base
https://api.iopoint.com.br/api

Endpoints

Listar departamentos

GET/customer/v2/department

Retorna todos os departamentos ativos da empresa.

Query parameters

NomeTipoObrig.Descrição
include_branchesbooleannãoQuando `1`, agrega a matriz e todas as filiais do grupo econômico na resposta. Só leitura.
company_national_registrystringnãoCNPJ (apenas dígitos) de uma empresa do grupo para restringir o escopo a ela. Use os CNPJs retornados em `GET /economic-group`. Fora do grupo acessível retorna `company_not_found` (404).

Exemplos

Request
curl -X GET "https://api.iopoint.com.br/api/customer/v2/department" \
  -H "apiIopointToken: SEU_TOKEN_AQUI"
Response200
{
  "data": [
    {
      "id": 1,
      "description": "Recursos Humanos"
    },
    {
      "id": 2,
      "description": "Operação"
    },
    {
      "id": 3,
      "description": "Financeiro"
    }
  ]
}

Respostas

200
{
  "data": [
    {
      "id": 1,
      "description": "Recursos Humanos"
    },
    {
      "id": 2,
      "description": "Operação"
    },
    {
      "id": 3,
      "description": "Financeiro"
    }
  ]
}

Criar departamento

POST/customer/v2/department

Cria um novo departamento ativo na empresa.

Body (application/json)

NomeTipoObrig.Descrição
descriptionstringsimNome do departamento.

Exemplos

Request
curl -X POST "https://api.iopoint.com.br/api/customer/v2/department" \
  -H "apiIopointToken: SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Tecnologia da Informação"
}'
Response201
{
  "data": {
    "id": 7
  }
}

Respostas

201
{
  "data": {
    "id": 7
  }
}