FAQ (Perguntas Frequentes)

Pergunta	Resposta
Como saber se o token expirou?	A API devolve 401 com código 40101. Implemente renovação automática antes de cada chamada ou ao receber esse erro. Ver detalhes no Apêndice 1.
Posso enviar campos que não estão na especificação?	Não. O validador da API ignora propriedades desconhecidas. A UI é armazenada, porém o campo desconhecido é ignorado e não é persistido no sistema.
Qual a precisão mínima para áreas?	4 casas decimais (ex.: 123.4567). Valores com menos casas serão aceitos, mas serão armazenados com 4 casas.
O que fazer se receber 409 – Unidade já cadastrada?	Verifique se o inscricaoImobiliaria já está no CADURB. Caso a atualização seja necessária, use o endpoint de Alteração disponível nesse manual.
Existe limite de tamanho para a lista de titulares?	Até o momento não há definição.
Como tratar valores monetários com ponto decimal?	Use ponto (.) como separador decimal e nunca inclua separador de milhar. Ex.: 350000.00.
Preciso enviar o campo bice quando tipoImovel = 3?	Sim – é obrigatório. Caso contrário, a API retornará 400.
O que acontecerá caso seja informado valor não compatível com o valor especificado?	Para os campos que são considerados para atribuição de CIB o sistema impedirá a atribuição de CIB e prejudica a avaliação de campos cuja obrigatoriedade sejam dependentes do campo com valor incompatível. Para os campos adicionais, os valores não conformes serão ignorados e no banco de dados ficarão com valor “null”.