PIX QR Code

Contexto

Gerar uma cobrança PIX do frete a partir da própria tela do CTRC no SSW não é um caminho direto, o que exige etapas adicionais para receber o pagamento. Esta funcionalidade gera o QR Code e o código copia e cola na hora, sem sair da opção 101.

Permissões e habilitação

Esta funcionalidade requer habilitação no painel administrativo do TurboTMS e delegação de permissões por grupos de usuários do SSW, definidas junto à nossa equipe de suporte. Para solicitar a habilitação, entre em contato conosco.

Para utilizar a geração de PIX, são necessários:

• Permissão “Gerar PIX QR Code” atribuída ao grupo do usuário no TurboTMS.
• O usuário do SSW conectado à extensão: o TurboTMS utiliza essas credenciais para gerar o PIX no SSW em nome do usuário.
• Acesso à opção 048 do SSW para o usuário em uso.

Sem a permissão de geração, o TurboTMS não injeta o botão de PIX na tela do CTRC.

Tarifa

É cobrada uma tarifa de R$ 0,99 por PIX recebido através da funcionalidade.

Parametrização

O comportamento da geração de PIX é configurado por empresa junto ao nosso time de suporte. Os parâmetros disponíveis são:

• Regras de bloqueio: lista de rótulos que, quando presentes na ficha do CTRC (ex.: “REDESPACHO EXPEDIÇÃO”), desabilitam o botão “Gerar PIX”, exibindo o motivo como dica ao passar o mouse. Sem regras, nenhum CTRC é bloqueado.
• Juros e multa por atraso: fórmula aplicada a faturas vencidas na geração do PIX. Duas opções: percentual + valor fixo (ex.: 9% + R$ 10,50) ou multa + juros mensal pró-rata (ex.: 2% + 1% ao mês). Também é possível definir que faturas em CARTEIRA só acumulem juros após a baixa bancária. Sem configuração, não há cobrança de juros.
• Cobrar valor total da fatura: quando ativado, o PIX de um CTRC já faturado em CARTEIRA liquida a fatura inteira (valor da fatura + juros) em vez de cobrar somente o CTRC. Faturas com cobrança bancária sempre liquidam a fatura inteira, independente da configuração.
• Bloquear PIX para cobrança à prazo: quando ativado, CTRCs cujo tipo de cobrança contém “À PRAZO” não geram PIX — o botão fica desabilitado com o motivo exibido como dica ao passar o mouse.

O que faz

• Adiciona o botão “Gerar PIX” na tela do CTRC (opção 101), apenas quando a situação de liquidação é “NÃO LIQUIDADO”.
• Ao clicar, abre um modal com o QR Code, o valor do frete e o botão “Copiar PIX” (código copia e cola).
• Quando há juros por atraso, o modal exibe a linha de juros e o total (frete + juros), que é o valor cobrado no PIX.
• Registra uma ocorrência no CTRC no SSW indicando que o PIX foi gerado pela extensão.
• Se já existir um PIX válido para o mesmo CTRC, reutiliza o mesmo em vez de gerar outro — o modal indica por quanto tempo ainda é reutilizável.
• Se o SSW recusar a geração (por exemplo, fatura com cobrança bancária), o motivo é exibido dentro do próprio modal.

Como usar

1. Acesse a opção 101 do SSW e abra a tela de detalhe do CTRC.
2. Clique no botão “Gerar PIX”.
3. Aguarde a geração; o modal exibirá o QR Code e o valor do frete.
4. Apresente o QR Code para leitura ou use “Copiar PIX” para enviar o código copia e cola.
5. Observe o tempo de reutilização exibido; após expirar, gere o PIX novamente.