Introdução
Usuário, permissões, liberações e cadastros que o administrador do UAU prepara antes de integrar o Contas a Pagar.
Este artigo lista o que a sua equipe configura no UAU para a Paggo integrar o Contas a Pagar. Com tudo liberado, a Paggo lê os processos de pagamento das obras integradas e registra a baixa no UAU. A configuração é feita uma vez, nos ambientes de produção e de homologação.
1. Onde fazer a configuração e quem faz
A configuração acontece fora da Paggo, em três lugares: no UAU, no portal do cliente UAU e no servidor onde o UAU guarda os anexos.
Etapa | Onde | Quem faz |
1 a 4 | UAU | Administrador do UAU |
5 | Portal do cliente UAU | Usuário com acesso ao portal [validar: perfil exigido no portal] |
6 | Servidor de arquivos do UAU | TI da sua empresa |
7 | Documentação da sua instalação do UAU | TI da sua empresa ou a Senior |
Antes de começar, peça à equipe da Paggo os dados da conta Paggo. Você vai usá-los na etapa 4.
2. Etapa 1: Criar o usuário da Paggo no UAU
Crie no UAU um usuário exclusivo para a integração com a Paggo, em produção e em homologação.
Use uma senha só com letras e números, sem caracteres especiais como #, @ ou $.
Guarde o login e a senha. Eles vão para a equipe da Paggo no fim da configuração.
3. Etapa 2: Liberar os programas do usuário
No UAU, cada permissão é dada por programa e por operação. Aplique ao usuário da Paggo os programas das tabelas abaixo, com a operação indicada, em produção e em homologação.
Atenção: a liberação de cada programa vale por empresa e obra. Quando uma obra nova passar a operar com a Paggo, repita a liberação para ela.
3.1. Programas do Contas a Pagar
Estes programas são obrigatórios. Com eles, a Paggo lê os processos de pagamento e registra a baixa no UAU.
Programa | Operação | Para que serve |
GEBCOPES (nível 2) | Alteração | Consultar as contas bancárias |
FID, FIV e FIQ | Alteração | Aprovar o DVQ: data, valor e quantidade |
FICHEQUE e FICHEQUEEMISSAO | Alteração | Aprovar os processos e a emissão |
FIEMISSAOPGTO | Alteração | Emitir os pagamentos |
FIRELPROC | Alteração | Lançar acréscimos e descontos |
FIANALISE | Alteração | Manter o processo e confirmar para emissão |
CLPROVISIONADO | Alteração | Acessar os processos provisionados |
FIALTERADTPRORROG, FIDATAPROC e FIVENCTOPROC | Alteração | Alterar as datas do processo |
3.2. Programas da entrada de notas fiscais
Libere estes programas só se a sua empresa vai usar a entrada de notas fiscais pela Paggo. Com eles, a Paggo lança a nota no processo de pagamento e cadastra fornecedores novos no UAU.
Programa | Operação | Para que serve |
CLDOCFISC | Inclusão | Lançar a nota fiscal no processo de pagamento |
GEBCOPES | Inclusão | Cadastrar a conta bancária do fornecedor |
FIPIXPGTO | Inclusão | Cadastrar a chave PIX do fornecedor |
GETELPES | Consulta | Consultar o telefone do fornecedor |
OBPLNOBR | Consulta | Consultar o planejamento da obra para validar o orçamento |
A entrada de notas também usa os programas FIANALISE e FIVENCTOPROC, já liberados na seção 3.1. No GEBCOPES, mantenha a Alteração da seção 3.1 e acrescente a Inclusão.
4. Etapa 3: Liberar o usuário nas obras
O usuário da Paggo precisa consultar os dados financeiros de todas as obras que vão operar com a Paggo. Libere o usuário em cada uma delas, em produção e em homologação.
O passo a passo está nos artigos da Senior:
Atenção: se uma obra integrada não estiver liberada, a consulta da Paggo ao UAU pode falhar para todas as obras. Confira a liberação obra a obra.
5. Etapa 4: Conferir os cadastros no UAU
Antes do primeiro pagamento pela Paggo, confira se o UAU tem estes cadastros:
Banco Celcoin, código 509, no Cadastro de Bancos, com a razão social Celcoin Pagamentos S/A. Sem ele, não dá para cadastrar a conta Paggo.
Conta Paggo, no Cadastro de Bancos, com instituição, agência, conta e chave PIX. Os dados vêm da equipe da Paggo.
Empresas e obras que vão operar com a Paggo, cadastradas e ativas. A lista com os CNPJs e as obras é alinhada antes com a equipe da Paggo.
Ao registrar a baixa, a Paggo informa no processo o banco 509 e a conta Paggo usada no pagamento.
6. Etapa 5: Autorizar a Paggo no portal do cliente UAU
A Paggo usa as APIs do UAU como desenvolvedor autorizado pela sua empresa. Faça a autorização para produção e para homologação.
Acesse o portal do cliente UAU em https://clientes.uau.com.br/wbfGerenciarDev.aspx. A tela Configuração de ambientes de integração abre.
Na aba Gerenciar integração, busque por "paggo" no campo Desenvolvedor.
Selecione 10609 - PAGGO TECNOLOGIA LTDA. e confirme em [validar: rótulo do botão de autorização].
Repita a autorização para o ambiente de homologação. [validar: como a tela separa produção e homologação]
Na aba Painel de integração, copie o token de integração de produção e o de homologação.
Atenção: a busca por "paggo" mostra dois desenvolvedores. Selecione o 10609 - PAGGO TECNOLOGIA LTDA., não o 10601.
Print 6 (anexo print-6.png)
7. Etapa 6: Liberar a pasta de anexos
A Paggo lê os anexos dos processos de pagamento pela API do UAU. Para isso, a pasta onde o UAU guarda esses anexos precisa de leitura recursiva liberada para a integração. [validar: para qual usuário a TI libera a pasta]
Libere a leitura na pasta de anexos e em todas as subpastas, em produção e em homologação.
Anote o caminho completo da pasta. Ele vai para a equipe da Paggo no fim da configuração.
Exemplo de caminho: \\<servidor>\uau\<id>\#Arquivos\Anexos\02-PROCESSOS DE PAGAMENTO\<empresa>
8. Etapa 7: Confirmar os dados da API do UAU
Confirme com a sua TI ou com a Senior estes dados, para produção e para homologação:
O endereço da API do UAU.
A documentação da API do UAU.
A versão do UAU instalada.
9. Concluindo a configuração
Envie à equipe da Paggo, por um canal seguro, os dados de produção e de homologação:
Endereço e documentação da API do UAU.
Token de integração copiado no portal do cliente UAU.
Login e senha do usuário da Paggo no UAU.
Caminho da pasta de anexos.
Confirme também que:
O desenvolvedor 10609 está autorizado no portal do cliente UAU.
Todos os programas da seção 3 estão liberados para o usuário da Paggo.
O usuário da Paggo está liberado em todas as obras que vão operar com a Paggo.
A pasta de anexos tem leitura recursiva liberada.
O banco 509 e a conta Paggo estão no Cadastro de Bancos.
Com os dados em mãos, a equipe da Paggo testa os acessos e avisa se falta alguma liberação em até [validar: prazo de resposta da Paggo].
Atenção: o UAU só indica que falta uma permissão quando a Paggo tenta usá-la. Se a equipe da Paggo pedir uma liberação extra, aplique no mesmo usuário.
10. Perguntas frequentes
A - Preciso repetir a configuração em homologação? Sim. O usuário, os programas, as obras e a autorização do desenvolvedor valem por ambiente.
B - Uma obra nova vai operar com a Paggo. O que fazer? Libere o usuário da Paggo na obra e aplique nela os programas da seção 3. Depois, avise a equipe da Paggo para incluir a obra na integração.
C - Nenhum pagamento chegou à Paggo depois da configuração. O que verificar ?Confira se o usuário da Paggo está liberado em todas as obras integradas. Uma obra sem liberação pode bloquear a consulta das outras.
D - Posso usar caracteres especiais na senha do usuário? Não. Use só letras e números, sem símbolos como #, @ ou $.