DT DVARLIVEPDV-22159 - Consulta de CEP com banco de dados Local

01. DADOS GERAIS

Produto:	TOTVS VAREJO PDV OMNI
Linha de Produto:
Segmento:	Varejo
Módulo:	PDV OMNISHOP - DESK
Função:	Consulta de CEP
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :	DVARLIVEPDV-22159

02. SITUAÇÃO/REQUISITO

Implementar a funcionalidade de consulta de endereços e CEPs a partir da base de dados local (SQLite) no PDV, garantindo maior performance e a possibilidade de realizar buscas offline.

O processo de busca seguirá a seguinte ordem:

Busca local: A pesquisa será feita inicialmente na base de dados local.
Busca online (fallback): Caso não seja encontrado nenhum resultado correspondente, será feita automaticamente uma consulta em uma API externa (Consulta de CEP online API ViaCEP)

03. SOLUÇÃO

Foi gerado e distribuído o arquivo de banco de dados totvscep.db3, que contém a base de endereços dos Correios. Este banco de dados será integrado ao PDV, permitindo consultas de CEP e endereço de forma local.

O arquivo totvscep.zip será distribuído no instalador do PréRequisitosOmnishop, no diretório C:\TotvsPDVResource\database

Durante a inicialização do PDV, o sistema verifica automaticamente a versão do banco de dados local e, caso seja identificado uma nova versão disponível ou não encontre o banco local, inicia o processo de importação da base de dados.

O download e a atualização do banco de dados ocorrem em background, não impactando o funcionamento do PDV.
Isso significa que o PDV pode ser utilizado normalmente durante esse processo — não é necessário aguardar a conclusão do download para que o sistema seja iniciado ou continue operando.

A consulta de CEP pode ser realizada de duas formas:

Pesquisa por CEP numérico:
- O usuário deve digitar um CEP com 8 dígitos numéricos.
- A consulta será realizada diretamente com base no número informado.
Pesquisa por endereço (logradouro):
- Esse modo de consulta é apresentando quando o campo de CEP está vazio e o usuário pressiona Enter, Tab ou clica no ícone de busca.
- Para realizar a pesquisa, é necessário informar os seguintes campos:
  - Estado
  - Município
  - Logradouro
- O sistema exibirá até 50 (cinquenta) resultados ordenados pela proximidade do nome do logradouro. Quanto mais específico for o logradouro, mais precisa será a busca.

No modo de operação Self Checkout apenas o modo de consulta de CEP númerico esta disponivel.

Exemplos de consultas realizadas estão apresentados abaixo:

Pesquisa por CEP numérico Windows

Pesquisa por endereço (logradouro) Windows:

Pesquisa por CEP numérico Android

Pesquisa por endereço (logradouro) Android:

Pesquisa por CEP numérico Self Checkout

04. DEMAIS INFORMAÇÕES

Não se aplica

05. ASSUNTOS RELACIONADOS