Módulo: Comercial › Rotinas
Telas associadas: Central de Vendas · Contas · Tipos de Título · Tipos de Negociação · Tela Preferências · Preferências da Empresa · Movimentação Financeira
Versão disponível: Sankhya Om 4.31 ou superior. Para contas do Banco do Brasil com PIX Integrado, 4.35b226 ou superior.
Você encontra neste artigo:
O que é e para que serve
O recebimento via PIX na tela Central de Vendas gera o QR Code do PIX no momento da confirmação da nota, na própria tela de baixa do título. O cliente paga na hora e o título é baixado sem que você precise sair da Central de Vendas.
Este artigo trata só do recebimento na Central de Vendas. O PDV Web e o Sankhya Checkout têm configuração própria de PIX, descrita nos artigos de cada um.
Geração do PIX por banco
A forma de gerar o PIX depende do banco da conta usada na baixa:
- Banco do Brasil: desde 31/03/2026, com a descontinuação da API V1 do banco, o PIX é gerado exclusivamente pelo PIX Integrado da Sankhya Fintech. Você precisa contratar o serviço e credenciar a conta.
- Demais bancos: o PIX continua sendo gerado pela integração direta com a API do banco, a partir das credenciais cadastradas na tela Contas.
Antes de começar
Contratação do PIX Integrado (Banco do Brasil)
Se a conta da baixa for do Banco do Brasil, a empresa precisa ter:
- o Pacote Boleto Rápido contratado no Marketplace do Sankhya Om, que inclui o PIX Integrado
- o Sankhya ID ativado e conectado
Para saber mais, acesse Contratação e cobrança dos serviços Sankhya Finance: Automação Bancária.
Permissões
Quem faz a configuração inicial precisa de:
- acesso à tela Tipos de Negociação
- no Banco do Brasil, acesso à tela Assistente de Melhores Práticas, para o credenciamento no PIX Integrado
Usuários do tipo SUP não podem cancelar o contrato do serviço.
Quem recebe via PIX na Central de Vendas precisa de:
- acesso à tela Central de Vendas
- acesso Baixa de Receita da tela Movimentação Financeira, no cadastro de acessos do usuário ou do grupo
Configurações necessárias
A configuração da conta bancária muda conforme o banco. As configurações de Tipo de Título, Tipo de Negociação, parâmetro BXARTITSEMPERG e Nota Técnica são necessárias para todos os bancos, inclusive o Banco do Brasil.
Conta bancária
Conta do Banco do Brasil
Credencie a conta no PIX Integrado em Configurações › Rotinas › Assistente de Melhores Práticas › PIX Integrado.
Na etapa Ações Automáticas do credenciamento, informe na Baixa Automática um Tipo de Título ativo e com Subtipo PIX. Para o título ser baixado automaticamente após o pagamento, configure também a Baixa Automática e a Conciliação Automática com opções diferentes de Não realizar.
Para ver o passo a passo de cada etapa do credenciamento, acesse PIX imediato.
A conta do título deve ser exatamente a mesma conta credenciada no PIX Integrado.
O Sankhya Om não valida os dados bancários junto ao banco no momento do credenciamento. Confirme os dados com o gerente da conta antes de prosseguir.
Conta de outros bancos
Na tela Contas, acesse o cadastro da conta que será usada na baixa e preencha na aba Pix:
- Chave da API PIX
- Client Secret Pix
- Client ID Pix
- Chave Pix
Tipo de Título
Na tela Tipos de Título, aba Geral, selecione no campo Tipo de pgto para NFC-e / NF-e / CF-e a opção 17-Pagamento Instantâneo (PIX). Preencha também o campo Parc. Administradora.
O Tipo de Título também precisa estar ativo e com Subtipo PIX.
Tipo de Negociação
Acesse Comercial › Cadastros › Tipos de Negociação e, na aba Parcelas:
- No campo Tipo de Título, vincule o Tipo de Título configurado no passo anterior.
- Marque Baixa na Confirmação.
É essa marcação que faz a tela de baixa abrir no momento da confirmação da nota, onde fica a opção de receber via PIX.
Parâmetro BXARTITSEMPERG
Na Tela Preferências, deixe desativado o parâmetro Baixar título na central sem perguntar? (BXARTITSEMPERG).
Se ele estiver ativado, a tela de baixa não é exibida, mesmo com a marcação Baixa na Confirmação ativa. Nesse caso, a baixa é feita automaticamente, sem confirmação manual e sem a opção de receber via PIX.
Nota Técnica
Na tela Preferências da Empresa, aba Documentos Fiscais Eletrônicos, sub-aba NF-e/NFC-e › Nota Técnica NF-e, verifique se a empresa emissora está com a Nota Técnica 2023.004 - v.1.11 ativa.
Recebimento via PIX na Central de Vendas
-
Na tela Central de Vendas, lance a nota com um Tipo de Negociação que tenha a marcação Baixa na Confirmação ativa.
-
Clique em Confirmar. A tela Baixa de Títulos é exibida.
-
Em Movimentação bancária, confira o campo Conta.
O botão Receber com Pix só aparece quando a conta informada tem PIX configurado. No Banco do Brasil, a conta precisa estar credenciada no PIX Integrado.
-
Clique em Receber com Pix.
-
No pop-up Receber com PIX, peça ao cliente que escaneie o QR Code ou compartilhe o código usando Copiar código Pix.
O pop-up também mostra o valor do PIX e a data e a hora de expiração. Nele, você também pode:
- Baixar PDF: gera o QR Code em PDF para impressão ou envio ao cliente.
- Cancelar PIX: cancela a cobrança antes do pagamento.
-
Quando o pagamento é identificado, o pop-up exibe "PIX recebido com sucesso!", com o valor recebido, a data e a hora do pagamento e o ID da transação. Clique em Finalizar.
O status do PIX fica registrado no campo Baixa via API da tela Movimentação Financeira. No PIX Integrado (Banco do Brasil), o título é baixado automaticamente quando as Ações Automáticas estão configuradas no credenciamento, conforme Conta do Banco do Brasil.
Quando o PIX Integrado não está contratado
Se a conta da baixa for do Banco do Brasil e o PIX Integrado não estiver contratado, o Sankhya Om impede a geração do PIX e exibe a mensagem "Você ainda não contratou o PIX Integrado", com o texto "Esse serviço só está disponível para quem já contratou o PIX Integrado. Com ele, você pode emitir PIX imediato de forma simples e integrada ao seu ERP. Acesse a tela: Configurações >> Rotinas >> Assistente de Melhores Práticas e procure por Pix integrado e realize a contratação".
Para resolver, faça a contratação do PIX Integrado e o credenciamento da conta.
Pontos de atenção do PIX Integrado
Estes pontos valem para contas do Banco do Brasil, com PIX Integrado:
- Alteração de valor: se o valor do título for alterado depois de gerado o PIX, o PIX anterior é cancelado e um novo deve ser gerado.
- Expiração: o PIX vale por 24 horas. Depois disso, o campo Baixa via API registra PIX expirado e você pode gerar um novo PIX para o mesmo título.
- Cancelamento: pode ser feito no próprio pop-up, antes do pagamento.
- Impressão: o QR Code é gerado em PDF.
Perguntas frequentes
Preciso configurar o Tipo de PIX "PIX Fintech" em Preferências da Empresa para usar PIX na Central de Vendas?
Não. Essa configuração é usada apenas pelo PDV Web e pelo Sankhya Checkout, e a Central de Vendas não considera esse campo. Para configurar o PIX nesses canais, acesse PIX Imediato e Integração no PDV Web, PIX Imediato e Checkout (PDV) e Novo PIX Integrado (Banco do Brasil) no PDV e Sankhya Checkout.
Preciso preencher a aba Pix da tela Contas?
Depende do banco. Para contas do Banco do Brasil, não: o PIX usa o credenciamento feito no PIX Integrado. Para os demais bancos, sim: as credenciais da aba Pix são obrigatórias.
Por que o botão Receber com Pix não aparece na confirmação da nota?
Verifique estes pontos:
- marcação Baixa na Confirmação ativa no Tipo de Negociação, aba Parcelas
- parâmetro
BXARTITSEMPERGdesativado - Tipo de Título com o tipo de pagamento 17-Pagamento Instantâneo (PIX) e Subtipo PIX
- conta da baixa configurada para PIX
Preciso acessar a Movimentação Financeira para gerar o PIX?
Não. O PIX é gerado na própria Central de Vendas, após a confirmação da nota. Mas você precisa ter o acesso Baixa de Receita da tela Movimentação Financeira.
O PIX gerado na Central de Vendas aparece na Movimentação Financeira?
Sim. O título da venda registra o status do PIX no campo Baixa via API (recebido, cancelado ou expirado).
Comentários
0 comentário
Escreva seu comentário aqui
Por favor, entre para comentar.