Uma vez que as boas práticas pertinentes ao modelo Rest pregam que as requisições devem retornar um código especificando o resultado da requisição foram estabelecidos códigos de retornos para simplificar e facilitar no entendimento dos retornos do web-service.
Códigos de Retorno do Falcon SLL
0### Códigos de retorno do web service
- 0200 - Sucesso
- 0201 - Terminal registrado com sucesso
- 0401 - Token de acesso não encontrado
Falha de integridade, não foi possível verificar o Token
- 0500 - Erro
1### Erros de processamento
- 1408 - Tempo excedido durante download dos dados de licenciamento
- 1999 - Erro desconhecido (não mapeado)
2### Erros de validação de dados
- 2010 - Serial requerido
- 2011 - Formato de serial inválido
- 2030 - Versão do App requerida
- 2031 - Formato da versão inválido
4### Erros de registro e autorização
- 4000 - Identificador da App inválido
- 4001 - Aplicação não encontrada
O Tipo de Licença do FalconSL deve estar compatível com o tipo de licença do LocalConf
- 4010 - Registro da empresa desativado
- 4011 - Empresa sem contrato de uso
- 4012 - Empresa não encontrada
- 4020 - Contrato de uso inativo
- 4021 - Contrato de uso bloqueado
- 4022 - Contrato de uso expirado
Data de vencimento anterior à data atual
- 4023 - Contrato de uso expirado
Tempo de uso maior que o permitido
- 4024 - Contrato de uso sem módulos vinculados
- 4030 - Licença não encontrada
- 4031 - Licença em uso
- 4032 - Licença não registrada
- 4033 - Licença expirada
- 4034 - Licença excluída
- 4035 - Licença já resgistrada nesse terminal
- 4040 - Terminal servidor não registrado
- 4041 - Terminal servidor já registrado
- 4042 - Terminal já registrado
- 4050 - Limite de tempo sem comunicação com o web service excedido
- 4060 - Token de desbloqueio inválido
- 4061 - Desbloqueio de uso não permitido
5### - Erros de execução
- 5000 - Erro desconhecido
- 5010 - Arquivo de licenças não encontrado
- 5011 - Arquivo de licenças em branco
- 5012 - Erro ao desencriptar os dados do arquivo
- 5013 - Erro ao encriptar os dados do arquivo
- 5014 - Formato dos dados de licenças inválido
- 5015 - Erro ao serializar os dados da base de dados
- 5016 - Ocorreu um erro tentar salvar o arquivo de licenças
- 5017 - Não foi possível gravar a cópia de seguraça da base de dados
6### - Erros reportados pelo Web Service
- 6400 - Licença inválida
- 6401 - Acesso negado
- 6402 - Token de autenticação não informado
- 6403 - Token de autenticação adicionado à lista negra
- 6404 - Dados de licenciamento não encontrados
- 6422 - Formato da requisição inválido. Fingerprint requerido
- 6440 - Formato de serial inválido
- 6441 - Licença não encontrada
- 6442 - Registro da empresa ou parceiro desativado
- 6443 - Licença inválida.
- 6444 - A Licença a ser registrada não é a Principal
- 6445 - Licença já registrada
- 6446 - Licença sem contrato
- 6447 - Licença não registrada
Caso a chamada efetuada se depare com uma licença não registrada
- 6901 - Formato da resposta diferente do suportado
- 6999 - Código de resposta (###) inválido
Por convenção os códigos de retorno do Falcon SLL são retornados para as aplicações clientes com o prefixo S no código de status
Erros de Retorno do Falcon Client
C0### - Retornos de processamento bem sucedido
- C0200 - Sucesso
- C0201 - Registro realizado com sucesso
C1### - Erros de processamento
- C1010 - Parâmetro obrigatório
- C1011 - Codificação do parâmetro inválido
Erro disparado quando a codificação JSON dos dados é inválida
- C1099 - Error retrieving application version
- C1999 - Unknown Error
C2### - Erros de validação de dados
- C2000 - Identificador da empresa é de preenchimento obrigatório
- C2001 - Identificador da empresa inválido
- C2010 - URL do servidor é de preenchimento obrigatório
- C2011 - IP do servidor inválido
- C2012 - Porta do servidor inválida
- C2013 - Porta do servidor é de preenchimento obrigatório
- C2020 - Identificador da aplicação é de preenchimento obrigatório
- C2021 - Identificador da aplicação inválido
- C2030 - Identificador do terminal é de preenchimento obrigatório
- C2031 - Indentificador do terminal inválido
- C2050 - Versão da aplicação é de preenchimento obrigatório
- C2051 - Versão da aplicação inválida
- C2070 - Usuário é de preenchimento obrigatório
- C2071 - Usuário inválido
- C2080 - Senha é de preenchimento obrigatório
- C2081 - Senha inválida
- C2091 - Token de desbloqueio inválido
C3### - Erros de comunicação com o servidor local de licenças
- C3061 - Não foi possível estabelecer uma conexão com o servidor de licenças
- C3999 - Unknown network error
C4### - Erros de autenticação da mensagem do servidor local de licenças
- C4000 - Token de autenticação inválido
- C4001 - Assinatura do token inválida
- C4002 - O token não possui assinatura
- C4003 - Invalid JWT (Invalid Claims)
Erro disparado durante a validação do token JWT caso o token seja invalido.
- C4004 - Claim Not Found
Erro disparado quando o servidor não envia o "claim" com os dados esperados pelo cliente.
L5### - Erros ocorridos no carregamento e acesso ao métodos da DLL
- L5001 - Módulo de integração com o servidor de licenças não encontrado
Este erro será retornado sempre que o arquivo da DLL não for encontrada na pasta em que o executável estiver
- L5002 - Não foi possível carregar o módulo de comunicação com servidor de licenças
Este erro será retornado sempre que ocorrer um erro no carregamento dinâmico da DLL.
- L5003 - Erro de autenticação da módulo de integração com o servidor de licenças
Erro retornado sempre que a autenticidade da DLL não for confirmado
- L5011 - Não foi possível acessar o recurso de registro de terminais servidores
- L5012 - Não foi possível acessar o recurso de registro de terminais
- L5013 - Não foi possível acessar o recurso de listagem de licenças disponíveis
- L5014 - Não foi possível acessar o recurso de autenticação e autorização de terminais
- L5021 - Não foi possível executar o recurso de registro de terminais servidores
- L5022 - Não foi possível executar o recurso de registro de terminais
- L5023 - Não foi possível executar o recurso de listagem de licenças disponíveis
- L5024 - Não foi possível executar o recurso de autenticação e autorização de terminais
- L5100 - Formado de retorno do servidor inválido
- L5201 - Documento da empresa precisa ser informado
- L5202 - Serial de registro do terminal precisa ser informado
- L5301 - Falha ao tentar converter o nome do host para IP
- L5404 - Acesso não permitido a esta módulo