Pular para o conteúdo principal
Página inicial da Central de Ajuda de Sankhya Gestão de Negócios

PIX imediato

Documentação Dti
  • Atualizado
Módulo: Financeiro
Versão Mínima: A partir da 4.35b226
Caminho de Acesso: Menu Principal > Financeiro > Movimentação Financeira

Sumário

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.

  • 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.
  • Valor para o Usuário: Oferece maior comodidade ao cliente final, garantindo segurança e rastreabilidade das transações.

2. Pré-requisitos

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

⚙️ 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.

🏦 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.

✅ Permissões Necessárias

  • Ter o Sankhya ID ativado.
  • 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

pix_imediato.png

4. Jornada de Uso

A jornada do PIX Imediato consiste em três etapas principais: Contratação, Credenciamento e Geração/Recebimento do PIX.

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:

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

  • 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.

  1. 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.

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

  • Consulte os artigos relacionados do seu banco para obter as credenciais (Artigos Relacionados, neste artigo).
  1. Na Etapa 5, confira o resumo das informações e clique em ‘Instalar’ para finalizar o credenciamento.

  2. Uma mensagem de "Configuração realizada com sucesso" será exibida.

4.3. Geração e Recebimento do PIX

Após a contratação e o credenciamento da conta:

  1. Acesse a tela Movimentação Financeira e selecione um título que seja de ‘Receita’, ‘Real’ e ‘Pendente’.

  2. Clique na opção ‘Receber com PIX’ (ícone do PIX no menu superior).

  3. Se o tipo de título do financeiro for diferente do configurado no credenciamento, o sistema perguntará se você deseja alterá-lo. Ao continuar, o PIX será gerado.

  4. O pop-up "Receber com PIX" será exibido, contendo o QR Code e o código Copia e Cola. Nele, você também encontra a opção "Baixar PDF" para gerar um documento com o QR Code e os dados do PIX, caso deseje enviar ao pagador.

  • O valor do PIX será sempre o ‘Vlr. Líquido’ do título.
  • A expiração é de 24 horas a partir da geração.

  1. Quando o pagamento for efetuado, o sistema exibirá uma mensagem de "PIX recebido com sucesso!".

  • A consulta de recebimento é instantânea nos primeiros 5 minutos e, depois, a cada 5 minutos.
  1. Se as ações automáticas foram configuradas, a baixa e conciliação do título serão realizadas automaticamente. O histórico da transação será registrado no campo ‘Baixa via API’.

Cancelamento do PIX Imediato

Opcionalmente, é possível cancelar um PIX Imediato gerado, caso o pagamento ainda não tenha sido efetuado. Ao solicitar o cancelamento do PIX, a requisição é enviada ao Banco.

  • Pop-up de Solicitação: Neste momento, será visualizado o pop-up de confirmação:

  • Status no Histórico: Recebido o retorno de efetivação desse cancelamento, o campo ‘Baixa via API’ (Movimentação Financeira) do respectivo título financeiro será populado com a mensagem de cancelamento:

Expiração do PIX Imediato

Se o pagamento não for realizado, o PIX Imediato tem um prazo de expiração de 24 horas a partir de sua geração. Para conferir a efetivação dessa expiração, consulte o campo Baixa via API, onde constará descrito: PIX expirado.

  • Status no Histórico: Efetivada essa expiração, no campo ‘Baixa via API’ será alimentado o histórico com a mensagem:

  • Reemissão: Ao selecionar o financeiro de um PIX expirado e reabrir o ‘Recebimento com PIX’, um novo PIX será automaticamente gerado.

Falha na Geração do PIX Imediato

Caso no momento da geração deste PIX haja algum erro de comunicação com o Banco ou de dados, o erro deverá ser apresentado no mesmo pop-up "Receber com PIX" (que seria usado para exibir o QR Code), porém mostrando a mensagem de falha, conforme imagem abaixo.

  • Pop-up de Erro:
Exibindo image.png

 

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.

Gerenciamento de Contrato e Contas

  • Descredenciamento da Conta:

    • Para remover uma conta dos serviços PIX Imediato/Boleto Rápido, acesse a tela Contas, selecione a conta credenciada, clique no botão "Descredenciar conta" e confirme a ação.

    • Importante: Mesmo que TODAS as contas sejam descredenciadas, o contrato e a cobrança mensal do Pacote Boleto Rápido continuarão ativos.

  • Cancelamento do Contrato (Interrupção da Cobrança):

    • Caso queira realizar o cancelamento do contrato com a Sankhya referente ao Pack Boleto Rápido, acesse a etapa "Seleção de Contas" no Credenciamento PIX (na tela Assistente de Melhores Práticas), clique em "Cancelar contrato" e confirme.

    • Ao confirmar o cancelamento, todas as contas serão descredenciadas dos serviços de Boleto Rápido (Simples e/ou Híbrido) e PIX Imediato.

    • Restrições Críticas:

      • O cancelamento não pode ser realizado por usuários do tipo SUP.
      • Somente será realizado por usuários que tenham acesso à tela 'Contas'.
      • Não poderá ser realizado através de bases de treinamento.

    • Valor do Pacote: R$ 250,00/mês para 1.500 transações.

  • Cancelamento de Contrato vs. Descredenciamento de Conta:

    • Descredenciar a conta remove a conta dos serviços, mas o contrato continua ativo e a cobrança é mantida.
    • Cancelar o contrato é a única forma de interromper a cobrança do Pacote Boleto Rápido/PIX Imediato, descredenciando todas as contas dos serviços.

  • Alteração do Valor Líquido: Se o Vlr. 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.

  • Acompanhamento de Status: O status da transação (Recebido, Cancelado, Expirado) é registrado no campo ‘Baixa via API’ na tela Movimentação Financeira.

    • Falhas na baixa automática também são registradas neste campo.

6. Casos de Uso

  • ✅ Exemplo: Liquidação Automática
    • Um PIX Imediato é gerado. 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 do usuário.
  • ❌ Erro Comum: Falha na Baixa Automática
    • O pagamento do PIX é recebido, mas a baixa automática falha (Ex: Lançamento inválido SQL-50001). O motivo da falha é registrado no campo ‘Baixa via API’, e o usuário deve resolvê-lo, permitindo que nas novas tentativas de baixa (realizadas por um Job) seja executado com sucesso.

FAQ – Dúvidas Frequentes

  1. O PIX Imediato está incluso na mensalidade padrão do ERP? O PIX Imediato é um produto pago que faz parte do Pacote Boleto Rápido da Sankhya Fintech. Este pacote possui uma cobrança mensal à parte (R$ 250,00/mês para 1.500 transações, com cobrança de excedente por transação acima do limite). 

  2. O que acontece se eu alterar o Valor Líquido do título com o PIX já gerado? Se o Valor Líquido for alterado, o PIX gerado anteriormente é cancelado automaticamente no banco. É necessário gerar um novo PIX para que o cliente pague o valor atualizado.

  3. O sistema valida os dados bancários (Agência, Conta e Chave PIX) no momento do credenciamento? Não. O sistema não realiza a validação dos dados bancários junto ao banco no momento do cadastro. É crucial que o usuário confira todas as informações com o gerente do banco antes de finalizar o credenciamento.

  4. O que significa a mensagem registrada no campo ‘Baixa via API’ da Movimentação Financeira? Este campo registra o status da operação PIX (Ex: Pix recebido, cancelado ou expirado) e também aponta os motivos de falha, caso a baixa automática não tenha sido realizada.

Artigos Relacionados

Esse artigo foi útil?
Usuários que acharam isso útil: 2 de 2

Comentários

0 comentário

Escreva seu comentário aqui

Por favor, entre para comentar.

Confira os outros artigos