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
Rotahttps://api.ahgora.com.br/subsidiaries
Método:POST

Subsidiaries (Filiais)

CampoTipoObrig.DescriçãoRegra
numeroCadastroStringSimNúmero do CNPJSem separadores
razaoSocialStringSimRazão SocialSem separadores
telefoneDDDStringNãoCódigo de Área (DDD)formato: XX
telefoneStringNãoNúmero do TelefoneSem separadores
cepStringNãoCEPformato: XXXXXXXX
Sem separadores
enderecoStringNãoEndereço
complementoStringNãoComplemento
bairroStringNãoBairro
cidadeStringNãoCidade
estadoStringNãoEstadoSigla de dois dígitos válida em minúsculo
paisStringNãoSigla do PaísFixo: 1058
Para Brasil deve-se utilizar 1058
ativacaoStringNãoAtivação de relógio de ponto na filalUtilize 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
}