Introdução
Este artigo apresenta o passo a passo para configurar a integração entre a Paggo e o Sienge no módulo de 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.
Artigo do Sienge: Como liberar recursos para Usuários de APIs?
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 as opções do tipo GET (azul) e POST (verde).
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.
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:
3.1 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.
3.2 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.
A - 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);