PIX Imediato e Integração no PDV Web

Sumário

• Descrição e Usabilidade

• 1. Descrição da funcionalidade

• 2. Pré-requisitos

• 2.1 Requisitos de versão e layout

• 2.2 Bancos ativos

• 2.3 Permissões necessárias

• 3. Diagrama de fluxo

• 4. Jornada de uso

  • 4.1. Contratação do serviço

  • 4.2. Credenciamento da Conta bancária

  • 4.3. Parametrização e uso do PIX no PDV Web

• 5. Pontos de atenção

• 6. Casos de uso

• FAQ – Dúvidas frequentes

Descrição e Usabilidade

1. Descrição da funcionalidade

O PIX Imediato é uma solução Sankhya Fintech que permite gerar um PIX de forma instantânea a partir de títulos de Receita Real em aberto na Movimentação Financeira. Além disso, a solução viabiliza que as jornadas de varejo no PDV Web e no Checkout comuniquem-se diretamente com a API de PIX da Fintech para a geração automatizada de QR-Code, garantindo a continuidade dos recebimentos de clientes que utilizavam a antiga API V1 do Banco do Brasil.

• Propósito: Agilizar o processo de recebimento ao gerar um QR Code e um código "copia e cola" com validade de 24 horas, permitindo a liquidação e conciliação automática do título após a confirmação do pagamento, tanto na rotina financeira padrão quanto diretamente nos caixas de varejo.

• Valor para o Usuário: Oferece maior comodidade ao cliente final, garantindo rapidez no momento do pagamento, segurança e rastreabilidade total das transações comerciais.

2. Pré-requisitos

Para utilizar o PIX Imediato, sua empresa e usuário devem atender aos seguintes requisitos e configurações:

2.1 Requisitos de versão e layout

• Contratação do Pacote Básico de serviços Fintech (Pacote Boleto Rápido).

• Versão ERP: 4.35b226 ou superior.

• Versão BFF Financeiro: 1.20.1 ou superior.

• Layout do Sistema: Design System.

2.2 Bancos ativos

Atualmente, o PIX Imediato é compatível com os seguintes bancos:

• Banco do Brasil.

• Banco Itaú.

• Banco Santander.

• Banco SICOOB.

• Nota: O Bradesco está em desenvolvimento.

2.3 Permissões necessárias

• Ter o Sankhya ID ativado e conectado.

• Permissão de gestor e acesso à tela Contas para contratação, descredenciamento e cancelamento do serviço. Nota: Usuários do tipo SUP não podem realizar o cancelamento do contrato.

• Acesso à Baixa de Receita na rotina Movimentação Financeira para emissão do PIX.

3. Diagrama de fluxo

4. Jornada de uso

A jornada do PIX Imediato consiste em etapas principais que vão desde a contratação interna e configuração bancária até a aplicação e recebimento no balcão de vendas.

4.1. Contratação do serviço

O serviço de PIX Imediato está incluso no mesmo Pacote de Serviços do Boleto Rápido.

• Se sua empresa JÁ tem o Boleto Rápido ativo: As transações de PIX Imediato serão incluídas na volumetria do seu pacote atual.

• Se sua empresa NÃO tem o serviço ativo: É necessário contratar o pacote, que custa R$ 250,00/mês para até 1.500 transações, sendo as transações excedentes cobradas à parte.

Passos para contratação:

1. Clique no botão "Quero conhecer" para ser direcionado ao Marketplace.

2. Em caso de dúvidas sobre o processo de contratação, acesse o documento: Contratação e Cobrança dos serviços Fintech.

Com a contratação concluída, você estará apto a seguir para o credenciamento da conta bancária.

4.2. Credenciamento da Conta bancária

O processo de credenciamento ao PIX Imediato só será permitido após a contratação do serviço (conforme item 4.1).

1. Acesse a tela Assistente de Melhores Práticas.

2. Na opção ‘Configurações serviços Fintech’, escolha ‘PIX Integrado’ e clique em ‘Iniciar’.

3. Selecione a Conta Bancária a ser credenciada na Etapa 1 e clique em ‘Avançar’.

4. Preencha os Dados da Conta (Agência, Dígito, Conta, CNPJ e Chave PIX) na Etapa 2. (Se a conta já foi credenciada para Boleto Híbrido, os dados podem vir preenchidos. Apenas confira e avance.)

5. Defina as Ações Automáticas (Etapa 3) para Baixa, Lançamento, TOP e Conciliação.

   • Melhor Prática: Configure a Baixa Automática e Conciliação Automática para valores diferentes de 'Não realizar'.

   • É essencial informar o Tipo de Título na Baixa Automática (com Subtipo = PIX e Ativo) para identificar o recebimento.

6. Insira as Credenciais (Client ID e Client Secret) fornecidas pelo seu banco (Etapa 4).

7. Na Etapa 5, confira o resumo das informações e clique em ‘Instalar’ para finalizar o credenciamento. Uma mensagem de "Configuração realizada com sucesso" será exibida.

4.3. Parametrização e uso do PIX no PDV Web

Para que os operadores de caixa realizem recebimentos no ambiente de varejo através do PIX integrado com a API da Fintech, certifique-se de que todos os passos anteriores (Contratação e Credenciamento) estejam concluídos e ativos.

Fluxo operacional no PDV Web

1. Lançamento e Recebimento: Durante o processo regular de fechamento de uma venda no PDV Web, ao avançar para a tela de formas de pagamento (atalho [F7] Receber), selecione a opção "PIX".

2. Geração do QR Code: O sistema abrirá automaticamente o pop-up "Receber com PIX", exibindo na tela o QR Code exclusivo e o código Copia e Cola gerados pela API Fintech para aquela transação.

3. Impressão opcional (PDF): No mesmo pop-up, o operador de caixa dispõe do botão "Baixar PDF", que gera um documento legível com o QR Code e os dados do PIX para impressão ou compartilhamento físico com o pagador.

4. Confirmação Automática: Assim que o pagamento é efetuado pelo cliente, o sistema altera o status no caixa de forma instantânea exibindo a mensagem "PIX recebido com sucesso!" junto com o ID da transação. Ao clicar em "Finalizar", a venda é concluída e o cupom fiscal emitido.

Tratamento de exceções e mensagens no Caixa

• Cancelamento de Operação: Caso o cliente desista do PIX antes de efetuar o pagamento, o operador pode clicar em "Cancelar PIX". O sistema exibirá uma confirmação ("Deseja realmente cancelar esta cobrança PIX?"). Ao continuar, a ordem é revogada na API e o caixa é liberado.

• Aviso de Tipo de Título Inválido: Se o sistema retornar uma mensagem informando que não existe um Tipo de Título configurado para o PDV Web com este subtipo, o operador será alertado e o recebimento não poderá prosseguir até que a parametrização do tipo de título (Subtipo = PIX e Ativo) esteja associada ao terminal.

• Acompanhamento de Falhas: Se houver falha de comunicação ou de preenchimento na requisição, o erro correspondente (Ex: erro retornado da API ou validação pendente) será exibido no mesmo pop-up de cobrança, impedindo a exibição do QR Code incorreto e instruindo o usuário a tentar novamente.

• Validação no ERP: Após o encerramento da venda, se o gestor financeiro consultar o respectivo título gerado na rotina de Movimentação Financeira, o campo "Baixa via API" na aba Lançamento/Histórico estará automaticamente populado com as informações de recebimento, data e ID da transação.

5. Pontos de atenção

• Validação dos Dados Bancários (DOR DE TICKET): O sistema não valida os dados bancários (Agência, Conta, Chave PIX) junto ao banco no momento do credenciamento. ⚠️ É crucial que o usuário confirme todas as informações junto ao gerente do banco antes de iniciar o credenciamento para evitar chamados e falhas na emissão.

• Cobrança do Serviço: O PIX Imediato é cobrado através do mesmo pacote do Boleto Rápido. A contagem de transações inclui todos os recebimentos liquidados via código de barras, QR Code do boleto e QR Code gerado pelo PIX Imediato.

• Descredenciamento da Conta: Para remover uma conta dos serviços, acesse a tela Contas, selecione a conta credenciada, clique no botão "Descredenciar conta" e confirme. Importante: Mesmo que todas as contas sejam descredenciadas, o contrato e a cobrança mensal continuarão ativos.

• Cancelamento do Contrato (Interrupção da Cobrança): Caso queira interromper a cobrança da Sankhya Fintech, acesse a etapa "Seleção de Contas" no Credenciamento PIX (na tela Assistente de Melhores Práticas), clique em "Cancelar contrato" e confirme. Isso descredenciará todas as contas dos serviços de Boleto Rápido e PIX Imediato.

  • Restrições: O cancelamento não pode ser realizado por usuários do tipo SUP, exige acesso à tela 'Contas' e não pode ser feito em bases de treinamento.

• Alteração do Valor Líquido: Se o Valor Líquido de um título com PIX ativo for alterado, o PIX anterior é cancelado automaticamente no banco. Um novo PIX deve ser gerado para o valor atualizado.

6. Casos de uso

• ✅ Exemplo: Liquidação Automática: Um PIX Imediato é gerado (seja na Movimentação Financeira ou no PDV Web). O sistema recebe a confirmação do Banco e, como as ações automáticas foram configuradas, o título na Movimentação Financeira é liquidado (baixado e conciliado) sem intervenção manual do usuário.

• ❌ Erro Comum: Falha na Baixa Automática: O pagamento do PIX é recebido, mas a baixa automática falha no ERP (Ex: Lançamento inválido / Regra de transação). O motivo exato da falha é registrado no campo ‘Baixa via API’ na tela Movimentação Financeira. O usuário deve resolver o impeditivo cadastral apontado no log para que o Job do sistema execute a baixa com sucesso nas próximas tentativas automáticas.

FAQ – Dúvidas frequentes

• O PIX Imediato está incluso na mensalidade padrão do ERP?

  Não. O PIX Imediato faz parte do Pacote Boleto Rápido da Sankhya Fintech, possuindo uma cobrança mensal à parte (R$ 250,00/mês para até 1.500 transações, com taxa de excedente por transação acima do limite).

   

• O que acontece se eu alterar o Valor Líquido do título com o PIX já gerado?

  O PIX gerado anteriormente é cancelado automaticamente no banco. É necessário gerar um novo PIX para que o cliente pague o valor atualizado.

   

• O sistema valida os dados bancários no momento do credenciamento?

  Não. O sistema não realiza a validação dos dados junto ao banco no momento do cadastro. É vital conferir todas as informações com seu gerente bancário antes de finalizar.

   

• O que significa a mensagem registrada no campo ‘Baixa via API’ da Movimentação Financeira?

  Este campo registra todo o histórico do ciclo de vida do PIX (Ex: se foi recebido, cancelado ou expirado) e também aponta os códigos de erro e motivos de falha caso a baixa automática encontre algum problema.