{"section":"known-issues","requestedLocale":"pt","requestedSlug":"a-pesquisa-nao-retorna-o-documento-quando-o-valor-contem-um-simbolo-mais","locale":"pt","slug":"a-pesquisa-nao-retorna-o-documento-quando-o-valor-contem-um-simbolo-mais","path":"docs/pt/known-issues/Storage/a-pesquisa-nao-retorna-o-documento-quando-o-valor-contem-um-simbolo-mais.md","branch":"main","content":"## Sumário\n\n>ℹ️ Este problema conhecido foi traduzido automaticamente do inglês.\n\n\nAo pesquisar um documento usando um valor de campo que inclui o símbolo \"+\", a pesquisa não retorna o documento. Isso acontece porque o símbolo \"+\" é interpretado incorretamente, o que faz com que o valor da pesquisa não corresponda ao valor existente.\nEsse problema ocorre tanto na API quanto no CRM_\n\n## Simulação\n\n\n\n1. Use a API de pesquisa para consultar um campo que inclua um símbolo \"+\".\n2. A pesquisa retornará uma matriz vazia. Exemplo:\n\n    https://\\{accountName\\}.environment.com.br/api/dataentities/\\{entity\\}/search?_where=homePhone=+5512345678901&_fields=id,userId,email,homePhone,firstName\n\n\nNa interface do usuário do CRM:\nSe você pesquisar um e-mail que contenha o símbolo \"+\", será retornado um erro.\n\n    Ocorreu um erro inesperado. Tente novamente. Se o problema persistir, entre em contato com o suporte.\n\n\n\n\n## Workaround\n\n\nHá duas maneiras de lidar com esse problema:\nCodificar o símbolo \"+\" para \"%2B\", de modo que a consulta de pesquisa se torne:\n\n    https://\\{accountName\\}.environment.com.br/api/dataentities/\\{entity\\}/search?_where=homePhone=%2B5512345678901&_fields=id,userId,email,homePhone,firstName\n\n\nUse o símbolo \"*\" como um curinga, o que permitirá que a pesquisa corresponda a qualquer caractere antes do valor especificado:\n\n    https://\\{accountName\\}.environment.com.br/api/dataentities/\\{entity\\}/search?_where=homePhone=*12345678901&_fields=id,userId,email,homePhone,firstName\n\nEsse problema surge ao pesquisar documentos usando valores de campo que incluem o símbolo \"+\". A API de pesquisa não interpreta corretamente o símbolo \"+\", fazendo com que a pesquisa falhe por não corresponder aos valores existentes. Esse problema não se limita ao campo \"homePhone\", mas pode ocorrer com outros campos, como e-mail, que podem incluir caracteres especiais.\nPara contornar esse problema, você pode codificar o símbolo \"+\" como \"%2B\" na consulta de pesquisa ou usar o símbolo \"*\" como curinga para garantir que a pesquisa recupere os documentos corretos."}