Configurar Ágora Retail no ImaCash
Este guia corresponde a POS > AgoraRetail e à sua leitura SQL Server. Ágora POS e Ágora API são modalidades distintas. Os nomes anteriores AgoraRetail V2 e V3 remetem para o mesmo conector; não comprovam versões comerciais nem compatibilidade adicional.
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 > AgoraRetail. Confirme com o fornecedor a modalidade preparada antes de alterar uma instalação existente.
- 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.
Guarde a ligação e escolha as formas reais da instalação quando surgirem as listas. Preserve a configuração válida e verifique o que foi guardado antes de utilizar. Se não surgirem formas, não presuma que a ligação validou os pagamentos. Conclua um novo arranque normal do ImaCash, sem operações em curso, para aplicar e verificar as formas guardadas.
Numerário, cartões e movimentos de caixa
Selecione a forma de numerário pelo nome real. Para cartões, escolha uma forma diferente e ative Aceitar cartões nas definições. Com a opção desativada, só é consultada a forma de numerário; a ativação acrescenta a forma de cartão selecionada. Não utilize identificadores de exemplo nem presuma que uma lista vazia ou seleção cancelada deixa a classificação correta. Crédito, vales e outras formas não são incluídos automaticamente.
Cada pagamento é lido como valor pago menos troco, mantendo o sinal. Um documento misto pode produzir movimentos separados das componentes selecionadas; o total não é repetido por forma. Um valor negativo não comprova um reembolso executado nem autorização bancária. Esta modalidade não inclui uma leitura independente de movimentos de caixa/fornecedores.
Postos, operadores e filtros
Verifique postos e operadores com documentos conhecidos antes de aplicar filtros. A lista de postos pode apresentar identificadores e os movimentos nomes; confirme a correspondência. Em certos esquemas, o posto corresponde à abertura do talão, não ao local do pagamento. O operador é o da abertura do documento. Os filtros locais do ImaCash podem excluir pagamentos já lidos por SQL; uma referência genérica de loja não identifica uma loja física.
Verificar os resultados
Compare pagamentos existentes em numerário, cartão e mistos, troco, valores negativos, datas e ligação ao documento. Reveja com o fornecedor pagamentos sem documento associado, duplicados, omissões e filtros. Não efetue pagamentos ou reembolsos reais para testar. Uma ligação SQL bem-sucedida não comprova a leitura completa nem o fecho do documento. Os pagamentos sem documento associado podem não ter posto ou operador; não complete esses dados por suposição.
A ligação lê pagamentos; não importa produtos nem escreve confirmações, rejeições ou anulações no Ágora. Listas de formas, uma ligação e variantes de esquema previstas não comprovam compatibilidade com todas as versões nem validação física. Confirme o âmbito da instalação antes do uso automático.