> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salu.com.vc/llms.txt
> Use this file to discover all available pages before exploring further.

# Unidade (Branch)

> O local físico ou legal onde os colaboradores trabalham.

A **Unidade** (Branch) é um **local físico ou legal** onde as pessoas trabalham — uma filial,
fábrica, escritório ou armazém. Responde à pergunta: **“Onde o colaborador trabalha?”**

<Info>
  Na saúde ocupacional, unidades diferentes podem ter perfis de exposição completamente
  distintos, mesmo dentro da mesma empresa. Por isso a Unidade é o primeiro nível da
  [hierarquia](/public-api/br/conceitos/hierarquia).
</Info>

## Campos principais

| Campo                     | Obrigatório | Descrição                                                                 |
| ------------------------- | ----------- | ------------------------------------------------------------------------- |
| `organization_id`         | sim         | Organização à qual a unidade pertence.                                    |
| `display_name`            | sim         | Nome de exibição da unidade.                                              |
| `cnpj`                    | sim         | CNPJ da unidade (pode diferir do CNPJ da organização).                    |
| `company_name`            | na criação  | Razão social.                                                             |
| `cnae`                    | não         | Código CNAE da atividade econômica.                                       |
| `hr_code`                 | não         | Código interno do RH do cliente.                                          |
| `client_integration_code` | não         | Identificador externo do cliente (idempotência/mapeamento).               |
| Endereço                  | não         | `street`, `number`, `complement`, `neighborhood`, `city`, `state`, `cep`. |
| `is_active`               | não         | Ativa/inativa (padrão `true`).                                            |

<Note>
  `client_integration_code` permite mapear o registro da Salú ao ID do **seu** sistema e está
  disponível também como filtro de listagem — facilitando sincronizações idempotentes. Veja
  [Como usar §3](/public-api/br/como-usar#pt-3).
</Note>

## Exemplos

| Unidade                   | Pergunta que responde |
| ------------------------- | --------------------- |
| Escritório de São Paulo   | Onde?                 |
| Fábrica do Rio de Janeiro | Onde?                 |
| Armazém de Belo Horizonte | Onde?                 |

## Endpoints

<CardGroup cols={2}>
  <Card title="Listar unidades" icon="list" href="/public-api/br/endpoints/branches/public_list_branches_v0_branch__get" />

  <Card title="Criar unidade" icon="plus" href="/public-api/br/endpoints/branches/public_create_branch_v0_branch__post" />
</CardGroup>