Cobre Bem Tecnologia
INSTITUCIONAL
Empresa especializada em soluções padronizadas de meios de pagamento e de recebimento.
Há 16 anos, a Cobre Bem Tecnologia é líder nacional no mercado de softwares padronizados de cobrança.
Atualmente, destaca-se no âmbito internacional por seus diferenciais.
EVENTOS
SEGURANÇA COMPROVADA
A Cobre Bem Tecnologia é o primeiro Provedor de Serviços de Pagamentos (PSP) brasileiro a conquistar a certificação de total conformidade com as normas do PCI.
FALE CONOSCO
COMERCIAL:
comercial@cobrebem.com
Skype ID: cobrebemcomercial
São Paulo: (11) 5041 2228
Rio de Janeiro: (21) 2288 5990
Buenos Aires: +54 (11) 6841 9067
Dallas: +1 (469) 298-8901
Santiago: +56 (2) 570-8663
Cidade do México: +52 (55) 2789-0325
Bogotá: +57 (1) 381-9016
SUPORTE TÉCNICO:
suporte@cobrebem.com
Skype ID: cobrebemsuporte
Rio de Janeiro: (21) 2288 5990
Descrição
O Cobre Bem E-Commerce é um programa que disponibiliza em seu site, imediatamente no navegador do cliente a geração de Boletos Bancários totalmente personalizados com seu Logotipo.
Neste manual, procuramos explicar as principais funcionalidades através de pequenos filmes que poderão ser facilmente localizados através do desenho da camêra.
Instalação - Procedimentos Comuns a todos os Sistemas Operacionais
Para darmos inicio ao processo de instalação efetue o download do programa Cobre Bem E-Commerce a partir da área de Downloads do site da Cobre Bem Tecnologia.
A instalação deverá ser realizada em Servidores Web nos sistemas operacionais Windows ou Unix.
Efetue o download do arquivo "CobreBemECommerceUnix.zip", quando o servidor for Unix ou "CobreBemECommerceWindows.zip", quando o servidor for Windows a partir do site da Cobre Bem. Ao descompactar este arquivo serão exibidos os seguintes diretórios: cgi-bin e public-html ou www-root.
Procedimento:
- Faça o "upload" do arquivo no diretório cgi-bin "CobreBemECommerce" (servidores Unix) ou "CobreBemECommerce.exe" (servidores Windows) para o diretório cgi-bin do servidor Web;
- Efetue o "upload" do diretório "imagenscbe" e seu conteúdo, para uma área navegável do site e do diretório "CobreBemECommerceDados" com todos os seus arquivos para o diretório cgi-bin/CobreBemECommerceDados no servidor Web.
Considerações Gerais:
- O Cobre Bem E-Commerce é um programa binário, sendo assim, não há necessidade de nenhuma instalação adicional;
- O programa Cobre Bem E-Commerce pode ser chamado a partir de uma página HTML comum, utilizando os métodos GET ou POST em um form;
- Poderá ser chamado também, de dentro de um script escrito em ASP, PHP, JSP, PERL, ColdFusion ou de qualquer outra linguagem que tenha a possibilidade de chamar um CGI pelo método GET ou POST;
- Normalmente, para chamar o Cobre Bem E-Commerce de dentro de outro script é mais fácil utilizar o método GET do que o POST;
- O Cobre Bem E-Commerce poderá ser utilizado em seu computador sem problemas, no entanto, isto só faz sentido para efetuar testes, uma vez que o objetivo do programa é gerar boletos bancários em sites;
- Não existe nenhuma incompatibilidade entre as versões Windows e Unix do CGI, sendo o funcionamento de ambos exatamente igual. Por exemplo, esta solução poderá ser testada em ambiente Windows e disponibilizada em produção em ambiente Unix, sem necessitar de nenhuma modificação nas suas páginas/scripts;
- Atentamos que nos servidores Web em Linux os nomes dos arquivos são case-sensitives (Distinção entre letras maiúsculas e minúsculas).
Instalação com Sistema Operacional Windows
Entre em contato com o responsável pelo seu servidor Web solicitando as seguintes permissões:
- Para execução de aplicação do "tipo binário" no diretório onde será instalado o CobreBemECommerce.exe;
- De "escrita" para o diretório CobreBemEComerceDados e seus arquivos.
No Apache para Windows, o nome do executável do Cobre Bem E-Commerce não pode possuir mais do que 8 dígitos. Desta forma, alterar o nome CobreBemECommerce.exe para, por exemplo CBE.exe resolve o problema. Note que será necessário também alterar o nome da pasta CobreBemECommerceDados para CBEDados.
Instalação com Sistema Operacional Unix
Para os fabricantes: LINUX, FREEBSD, SOLARIS, BSDI e OPEN BSD, deverão ser concedidas as seguintes permissões neste ambiente:
- No arquivo CobreBemECommerce sempre 755;
- No diretório CobreBemECommerceDados, em servidor compartilhado conceda as permissões 755 ou 775, e até mesmo 777, dependendo do usuário de navegação anônima do Apache;
- Para os arquivos do diretório CobreBemECommerceDados poderão ser concedidas as permissões 644, 664 ou 666.
Veja a correspondência:
| CBEDados | Arquivos CBEDados |
|---|---|
| 755 | 644 |
| 775 | 664 |
| 777 | 666 |
Veja a descrição das permissões:
| Permissões | Descrição |
|---|---|
| 755 | RWX, R-X, R-X |
| 775 | RWX, RWX, R-X |
| 777 | RWX, RWX, RWX |
| 644 | RW-, R--, R-- |
| 664 | RW-, RW-, R-- |
| 666 | RW-, RW-, RW- |
Considere: R - Ler W - Escrever X - Executar
Executando o Cobre Bem E-Commerce
Windows
Para executar o Cobre Bem E-Commerce em ambiente Windows, basta acessar a URL onde está instalado o programa, digite em seu navegador a seguinte URL: http://www.seusite.com.br/cgi-bin/CobreBemECommerce.exe
Unix
Nos Sistemas Operacionais Unix compatíveis com o Cobre Bem E-Commerce, digite: http://www.seusite.com.br/cgi-bin/CobreBemECommerce
Tela de Login
Ao abrir um navegador, digite a URL de chamada do programa Cobre Bem E-Commerce, de acordo com o sistema operacional onde está instalado o programa, para que seja exibida a tela de login denominada: Thisf Informática - Validação de Usuários.
O Cobre Bem E-Commerce é distribuído com os usuários descritos abaixo:
| Usuário | Senha |
|---|---|
| administrador | CobreBem |
| gerente | CobreBem |
Os campos usuários e senhas são case-sensitives, ou seja, existe distinção entre as letras maiúsculas e minúsculas.
Configuração/Administração
Entende-se por Administrador, o profissional responsável por administrar todas as contas configuradas no programa, bem como, permitir a criação de novos usuários.
O usuário é o profissonal responsável por configurar a conta corrente, bem como, manusear o programa de acordo com as permissões concedidas pelo Administrador.
Para configurar os dados da Conta Corrente o programa percorre 06 telas, veja abaixo:
Primeira Tela
Informe no campo "Apelido" um nome que identifique a Conta Corrente. O ato de apelidar a Conta Corrente é extremamente útil, pois quando há necessidade de configurar mais de um Cedente, Banco ou Conta Corrente, há como identificar facilmente as mesmas. Ao final do processo, clique no botão "Incluir".
Ao cadastrar uma conta corrente definitiva (em produção) é necessário verificar se há alguma conta de teste que foi configurada anteriormente. Neste caso o nome/apelido da conta corrente deverá ser diferente do já existente.
Caso deseje cadastrar a licença definitiva com o mesmo nome da licença de teste, apague a conta criada anteriormente e inclua a nova.
Segunda Tela
Tela instrutiva, leia-a atentamente. Para prosseguir, clique no botão "Continuar".
Terceira Tela
- Encaixe as chaves de licença no campo "Chaves de Licença", sejam elas de Teste ou de Registro;
- Digite o CNPJ ou CPF do Cedente no campo "CNPJ/CPF". Esses dados serão validados junto à Receita Federal, automaticamente pelo programa Cobre Bem E-Commerce. Somente poderá utilizar o programa o cedente que se encontrar em situação "Regular" na Receita Federal;
- Preencha o campo "CEP" corretamente. Informe seu ramo de atividade, clicando na lista exibida;
- Escolha o Banco e a Carteira habilitada para cobrança junto ao Banco e clique no botão "Carregar";
- Leia o Contrato de Licença de Uso dos softwares desenvolvidos pela Thisf Informática e ao concordar com os termos do mesmo, clique no botão aceito.
- Não concordando com os termos do contrato, feche a janela clicando no "X" do navegador.
Quarta Tela
Exibe os dados cadastrais do Cedente e do Banco e Carteira selecionados anteriormente.
Verifique se os dados estão corretos. Caso estejam, clique no botão "Carregar Configuração" ou se necessitar alterar algo, clique no botão "Alterar Dados".
Vídeos:
Configurando sua conta corrente - Confirmação dos dados do Cedente
Exemplo prático de Configuração Conta Corrente
Quinta Tela
Os campos apresentados nesta tela destinam-se ao preenchimento de seus dados de Conta Corente, tais como: Agência, Conta Corrente, Início Nosso Número e Fim Nosso Número.
O preenchimento correto de seus dados de Conta Corrente será primordial para que o programa Cobre Bem E-Commerce possa gerar o boleto posteriormente, contendo o código de barras, linha digitável e nosso número em conformidade com as regras especificadas pelo seu banco e carteira de cobrança.
Para emitir cobrança através de Boleto Bancário é necessário que sua Conta Corrente seja habilitada junto ao Banco de sua preferência na modalidade de cobrança Boleto Bancário.
Sexta Tela
Os campos apresentados nesta tela são de preenchimento "opcional" e destinam-se a personalização do boleto.
Fica a critério do Webmaster, desenvolvedor ou mesmo do usuário com simples conhecimento na linguagem HTML, a personalização e o design do boleto de acordo com a sua necessidade.
O programa oferece alguns recursos básicos de personalização, tais como: Exibição do Logotipo, Banners ou até mesmo o preenchimento de mensagens no Cabeçalho e Rodapé do boleto.
De acordo com seu tipo de negócio é possível exibir partes do boleto, como por exemplo, apresentar no navegador do cliente somente a "Linha Digitável" (IPTE), facilitando assim, o pagamento via HomeBanking.
Para facilitar a identificação da Conta Corrente em questão, ao acessar esta tela o programa preenche automaticamente o campo "Apelido".
Poderão ser desenvolvidos scripts a serem utilizados no boleto. A utilização e criação dos scripts devem ser realizadas pelos webmasters e deverão ser informdos no campo"HTML Script".
Para personalizar seu boleto com "scripts", disponibilizamos exemplos no site da Cobre Bem, para visualizá-los acesse Exemplos Scripts.
Vídeos:
Personalizando o Boleto: Incluir Logotipo, Cabeçalho e Rodapée
Exemplo de Boleto Personalizado
Integração do Formulário de Pedidos ao Programa
Chamamos de "Formulário de Pedidos" uma página que contém alguns dados necessários para identificação do pedido do seu cliente.
De acordo com o seu tipo de negócio, ramo de atividade e situação de venda de serviços ou produtos, o webmaster poderá definir a lista de campos a serem exibidos, bem como, os campos de preenchimento obrigatório.
Verifique o procedimento abaixo, para que seja possível realizar a integração:
- Acesse o programa Cobre Bem E-Commerce e digite o seu login de "Usuário";
- Visualize a tela "Administração de Contas Correntes" contendo o "apelido" de sua Conta Corrente;
- Clique no "Apelido de Conta Corrente" e posteriormente no botão "Consultar";
- Os dados de sua Conta Corrente serão exibidos no visor da tela;
- Nesta mesma tela, clique no botão "Página Exemplo" localizado à sua direita.
Será exibida uma página, contendo o exemplo de um formulário a ser implementado no seu site com a explicação de todos os parâmetros suportados pelo Cobre Bem E-Commerce.
Se desejar, salve a "Página Exemplo" em seu site e altere-a de acordo com sua conveniência.
Resumindo, a Página de Exemplo tem como objetivo ilustrar a forma de construir uma página HTML para "chamar" o programa Cobre Bem E-Commerce.
Na realidade, poderá ser utilizado qualquer formato de página que permita "chamar" um programa CGI com os métodos GET ou POST, como por exemplo, scripts escritos em diversas linguagens, tais como: ASP, JSP, PERL, PHP, CodeFusion entre outras.
Exemplos:
<input type="hidden" name="IdentificacaoPagina" value="PB">
<input type="hidden" name="UsuarioBoleto" value="2004010785725635">
<input type="hidden" name="CSID" value="teste">
Conectividades/Tecnologias
A Página Exemplo possui várias funcionalidades, veja abaixo algumas delas:
- Verificar se a configuração da Conta Corrente e Personalização do Boleto estão corretos;
- Listar para o desenvolvedor web os parâmetros a serem passados para que o programa possa gerar o boleto, de acordo com o desejado;
- Através desta página, consegue-se detectar alguns erros, como por exemplo, na passagem incorreta dos parâmetros obrigatórios (escritos em vermelho). Neste caso ao clicar no botão "Gerar Boleto", será exibida a mensagem de erro "Acesso Não Autorizado";
- Pode ser utilizada como "formulário simples" de pedido no seu site.
A lista de parâmetros exibida na "Página de Exemplo" deve ser lida atentamente, pois esta auxilia no tratamento efetivo da cobrança.
Exemplo:
Para que os boletos sejam gerados somente nos dias úteis, informe o parâmetro:"VencimentoDiaUtil" = "S"
Poderão ser utilizadas lojas vituais desenvolvidas pelo seu webmaster, as disponíveis no mercado ou se desejar, divulgamos lojas "gratuitas/OpenSource" no site da Cobre Bem.
Acesse a URL a seguir para visualiá-las http://www.cobrebem.com/downloads/lojasvirtuais.html. Destacamos o item "Lojas Simplificadas" existente no exemplo acima, para quem necessita de uma loja bem prática, simples e de fácil implementação.
Barra de Ferramentas
A Barra de Ferramentas contém os botões utilizados para acessar funções, tais como: Apagar, Consultar, Alterar entre outras.
A Barra de Ferramentas está presente em quase todas as telas do Cobre Bem E-Commerce, com a finalidade de auxiliá-lo.
Botão "Consultar"
Este não está localizado na Barra de Ferramentas, e sim abaixo do campo com os "Apelidos" das contas criadas. Sua utilização também é de muita importância, pois permite a consulta aos dados da configuração de um Cedente, Conta Corrente ou Boletos Emitidos.
Botão "Incluir"
Possibilita a inclusão de uma nova Conta Corrente após ser preenchido o campo "Apelido".
Botão "Alterar"
Altera os dados da Conta Corrente, veja como alterar de acordo com o procedimento abaixo:
- Consulte o apelido de Conta Corrente que deseja alterar;
- Clique no botão "Alterar";
- Clique no botão "Próxima Página", e altere os dados da Conta Corrente;
- Para concluir, clique no botão "Próxima Página", depois no botão "Encerrar Sessão".
Botão "Apagar"
Apaga a Conta Corrente selecionada e todas as suas configurações, sendo assim, sua utilização deve ser feita com bastante cuidado.
Botão "Próxima Página"
Destina-se à navegação das telas do sistema. Sua utilização é importante no ato de alterar os dados da Conta Corrente.
Boletos Emitidos - Consulta/Nosso Número
Permite a visualização dos boletos gerados pelo sistema.
Botão "Página Exemplo"
Acessa a página de exemplo, permitindo a execução de testes de exibição do boleto, bem como, outras funcionalidades.
Botão "Encerrar"
Sai efetivamente do sistema e/ou efetua login de usuários.
Vídeos:
Exemplo prático do uso do botão Consultar
Exemplo prático de Alteração dos dados de conta corrente utilizando o botão Alterar
Exemplo prático do uso do botão Apagar
Exemplo prático do uso do botão Próxima Página
Exemplo prático de Boletos Emitidos Consulta Nosso Número
Exemplo prático do uso do botão Página Exemplo
Exemplo prático do uso do botão Encerrar Sessão
Como Gerenciar Boletos Emitidos
O programa Cobre Bem E-Commerce possui uma tela que possibilita o gerenciamento eficaz do seu Contas a Receber denominada "Administração de Boletos Emitidos", nesta tela serão listados todos os boletos que foram gerados no site.
O Banco disponibilizará o "Nosso Número", a Data do pagamento e o "Valor Pago" em seus programas e/ou homebankings. De posse destas informações, é possível realizar consultas na tela através do critério desejado.
O programa irá listar todas as cobranças que foram geradas no seu site de acordo com o critério especificado, identifique os nossos números informados pelo Banco como "pago" e dê "baixa" nas cobranças.
Clique no botão "Detalhar", existente em cada cobrança, para identificar todas as informações fornecidas na tela de pedidos pelo seu cliente no momento da compra.
Boletos por E-Mail
O objetivo do Cobre Bem E-Commerce é gerar a cobrança no navegador do cliente quando solicitado no site.
O desenvolvedor com auxílio de um script poderá enviar boletos por e-mail, somente poderá ser realizado com o auxílio de um script. Este enviará um e-mail contendo uma URL, que ao ser clicada pelo seu cliente exibirá o boleto.
Para enviar boletos por e-mail no Cobre Bem E-Commerce, o cliente deverá sempre acessar o site do lojista e preencher o formulário de pedido.
Poderá ser utilizado um script próprio, ou o que a Cobre Bem Tecnologia disponibiliza gratuitamente no site. Em "Scripts" selecione a opção "Envio de Boleto por Email com script PHP", ao acessar a área de Mais Downloads.
Configurando Administrador e Usuários
O programa permite a criação de um "Administrador" e vários "Usuários".
O Administrador terá a incumbência de gerenciar os usuários e conceder níveis de acesso ao sistema conforme desejado, tais como:
- Permitir que o Usuário configure várias Contas Correntes/Bancos para o mesmo Cedente;
- Permitir a geração de boleto para primeira ou segunda via;
- Permitir o gerenciamento do Contas a Receber, possibilitando consultas por Nosso Número, Sacado, Data de Vencimento etc;
- Permitir o acesso para a personalização da cobrança.
O Cobre Bem E-Commerce é distribuído com os seguintes usuários e senhas criados:
| Usuário | Senha |
|---|---|
| administrador | CobreBem |
| gerente | CobreBem |
Os campos Usuário e Senha são case-sensitives, ou seja, observe que há presença de letras maiúsculas e minúsculas no usuário e senha padrão que deverão ser respeitados.
Iniciando a sessão com o usuário "gerente", estará sendo exibida a página de gerenciamento de contas correntes podendo criar e configurar a sua Conta Corrente, bastando para isto, seguir as instruções que são exibidas na própria página.
Como Trocar de Servidor de Hospedagem
Como dito anteriormente, o sistema pode ser instalado em servidores Windows ou Unix. Sendo assim, em alguns casos poderá ocorrer a necessidade de mudar de servidor de hospedagem, para isso veja abaixo:
Procedimento:
- Copie o diretório cgi-bin e os seus subdiretórios;
- Utilize o procedimento de instalção do programa Cobre Bem E-Commerce normalmente, de acordo com o sistema operacional do servidor web;
- Conceda as devidas permissões conforme descrito nos intens 2 e 3 deste manual.
Venda Parcelada
Caso deseje efetuar uma "venda parcelada" na modalidade de cobrança Boleto Bancário, poderá realizá-la através do Cobre Bem E-Commerce. Acesse Lojas Virtuais e em "Lojas Simplificadas" escolha a opção: "HTML + JavaScript - Loja Virtual de uma página só com venda parcelada".
Cumpre-nos ressaltar que a prática de venda parcelada deve ser adotada em situações de venda onde não haja risco na cobrança, ou seja, o serviço ou produto somente deverão ser disponibilizados após o pagamento da última parcela.
Exportação da Base de Dados
Para exportar a base de dados em formato texto, e posteriormente importá-lo em aplicativo, clique aqui.
Procedimento:
- Descompacte o arquivo em uma estação Windows;
- Efetue o download dos arquivos BOLETOS.DBF, BOLETOS.CDX e BOLETOS.FTP salvando-os no mesmo local onde o programa foi descompactado;
- Execute o programa;
- Selecione os parâmetros e campos desejados em cada tela.
Dúvidas Freqüentes
Na opção Dúvidas Freqüentes separamos algumas dúvidas que usualmente atendemos no nosso setor de suporte.
Em caso de dúvidas, por gentileza, entre em contato com nossa equipe de suporte através do e-mail suporte@cobrebem.com.
Para maiores informações sobre cobrança, sugerimos a leitura do Manual Técnico de Noções Básicas de Cobrança disponibilizado no site da Cobre Bem.
Índice
- Instalação - Procedimentos para todos Sistemas Operacionais
- Instalação com Windows
- Instalação com Sistema Operacional Unix
- Executando o Cobre Bem E-Commerce
- Tela de Login
- Configuração/Administração
- Formulário de Pedidos ao Programa
- Utilizando a Página Exemplo
- Barra de Ferramentas
- Como Gerenciar Boletos Emitidos
- Boletos por E-Mail
- Configurando Administrador e Usuários
- Como Trocar de Servidor de Hospedagem
- Vendas Parceladas
- Exportação da Base de Dados
- Dúvidas Frqüentes
