=== Cobre Grátis WooCommerce === Contributors: claudiosanches Tags: checkout, billet, boleto, cobregratis Requires at least: 3.5 Tested up to: 4.0 Stable tag: 1.0.1 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Start getting money by bank billet in your checking account using Cobre Grátis == Description == ### Description (en): ### Start getting money by bank billet in your checking account using **[Cobre Grátis](http://cobregratis.com.br/)**. ### Descrição (pt_BR): ### Comece a receber dinheiro por boleto bancário direto na sua conta corrente usando o **[Cobre Grátis](http://cobregratis.com.br/)**. Sem limites e sem taxa por boleto. = Como Funciona o Boleto Bancário = [youtube http://www.youtube.com/watch?v=XhCMJ6CpD4M] O Boleto Bancário é uma forma de pagamento exclusiva do Brasil. Qualquer pessoa física ou jurídica pode cobrar através de boletos bancários. Basta ter uma conta bancária e contratar uma carteira de cobrança junto ao banco. Aprenda mais como funciona, o que é Cedente, Sacado e o que você precisa para começar a cobrar seus clientes por Boleto Bancário. = Integração = A integração é completa para vender por boleto e ainda conta com sistema de retorno que avisa quando o boleto é pago, atualizando o status do seu pedido para *processando*. É possível integrar com os seguintes bancos: * Banco do Brasil * Banespa * Banrisul * Santander * Sicredi * Real * Itaú * Bradesco * HSBC * Caixa Econômica Federal * Nossa Caixa * BCN * Sudameris * FINASA * Unibanco * Safra * Citibank * Bancoob/Sicoob = Instalação = Instalar é bem simples, basta seguir o nosso [guia de instalação](http://wordpress.org/extend/plugins/cobregratis-woocommerce/installation/). = Compatibilidade = Compatível com as versões 2.0.x e 2.1.x do WooCommerce. = Dúvidas? = Você pode esclarecer suas dúvidas usando: * A nossa sessão de [FAQ](http://wordpress.org/extend/plugins/cobregratis-woocommerce/faq/). * Criando um tópico no [fórum do GitHub](https://github.com/Cobre Grátis/cobregratis-woocommerce/issues). * Criando um tópico no [fórum de ajuda do WordPress](http://wordpress.org/support/plugin/cobregratis-woocommerce) (apenas em inglês). = Coloborar = Você pode contribuir com código-fonte em nossa página no [GitHub](https://github.com/Cobre Grátis/cobregratis-woocommerce). == Installation == = Instalação do plugin = * Faça upload dos arquivos do plugin para a sua pasta de plugins ou faça a instalação usando o instalador do WordPress em `Plugins > Adicionar Novo`; * Ative o plugin. = Configuração do Cobre Grátis = 1. Crie uma conta e contrate um Plano Pago no [Cobre Grátis](http://cobregratis.com.br/planos/); 2. Com a conta é possível gerar um Token em [Cobre Grátis - Minhas informações](https://app.cobregratis.com.br/myinfo); 3. E finalmente crie uma notificação em [Cobre Grátis - Notificações](https://app.cobregratis.com.br/web_hooks/new); 4. Na notificação criada:; 5. Escolha o evento 'Pago'; 6. Escolha a situação 'Ativo'; 7. Crie um **Código de Segurança**; 8. E configure a **URL para notificação** como por exemplo `http://seusite.com.br/?wc-api=WC_Cobregratis_Gateway`; 9. Pronto, conta configurada. = Configuração do plugin = 1. Vá até `WooCommerce > Configurações > Finalizar compra > Cobre Grátis`; 2. Habilite o **Cobre Grátis** e preencha como preferir as opções de *Título* de *Descrição*; 3. Digite o token gerado na sua conta do **Cobre Grátis**; 4. Por final preencha também a opção *Código de segurança da notificação*; 5. Salve as configurações; 6. Vá até `WooCommerce > Configurações > Produtos > Inventário`; 7. Deixe em branco a opção **Manter estoque (minutos)** (isso evita problemas com contas canceladas antes do cliente pagar o boleto). 8. Salve novamente as configurações; 9. Tudo pronto para receber pagamentos via boleto bancário usando o **Cobre Grátis**. == Frequently Asked Questions == = O que eu preciso para utilizar este plugin? = * Ter instalado o WooCommerce 2.0.x ou superior. * Com a conta é possível gerar um Token em [Cobre Grátis - Minhas informações](https://app.cobregratis.com.br/myinfo); * E finalmente crie uma notificação em [Cobre Grátis - Notificações](https://app.cobregratis.com.br/web_hooks/new); * Na notificação criada:; * Escolha o evento 'Pago'; * Escolha a situação 'Ativo'; * Crie um **Código de Segurança**; * E configure a **URL para notificação** como por exemplo `http://seusite.com.br/?wc-api=WC_Cobregratis_Gateway`; * Pronto, conta configurada. = O que é o Cobre Grátis? = O Cobre Grátis é um sistema que funciona na web, feito para que qualquer pessoa possa gerar boletos bancários e gerenciar suas cobranças. Com o Cobre Grátis é possível cadastrar os dados da cobrança que ele gera o boleto bancário para ser enviado para o cliente pagar. Os bancos possuem seus próprios sistemas para isso, mas no Cobre Grátis é possível emitir boletos para diversos bancos e gerenciar todas as cobranças em um só lugar. Além de possuir diversos recursos que outros sistemas não oferecem. = Quais são os pré-requisitos para usar o Cobre Grátis? = Para usar o Cobre Grátis é necessário: 1. Ter uma conta corrente em banco; 2. Possuir um contrato de cobrança (chamada de carteira de cobrança); 3. Ter em mãos os dados da conta corrente e os dados da carteira de cobrança; 4. Possuir um computador com acesso à internet; = Quais os bancos e carteiras suportadas? = * **Banco do Brasil** - 18-17, 18-027, 17-019, 18-019 (Convênio com 7 dígitos), 18-019 (Convênio com 6 dígitos), 18-019 (Convênio com 8 dígitos) * **Banespa** - 008 * **Banrisul** - Cob. Direta * **Santander** - 102 * **Sicredi** - A (Simples) * **Real** - 57 * **Itaú** - 179, 175, 109, 174, 176, 178, 157 * **Bradesco** - 06, 09, 25, 03 * **HSBC** - CNR, CNR Fácil * **Caixa Econômica Federal** - SIGCB: 24 ou 02, SINCO, SR (80), SR (82), CR (90), SR5 * **Nossa Caixa** - CIDENT * **BCN** - 1 * **Sudameris** - Cobrança Simples * **FINASA** - 27 * **Unibanco** - Cob Especial * **Safra** - 4 * **Citibank** - 3 - Cobrança Comum, 4 - Cobrança de Seguro * **Bancoob/Sicoob** - 01, 02 = Mais dúvidas de como funciona o Cobre Grátis? = Acesse a [FAQ do Cobre Grátis](http://suporte.cobregratis.com.br/hc/pt-br). == For Developers == É possível usar qualquer um dos exemplos abaixo dentro do `functions.php` do seu tema ou criando um plugin (veja como em [WordPress - Writing a Plugin](http://codex.wordpress.org/Writing_a_Plugin)). = Adicionar um ícone no método de pagamento: = /** * Adicionar um ícone para Cobre Grátis. * * @param string $url String vazia. * * @return string Link para o seu ícone. */ function custom_woocommerce_cobregratis_icon( $url ) { return 'link do ícone'; } add_filter( 'woocommerce_cobregratis_icon', 'custom_woocommerce_cobregratis_icon' ); = Alterar os parametros postados para o Cobre Grátis: = /** * Customizar os dados postados para o Cobre Grátis. * * @param array $data Dados gerados pelo plugin. * @param WC_Order $order Objeto que contém todas as informações do pedido. * * @return array */ function custom_woocommerce_cobregratis_billet_data( $data, $order ) { // aqui você pode trabalhar e alterar o array $data com o que desejar. // Api do Cobre Grátis: https://github.com/Cobre Grátis/cobregratis-api return $data; } add_filter( 'woocommerce_cobregratis_billet_data', 'custom_woocommerce_cobregratis_billet_data', 10, 2 ); = Alterar as instruções do boleto na página de "obrigado" (thankyou page): = /** * Customizar as instruções sobre o boleto na página "obrigado". * * @param string $message Mensagem padrão do plugin. * @param int $order_id ID do pedido. * * @return string Novas instruções. */ function custom_woocommerce_cobregratis_thankyou_page_instructions( $message, $order_id ) { return 'Novas instruções'; } add_filter( 'woocommerce_cobregratis_thankyou_page_instructions', 'custom_woocommerce_cobregratis_thankyou_page_instructions', 10, 2 ); = Alterar as instruções do boleto no e-mail: = /** * Customizar as instruções sobre o boleto no e-mail. * * @param string $message Mensagem padrão do plugin. * @param WC_Order $order Objeto que contém todas as informações do pedido. * * @return string Novas instruções. */ function custom_woocommerce_cobregratis_email_instructions( $message, $order ) { return 'Novas instruções'; } add_filter( 'woocommerce_cobregratis_email_instructions', 'custom_woocommerce_cobregratis_email_instructions', 10, 2 ); = Alterar as instruções do boleto para pedidos que estão aguardando pagamento: = /** * Customizar as instruções do boleto para pedidos que estão aguardando pagamento. * * @param string $message Mensagem padrão do plugin. * @param WC_Order $order Objeto que contém todas as informações do pedido. * * @return string Novas instruções. */ function custom_woocommerce_cobregratis_pending_payment_instructions( $message, $order ) { return 'Novas instruções'; } add_filter( 'woocommerce_cobregratis_pending_payment_instructions', 'custom_woocommerce_cobregratis_pending_payment_instructions', 10, 2 ); == Screenshots == 1. Plugin Settings. == Changelog == = 1.0.1 - 17/05/2014 = * Corrigida a geração de boletos. = 1.0.0 = * Versão inicial. == Upgrade Notice == = 1.0.1 = * Corrigida a geração de boletos. == License == Cobre Grátis WooCommerce is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. Cobre Grátis WooCommerce is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Cobre Grátis WooCommerce. If not, see .