Protocolo MDB: Limitação Técnica de Valores Máximos 655,35 e Soluções (VendTEF Smart)

1. Escopo e Cenário

Este documento detalha a limitação estrutural do protocolo MDB (Multi-Drop Bus) padrão em relação à transação de produtos com valores elevados, justificando o teto nativo de R$ 655,35, e apresenta as soluções de contorno disponíveis nativamente no aplicativo VendTEF Smart.

2. A Causa Raiz: Arquitetura de 16-bits

O protocolo MDB clássico (normatizado pela NAMA) transmite os valores das transações financeiras pelo barramento utilizando variáveis do tipo Unsigned Integer de 16-bits (inteiro sem sinal).

• O valor máximo absoluto suportado em uma variável de 16-bits é 65.535 (em binário: 11111111 11111111).

• Como o sistema opera considerando centavos (fator de escala padrão de 0.01 ou 2 casas decimais), o limite máximo que o protocolo consegue trafegar nativamente é de 655,35 na moeda local (ex: R$ 655,35).

3. O Impacto na Prática (Truncamento de Cobrança)

Quando a VMC (Vending Machine Controller) tenta enviar para o terminal de pagamento uma intenção de venda superior a R$ 655,35 no padrão L1, o sistema atinge o teto da variável.

O que ocorre na máquina: O barramento "trava" no valor máximo. Se o produto custa R$ 800,00, o terminal aprova e cobra do cliente apenas R$ 655,35 (ou o valor de corte configurado), liberando o produto e gerando prejuízo financeiro automático.

4. Soluções e Contornos (Via App VendTEF Smart)

Para resolver essa limitação técnica de hardware sem necessariamente trocar a placa da máquina, o aplicativo VendTEF Smart (a partir da v1.38.23) possui duas configurações nativas na seção Configurações do MDB. Estas opções são mutuamente exclusivas e não podem ficar ativas simultaneamente.

Alternativa A: Ignorar Centavos (Para MDB L1 e Terminais Legados)

Esta é a opção mais universal recomendada para terminais incompatíveis com MDB L3. O aplicativo altera a interpretação dos valores recebidos (MDB L1), multiplicando o que vem da máquina por 100[cite: 2]. Isso eleva o teto de vendas para R$ 65.535,00.

• Atenção à Configuração da VMC: Para que a matemática funcione corretamente, os preços na Vending Machine precisam obrigatoriamente ser configurados sem as casas dos centavos. Exemplo: Para vender um produto de R$ 200,00, o preço cadastrado na VMC deve ser 2.00. O terminal irá ignorar os centavos, multiplicar o valor por 100 e realizar a cobrança de R$ 200,00.

• O menor valor configurável na máquina passa a ser R$ 1,00.

Alternativa B: Suporte a Valores Estendidos (Para MDB L3+)

Esta opção habilita o suporte a valores estendidos nativamente no protocolo MDB.

• Requer terminal PayBlu compatível (com suporte a valores estendidos).

• Caso o terminal seja antigo/incompatível, ativar essa flag não fará diferença no funcionamento. Neste caso, recomenda-se utilizar a opção "Ignorar Centavos".

⚠️ Procedimento Operacional: Sempre alinhe a configuração de preços da máquina com o terminal antes de ativar qualquer uma destas funcionalidades. Operar com os preços antigos em conjunto com a flag "Ignorar Centavos" ativada fará com que produtos de R$ 5,00 sejam cobrados como R$ 500,00.