Criar Matriz

Cria uma nova empresa matriz vinculada ao cliente dono da API Key. Requer uma **API Key de cliente** (não de empresa) com scope empresas:write. A nova matriz fica com `empresa_matriz_id: null` e é automaticamente vinculada ao `cliente_id` da chave.

Autenticação:

🔑 API Key

Corpo

nome_fantasiastring

Obrigatório

Nome fantasia da empresa

cnpjstring

Obrigatório

CNPJ da empresa (mínimo 11 caracteres)

razao_socialstring

Obrigatório

Razão social

email_corporativostring

Email corporativo

telefonestring

Telefone de contato

cepstring

CEP

logradourostring

Logradouro

numerostring

Número

complementostring

Complemento

bairrostring

Bairro

cidadestring

Cidade

estadostring

UF do estado (2 caracteres)

Respostas

{
  "ok": true,
  "data": {
    "empresa_id": 10,
    "nome_fantasia": "Empresa Matriz SP",
    "cnpj": "12345678000190",
    "razao_social": "Empresa Matriz Ltda",
    "status": "Ativa",
    "empresa_matriz_id": null,
    "cliente_id": 5,
    "email_corporativo": "contato@empresa.com.br",
    "telefone": "11999999999",
    "cep": "01310100",
    "logradouro": "Av. Paulista",
    "numero": "1000",
    "complemento": "Sala 501",
    "bairro": "Bela Vista",
    "cidade": "São Paulo",
    "estado": "SP"
  }
}

Sandbox Mode

curl --request POST \
  'https://rep-gestor.youuponto.com/api/v1/empresas/matriz' \
  --header 'x-api-key: yk_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "nome_fantasia": "Empresa Matriz SP",
  "cnpj": "12345678000190",
  "razao_social": "Empresa Matriz Ltda",
  "email_corporativo": "contato@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": 10,
    "nome_fantasia": "Empresa Matriz SP",
    "cnpj": "12345678000190",
    "razao_social": "Empresa Matriz Ltda",
    "status": "Ativa",
    "empresa_matriz_id": null,
    "cliente_id": 5,
    "email_corporativo": "contato@empresa.com.br",
    "telefone": "11999999999",
    "cep": "01310100",
    "logradouro": "Av. Paulista",
    "numero": "1000",
    "complemento": "Sala 501",
    "bairro": "Bela Vista",
    "cidade": "São Paulo",
    "estado": "SP"
  }
}