{"_id":"5a7c59045ac9e4003d7fcdcb","project":"575aeffae12cf20e002f306c","version":{"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","__v":31,"createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","categories":["575aeffae12cf20e002f3070","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","57602fe5b82256240055c657","57602ff6c811102000cef302","576030909b1a9a220067ca40","57604518b82256240055c722","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","577680bf3cee3a0e00a000bc","577ff3b1ff48990e000c6806","5783f78c5cbce30e0074e2b7","5783f86292edb92200e6101c","5783f86dbfbba719003f0d8b","5783f8755cbce30e0074e2b8","5783f8b65cbce30e0074e2b9","5783f8bf5cbce30e0074e2ba","5783f8d8ce802f0e0087d574","578529f887c9280e0090394b","57852aeb87c9280e0090394d","57866e72b2f4060e00fa39ca","57ab6d5c39c2fd1900191879","57f39451ab0ee12000bef915","582499a0d90fa027009b259e","58c29df1258e5a1900b60478","5a7c4127490e52002a7f643c"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"2016","version_clean":"1.0.0","version":"1"},"category":{"_id":"5a7c4127490e52002a7f643c","project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2018-02-08T12:23:03.906Z","from_sync":false,"order":11,"slug":"sistemas-integrados","title":"Sistemas Integrados"},"user":"57601a13af3e090e00108059","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-02-08T14:04:52.828Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":15,"body":"<img src=\"https://gerencianet.com.br/wp-content/uploads/2015/08/post-6-integra----o-topsapp-1.png\" alt=\"TopSapp\">\n\nSe você utiliza o TopSapp como gerenciador e a Gerencianet como meio de pagamento, está na hora de tirar todas as dúvidas sobre a integração dos sistemas.\n\nA primeira etapa é realizada dentro da sua conta Gerencianet:\n\n1. Acesse o menu <code>Integrações > Token</code>;\n\n2. Informe o nome da integração e clique no botão <code>Gerar Token</code>;\n\n3. Copie o token gerado.\n\nEm seguida, é necessário acessar o portal TopSapp para finalizar o processo:\n\n1. Acesse o menu <code>Financeiro > Receber > Portadores</code> do portal do TopSapp;\n\n2. Escolha a opção <code>Gerencianet</code> como <code>Portador Fixo</code>;\n\n3. Cole o token gerado no campo disponível.\n\nPronto. A integração está finalizada.\n\n# Como dar baixa automática?\n\nPara que o pagamento seja identificado diretamente em seu sistema você deve cadastrar uma URL de callback. Também é possível cadastrar uma URL de cancelamento para que o TopSapp realize a baixa automática de cobranças canceladas na Gerencianet.\n\nMas atenção! Se o cancelamento for realizado no TopSapp, não acontece a baixa automática na conta Gerencianet.\n\n## Veja como cadastrar as URL's:\n[block:html]\n{\n  \"html\": \"<ol>\\n\\n  <li>Acesse o menu <code>Integrações > Callback</code>;</li><br>\\n\\n\\t<li>Informe a URL de cadastro e clique no botão <code>Cadastrar</code>. A URL deve seguir o modelo: <code>https://ipservidorlinux:1996/StatusBilling.php</code>. A mesma URL funciona para confirmação e cancelamento de pagamentos;</li><br>\\n\\n\\t<li>Clique no botão <code>Ativar</code> que está disponível em frente a URL cadastrada. Neste mesmo local, você pode desativar a URL de notificação quando necessário;</li><br>\\n\\n\\t<li>Utilize o botão <code>Testar</code> para verificar se a URL está funcionando. Faça essa operação tanto para confirmação de pagamentos, quanto para o cancelamento de cobranças.</li><br>\\n\\n\\t<p>Para que a URL de cancelamento seja cadastrada com sucesso, é preciso marcar a opção <code>Cobrança Cancelada</code>, na configuração de callback de sua conta Gerencianet.</p>\\n  \\n</ol>\"\n}\n[/block]\n# Como verificar se a integração está funcionando?\n\nVocê pode realizar testes para verificar se a URL está funcionando perfeitamente. Para isto, clique no botão <code>Testar</code>, que fica ao lado da URL de notificação cadastrada em sua conta Gerencianet. Ao clicar no botão, uma requisição é enviada para o TopSapp e você recebe uma mensagem informando se o callback está funcionando ou não.\n\nÉ importante verificar se a porta <code>1996</code> está liberada e operante. Muitas vezes, alguns usuários ou a própria operadora bloqueiam as portas e, por isso, é necessário confirmar se está tudo funcionando.\n\nQuando a sua URL está configurada corretamente, mas por algum motivo o seu TopSapp parou de funcionar ou apresentou problema, sua URL é desativada e as notificações não são enviadas. Quando isso ocorre, você deve ativar novamente a sua URL e fazer o testar para saber se está tudo ok. Em caso de resposta com sucesso (200), você poderá reenviar as notificações de confirmação de pagamento. Para isso, siga o procedimento abaixo:\n\n1. Clique no menu <code>Integrações > Callback</code> da conta Gerencianet;\n\n2. Em frente a URL de notificação de pagamento cadastrado, clique no botão <code>Logs</code>;\n\n3. Selecionar as cobranças que estão com o status <code>não</code>;\n\n4. Clique em <code>Reenviar callback</code>.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"IMPORTANTE\",\n  \"body\": \"É importante sempre monitorar o status da sua URL de callback.\"\n}\n[/block]\n# A integração falhou. Como verificar o erro?\n\nSe mesmo após a integração realizada acontecer algum erro na emissão da cobrança, você pode verificar a origem do erro clicando no botão <code>Logs</code>, disponível em frente ao token de integração cadastrado em sua conta Gerencianet. Os dados da entrada mostram as informações no momento da emissão e os dados de saída mostram se a cobrança foi emitida com sucesso ou, em caso de falha, o campo em que está o erro.\n\nSe surgir algum erro na tentativa de emissão e não for gerado um log, você deve conferir as configurações do TopSapp.\n\nA integração funciona para boletos e carnês. Você pode gerar quantos precisar a partir de seu TopSapp.\n\n<br>\n\nAinda ficou com alguma dúvida? <a href=\"https://accounts.gerencianet.com.br/faqticket/novoTicket\" target=\"_blank\" title=\"Link Externo\">Envie um ticket</a> para nossa equipe.","excerpt":"Você está em: *\"Sistemas Integrados > TopSapp\"*","slug":"topsapp","type":"basic","title":"TopSapp"}

TopSapp

Você está em: *"Sistemas Integrados > TopSapp"*

<img src="https://gerencianet.com.br/wp-content/uploads/2015/08/post-6-integra----o-topsapp-1.png" alt="TopSapp"> Se você utiliza o TopSapp como gerenciador e a Gerencianet como meio de pagamento, está na hora de tirar todas as dúvidas sobre a integração dos sistemas. A primeira etapa é realizada dentro da sua conta Gerencianet: 1. Acesse o menu <code>Integrações > Token</code>; 2. Informe o nome da integração e clique no botão <code>Gerar Token</code>; 3. Copie o token gerado. Em seguida, é necessário acessar o portal TopSapp para finalizar o processo: 1. Acesse o menu <code>Financeiro > Receber > Portadores</code> do portal do TopSapp; 2. Escolha a opção <code>Gerencianet</code> como <code>Portador Fixo</code>; 3. Cole o token gerado no campo disponível. Pronto. A integração está finalizada. # Como dar baixa automática? Para que o pagamento seja identificado diretamente em seu sistema você deve cadastrar uma URL de callback. Também é possível cadastrar uma URL de cancelamento para que o TopSapp realize a baixa automática de cobranças canceladas na Gerencianet. Mas atenção! Se o cancelamento for realizado no TopSapp, não acontece a baixa automática na conta Gerencianet. ## Veja como cadastrar as URL's: [block:html] { "html": "<ol>\n\n <li>Acesse o menu <code>Integrações > Callback</code>;</li><br>\n\n\t<li>Informe a URL de cadastro e clique no botão <code>Cadastrar</code>. A URL deve seguir o modelo: <code>https://ipservidorlinux:1996/StatusBilling.php</code>. A mesma URL funciona para confirmação e cancelamento de pagamentos;</li><br>\n\n\t<li>Clique no botão <code>Ativar</code> que está disponível em frente a URL cadastrada. Neste mesmo local, você pode desativar a URL de notificação quando necessário;</li><br>\n\n\t<li>Utilize o botão <code>Testar</code> para verificar se a URL está funcionando. Faça essa operação tanto para confirmação de pagamentos, quanto para o cancelamento de cobranças.</li><br>\n\n\t<p>Para que a URL de cancelamento seja cadastrada com sucesso, é preciso marcar a opção <code>Cobrança Cancelada</code>, na configuração de callback de sua conta Gerencianet.</p>\n \n</ol>" } [/block] # Como verificar se a integração está funcionando? Você pode realizar testes para verificar se a URL está funcionando perfeitamente. Para isto, clique no botão <code>Testar</code>, que fica ao lado da URL de notificação cadastrada em sua conta Gerencianet. Ao clicar no botão, uma requisição é enviada para o TopSapp e você recebe uma mensagem informando se o callback está funcionando ou não. É importante verificar se a porta <code>1996</code> está liberada e operante. Muitas vezes, alguns usuários ou a própria operadora bloqueiam as portas e, por isso, é necessário confirmar se está tudo funcionando. Quando a sua URL está configurada corretamente, mas por algum motivo o seu TopSapp parou de funcionar ou apresentou problema, sua URL é desativada e as notificações não são enviadas. Quando isso ocorre, você deve ativar novamente a sua URL e fazer o testar para saber se está tudo ok. Em caso de resposta com sucesso (200), você poderá reenviar as notificações de confirmação de pagamento. Para isso, siga o procedimento abaixo: 1. Clique no menu <code>Integrações > Callback</code> da conta Gerencianet; 2. Em frente a URL de notificação de pagamento cadastrado, clique no botão <code>Logs</code>; 3. Selecionar as cobranças que estão com o status <code>não</code>; 4. Clique em <code>Reenviar callback</code>. [block:callout] { "type": "warning", "title": "IMPORTANTE", "body": "É importante sempre monitorar o status da sua URL de callback." } [/block] # A integração falhou. Como verificar o erro? Se mesmo após a integração realizada acontecer algum erro na emissão da cobrança, você pode verificar a origem do erro clicando no botão <code>Logs</code>, disponível em frente ao token de integração cadastrado em sua conta Gerencianet. Os dados da entrada mostram as informações no momento da emissão e os dados de saída mostram se a cobrança foi emitida com sucesso ou, em caso de falha, o campo em que está o erro. Se surgir algum erro na tentativa de emissão e não for gerado um log, você deve conferir as configurações do TopSapp. A integração funciona para boletos e carnês. Você pode gerar quantos precisar a partir de seu TopSapp. <br> Ainda ficou com alguma dúvida? <a href="https://accounts.gerencianet.com.br/faqticket/novoTicket" target="_blank" title="Link Externo">Envie um ticket</a> para nossa equipe.