Orgãos e Entidades - GrupoBRA/GovAPI-Doc GitHub Wiki

Orgão

POST /v1/orgao/

Adiciona um orgão

Headers:

Authorization token

Payload:

{
  "o_leg_id": 2456,
  "orgao": "Olinda, PE",
}

Response:

{
  "success": true,
  "data": {
    "GovernancaAPI": {
      "oid": "{oid}"
    }
  }
}

Retorno:

201 | 400 | 406

GET /v1/orgao/search/{needle}/{offset}/{limit}/

Lista e pequisa os Órgãos existentes na base de dados, de forma paginada

Headers:

Authorization token

Response:

{
  "success": true,
  "data": {
    "GovernancaAPI": {
      "orgaos": [
        {
          "oid": "{16-byte-hex}",
          "orgao": "Olinda, PE",
          "o_leg_id": 99
        }
      ],
      "total": 10,
      "next": false
    }
  }
}

Retorno:

200 | 400 | 404 | 406

GET /v1/orgao/{oid}/

Lista os dados de um Órgão específico

Headers:

Authorization token

Response:

{
  "success": true,
  "data": {
    "GovernancaAPI": {
      "oid": "{16-byte-hex}",
      "orgao": "Olinda, PE",
      "o_leg_id": 99
    }
  }
}

Retorno:

200 | 400 | 404 | 406

PUT /v1/orgao/{oid}/

Altera um orgão

Headers:

Authorization token

Payload:

{
    "o_leg_id": 2456,
    "orgao": "Olinda, PE",
}

Response: (Empty)

Retorno:

200 | 400 | 405 | 406 | 409

Entidade

POST /v1/entidade/

Adiciona um orgão

Headers:

Authorization token

Payload:

{
    "oid": "{oid}",
    "o_e_leg_id": 2456,
    "orgao_entidade_tipo": 1,
    "cnpj": "12345678910123",
    "fantasia": "Nome fantasia",
    "razao_social": "Razao Social",
    "data_fundacao": "YYYY-mm-dd"
}

Response:

{
    "success": true,
    "data": {
	"GovernancaAPI": {
	    "oeid": "{oeid}"
	}
    }
}

Retorno:

201 | 400 | 406

GET /v1/entidade/search/{needle}/{offset}/{limit}/

Lista e pequisa as entidades existentes na base de dados, de forma paginada

Headers:

Authorization token

Response:

{
  "success": true,
  "data": {
    "GovernancaAPI": {
      "entidades": [
        {
          "oid": "{16-byte-hex}",
          "oeid": "{16-byte-hex}",
          "o_e_leg_id": 199,
          "orgao_entidade_tipo": 1,
          "cnpj": "12345678910123",
          "fantasia": "Nome fantasia",
          "razao_social": "Razao Social",
          "data_fundacao": "YYYY-mm-dd"
        }
      ],
      "total": 10,
      "next": false
    }
  }
}

Retorno:

200 | 400 | 404 | 406

GET /v1/entidade/{oeid}/

Lista os dados de uma Entidade específico

Headers:

Authorization token

Response:

{
  "success": true,
  "data": {
    "GovernancaAPI": {
      "oid": "{16-byte-hex}",
      "o_e_leg_id": 199,
      "orgao_entidade_tipo": 1,
      "cnpj": "12345678910123",
      "fantasia": "Nome fantasia",
      "razao_social": "Razao Social",
      "data_fundacao": "YYYY-mm-dd"
    }
  }
}

Retorno:

200 | 400 | 404 | 406

PUT /v1/entidade/{oeid}/

Altera uma entidade

Headers:

Authorization token

Payload:

{
    "cnpj": "12345678910123",
    "fantasia": "Nome fantasia",
    "razao_social": "Razao Social",
    "data_fundacao": "YYYY-mm-dd"
}

Retorno:

200 | 400 | 406

POST /v1/orgao-entidade-id/

Exchange para listar os orgaos e entidades

  • Retornar 400 se os campos orgaos e entidades estiverem vazios
  • Retornar 404 se nenhum orgao e entidade for encontrado

Headers:

Authorization token

Payload:

{
    "orgaos": ["{oid}"],
    "entidades": ["{oeid}"],
}

Response:

{
  "success": true,
  "data": {
    "GovernancaAPI": {
      "orgaos": [
        {
          "oid": "3a95c3e244e390e7ca8ced6d3abc0b",
          "orgao": "Lagoa do Carro, PE"
        }
      ],
      "entidades": [
        {
          "oeid": "5e95767f1ac55f81c5c4dd9ae210e3",
          "nome": "Prefeitura Municipal de Lagoa do Carro",  // mesmo que razão social
          "tipo": "Prefeitura",
          "pessoa_juridica": {
            "razao_social": "Prefeitura Municipal de Lagoa do Carro",
            "fantasia": "Prefeitura Municipal de Lagoa do Carro",
            "cnpj": "40893778000191",
            "fundacao": "1900-01-01"
          }
        }
      ]
    }
  }
}

Retorno:

200 | 400 | 404