Configurar FicherosTXT com ImaCash
O FicherosTXT recebe pedidos de um POS através de ficheiros de texto. O fornecedor deve preparar o formato e recolher os resultados antes da utilização comercial. Não é Ficheros Alcornoque, FicherosRCSCash nem um perfil de teste; o nome não valida todas as máquinas ou sistemas operativos.
1. Preparar a troca
Reserve uma pasta exclusiva para este POS e instalação. O utilizador Windows do ImaCash precisa de ler, criar, mover e eliminar ficheiros e criar subpastas. Não escolha a raiz do disco, documentos pessoais ou cópias de segurança. Verifique qualquer partilha de rede com esse mesmo utilizador; não pressuponha vários leitores simultâneos.
2. Selecionar FicherosTXT
Abra Configuração > Integração, escolha a categoria ImaCash e selecione FicherosTXT. Configure a máquina de numerário separadamente. O nome do método não torna equivalentes outros conectores de ficheiros nem exige um perfil oculto ou de teste.
3. Indicar a pasta
Em Vendas, selecione o diretório de troca confirmado pelo fornecedor, não um ficheiro individual. Capturas antigas podem mostrar Transações e um botão Guardar anterior. O conector não pede servidor SQL, base de dados, porta ou credenciais próprias. Mantenha privados o caminho e os dados de acesso à partilha de rede.
4. Preparar o TXT
Cada ficheiro contém um pedido: apenas a primeira linha é lida, com exatamente seis campos separados por ponto e vírgula. Não acrescente cabeçalhos nem conte com linhas adicionais. O POS deve terminar o ficheiro antes de o tornar visível como TXT; combine a codificação e o formato com o fornecedor segundo as definições regionais do Windows do ImaCash.
| Campo | Conteúdo a confirmar pelo fornecedor |
|---|---|
| Montante | Montante pedido e sinal, sem separador de milhares. Valide o separador decimal nas definições regionais reais do ImaCash. Um montante negativo não comprova autorização do reembolso. |
| Terminal | Identificador do posto POS conservado no pedido, não o modelo da máquina. |
| Referência | Identificador único e válido da operação, adequado para dar nome à resposta e sem separadores de caminho. Não o reutilize ou altere para repetir um pagamento incerto. |
| Vendedor | Identificador ou etiqueta do operador enviado pelo POS; deve corresponder aos filtros sem pressupor um catálogo de utilizadores. |
| Data e hora | Data e hora interpretáveis pelo ImaCash nas respetivas definições regionais. Confirme formato e data de negócio com o fornecedor. |
| Tipo de pagamento | 1 para numerário ou 0 para cartão, segundo o formato acordado. Não envie outros valores nem interprete o campo como autorização bancária. |
5. Guardar ao fechar
Feche Configuração e confirme a gravação quando for solicitado; siga o reinício proposto, se aplicável. O arranque verifica acesso básico à pasta e escrita, mas o indicador ligado não comprova formato, movimento dos ficheiros, pagamento ou receção da resposta pelo POS.
6. Distinguir captura de pagamento
Os TXT disponíveis são lidos sem reconstruir histórico pela data de sincronização. Os ficheiros podem passar para processed quando incorporados ou revistos localmente; isso não significa pago. Ficheiros vazios ou mal formatados podem passar para error sem que cada falha produza uma resposta .KO. Não elimine, edite ou reintroduza esses ficheiros para forçar um pagamento.
7. Rever cartões e filtros
O tipo 1 identifica numerário e 0 cartão. Aceitar cartões permite incluir esses pedidos; não autoriza nem liquida o pagamento bancário e o formato não discrimina pagamentos mistos. Compare terminal e vendedor com os filtros locais; os seis campos não fornecem empresa ou caixa independentes nem catálogos de lojas ou operadores. A leitura de artigos, turnos e total bancário não está validada.
8. Verificar respostas e cancelamento
A confirmação tenta escrever uma resposta .OK identificada pela referência, que pode diferir do nome do TXT original. O cancelamento usa .KO e pode mudar o nome do respetivo ficheiro de pedido; nem toda a falha de formato é um cancelamento. O POS deve usar o formato de cancelamento acordado com o fornecedor. A existência do ficheiro não comprova leitura ou fecho na origem nem devolução física.
9. Validar o percurso completo
Com o fornecedor, teste pedido, incorporação, montante e sinal, resultado no ImaCash e na máquina e receção da resposta no POS. Confirme data de negócio, moeda, filtros e cancelamentos admitidos, sem prometer uma janela universal de duas horas ou ausência de duplicados. Em caso de dúvida, reveja sistemas e numerário real antes de repetir, reenviar, alterar referências, resincronizar ou reiniciar. Esta revisão documental não substitui um teste físico.