Integração ImaCash

EANCustom

Configure EANCustom no ImaCash: máscara do talão, montante, leitura e seleção de pagamento, com requisitos e limitações.

Marca ImaCash para o seu modo EANCustom
ImaCash

Configurar EANCustom, também chamado Custom EAN

EANCustom é o modo do ImaCash que interpreta um código de talão através de uma máscara acordada com o fornecedor do POS. A máscara indica as posições do montante e das referências; não transforma qualquer código de produto num talão para pagamento.

Preparar a leitura

  1. Confirme o formato. Peça ao fornecedor a estrutura exata do código, o significado de cada posição, a moeda e a referência do talão. Prepare o leitor e a máquina separadamente. Este modo não necessita de ligação à base de dados do POS nem de credenciais do fornecedor.
  2. Selecione EANCustom. Em Configuração > Integração, escolha EANCustom. É o nome do seletor; Custom EAN é outro nome da mesma modalidade.
  3. Preencha Caracteres. Introduza a máscara em maiúsculas, com uma posição por cada caráter do código completo. Deve conter pelo menos três E e um D. Acorde dois D para os cêntimos; não copie uma máscara de outro POS nem adicione espaços ou separadores que o leitor não emita.
  4. Guarde e verifique. Ao fechar a configuração, confirme a gravação se for solicitado e siga o reinício proposto quando se aplicar. Guardar não comprova uma leitura correta. Antes da utilização real, confira com o fornecedor códigos de teste sem dados de clientes, montante, moeda, referências e meio de pagamento.

Significado de cada letra

  • L: Local ou loja do talão, se o código o incluir.
  • C: Caixa ou terminal do POS, se o código o incluir.
  • T: Referência do talão de origem. Deve identificar cada talão sem ambiguidades.
  • X: Tipo de pagamento: 0 numerário e 1 cartão. Sem X, o código é interpretado como numerário; confirme a correspondência com o talão.
  • E: Algarismos inteiros do montante. São necessárias pelo menos três posições E.
  • D: Algarismos decimais do montante. É necessária pelo menos uma posição D.
  • O: Posição ignorada. O conteúdo não é validado como valor fixo nem como dígito de controlo.

O comprimento lido deve corresponder exatamente à máscara. Um único D representa décimas; com mais de dois D, conservam-se apenas os dois primeiros, sem arredondamento. As letras distinguem maiúsculas e minúsculas: utilize as maiúsculas indicadas e confira sempre o montante apresentado.

Âmbito e precauções

Um código de preço pode repetir-se entre vendas: não identifica necessariamente um talão. Sem T, a referência local não identifica de forma estável o talão do POS. Não pressuponha proteção geral contra duplicados nem validação universal do dígito de controlo EAN13. Perante um resultado incerto, verifique a operação e o numerário real antes de repetir a leitura ou reiniciar.

Este percurso regista a operação no ImaCash; a confirmação ou rejeição local não escreve o fecho nem a anulação no POS. Não recupera vendas por data, produtos, turnos nem o total bancário do fornecedor. Reveja talões e referências com o responsável pelo POS.

O guia documenta o funcionamento do modo; não comprova compatibilidade com qualquer POS, leitor ou máquina. O fornecedor deve confirmar o formato e um teste físico supervisionado antes da utilização comercial.

EAN / EANCustom: Preparar o leitor e o formato

Em Configuração > Integração, selecione EAN ou EANCustom de acordo com o formato emitido pelo POS. No EANCustom, mantenha a máscara acordada com o fornecedor: L identifica o local, C a caixa, T o talão, X o tipo (0 numerário, 1 cartão), E os inteiros, D os decimais e O as posições ignoradas. Não altere posições nem suponha que qualquer EAN13 contém um montante. Verifique montante interpretado, moeda, leitor e uma base local operacional com permissão de escrita antes do primeiro pagamento. A leitura de códigos não exige inventar credenciais de base de dados.

Leituras e escolha de pagamento

Em configurações > Geral > Pagamento e vendas, «EANCustom: cobrar ao ler» está disponível apenas para EANCustom e desativado por predefinição. Iniciar numerário após leitura válida. Desativado: acumular talões. A cobrança mantém as autorizações e confirmações do fluxo habitual de numerário; EAN não muda. Este modo só aceita leituras de numerário; um código de cartão não inicia uma cobrança. Para registar um pagamento com cartão, desative esta opção e escolha Cartão no modo multitalão.

Com EAN, ou com a opção desativada no EANCustom, reúna os talões em Vendas digitalizadas, reveja as linhas e o total e escolha Numerário ou Cartão. Confirme o pagamento com cartão no terminal bancário antes de o registar no ImaCash. Utilize Cancelar para descartar uma seleção cuja cobrança ainda não tenha começado.

Integração pronta para avançar

Se esta ficha se adequa ao seu software, o próximo passo é passar para a operação real

Podemos ajudá-lo a validar o âmbito, confirmar hardware compatível e preparar o próximo passo de implementação.