15.5. Atualizar Unidade

Serviço que permite atualizar os dados (nome da unidade e código IBGE do município) de uma unidade em um órgão/entidade. Incluído no PNCP o código genérico 9097071 a ser usado como codigoIBGE possibilitando inclusão de Unidade localizada no exterior. Será retornado nome do município “Exterior” e UF “EX”.

Atenção

Disponível apenas no ambiente de treinamento/homologação. No ambiente de produção, utilize o procedimento do item Gestão de Órgão e Entidade.

Editar Unidade Administrativa

Atenção

  • Status: Ativar/Inativar

  • Nome da Unidade: campo alfanumérico de livre escolha;

  • Código Unidade: campo único para o órgão alfanumérico de livre escolha (não pode ser editado);

  • Código IBGE: Códigos de Municípios do IBGE composto de 7 dígitos, sendo os dois primeiros referentes ao código da Unidade da Federação. https://www.ibge.gov.br/explica/codigos-dos-municipios.php

15.5.1. Detalhes da Requisição

Endpoint

Método HTTP

/v1/orgaos/{cnpj}/unidades

PUT

15.5.2. Exemplo de Payload

1      {
2              "codigoUnidade": "1",
3              "nomeUnidade": "Unidade administrativa",
4              "codigoIBGE": "1000001"
5      }

15.5.3. Exemplo Requisição (cURL)

1      curl -k -X PUT \
2        --header "Authorization: Bearer access_token" \
3        "${BASE_URL}/v1/orgaos/10000000000003/unidades" \
4        -H "accept: */*" \
5        -H "Content-Type: application/json" \
6        --data "@/home/objeto.json"

15.5.4. Dados de entrada

Nota

Alimentar o parâmetro cnpj.

Id

Campo

Tipo

Obrigatório

Descrição

1

cnpj

Texto (14)

Sim

CNPJ do órgão ao qual a unidade será vinculada

2

codigoUnidade

Texto (30)

Sim

Código da unidade administrativa a ser vinculada (definido pelo próprio órgão). Obs: dado não atualizável

3

nomeUnidade

Texto (100)

Sim

Nome da unidade administrativa

4

codigoIBGE

Texto (7)

Sim

Código do município definido pelo IBGE ou utilizar o código 9097071 para localidade no exterior

15.5.5. Dados de retorno

Id

Campo

Tipo

Descrição

1

location

Texto (255)

Endereço HTTP do recurso atualizado

15.5.6. Códigos de Retorno

Código HTTP

Mensagem

Tipo

200

OK

Sucesso

400

BadRequest

Erro

422

Unprocessable Entity

Erro

500

Internal Server Error

Erro