SIGEP II

O SIGEP II é o registro do Departamento Administrativo de la Función Pública de quem trabalha para o Estado colombiano. Cada entidade informa ali seus servidores públicos e contratados, com o cargo que ocupam, sua formação e experiência, os contratos vigentes e a escala salarial da entidade, e o diretório de entidades registra o NIT, a natureza jurídica, a ordem, o setor e a localização de cada uma. Busque pessoas por nome, entidade ou cidade e filtre por departamento, município, entidade ou tipo de vínculo; leia uma hoja de vida completa; busque entidades; e consulte a ficha de uma entidade.

Buscar pessoas

POST /co/sigep/servants-search/v1 Live Uma busca sobre todas as pessoas que as entidades informam ao SIGEP II, servidores e contratados.

Campo	Tipo	Notas
`query`	string	Nomes e sobrenomes, uma entidade ou uma cidade. Opcional se um filtro for enviado.
`department`	string	Departamento opcional do cargo, p. ex. `CÓRDOBA`. Acentos e maiúsculas são opcionais.
`municipality`	string	Município opcional do cargo, p. ex. `MONTERÍA`. Acentos e maiúsculas são opcionais.
`entity_code`	string	Código SIGEP opcional de uma entidade: `facets.entities[].code`, ou `sigep_code` dos endpoints de entidades.
`employment_type`	enum	Opcional: `servidor_publico` ou `contratista`.
`page`	integer	Número da página, começa em 1. Por padrão `1`.
`per_page`	integer	Resultados por página (1-100). Por padrão `20`.

curl https://api.croma.run/co/sigep/servants-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "query": "alcaldia de monteria",
        "employment_type": "servidor_publico"
      }'

Retorna os filtros aplicados, total, total_pages, page, per_page, count, results[] e facets.

Campo	Notas
`results[].id`	Id da hoja de vida: envie-o como `servant_id` ao SIGEP II Person.
`results[].full_name`	Nomes e sobrenomes como publicados.
`results[].employment_type`	`servidor_publico` ou `contratista`, com o rótulo do diretório em `employment_type_label`.
`results[].entity` / `entity_code`	A entidade à qual a pessoa está vinculada e seu código SIGEP.
`results[].phone`, `city`, `department`	Telefone de contato e local do cargo, como a entidade os informou.
`results[].url`	A página da pessoa no diretório público.
`facets`	`departments[]`, `municipalities[]`, `entities[]` (com `code`) e `employment_types[]`, cada um com `name` e `count`: como os resultados se distribuem e os valores exatos que os filtros aceitam.

Os filtros de departamento e município são comparados com a grafia do diretório. cordoba e CÓRDOBA funcionam igual: a resposta repete a grafia aplicada.

Uma hoja de vida

POST /co/sigep/servant/v1 Live

Campo	Tipo	Notas
`servant_id`	string	Obrigatório. O `id` do SIGEP II People Search, p. ex. `S2060152-4395-4`.

curl https://api.croma.run/co/sigep/servant/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "servant_id": "S2060152-4395-4" }'

Retorna found, servant_id e servant:

Campo	Notas
`full_name`, `position`, `employment_type`	Quem é a pessoa e o cargo que ocupa.
`entity`, `dependency`	A entidade e a unidade dentro dela.
`email`, `phone`, `fax`	Dados de contato como a entidade os informou; `null` quando não informados.
`birthplace`	`municipality`, `department`, `country`.
`education[]`	`level`, `program`, `status` e a linha `raw`.
`experience[]`	`position`, `entity`, `start_date`, `end_date` (`yyyy-mm-dd`) e `current`.
`contracts[]`	Contratos vigentes: `entity`, `object`, `start_date`, `end_date`, `amount` (COP) e `amount_text`.
`salary_scale[]`	A escala salarial da entidade (`salary_scale_entity`): `level`, `denomination`, `grade`, `total` (COP mensal).

Um id que o diretório não tem retorna found: false com HTTP 200.

Buscar entidades

POST /co/sigep/entities-search/v1 Live

Campo	Tipo	Notas
`query`	string	Palavras opcionais do nome da entidade. Vazio lista todas as entidades.
`department`	string	Departamento opcional. Acentos, maiúsculas e pontuação são ignorados.
`municipality`	string	Município opcional. Acentos, maiúsculas e pontuação são ignorados.
`order`	enum	Opcional: `nacional` ou `territorial`.
`page`	integer	Número da página, começa em 1. Por padrão `1`.
`per_page`	integer	Resultados por página (1-100). Por padrão `20`.

curl https://api.croma.run/co/sigep/entities-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "alcaldia", "department": "antioquia" }'

Retorna os filtros aplicados, total, total_pages, page, per_page, count e results[]. Cada entidade traz entity_id, sigep_code, name, nit e verification_digit, status, entity_type, order e sub_order, organic_classification, administrative_sector, legal_nature, administrative_level, legal_personality, own_assets, post_conflict, department, municipality, dane_code, cuin_code, dnp_category, zone_type, address, email, website, phone, mobile, legal_representative, parent_entity, latitude e longitude.

Uma entidade

POST /co/sigep/entity/v1 Live

Campo	Tipo	Notas
`entity_id`	integer	Obrigatório. O `entity_id` do SIGEP II Entities Search, p. ex. `3098`.

curl https://api.croma.run/co/sigep/entity/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "entity_id": 3098 }'

Retorna found, entity_id e entity. Cada entidade traz entity_id, sigep_code, name, nit e verification_digit, status, entity_type, order e sub_order, organic_classification, administrative_sector, legal_nature, administrative_level, legal_personality, own_assets, post_conflict, department, municipality, dane_code, cuin_code, dnp_category, zone_type, address, email, website, phone, mobile, legal_representative, parent_entity, latitude e longitude. Também traz career_systems[] (code, name), salary_regimes[] e employment_natures[].

Um id que o diretório não tem retorna found: false com HTTP 200.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Tipos de solicitação

Monitores

Feedback

Países

Buscar pessoas

Uma hoja de vida

Buscar entidades

Uma entidade

Referência completa

​Buscar pessoas

​Uma hoja de vida

​Buscar entidades

​Uma entidade

Referência completa

Buscar pessoas

Uma hoja de vida

Buscar entidades

Uma entidade