Olá pessoal tudo bem ? Hoje neste artigo vamos mostrar que você pode emitir Pix e boletos PagHiper usando uma planilha online do Google, para isso vamos aos requisitos
| Requisitos | Detalhes | Caminho |
|---|---|---|
| Cadastro do tipo Vendedor ou Empresarial | Seu cadastro PagHiper deve estar apto para emissão de boletos e Pix para isso é necessário ter uma conta em um dos status citados | Painel PagHiper >> Minha conta >> Detalhes da Conta |
| Possuir acesso ao Google Planilhas | Para ter acesso ao Google Planilhas (Sheets), você precisa de uma Conta do Google, que pode ser gratuita (@gmail.com) ou uma conta de trabalho/escola (Google Workspace) | Veja mais detalhes na central de ajuda do Google |
| Google Apps Script | Permissão para usar o Apps script, onde vamos conectar sua planilha online com a API da PagHiper | Veja mais detalhes na pagina do serviço Google Apps Script |
Agora vamos iniciar integração com nosso Google Planilha, para isso deixamos o modelo de planilha que usaremos, ao final do artigo com o nome "Planilha-emissao-pedidos.xlsx"
Lembre-se! Ao importar o arquivo para google planilhas no formato ".xlsx", você deve converter para o formato google planilhas. Para isso basta abrir o arquivo no google planilhas ir em "Arquivo" >> Salvar como Google Planilhas, conforme a imagem a seguir
Entretanto se desejar, você pode montar a sua do zero, devendo respeitar as colunas estabelecidas, conforme a tabela a seguir:
| Coluna | Detalhes | Obrigatório | Formato de informação aceita |
|---|---|---|---|
| A | Nome do pagador/devedor, que será usado para emissão do Pix/Boleto | Sim | Letras e números (0 a 255 caracteres) |
| B | E-mail do pagador/devedor, usado para comunicação | Sim | Letras, números e símbolos (@ ), no formato de e-mail Ex: email@paghiper.com ( 0 a 255 caracteres) |
| C | CPF/CNPJ do pagador/devedor, usado para registro o Pix ou boleto | Sim | Números ( 0 a 14 caracteres) |
| D | Descrição do item vendido ou serviço prestado | Sim | Letras e números (0 a 255 caracteres) |
| E | Valor total do pedido já calculado (descontos, juros e multas) | Sim | Números, (0 a 15 caracteres) no formato decimal com apenas 2 casas decimais após a virgula, Ex: 1504,14 |
| F | Quantidade de dias para o vencimento, após a emissão | Sim | Numero, no formato inteiro, valores permitido entre ( 0 a 400) |
| G | Define o meio da cobrança a ser utilizada | Não | Letras, valores aceitos (Pix ou boleto) |
| H | Será preenchido automaticamente com o código da transação, quando emitido o pedido | Não | AlfaNumérico |
| I | Será preenchido automaticamente com link do Pix ou boleto, quando emitido o pedido | Não | URL |
Agora com a tabela já pronta (etapa anterior), vamos no menu superior da nossa planilha online e clicar em Extensões > Apps Script.Feito isso vamos usar um modelo de script já preparado pelo o nosso time de integração, estamos deixando em anexo também, ao final deste artigo, com o nome de "modelo-script-emissao.txt"
Agora vamos abrir o nosso arquivo modelo "modelo-script-emissao.txt" e copiar o seu conteúdo para a pagina que abrimos do Apps Script, ficando dessa forma.
Antes de salvar, precisamos atualizar algumas informações, que será nossa credencial chamada de "ApiKey"
No nosso código que colocamos ela fica posicionado na linha 2 ou basta procurar por "SEU_APIKEY"
Agora vamos substituir o valor entre os (") para nossa ApiKey, que pode ser obtida (AQUI), se tiver dúvidas de como obter suas credenciais de ApiKey, você pode ler esse outro Artigo AQUI
Após substituir deve ficar assim
O restante do nosso script foi escrito e documentado, você pode ler o código caso deseja entender um pouco mais do que o nosso script faz.
Tudo pronto, vamos clicar em salvar, simbolizado pelo o ícone de disquete
Agora que foi salvo, voltamos para nossa planilha, e atualizamos a pagina (F5), devemos observar que irá surgir uma nova opção no menu superior, chamada "PagHiper API"
Clicando nessa opção, vai ter a opção chamada "Gerar Boletos/Pix da Lista", conforme a imagem a seguir
ATENÇÃO! Em sua primeira execução o google Planilha pode solicitar a permissão para execução, basta permitir!
Clicando em OK, será encaminhado para uma janela semelhante a imagem a seguir
Basta selecionar a opção "Selecionar tudo" e clicar em "Continuar", com isso irá conseguir utilizar.
ATENÇÃO! Lembre-se de clicar apenas nesta opção se já tiver preenchido os dados necessários e obrigatórios para emissão.
A seguir simulamos uma emissão de um boleto e um Pix, veja que após preenchido os dados, clicamos em "Gerar Boletos/Pix da Lista) onde é processado e apresentado a seguinte tela
Ao clicar em OK, temos as colunas "H" e "I" preenchidas, com seus respectivos dados, conforme imagem a seguir
Vamos deixar também, alguns exemplos de quando alguma informação não é preenchida corretamente.
No nosso exemplo, passamos um CPF/CNPJ invalido e o e-mail errado na outra.
Veja que os pedidos não foram emitidos, listando os erros ocorridos.
Esses erros são com base na API da PagHiper, se você desejar pode conhecer nossa API AQUI
ATENÇÃO! As linhas que tiverem as colunas "H" e "I" preenchidas, não terão a emissão do Pix ou Boleto novamente. Para que seja reemitido, essas células devem estar vazias
Esperamos ter lhe ajudado!
Comentários
0 comentário
Artigo fechado para comentários.