Este guia orienta a preparação do banco de dados e a instalação dos arquivos na máquina do cliente. Destina-se ao responsável pela implantação. Não exige alterar ou compilar o código do sistema.

Referência: ambiente validado em 17/10/2026, com pedido simples e pagamento online por cartão. Opcionais, dinheiro, pagamentos mistos e descontos precisam de validação própria antes de liberar essas modalidades.

1. Separar o material e fazer o backup

• Fazer backup do banco do JuxtaPOS V3 e guardar uma cópia dos arquivos e configurações atuais.
• Separar o pacote completo e compatível do JuxtaPOS V3, da WebApi e do módulo iFood. Usar as versões preparadas para esta integração.
• Separar o modelo do arquivo IFoodV3.json e os arquivos de configuração e de banco que acompanham o módulo iFood.
• Confirmar a loja iFood correta e obter seu identificador e as credenciais de integração.
• Definir qual máquina receberá cada componente. Para a primeira implantação, preferir concentrar os componentes na mesma máquina, como no teste de validação.

2. Preparar o banco do JuxtaPOS V3

O JuxtaPOS V3 e a WebApi devem apontar para o mesmo banco da empresa. O ambiente testado utilizou SQL Server 2019 Express. O Firebird do módulo iFood é uma instalação separada e não substitui esse banco.

1. Confirmar que o V3 abre normalmente, acessa os produtos e permite iniciar o período de trabalho.
2. Aplicar a atualização de banco fornecida com o pacote da integração. Confirmar a existência da fila de pedidos dbo.JuxtaIFoodInbox no banco utilizado pelo V3 e pela WebApi.
3. Conferir terminal, departamento, tipo de comanda de entrega e cadastro de clientes. Anotar os respectivos códigos para preencher a configuração.
4. Conferir os cadastros da tabela abaixo antes de habilitar a integração.

Regra 7 — Atualizar estado quando pago: no banco do cliente, manter as condições de saldo zero e as ações existentes. Na restrição personalizada da regra, utilizar:

Ticket.GetState("iFood") == ""

Essa configuração preserva o comportamento das comandas comuns e evita que um pedido iFood pago online seja encerrado apenas ao salvar ou sair da tela. Se a regra “Finalizar comanda iFood” tiver sido criada durante testes, retirar seus mapeamentos para desativá-la. O encerramento local do iFood utiliza a confirmação na tela de recebimento da versão validada.

3. Preparar o Firebird do módulo iFood

Instalar o Firebird 3, versão utilizada no teste do módulo Delphi. Conferir se o serviço está iniciado e se o módulo consegue acessar seu banco.

Na máquina de testes, a instalação padrão precisou de ajuste de compatibilidade. Antes de editar, guardar uma cópia do firebird.conf. No arquivo da instalação ativa, conferir as seguintes opções, evitando entradas ativas duplicadas:

AuthServer = Legacy_Auth, Srp, Win_Sspi
AuthClient = Legacy_Auth, Srp, Srp256, Win_Sspi
UserManager = Legacy_UserManager, Srp
WireCrypt = Enabled

Após aplicar a configuração, reiniciar o serviço do Firebird e abrir o módulo. Esses valores reproduzem a configuração que funcionou no teste; o caminho do banco e as credenciais continuam sendo os da instalação do módulo.

4. Colocar os arquivos nas pastas corretas

Fechar os programas antes de atualizar. Copiar cada pacote completo para sua pasta, preservando as configurações específicas do cliente.

Para localizar a pasta do V3, clicar com o botão direito no atalho e escolher Abrir local do arquivo. Para acessar a pasta de configuração, pressionar Windows + R e informar:

%ProgramData%\Juxta Desenvolvimento\JuxtaPOS3

Se a pasta ProgramData não aparecer no Explorador, utilizar o caminho acima. Conferir também se o arquivo está com a extensão correta: IFoodV3.json, sem um .txt adicional.

5. Preencher a configuração da loja

Editar o modelo IFoodV3.json com os dados da instalação. Os códigos do ambiente de testes não devem ser copiados para o cliente.

Salvar o arquivo e reiniciar o V3 após a mudança. A configuração é carregada na inicialização do importador.

6. Conferir a comunicação e iniciar

1. Iniciar o serviço do Firebird e conferir o acesso do módulo ao seu banco.
2. Iniciar a WebApi e conferir a conexão com o banco do V3. No ambiente testado foi utilizado o endereço http://localhost:7163.
3. No módulo iFood, conferir a loja e selecionar o destino V3. Informar o endereço da WebApi acessível a partir da máquina do módulo.
4. Abrir o V3, entrar com o usuário e iniciar o período de trabalho. Utilizar o terminal, departamento e tipo de comanda configurados para a integração; manter o sistema desbloqueado durante a importação.
5. Manter os componentes necessários em execução durante a operação.

Se a WebApi estiver em outra máquina, utilizar seu endereço de rede. localhost sempre aponta para a própria máquina onde o programa está rodando. Conferir o acesso de rede e a liberação da porta configurada.

7. Validar antes de liberar

1. Enviar um pedido de teste simples, com produto mapeado e cartão de crédito online.
2. Conferir cliente, endereço, produto, quantidade, entrega, total e pagamento recebido no V3.
3. Abrir a comanda e sair pelo botão Fechar / Enviar cozinha. O pedido iFood deve permanecer aberto.
4. Abrir Receber, clicar em Finalizar pedido iFood e confirmar. A comanda deve ser encerrada localmente.
5. Conferir o pagamento e o encerramento nos relatórios, sem lançamento duplicado.
6. Validar separadamente complementos, descontos e outras formas de pagamento que a loja utilizar.

O encerramento local da comanda não confirma automaticamente a entrega no iFood. A comunicação de confirmação, despacho e conclusão do pedido na plataforma deve ser validada separadamente.

Conferência rápida se o pedido não aparecer

• Loja e conta iFood corretas.
• WebApi e módulo em execução; Firebird iniciado.
• V3 e WebApi apontando para o mesmo banco.
• IFoodV3.json na pasta correta, habilitado e com os códigos reais do cliente.
• Usuário conectado, período de trabalho aberto e contexto configurado ativo.
• Produtos e pagamentos relacionados nos cadastros.

Dados a completar antes de publicar este procedimento como definitivo

Este texto registra os caminhos e ajustes conferidos. Para que a instalação possa ser repetida sem depender de informações externas, anexar ou identificar no artigo:

• Pacote e versão exatos do V3, WebApi e módulo iFood aprovados para distribuição.
• Arquivo de atualização de banco e forma de aplicá-lo na instalação do cliente.
• Nome do executável do módulo, nome e caminho do seu banco e arquivo onde é configurada essa conexão.
• Arquivo de configuração da WebApi e forma de inicialização adotada no cliente.