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
2 - Criação de usuário Paggo no Sienge com permissões necessárias
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 criado na etapa
{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!