Criar Filial

Cria uma nova filial vinculada a uma matriz do cliente. Requer scope empresas:write.

Autenticação:

🔑 API Key

Corpo

empresa_matriz_idnumber

Obrigatório

ID da empresa matriz à qual a filial será vinculada

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": 11,
    "nome_fantasia": "Filial SP",
    "cnpj": "12345678000190",
    "razao_social": "Filial SP Ltda",
    "status": "Ativa",
    "empresa_matriz_id": 1,
    "is_sandbox": false,
    "email_corporativo": "filialsp@empresa.com.br",
    "telefone": "11999999999",
    "cep": "01310100",
    "logradouro": "Rua das Flores",
    "numero": "200",
    "complemento": "Loja 3",
    "bairro": "Centro",
    "cidade": "São Paulo",
    "estado": "SP"
  }
}

Sandbox Mode

curl --request POST \
  'https://rep-gestor.youuponto.com/api/v1/empresas/filial' \
  --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": "filialsp@empresa.com.br",
  "telefone": "11999999999",
  "cep": "01310100",
  "logradouro": "Rua das Flores",
  "numero": "200",
  "complemento": "Loja 3",
  "bairro": "Centro",
  "cidade": "São Paulo",
  "estado": "SP"
}'

Exemplos de Resposta

{
  "ok": true,
  "data": {
    "empresa_id": 11,
    "nome_fantasia": "Filial SP",
    "cnpj": "12345678000190",
    "razao_social": "Filial SP Ltda",
    "status": "Ativa",
    "empresa_matriz_id": 1,
    "is_sandbox": false,
    "email_corporativo": "filialsp@empresa.com.br",
    "telefone": "11999999999",
    "cep": "01310100",
    "logradouro": "Rua das Flores",
    "numero": "200",
    "complemento": "Loja 3",
    "bairro": "Centro",
    "cidade": "São Paulo",
    "estado": "SP"
  }
}