Passar para o conteúdo principal

Integração Paggo & Sienge — Contas a Pagar e Contas a Receber

Introdução

Este artigo apresenta o passo a passo para configurar a integração entre a Paggo e o Sienge, contemplando os fluxos de Contas a Pagar, incluindo a configuração das conciliações automáticas, e de Contas a Receber.
​



Contas a Pagar


1 - Criação de usuário de API da Paggo

Essa etapa é importante para que a Paggo consiga realizar as integrações via API necessárias para entregar um sistema integrado com o seu ERP, evitando retrabalho do seu time.

A - Criação de Usuário

1. Na tela de início, no canto superior direito, clicar no ícone quadrado e depois em Integrações:

2. No menu da lateral esquerda, selecione Usuários de APIs e clique no botão azul Novo Usuário de API

3. Para realizar a criação, insira os seguintes dados:

  • Descrição: Paggo;

  • E-mail do acesso: e-mail orientado pela equipe da Paggo

    • {nome do cliente}@usuariointegracao.com.br

  • Nome de acesso: {nome do seu ambiente Sienge}- paggo;

  • Expiração da senha: preferencialmente Nunca expira;

4. Copiar senha clicando em Copiar. Salvar nome de usuário e senha em um local seguro para enviar posteriormente para a equipe da Paggo.


B - Liberação dos Acessos

Agora, com o usuário criado, iniciaremos a parte das liberações dos recursos que a Paggo irá consumir. O objetivo dessa etapa é liberar os recursos para esse usuário de API acessar determinadas informações do sistema, e dessa forma possibilitar a integração.
​

1. Acesse as autorizações no Sienge - Clique nos quadrados no canto superior esquerdo do Sienge e acesse Integrações > APIs > Usuários de APIs > e clique no ícone de lápis no Usuário Paggo.

2. Autorize por recurso - No campo de pesquisa em Pesquisar Recurso, digite o nome de cada uma das etapas listadas abaixo. Em seguida, marque o checkbox conforme a lista de cada item:

Seguem as autorizações necessárias para utilizar o módulo de Contas a Pagar integrado com a Paggo.

Contas a Pagar:

  • Pesquisar recurso: Empresas

    Autorizar todas.

  • Pesquisar recurso: Empreendimentos (Obra)

    Autorizar todas.

  • Pesquisar recurso: Contas-correntes

    Autorizar a rota.

  • Pesquisar recurso: Credores

    Autorizar todas as opções do tipo GET (azul) e POST (verde).

Exemplo da visualização:

  • Pesquisar recurso: Planos Financeiros

    Autorizar todas.

  • Pesquisar recurso: Títulos do Contas a Pagar

    Autorizar todas.

  • Pesquisar recurso: Parcelas do Contas a Pagar

    Autorizar todas.

  • Pesquisar recurso: Pedido de compra

    Autorizar todas as opções do tipo GET (azul).

  • Pesquisar recurso: Contratos de Suprimento

    Autorizar todas as opções do tipo GET (azul).
    ​

  • Pesquisar recurso: Gerenciamento de webhooks

    Autorizar todos
    ​

  • Pesquisar recurso: Documentos
    Autorizar a rota.
    ​

3. Agora você deve enviar para a equipe da Paggo:

  • Nome de acesso do usuário de API: se você seguiu o padrão orientado, deveria ser {nome do seu ambiente Sienge}-paggo.

  • Senha do usuário de API: a que foi copiada, conforme orientado.
    ​​



2 - Criação de usuário Paggo no Sienge com permissões necessárias.

Com o usuário de API criado, agora basta criar um usuário padrão no Sienge e fazer suas liberações. Para isso, também será necessário ser um usuário administrador no sistema.

A - Cadastro do Usuário

1. No menu lateral, acesse Segurança e depois em Usuário > Cadastros.

2. Clique em Novo.

3. Com a tela aberta no Cadastro de Usuário, inserir:

  • Código: o que preferir/estiver disponível

  • Nome: Usuário Integração(recomendação)

  • Cargo: o que preferir/estiver disponível

  • E-mail: Inserir o e-mail seguindo o formato:
    ​{nome do cliente}@usuariointegracao.com.br

4. Depois de salvo com sucesso, clique no botão Convidar para primeiro acesso e confirme para que seja concluído o cadastro!


B - Liberações

Com o usuário criado, agora é necessário que sejam feitas as liberações de acesso ao fluxo de baixa.

1. Clique em Autorizações > Usuários > Ações do Usuário.


​2. Realize as seguintes liberações.

2.1 Liberações Contas a Pagar:

  • Pesquisar pelo Usuário Paggo que foi cadastrado e Sistema “FIN-CPG” e clicar em Consultar.

  • Fazer apenas as liberações do tipo “FIN-CPG - Baixas” - pesquisar com CTRL + F pode ajudar na busca. Ao todo são 19 liberações, conforme tabela abaixo:

1559

FIN-CPG - Baixas - Alteração/Exclusão - Excluir

1541

FIN-CPG - Baixas - Alteração/Exclusão - Acréscimos - Calcular - Salvar

1539

FIN-CPG - Baixas - Alteração/Exclusão - Acréscimos - Salvar

1428

FIN-CPG - Baixas - Alteração/Exclusão - Consultar

1451

FIN-CPG - Baixas - Alteração/Exclusão - Editar

7057

FIN-CPG - Baixas - Alteração/Exclusão - Emitir Comprovante Pagamento Escritural

1458

FIN-CPG - Baixas - Alteração/Exclusão - Salvar

4055

FIN-CPG - Baixas - Estorno - Exclusão - Consultar

4058

FIN-CPG - Baixas - Estorno - Exclusão - Excluir

4054

FIN-CPG - Baixas - Estorno - Inclusão - Consultar

4056

FIN-CPG - Baixas - Estorno - Inclusão - Salvar

1316

FIN-CPG - Baixas - Inclusão - Baixa por Parcela - Editar

1315

FIN-CPG - Baixas - Inclusão - Baixa por Parcela - Salvar

1334

FIN-CPG - Baixas - Inclusões - Acréscimos - Calcular - Salvar

1332

FIN-CPG - Baixas - Inclusões - Acréscimos - Salvar

1256

FIN-CPG - Baixas - Inclusões - Consultar

1261

FIN-CPG - Baixas - Inclusões - Editar

1262

FIN-CPG - Baixas - Inclusões - Informações da Baixa - Salvar

1375

FIN-CPG - Baixas - Inclusões - Salvar

  • Além dessas liberações, caso sua empresa trabalhe com algum tipo de documento com acesso restrito ou confidencial, liberar as flag “Autorizado a processar informações de documentos confidenciais de funcionários” e “ Autorizado a acessar informações no contas a pagar de tipos de documento de acesso restrito” para o usuário da Paggo em Segurança / Autorizações / Usuários / Financeiro:


​

2.2 Liberação por Empresa:

  • Em seguida, liberar usuário para as Empresas.

  • Inserir

    • Usuário: identificador do Usuário paggo

    • Função: 1

  • Clicar em Consultar e marcar as Empresas para as quais os pagamentos serão realizados via Paggo.
    ​

2.3 Liberação por Obra:

  • Em seguida, liberar usuário para as Obras.

  • Clicar em Segurança > Autorizações > Usuários > Obras.

  • Na tela de Autorizações de Usuários Por Obra, inserir:

    • Usuário: identificador do Usuário Paggo.

    • Função: 6 e 12.

  • Clique em Consultar e marcar as Obras para as quais os pagamentos serão realizados via Paggo.

Com isso, encerra-se o passo de liberações, restando apenas o cadastro da conta corrente Paggo e que pode ser visto abaixo.
​


​2.4 Liberação por departamento.
​
Acessar a tela: Segurança / Autorizações / Usuários / Departamentos.
​
Nesta tela consultar o Usuário, Departamento e Função 04 - Manutenção dos dados do departamento no módulo Financeiro. Com essa autorização, o usuário poderá consultar e realizar lançamentos, que tenham esse departamento associado, bem como relatórios financeiros.
​


​
​Conclusão: Com isso, já devemos ter todas as criações e liberações necessárias para a Integração. Ao final do processo:

  • Notificar equipe da Paggo de que o usuário Sienge e Conta Corrente já estão criados

  • Equipe da Paggo testará os acessos. ​​

Atenção: Por conta de parametrizações e especificidades do seu ambiente do Sienge, pode ser necessário fazer liberações adicionais. A equipe da Paggo informará se todos os acessos estão adequadamente configurados!​
​



Ação necessária para que a Conciliação seja realizada.

Garantir que as contas da Paggo estejam cadastradas corretamente no Sienge, com o campo “Identificador OFX” devidamente preenchido.
​


​




Contas a Receber


1 - Liberação de usuário de API da Paggo

Essa etapa é essencial para permitir que a Paggo realize as integrações via API com seu ERP, garantindo um sistema integrado e evitando retrabalho para sua equipe.

A - Liberação dos Acessos

Se a empresa já utiliza a Paggo no Contas a Pagar, um usuário de API já foi criado. Agora, é necessário liberar os recursos para que esse usuário possa acessar informações do sistema e viabilizar a integração do Contas a Receber.
​

Atenção: Para realizar estas ações, é necessário ser um usuário administrador no Sienge.
​

1. Acesse as autorizações no Sienge - Clique nos quadrados no canto superior esquerdo do Sienge e acesse Integrações > APIs > Usuários de APIs > e clique no ícone de lápis no Usuário Paggo.

2. Autorize por recurso - No campo de pesquisa em Pesquisar Recurso, digite o nome de cada uma das etapas listadas abaixo. Em seguida, marque o checkbox conforme a lista de cada item:

As autorizações para utilizar o módulo de Contas a Receber são as seguintes:

Contas a Receber:

  • Pesquisar recurso: Contratos de Vendas (Tipo de recurso: Transacional)

    Autorizar todas as opções do tipo GET (azul) e POST (verde).

  • Pesquisar recurso: Contrato de Vendas (Tipo de recurso: Massivo)

    Autorizar todas.

  • Pesquisar recurso: Parcelas do Contas a Receber

    Autorizar todas.

  • Pesquisar recurso: Títulos do Contas a Receber

    Autorizar todas.

  • Pesquisar recurso: Unidades de Imóveis

    Autorizar as opções do tipo GET (Azul).

  • Pesquisar recurso: Indexadores

    Autorizar todas.

  • Pesquisar recurso: Clientes

    Autorizar todas as opções do tipo GET (azul) e POST (verde).

  • Pesquisar recurso: Reparcelamentos

    Autorizar todas.

  • Pesquisar recurso: Tipos de Condições de Pagamento

    Autorizar toda.

  • Pesquisar recurso: Portadores para o Contas a Receber

    Autorizar todas.
    ​

  • Pesquisar recurso: Gerenciamento de webhooks

    Autorizar todos


    ​



​

2 - Criação de usuário Paggo no Sienge com permissões necessárias

Após configurar o usuário de API, é necessário conceder as permissões ao usuário padrão no Sienge. Para isso, é fundamental ser um usuário administrador no sistema.​
​
​
​2.1 Liberações Contas a Receber:

  • Fazer apenas as liberações do tipo “FIN-CRC - Baixas” - pesquisar com CTRL + F pode ajudar na busca. Ao todo são 15 liberações, conforme tabela abaixo:

2325

FIN-CRC - Baixas - Alterações/Exclusões - Apropriações de Desconto - Consultar

1721

FIN-CRC - Baixas - Alterações/Exclusões - Consultar

1727

FIN-CRC - Baixas - Alterações/Exclusões - Editar

1729

FIN-CRC - Baixas - Alterações/Exclusões - Excluir

3258

FIN-CRC - Baixas - Alterações/Exclusões - Excluir Multiplas

1728

FIN-CRC - Baixas - Alterações/Exclusões - Salvar

246

FIN-CRC - Baixas - Importar do Arquivo - Confirmar

2324

FIN-CRC - Baixas - Inclusão - Apropriações de Desconto - Consultar

5953

FIN-CRC - Baixas - Inclusão - Baixa por Parcela - Acréscimo - Descontos

1645

FIN-CRC - Baixas - Inclusão - Baixa por Parcela - Editar

1646

FIN-CRC - Baixas - Inclusão - Baixa por Parcela - Salvar

1601

FIN-CRC - Baixas - Inclusão - Consultar

2499

FIN-CRC - Baixas - Inclusão - Informações da Baixa

1643

FIN-CRC - Baixas - Inclusão - Seleção de parcelas - Seguros

1679

FIN-CRC - Baixas - Inclusões - Seleção de parcelas - Salvar

  • Além dessas liberações descritas, liberar a flag "Autorizado a configurar/conceder descontos e acréscimos nos contratos, títulos e baixas" para o usuário da Paggo em Segurança / Autorizações / Usuários / Financeiro:

2.2 Liberação por Empresa:

  • Em seguida, liberar usuário para as Empresas.

  • Inserir

    • Usuário: identificador do Usuário paggo

    • Função: 1

  • Clicar em Consultar e marcar as Empresas para as quais os pagamentos serão realizados via Paggo.
    ​

2.3 Liberação por Obra:

  • Em seguida, liberar usuário para as Obras.

  • Clicar em Segurança > Autorizações > Usuários > Obras.

  • Na tela de Autorizações de Usuários Por Obra, inserir:

    • Usuário: identificador do Usuário Paggo.

    • Função: 6 e 12.

  • Clique em Consultar e marcar as Obras para as quais os pagamentos serão realizados via Paggo.

Com isso, encerra-se o passo de liberações, restando apenas o cadastro da conta corrente Paggo e que pode ser visto abaixo.


3 - Cadastro e liberação das contas correntes na Paggo

O passo a passo abaixo tem por objetivo criar o registro de uma conta da Paggo dentro do Sienge. Com esse registro, temos a capacidade de parametrizar a baixa automática de parcelas pagas via Paggo.

Uma vez encerrado o passo a passo, basta avisar o time da Paggo para que possamos finalizar a parametrização.

Criar o registro do banco Celcoin no Sienge.

1. Acesse Apoio > Contas Correntes > Bancos.

2. Na tela de Cadastro de Bancos, clique em Adicionar e Insira:

  • Código: 509;

  • Nome: Celcoin Pagamentos S.A.;

  • Tam. dig. conta: Nenhum;

  • Tam. dig. ag.: Nenhum;

  • Tam. dig. DAC: Nenhum;

  • Valor Limite J52*: R$2000 (não é relevante);


​
​


B - Criar a conta Paggo como Conta Corrente do Sienge

Para cadastrar as contas correntes no Sienge, utilize as informações de conta bancária conforme enviado pela equipe da Paggo!

1. Acesse Apoio > Contas Correntes > Cadastros.

2. Na tela de Contas Correntes, clique em Novo.

3. Preencha os campos conforme abaixo (campos não mencionados poderão ser preenchidos como desejarem):

Informações Gerais:

*Para essa etapa, você precisará dos dados da sua conta Paggo. Se precisar de ajuda para encontrá-los, clique aqui para acessar as orientações.

  • Conta: [número da conta da Paggo];

  • Nome: Conta Paggo (flexível caso queiram que seja outro nome);

  • Máscara: [número da conta da Paggo];

  • Empresa: [Empresa do Sienge referente a Organization dona da conta bancária];

Informações do Cadastro Bancário:

  • Banco: 509;

  • Nome agência: 0001;

  • Nome agência: Celcoin Pagamentos S.A.;

  • Número da conta: [número da conta Paggo];

  • Identificador conciliação OFX: [número da conta Paggo];

Inicialização de Saldo:

  • Data: data do cadastro da conta;

  • Saldo: 0;


Como encontrar os dados da sua conta Paggo:

Acesse a plataforma dentro do módulo de Contas Bancárias > Contas Paggo > clique em Depositar.

Em seguida clique em Copiar as informações bancárias para acessar os dados da conta selecionada.

Agora você pode visualizar todos os dados da sua conta Paggo e consultar ou copiar as informações necessárias.


Conclusão

Com isso, já devemos ter todas as criações e liberações necessárias para a Integração. Ao final do processo:

  1. Passar o usuário de API e senha para o time Paggo;

  2. Notificar equipe da Paggo de que o usuário Sienge e Conta Corrente já estão criados;

  3. Equipe da Paggo testará os acessos;

ATENÇÃO: por conta de parametrizações e especificidades do seu ambiente do Sienge, pode ser necessário fazer liberações adicionais. A equipe da Paggo informará se todos os acessos estão adequadamente configurados!

Respondeu à sua pergunta?