Configurar Ágora POS no ImaCash
Este guia corresponde ao seletor AgoraPOS do ImaCash e à sua leitura SQL Server. Ágora API e Ágora Retail são modos distintos: confirme com o fornecedor qual está preparado para a instalação antes de escolher ou mudar a ligação.
Antes de começar
O fornecedor deve confirmar a versão e estrutura compatíveis, o servidor e a base ativos e uma conta autorizada com as permissões de leitura necessárias. Verifique o acesso com a identidade que executa o ImaCash e preserve uma configuração operacional. Não copie exemplos dos manuais nem presuma compatibilidade de todas as instalações Ágora.
Passos de configuração
- Abra Configuração > Integração e selecione POS > AgoraPOS. Não escolha API ou Retail apenas pela semelhança do nome.
- Reveja estes campos com o técnico, utilizando apenas os dados privados fornecidos pelo administrador:
- IP do servidor e Porta identificam o destino SQL Server da instalação. A porta é usada quando o destino não inclui já uma instância ou porta; este guia não define uma porta universal.
- Nome da BDD é o nome exato da base de vendas compatível, não um ficheiro nem uma lista de postos.
- Nome da instância identifica a instância SQL Server, quando aplicável. A instância tem prioridade sobre o campo Porta; não a adicione duas vezes nem combine dados de outra instalação.
- Preencha Utilizador e palavra-passe com a conta SQL privada autorizada e introduza o segredo apenas no ImaCash. Este modo não apresenta uma caixa de autenticação Windows. Se uma configuração anterior já a utiliza, preserve a identidade Windows válida e peça revisão técnica; não edite ficheiros para a ativar.
Use Guardar e verifique a conexão. Altere uma configuração existente com o suporte e sem operações em curso. Guardar ou abrir SQL não prova a leitura de todos os pagamentos e movimentos corretos.
Numerário, cartões e movimentos de caixa
Este modo usa os meios de numerário e cartão previstos pela ligação, sem seletores próprios de formas de pagamento. O fornecedor deve confirmar a correspondência. Com Aceitar cartões desativado, são lidos os pagamentos de documentos em numerário; a ativação acrescenta os pagamentos de cartão previstos. Meios personalizados, crédito ou vales não são incluídos automaticamente, e nenhum pagamento bancário é autorizado.
Cada pagamento é lido pelo valor pago menos o troco. Pagamentos separados de um documento misto podem gerar movimentos separados das respetivas partes, sem repetir o total completo por cada meio. Caixa/fornecedores é lido como numerário e mantém o sinal do TPV, mesmo com cartões ativados: nem todos esses movimentos são saídas. Valide o alcance e significado antes de movimentos automáticos de numerário.
Postos, operadores e filtros
Reveja os nomes e identificadores reais da instalação. Configure os filtros no ImaCash e confronte-os com documentos conhecidos. O filtro de operador também pode excluir movimentos de caixa/fornecedores; não presuma a mesma origem ou seleção nas duas leituras. Uma lista de centros não demonstra equivalência com postos, e a referência de loja da ligação não identifica uma loja física real.
Verificar os resultados
Com o fornecedor, compare pagamentos existentes em numerário, cartão e mistos, valores pagos menos troco, documentos negativos e movimentos de caixa/fornecedores. Reveja datas, postos, operadores, omissões e duplicados. Valores negativos mantêm o sinal, mas não provam um reembolso efetuado. Guias de remessa identificadas como reabertas são omitidas; isso não confirma anulação nem remoção de um movimento pendente anterior. Não faça pagamentos ou reembolsos reais para testar a configuração.
A ligação lê dados; não importa artigos nem escreve confirmações, rejeições ou anulações no Ágora. Uma conexão correta não prova leitura completa, documento fechado, pagamento bancário, conciliação ou validação física. Confirme com o fornecedor o alcance das duas leituras e de cada instalação.