Configurar Aseproda
Aseproda tem uma única ficha pública. O fornecedor deve confirmar se a instalação utiliza ficheiros Visual FoxPro, uma ligação MySQL ou uma API. Siga apenas o percurso da interface correspondente; não altere uma configuração operacional devido ao nome de uma versão.
Ligação por ficheiros
Preparar e guardar a ligação
- Prepare o VFPOLEDB de 32 bits no computador do ImaCash com o instalador autorizado. O administrador deve confirmar as três origens Visual FoxPro e os ficheiros associados, acessíveis para consulta pela conta Windows que executa o ImaCash. Não mude os nomes nem converta os ficheiros. Se o fornecedor confirmar uma pasta de tabelas livres como origem VFPOLEDB, introduza essa pasta manualmente no campo correspondente: o seletor não a deduz do ficheiro escolhido.
- Abra Configuração > Integração, selecione POS > Aseproda e o perfil de ficheiros confirmado pelo fornecedor. Aparecem os campos Transações, Empresas e Auxiliares.
- Em Transações, selecione o ficheiro de origem das vendas confirmado pelo fornecedor. A captura antiga chama Ventas a este campo. O botão abre um seletor de ficheiros; não deduza o caminho a partir do nome de uma pasta.
- Em Empresas, selecione o ficheiro de origem dos movimentos de caixa confirmado pelo fornecedor. Não é um filtro de empresa nem um catálogo de clientes.
- Em Auxiliares, introduza manualmente o caminho da origem auxiliar confirmado pelo fornecedor: o botão não abre um seletor neste modo. Esta origem ajusta os valores das vendas; não é uma lista de utilizadores.
- Guarde e verifique as três origens com o utilizador Windows real. Este modo não pede servidor SQL, porta nem credenciais SQL. Uma indicação de ligação não prova que todas as operações estejam a ser capturadas.
O que verificar na leitura
O conector agrupa determinadas vendas por referência e desconta os valores auxiliares associados. Também lê movimentos de caixa, conservando o sentido de entrada ou saída. Apresenta os resultados como numerário; não fornece uma discriminação geral de cartões, pagamentos mistos ou troco.
A consulta utiliza a data de sincronização e um limite estritamente posterior, sem a hora exata. Verifique quais os registos do mesmo dia devolvidos pela origem; não presuma que alterar a sincronização recupera todo o histórico.
Posto, vendedor e filtros
A caixa vem dos registos, mas o vendedor é genérico. Compare os identificadores recebidos com os filtros locais do ImaCash; esse vendedor não identifica o funcionário real e um filtro não comprova uma operação física.
Limites e verificações
Este conector não importa produtos ou turnos, nem escreve confirmações ou anulações no Aseproda. O fornecedor deve verificar a edição, estrutura, período, agrupamento, deduções e sinais face à operação real antes da utilização. A documentação e uma ligação bem-sucedida não comprovam validação física nem compatibilidade com todo o catálogo ASEPRODA.
A captura histórica mantém os campos vazios e mostra Gas Station e Ventas. A interface atual utiliza POS e Transações; os rótulos da captura não substituem os passos anteriores.
Ligação MySQL
- Em POS > Aseproda, selecione o perfil MySQL confirmado pelo fornecedor. Introduza servidor, porta, nome da base de dados, utilizador e palavra-passe privados fornecidos pelo administrador. Utilize uma conta autorizada para as consultas necessárias, acessível ao utilizador Windows real do ImaCash; não copie credenciais de outra instalação.
- Selecione a forma de numerário do catálogo real do POS. Para incluir cartões, confirme uma forma de cartão diferente e a opção Aceitar cartões. O leitor classifica os registos segundo esses identificadores; não comprova um pagamento bancário nem discrimina automaticamente todos os pagamentos mistos ou trocos.
- Guarde e confirme com o fornecedor os documentos a cobrar recebidos, montantes, referências, datas e vendedor. O posto publicado é genérico; não o utilize para identificar um terminal físico. Esta ligação não importa produtos nem turnos e não escreve confirmações ou anulações no POS. Uma ligação aberta não comprova captura completa nem compatibilidade com todas as edições.
Ligação por API
Preparação e configuração
- Termine as operações em curso antes de começar. O fornecedor deve preparar o componente de comunicação, a ponte local e o armazenamento de troca, com as permissões necessárias para o utilizador Windows que executa o ImaCash. Este armazenamento exige leitura e escrita; uma conta SQL apenas de leitura não basta.
- Em Configuração > Integração, selecione POS > Aseproda e o perfil API confirmado pelo fornecedor. Este perfil mostra apenas o campo Porta para a ligação.
- Em Porta, introduza a porta HTTP de escuta do ImaCash acordada com o fornecedor, livre nesse computador e coerente com o destino configurado no POS. Não é a porta SQL nem uma porta remota do POS. Limite o serviço à rede autorizada; o administrador fornece o endereço e os dados de acesso de forma privada.
- Guarde com o ícone de disquete e siga o pedido de reinício com elevação, se aparecer. Após alterar a porta, feche e volte a abrir o ImaCash sem operações em curso para iniciar a escuta com a nova configuração.
- Com o fornecedor, verifique o acesso ao serviço a partir do posto autorizado. GET /test, no endereço e porta privados preparados, apenas verifica se o serviço HTTP responde: não valida a ponte, o armazenamento, o POS nem uma operação de numerário. Verifique esses elementos separadamente antes da utilização.
O que o conector troca
O ImaCash recebe pela API as operações preparadas para troca e consulta as pendentes. A ponte pode fornecer a configuração do armazenamento; se não a obtiver, utiliza a configuração local disponível. Isto não significa que todo o histórico do POS seja lido automaticamente.
As referências, montantes, datas e identificadores de caixa, empresa e vendedor vêm da troca recebida. O ImaCash regista resultados nesse armazenamento; o fornecedor deve validar que o POS os consome corretamente, incluindo estados e anulações. Uma resposta técnica não comprova o fecho fiscal, um pagamento bancário nem o resultado físico da máquina.
Âmbito e verificações pendentes
Esta modalidade não importa produtos nem turnos e não oferece um seletor próprio de numerário ou cartão. Confirme com o fornecedor os meios de pagamento, os montantes e os filtros aplicados. A configuração, o código ou um teste simulado não comprovam compatibilidade de uma edição concreta nem validação física do circuito completo.
