Criar Filial

Cria uma filial ativa. Requer empresas:write. Para chaves de empresa, a filial é vinculada automaticamente à matriz da chave. Para chaves de cliente, empresa_matriz_id é obrigatório e deve estar no escopo da integração. O header X-Sandbox-Mode define se a filial pertence ao ambiente sandbox.

Autenticação:

🔑 API Key

Corpo

empresa_matriz_idnumber

Obrigatório somente para API Keys de cliente.

nome_fantasiastring

Obrigatório

Nome fantasia.

cnpjstring

Obrigatório

CNPJ com no mínimo 11 caracteres.

razao_socialstring

Obrigatório

Razão social.

email_corporativostring

E-mail corporativo.

telefonestring

Telefone.

cepstring

CEP.

logradourostring

Logradouro.

numerostring

Número.

complementostring

Complemento.

bairrostring

Bairro.

cidadestring

Cidade.

estadostring

UF com duas letras.

Respostas

{
  "ok": true,
  "data": {
    "empresa_id": 2,
    "nome_fantasia": "Filial SP",
    "empresa_matriz_id": 1,
    "status": "Ativa",
    "is_sandbox": false
  }
}

Sandbox Mode

curl --request POST \
  'https://rep-gestor.youuponto.com/api/v1/empresas' \
  --header 'x-api-key: yk_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "empresa_matriz_id": 1,
  "nome_fantasia": "Filial SP",
  "cnpj": "12345678000190",
  "razao_social": "Filial SP Ltda",
  "email_corporativo": "filial@empresa.com.br",
  "telefone": "11999999999",
  "cep": "01310100",
  "logradouro": "Av. Paulista",
  "numero": "1000",
  "complemento": "Sala 501",
  "bairro": "Bela Vista",
  "cidade": "São Paulo",
  "estado": "SP"
}'

Exemplos de Resposta

{
  "ok": true,
  "data": {
    "empresa_id": 2,
    "nome_fantasia": "Filial SP",
    "empresa_matriz_id": 1,
    "status": "Ativa",
    "is_sandbox": false
  }
}