Pix Integrado App x Linx DMS Apollo
Pix Integrado (App) com Linx DMS Apollo
Este artigo explica como configurar, no Linx DMS Apollo, a integração do Pix com a plataforma Movisis.
Pré-requisito: tenha em mãos os dados da conta Pix utilizada na plataforma Movisis para replicar as mesmas informações no DMS.
1. Consultar os parâmetros na Plataforma Movisis
Antes de configurar o DMS, identifique os códigos que deverão ser espelhados.
Caminho: Financeiro → Parâmetros Financeiros → Pix → aba Aplicativo → selecione o aplicativo desejado.
Passo a passo (imagem abaixo):
- No menu lateral, acesse Financeiro → Parâmetros Financeiros.
- Na coluna de categorias, clique em Pix.
- Na parte superior, selecione a aba Aplicativo.
- Selecione o Grupo de Lojas desejado.
- Anote os valores preenchidos em Parâmetros de Integração Pix:
- Banco
- Grupo
- Transação
- Origem de Pagamento
- Condição de Pagamento do Adiantamento
2. Configurações no Linx DMS Apollo
A partir de agora, todos os cadastros devem ser feitos no Linx DMS Apollo, utilizando os mesmos códigos identificados na Movisis.
2.1. Banco (Carteira)
É necessário criar um banco específico para essa modalidade. A parametrização segue o mesmo padrão dos demais bancos, alterando apenas as informações de agência e conta do banco utilizado pelo Pix.
Caminho: Financeiro → Cadastros → Bancos.
Passo a passo:
- Acesse o menu Financeiro → Cadastros → Bancos.
- Na tela Manutenção de Bancos e Agências, clique em + Novo Banco.
- Preencha os campos:
- Código (ex.:
944) - Nro. Banco, Dígito Banco, Nome do Banco
- Carteira, Nro. Agência, Dígito Agência, Nome da Agência
- Código (ex.:
- Na aba Dados Gerais, informe Nro. da Conta, Dígito Conta e demais campos exigidos pelo banco.
- Clique em Salvar.
2.2. Grupo Bancário
É possível utilizar um grupo já existente ou cadastrar um específico para o Pix.
Caminho: Financeiro → Cadastros → Grupos Bancários.
Passo a passo:
- Acesse Financeiro → Cadastros → Grupos Bancários.
- Na tela Manutenção de Grupos Bancários, clique em + Inserir.
- Informe Código (ex.:
499) e Descrição (ex.:PIX APP). - Clique em Salvar.
2.3. Transação Bancária
É possível utilizar uma transação já existente ou cadastrar uma específica para o Pix.
Caminho: Financeiro → Cadastros → Transações Bancárias.
Passo a passo:
- Acesse Financeiro → Cadastros → Transações Bancárias.
- Na tela Manutenção de Transações Bancárias, clique em + Inserir.
- Informe Código (ex.:
499) e Descrição (ex.:PIX APP). - Clique em Salvar.
2.4. Tela de Manutenção de Adiantamentos
A imagem a seguir mostra como os campos configurados se relacionam na tela de Manutenção de Adiantamentos (545).
Pontos de atenção destacados:
- Confira o campo Tipo de Cobrança (deve corresponder ao Pix App).
- Confira o campo Transação (deve apontar para a transação criada, ex.:
499 PIX APP). - Os campos Grupo, Origem (Conforme ref. cruzada) e Banco devem refletir os códigos cadastrados.
2.5. Origem de Pagamento
Essa origem deve ser criada pela Contabilidade, sendo específica para o PIX APP.
Importante: será necessário, posteriormente, amarrar a Ref. Financeiro nessa origem. Lembre-se de que existem duas referências: uma para o lançamento e outra para a baixa do adiantamento, além da Tarifa do Cartão.
Caminho: Financeiro → Cadastros → Origens Pagamentos.
Passo a passo:
- Acesse Financeiro → Cadastros → Origens Pagamentos.
- Na tela Manutenção de Origens de Pagamento, clique em + Inserir.
- Preencha:
- Código (ex.:
655) - Descrição (ex.:
ADTO CLIENTE PIX APP)
- Código (ex.:
- Em Tipo da Origem, marque Outros.
- Em Adiantamentos, marque Ambos.
- Acesse a aba Ref. Financeiro e relacione as referências cruzadas que serão criadas na etapa 2.7 (ex.:
7767 CT,7768 CT,7769 AD,7782 AD,7796 AD). - Clique em Salvar.
2.6. Condição de Pagamento do Adiantamento
Essa condição deve ser criada pela Contabilidade/Financeiro, sendo específica para o PIX APP.
Dica: copie a condição atualmente utilizada para adiantamento de cliente e ajuste o que for necessário.
Caminho: Faturamento → Cadastros → Condições Pagamento.
Passo a passo:
- Acesse Faturamento → Cadastros → Condições Pagamento.
- Na tela Manutenção de Condições de Pagamento, clique em + Inserir.
- Preencha Código (ex.:
499) e Descrição (ex.:ADTO CLIENTE PIX APP). - Em Tipo de Pagamento, marque Adiantamento.
- Em Grupo de Pagamento - Agrupar Frente Caixa, selecione o grupo desejado (ex.:
1). - Clique em Salvar.
2.7. Código de Referência Cruzada
A Contabilidade/Financeiro deve cadastrar essas referências e amarrar cada uma à Ref. Financeiro da Origem de Pagamento criada na etapa 2.5.
Atenção: são duas referências principais — uma para o lançamento do adiantamento e outra para a baixa (as “duas pernas” da operação). Além delas, podem existir referências adicionais para estorno, cartão de crédito e tarifa.
Caminho: Financeiro → Cadastros → Referência Cruzada.
Passo a passo geral (repetir para cada referência):
- Acesse Financeiro → Cadastros → Referência Cruzada.
- Na tela Manutenção de Referência Cruzada, clique em + Inserir.
- Informe o número da Referência Cruzada (ex.:
7767,7768,7769,7782,7796). - Preencha Tipo Título, Operação, Tipo Cobrança, Banco e Origem Pagamento conforme o modelo de cada referência (tabela abaixo).
- Clique em Cód.Contábil e relacione o código contábil correspondente.
- Quando aplicável, acesse a aba Adicional Cartão de Crédito e informe a Taxa Administradora (ex.:
2300 TARIFA APP RECEBIMENTO). - Clique em Salvar.
Modelos de Referência Cruzada:
| Ref. | Tipo Título | Operação | Tipo Cobrança | Banco | Origem |
|---|---|---|---|---|---|
| 7767 | Cartão de Crédito | Lançamento | Cobrança Simples | 944 — ASAAS | 655 — ADTO CLIENTE PIX APP |
| 7768 | Cartão de Crédito | Baixa | Cobrança Simples | 944 — ASAAS | 655 — ADTO CLIENTE PIX APP |
| 7769 | Adiantamento | Lançamento | Adiantamento com Cheque | — | 655 — ADTO CLIENTE PIX APP |
| 7782 | Adiantamento | Estorno de Pagamento | Cobrança Simples | 944 — ASAAS | 655 — ADTO CLIENTE PIX APP |
| 7796 | Adiantamento | Baixa | Pagamento por Conta | — | 655 — ADTO CLIENTE PIX APP |
Referência 7767 — Cartão de Crédito (Lançamento)
Referência 7768 — Cartão de Crédito (Baixa)
Referência 7769 — Adiantamento (Lançamento)
Referência 7782 — Adiantamento (Estorno de Pagamento)
Referência 7796 — Adiantamento (Baixa)
Lembre-se: é necessário criar e relacionar o Código Contábil para cada uma das referências acima.
3. Códigos Contábeis
O código contábil é criado em Faturamento → Cadastros → Códigos Contábeis e deve ser relacionado às descrições e contas de Débito e Crédito, além de vinculado à Ref. Financeira criada anteriormente.
A Conta Contábil pode ser nova e específica para o Pix ou uma já existente, conforme o modelo de cada código.
3.1. Código 2299 — ADIANTAMENTO VENDAS PIX
Passo a passo:
- Acesse Faturamento → Cadastros → Códigos Contábeis.
- Clique em + Inserir e informe Código
2299e DescriçãoADIANTAMENTO VENDAS PIX. - Na aba Cadastro, informe:
- Conta Contábil Débito:— BANCO ASAAS 2253458-0 (944)
- Conta Contábil Crédito:— ADIANTAMENTO DE CLIENTES VENDAS PIX
- Em Tipo Referência, marque Todos.
- Acesse a aba Ref. Financeiro e vincule a referência 7769 (AD).
- Clique em Salvar.
3.2. Código 2300 — TARIFA APP RECEBIMENTO VIA PIX
Passo a passo:
- Acesse Faturamento → Cadastros → Códigos Contábeis.
- Clique em + Inserir e informe Código
2300e DescriçãoTARIFA APP RECEBIMENTO VIA PIX. - Na aba Cadastro, informe:
- Conta Contábil Débito: — TAXA OPERAÇÃO PIX APP
- Conta Contábil Crédito: — BANCO ASAAS 2253458-0 (944)
- Em Tipo Referência, marque Todos.
- Acesse a aba Ref. Financeiro e vincule as referências 7767 (CT) e 7769 (AD).
- Clique em Salvar.
4. Contas Contábeis
Os códigos contábeis acima dependem de contas previamente cadastradas em Manutenção Conta Contábeis. Verifique se as três contas abaixo já existem e, caso contrário, faça o cadastro.
Passo a passo (repetir para cada conta):
- Acesse Manutenção Conta Contábeis.
- Pesquise pelo número da conta. Se não existir, clique em + Inserir.
- Preencha Conta, Máscara, Descrição e Conta Superiora.
- Defina Natureza (Ambos) e Nível (Analítico).
- Marque Incluir nos relatórios.
- Clique em Salvar.
5. Reintegração Contábil (rotina em produção)
Quando a integração estiver em produção, oriente a Contabilidade a executar a Reintegração Contábil Financeiro para garantir que os títulos sejam integrados corretamente.
Caminho: Financeiro → Lançamentos → Reintegração Contábil Financeiro.
Passo a passo:
- Acesse Financeiro → Lançamentos → Reintegração Contábil Financeiro.
- Na aba Filtro, em Tipo de Lançamento, marque Adiantamento.
- Em Operação, marque Lançamento.
- Informe o intervalo em Data Emissão (ex.:
31/01/2025a31/01/2025). - Marque a opção Apenas Títulos Não Integrados.
- Clique em Procurar.
- Acesse a aba Resultado e confira os títulos retornados.
- Clique com o botão direito sobre a lista e selecione Reintegração Geral.
Resumo da configuração
| Item | Onde configurar | Exemplo |
|---|---|---|
| Banco (Carteira) | Financeiro → Cadastros → Bancos | 944 |
| Grupo Bancário | Financeiro → Cadastros → Grupos Bancários | 499 PIX APP |
| Transação Bancária | Financeiro → Cadastros → Transações Bancárias | 499 PIX APP |
| Origem de Pagamento | Financeiro → Cadastros → Origens Pagamentos | 655 ADTO CLIENTE PIX APP |
| Condição de Pagamento | Faturamento → Cadastros → Condições Pagamento | 499 ADTO CLIENTE PIX APP |
| Referência Cruzada (Lançamento) | Financeiro → Cadastros → Referência Cruzada | 7769 AD |
| Referência Cruzada (Baixa) | Financeiro → Cadastros → Referência Cruzada | 7796 AD |
| Código Contábil (Adiantamento) | Faturamento → Cadastros → Códigos Contábeis | 2299 |
| Código Contábil (Tarifa) | Faturamento → Cadastros → Códigos Contábeis | 2300 |
Observação final: os códigos numéricos apresentados (
944,499,655,7767–7796,2299,2300, contas contábeis etc.) são exemplos baseados no ambiente de referência. Os valores reais devem ser definidos pela Contabilidade/Financeiro de cada cliente conforme o plano de contas em uso.
💬 Dúvidas ou dificuldades? Entre em contato com o suporte Movisis através da nossa central de atendimento:
🔗 suporte.movisis.com.br