Subsidiaries (Filiais)

Serviço utilizado para cadastrar, alterar e inativar filiais no Ahgora PontoWeb.

Permitido envio em lote, máximo 1000 registros por requisição, ou 1mb (mega)

Subsidiaries (Filiais)

Item	Descrição
Fluxo:	Cliente → PontoWeb
Rota	https://api.ahgora.com.br/subsidiaries
Método:	POST

Subsidiaries (Filiais)
Campo	Tipo	Obrig.	Descrição	Regra
numeroCadastro	String	Sim	Número do CNPJ	Sem separadores
razaoSocial	String	Sim	Razão Social	Sem separadores
telefoneDDD	String	Não	Código de Área (DDD)	formato: XX
telefone	String	Não	Número do Telefone	Sem separadores
cep	String	Não	CEP	formato: XXXXXXXX Sem separadores
endereco	String	Não	Endereço
complemento	String	Não	Complemento
bairro	String	Não	Bairro
cidade	String	Não	Cidade
estado	String	Não	Estado	Sigla de dois dígitos válida em minúsculo
pais	String	Não	Sigla do País	Fixo: 1058 Para Brasil deve-se utilizar 1058
ativacao	String	Não	Ativação de relógio de ponto na filal	Utilize true para sim e false para não Utiliza CNPJ ou CPF para ativação de Relógios de Ponto.

Exemplos de Requisições (Requests)

Corpo da Requisição - Inclusão, Alteração e Ativação:

[
  {
    "numeroCadastro": "XXXXXXXX0001XX",
    "razaoSocial": "Example Text",
    "telefoneDDD": "XX",
    "telefone": "XXXXXXXX",
    "cep": "XXXXXXX",
    "endereco": "Avenida XYZ",
    "complemento": "número 0123, Setor A",
    "bairro": "Example",
    "cidade": "São Paulo",
    "estado": "sp",
    "pais": "1058",
    "ativacao": true
  }
]

Corpo da Requisição - Desativação:

[
  {
    "numeroCadastro": "XXXXXXXX0001XX",
    "razaoSocial": "Example Text",
    "telefoneDDD": "XX",
    "telefone": "XXXXXXXX",
    "cep": "XXXXXXX",
    "endereco": "Avenida XYZ",
    "complemento": "número 0123, Setor A",
    "bairro": "Example",
    "cidade": "São Paulo",
    "estado": "sp",
    "pais": "1058",
    "ativacao": false
  }
]

Exemplos de Respostas (Responses)

Resposta quando SUCESSO - Code 200:

{
  "company": "a000101",
  "unique": "bd751350",
  "message": "Subsidiaries Integration on progress"
}

Para obter mais detalhe, utilize o serviço Process. Para saber mais entre no link.

ERRO de Validação - Code 400:

{
  "message": "Request format must be an Array",
  "code": 400
}

ERRO de Autenticação - Code 401:

{
  "message": "Unauthorized",
  "code": 401
}

ERRO de Permissão - Code 403:

{
    "error": {
        "message": "Forbidden",
        "code": 403
    }
}

Observação: Verificar as permissões do usuário para acessar a rota/serviço.