Correios, plugin para WooCommerce

[alert]Atualização do plugin WC Correios, leia o item Problemas e soluções desta página.[/alert]

Loja virtual sem cálculo de frete é muito incomum, praticamente toda loja virtual precisa calcular o frete do SEDEX para entregar o produto através dos Correios. No WooCommerce isto não muda, por isso criei o plugin WooCommerce Correios BR, este plugin integra o serviço dos Correios ao WooCommerce permitindo que você ofereça o calculo de frete de:

  • SEDEX
  • SEDEX 10
  • SEDEX a cobrar
  • e-SEDEX
  • PAC

Documentação

WooCommerce Correios
plugin WooCommerce Correios

Estas informações podem ser encontradas também no arquivo readme.txt que acompanha o plugin Correios, qualquer dúvida pode ser esclarecida através do atendimento.

Como instalar

Basta acessar o menu Plugins/Adicionar novo/Fazer upload e enviar o plugin para seu site WordPress, em seguida clique em Ativar plugin. Agora você precisa configurar o plugin no WooCommerce. Exatamente como os outros plugins WordPress.

A configuração no WooCommerce Correios BR baseia-se em escolher o País base como Brasil (e seu estado de localização) e moeda Real do Brasil. Em seguida você precisa configurar o plugin WooCommerce Correios BR. A versão atual do plugin é 1.1 e suporta a ultima versão da API dos Correios e está compatível com o WooCommerce 1.4+.

Requerimentos

O WooCommerce Correios BR é integrado perfeitamente desde que:

  1. Sua conta de hospedagem tenha suporte a biblioteca cURL.
  2. Você tenha informado um CEP válido no Brasil (somente números).
  3. Você tenha informado o peso no cadastro do produto (o peso deve ser informado com pontos ex. 2.5 para 2,5 kg).
  4. Os campos Empresa e Senha não são obrigatórios.
  5. O preço dos produtos não seja maior que R$ 10.000,00

Campos opcionais

Os campos Empresa e Senha é utilizado por empresas que possuem contrato com os Correios para utilizar os serviços e-SEDEX, SEDEX 10 ou Coleta. Sendo assim, você não precisa informar nada nestes campos, mas se informar o plugin irá entender que estes dados são válidos e tentará logar na API dos Correios, se os dados estiverem errados não serão apresentados os cálculos de frete (citados acima).

Você pode selecionar os serviços de entrega (métodos de entrega) disponíveis, basta marca-los, vale lembrar a que sem contrato com os Correios apenas PAC, SEDEX e SEDEX a cobrar estarão disponíveis para sua loja.

Problemas e soluções

É possível que você enfrente algum problema/dificuldade para instalar o plugin Correios para WooCommerce, se isto ocorrer você pode tirar suas dúvidas aqui e nós iremos encontrar uma solução o mais rápido possível mesmo que a Luiza esteja no Canadá.

  1. O plugin dos Correios não está informando o preço do frete, o que pode causar isto?
    – Se você está utilizando este plugin em localhost (servidor local) é possível que seu firewall esteja bloqueando a comunicação entre os Correios e seu WooCommerce, para resolver é necessário desbloquear o acesso no firewall.
    – Algumas vezes a mensagem “Aparentemente não existem métodos de entrega para sua região” é exibida, ela indica que o WooCommerce não conseguiu determinar um método de entrega para a região informada, isto é baseado no CEP informado em WooCommerce -> Configurações -> Entrega, informe um CEP válido no Brasil.
    [alert]É possível que os produtos da sua loja não possuam peso e medidas definidos. Os Correios precisam das medidas do produto para calcular SEDEX e outros serviços, por isto, sempre que cadastrar um produto adicione o peso e medida. Lembre-se, no WooCommerce informe 12.5 para indicar 12,5 centímetros.[/alert]
  2. Quando o valor total da compra é maior que R$ 10.000,00 o plugin de frete não exibe o calculo, porque?
    – Os Correios limitam o webservice para calcular produtos de até R$ 10.000,00 qualquer solicitação de calculo acima deste valor é  automaticamente recusado. Em caso de ocorrer um erro o WooCommerce retorna a mensagem “Aparentemente não existem métodos de entrega para sua região” impedindo a exibição do motivo que causou o erro do calculo de frete.
  3. Desde o dia 01/12/2012 meu plugin WooCommerce Correios não está funcionando, o que houve?
    – O webservice (sistema de calculo de frete online) dos Correios  está sendo recriado e passa por instabilidades, já atualizamos o plugin WC Correios e já está funcionando normalmente mas você precisará atualiza-lo, veja como atualizar o plugin https://woocommerce.com.br/noticias/atualizacao-woocommerce-correios-v-2-2-novo-webservice-correios/
  4. Porque não consigo salvar alterações no painel do plugin?
    – Você deve estar utilizando uma versão desatualizada, basta atualizar o plugin para a versão mais recente. Este erro acontece principalmente quando você está utilizando o WooCommerce 2.0 mas o plugin do Correios não está atualizado. Para atualizar baixe a versão mais recente através de sua conta e siga as instruções sobre Como atualizar plugins.

 

Outros plugins WooCommerce

Além do Plugin WooCommerce PagSeguro, conheça os plugins para Corrigir moeda, calcular frete dos Correios WooCommerce CorreiosWooCommerce MoIP e Pagamento Digital.

Pagamento Digital, plugin para WooCommerce

Plugin WooCommerce Pagamento Digital permite que você utilize o Pagamento Digital na sua loja virtual WordPress. Esta página possui toda a documentação relacionada ao plugin Pagamento Digital WooCommerce desenvolvido por John-Henrique. O Pagamento Digital é o gateway de pagamento do grupo Buscapé. Ao utilizar o Pagamento Digital em sua loja alguns benefícios são oferecidos para anunciar no Buscapé (oferecido diretamente pelo Buscapé).

O gateway Pagamento Digital foi renovado e passa a se chamar BCash. Mesmo assim, estas informações continuam valendo e o plugin continua funcionando.

Documentação

WooCommerce Pagamento digital
WooCommerce Pagamento digital

Estas informações podem ser encontradas também no arquivo readme.txt que acompanha o plugin, qualquer dúvida pode ser esclarecida através dos comentários ou contato direto com o atendimento.

A configuração no WooCommerce baseia-se em escolher o País base como Brasil (e seu estado de localização) e moeda Real do Brasil. Em seguida você precisa configurar o plugin WooCommerce Pagamento Digital. A versão atual do plugin é 1.0.4 e  suporta o retorno de dados do Pagamento Digital e atualização do status de pagamento. isto inclui.

  1. Retorno automático dos dados
  2. Alteração do status de pagamento
  3. Pagamentos através do Token
  4. Verificação dos valores e itens da compra

Segurança

Vez ou outra alguém tentará fazer uma compra e alterar o valor do preço para pagar menos, nisto os gateways vão verificar apenas se o pagamento foi aprovado e notificar sua loja, quando isto ocorre o lojista leva prejuízo porque não é realizada a verificação do total da compra com o total aprovado pelo gateway de pagamentos. O plugin WooCommerce Pagamento Digital possui uma verificação de segurança que verifica se o pagamento que está sendo aprovado possui o mesmo valor que o total da compra realizada na loja, isto evita prejuízos e traz segurança para o vendedor.

Requerimentos

O plugin Pagamento Digital para WooCommerce é totalmente integrado ao WooCommerce desde que:

  1. A conta Pagamento Digital tenha perfil Vendedor ou Profissional.
  2. O email informado esteja cadastrado na conta Pagamento Digital.
  3. A opção Informe a url de aviso da sua loja esteja configurada, a URL para receber as notificações deve ser sualoja.com.br/?wc-api=WC_Gateway_Pagamento_Digital
  4. Você tenha informado sua Chave de segurança.

Todos os itens acima precisam estar ativados e configurados para que o plugin WooCommerce Pagamento Digital funcione. Basta acessar a página de configuração do plugin clicar na aba Portais de Pagamento/Pagamento Digital e informar os dados solicitados. Todas as estas configurações podem ser realizadas no menu Ferramentas da sua conta Pagamento Digital.

* A URL de retorno não será utilizada mas o Pagamento Digital precisa que você informe um endereço do seu site. Você poderia inclusive informar a URL principal do seu site.

WooCommerce Pagamento Digital integrado

Mesmo existindo uma documentação razoável e levando-se em conta que não há muito o que configurar no plugin, ainda assim algumas pessoas podem não conseguir utiliza-lo, para resolver isso fiz um vídeo mostrando como configurar, como funciona a integração e como utilizar o plugin Pagamento Digital na sua loja.

Problemas e soluções

É possível que você enfrente algum problema/dificuldade com o plugin Pagamento Digital para WooCommerce, se isto ocorrer você pode tirar suas dúvidas diretamente conosco, iremos encontrar uma solução rapidamente.

  1. O Pagamento Digital informa que o pagamento foi aprovado mas a loja continua mostrando como “aguardando pagamento”, porque?
    Você precisa configurar sua conta Pagamento Digital para retornar os dados da compra, veja como fazer lendo o item Requerimentos.[info]No WooCommerce 2.0 (ou superior) a URL de notificação ou Retorno das transações deve ser sualoja.com/?wc-api=WC_Gateway_Pagamento_Digital[/info]
  2. Porque não consigo salvar alterações no painel do plugin?
    – Você deve estar utilizando uma versão desatualizada, basta atualizar o plugin para a versão mais recente. Este erro acontece principalmente quando você está utilizando o WooCommerce 2.0 mas o plugin do Pagamento Digital não está atualizado. Para atualizar baixe a versão mais recente através de sua conta e siga as instruções sobre Como atualizar plugins.

Outros plugins WooCommerce

Além do Plugin WooCommerce Pagamento Digital, conheça os plugins para Corrigir moeda, calcular frete dos Correios WooCommerce CorreiosWooCommerce MoIP e PagSeguro.

MoIP, plugin para WooCommerce

Plugin WooCommerce MoIP permite que você utilize o MoIP na sua loja virtual WordPress. Esta página possui toda a documentação relacionada ao plugin MoIP WooCommerce desenvolvido por John-Henrique. O MoIP provavelmente é um dos gateways de pagamento mais populares no Brasil e você já pode disponibilizar o MoIP em sua loja WooCommerce.

Ao atualizar seu plugin MoIP Transparente para a versão 2.5, você precisará realizar alguns procedimentos para que o plugin funcione corretamente, veja Atualização MoIP Transparente 2.5.

MoIP
MoIP WooCommerce

As principais vantagens do MoIP são:

  1. Disponibilidade do dinheiro na sua conta em 2 dias úteis.
  2. O comprador não precisa se cadastrar no MoIP para realizar pagamentos.
  3. Permite que o comprador financie o pagamento da compra.

Como instalar

Por tratar-se de um plugin WordPress a instalação segue o padrão de instalação de qualquer plugin. Basta acessar o menu Plugins/Adicionar novo/Fazer upload e enviar o plugin para seu site WordPress, em seguida clique em Ativar plugin. Agora você precisa configurar o plugin no WooCommerce.

A configuração no WooCommerce baseia-se em escolher o País base como Brasil (e seu estado de localização) e moeda Real do Brasil. Em seguida você precisa configurar o plugin WooCommerce MoIP. A versão atual do plugin é 2.5 e suporta a ultima versão da API MoIP, isto inclui.

  1. Retorno automático dos dados
  2. Pré cadastro de clientes
  3. Alteração do status de pagamento
  4. Pagamentos através do Token
  5. Consulta de saldo da carteira – Permite que você veja na sua loja WooCommerce o saldo existente na sua conta MoIP.**

Requerimentos

O WooCommerce MoIP é integrado perfeitamente desde que:

  1. A conta MoIP tenha perfil Vendedor ou Profissional.
  2. O email informado no painel do plugin esteja cadastrado na carteira MoIP.
  3. Sua conta precisa ter acesso ao Token de acesso (solicite com o atendimento MoIP)
  4. A opção URL de retorno esteja ativada, a URL para receber as notificações pode ser seudominio.com.br/?wc-api=WC_Gateway_Moip para o plugin WC MoIP Checkout Transparente você deve informar seudominio.com.br/?wc-api=WC_Gateway_Moip_Transparente
  5. A opção notificação das transações esteja ativada.

Todos os itens acima precisam estar ativados e configurados para que o plugin WooCommerce MoIP funcione. Basta acessar a página de configuração do plugin clicar na aba Portais de Pagamento/MoIP e informar os dados solicitados.

* A URL de retorno não será utilizada mas o MoIP precisa que você informe um endereço do seu site. Você poderia inclusive informar a URL principal do seu site.

WooCommerce MoIP integrado

Mesmo existindo uma documentação razoável e levando-se em conta que não há muito o que configurar no plugin, ainda assim algumas pessoas podem não conseguir utiliza-lo, para resolver isso fiz um vídeo mostrando como configurar e como funciona a integração e como utilizar o plugin MoIP no seu site.

Problemas e soluções

É possível que você enfrente algum problema/dificuldade para configurar o plugin MoIP para WooCommerce, se isto ocorrer você pode tirar suas dúvidas aqui e nós iremos encontrar uma solução o mais rápido possível.

  1. Porque o status das transações não estão mudando na minha loja WooCommerce?
    – Você precisa habilitar a página de notificações de sua conta MoIP, para isso acesse sua conta MoIP Meus dados -> Preferencias -> Notificação das transações.[info]No WooCommerce 2.0 (ou superior) a URL de notificação ou Retorno das transações deve ser sualoja.com/?wc-api=WC_Gateway_Moip para o plugin WC MoIP Checkout Transparente você deve informar seudominio.com.br/?wc-api=WC_Gateway_Moip_Transparente[/info]
  2. Porque não consigo salvar alterações no painel do plugin?
    – Você deve estar utilizando uma versão desatualizada, basta atualizar o plugin para a versão mais recente. Este erro acontece principalmente quando você está utilizando o WooCommerce 2.0 mas o plugin do MoIP não está atualizado. Para atualizar baixe a versão mais recente através de sua conta e siga as instruções sobre Como atualizar plugins.
  3. O plugin está exibindo a mensagem “A causa do erro é Informe o token da Instrução”, como resolver?
    – Para utilizar o MoIP Transparente você precisa passar pela homologação da equipe de atendimento do MoIP, eles vão te fornecer o acesso ao serviço do MoIP Transparente e é a partir disso que você conseguirá realmente utilizar o plugin MoIP Transparente. A mensagem “A causa do erro é Informe o token da Instrução” indica que você está utilizando um token de acesso que permite apenas utilizar o ambiente de testes, então, você precisa solicitar ao atendimento MoIP para realizar homologação da sua loja e quando aprovada, você conseguirá utilizar o serviço MoIP Transparente. Não há outra forma de resolver.
  4. O plugin exibe a mensagem de erro “Entity: line 1: parser error : Opening and ending tag mismatch: HR line 1 and body” sempre que tento executar um pagamento, como resolver?
    – Veja o item 3

** Indica que a função está em testes.

Personalizar icones

No plugin WooCommerce MoIP Transparente a partir da versão 1.9 adicionamos suporte para personalizar os ícones dos meios de pagamento existentes no plugin, isto permite que você escolha seus próprios ícones de pagamento deixando o plugin ainda mais parecido com seu tema.

Para definir seu próprio ícone basta adicionar um pequeno código dentro do arquivo functions.php do seu tema WordPress. Veja um exemplo de como fazê-lo.

Neste exemplo estamos trocando o ícone referente ao cartão de crédito visa e iremos exibir nossa própria imagem ‘nova_imagem.png’ que está dentro da pasta de imagens do tema ativo no seu WordPress. Você pode utilizar qualquer imagem, bastando informar o endereço dela.

/**
* Personalizando ícones do plugin WooCommerce
* MoIP Transparente
*
* @since 1.9
* @see https://woocommerce.com.br/plugin/moip-plugin-woocommerce/
*/
function troca_icone_moip_transparente(){
return get_stylesheet_directory_uri() .’/imagens/nova_imagem.png’;
}
add_filter( ‘wc_moip_icon_visa’, ‘troca_icone_moip_transparente’);

fonte: https://gist.github.com/John-Henrique/5415932

Todos os hooks disponíveis

Abaixo disponibilizamos uma lista completa de hooks disponíveis no plugin MoIP Transparente.

Cartão de crédito

  1. wc_moip_icon_american_express
  2. wc_moip_icon_mastercard
  3. wc_moip_icon_hipercard
  4. wc_moip_icon_diners
  5. wc_moip_icon_visa

Transferencia eletrônica

  • wc_moip_icon_banrisul
  • wc_moip_icon_bradesco
  • wc_moip_icon_brasil
  • wc_moip_icon_itau

Boleto bancário

  • wc_moip_icon_boleto

Outros plugins WooCommerce

Além do Plugin WooCommerce PagSeguro, conheça os plugins para Corrigir moeda, calcular frete dos Correios WooCommerce CorreiosWooCommerce MoIP e Pagamento Digital.

PagSeguro, plugin para WooCommerce

Plugin WooCommerce PagSeguro permite que você utilize o PagSeguro na sua loja virtual WordPress. Esta página possui toda a documentação relacionada ao plugin PagSeguro WooCommerce desenvolvido por John-Henrique. O PagSeguro provavelmente é o gateway de pagamento mais popular no Brasil e você já pode disponibilizar o PagSeguro em sua loja WooCommerce.

Documentação

Estas informações podem ser encontradas também no arquivo readme.txt que acompanha o plugin, qualquer dúvida pode ser esclarecida através dos comentários ou contato direto com o atendimento.

WooCommerce PagSeguro
WooCommerce plugin PagSeguro

A configuração no WooCommerce baseia-se em escolher o País base como Brasil (e seu estado de localização) e moeda Real do Brasil. Em seguida você precisa configurar o plugin WooCommerce PagSeguro. A versão atual do plugin é 1.0.13 e suporta a API 2.0 do PagSeguro, isto inclui.

  1. Retorno automático dos dados
  2. Alteração do status de pagamento
  3. Pagamentos através do Token
  4. Verificação dos valores e itens da compra

Requerimentos

O plugin PagSeguro para WooCommerce é totalmente integrado desde que:

  1. A conta PagSeguro tenha perfil Vendedor ou Profissional (com status “verificada“).
  2. O email informado esteja cadastrado na conta PagSeguro.
  3. A função aceitar somente pagamentos via API esteja ativada.
  4. A opção Notificação das transações esteja ativada, a URL para receber as notificações pode ser sualoja.com.br/?wc-api=WC_Gateway_Pagseguro*
  5. Você tenha gerado o Token de segurança.
  6. Você tenha definido o Código da transação
  7. Bibliotecas cURL e simpleXML estejam ativas

[info]Todos os itens acima precisam estar ativados e configurados para que o plugin WooCommerce PagSeguro funcione. Basta acessar a página de configuração do plugin clicar na aba Portais de Pagamento/PagSeguro e informar os dados solicitados.[/info]

* A URL de retorno não será utilizada mas o PagSeguro precisa que você informe um endereço do seu site. Você poderia inclusive informar a URL principal do seu site.

Guia de funções

Alguns itens do plugin podem não fazer muito sentido para algumas pessoas, por isto alguns deles estão declarados neste trecho da documentação do plugin WooCommerce PagSeguro.

Código da transação

É um identificador que armazenará os dados da transação entre sua loja e o PagSeguro e entre o PagSeguro e sua loja (envio e retorno de dados). Por padrão o plugin PagSeguro utiliza o código da transação notification_code, este é o modo padrão, mas você pode criar seu próprio código de notificação como notificacao, transacao, transacao_id. O importante é que você informe este mesmo código no plugin e na sua conta PagSeguro acessando Integrações -> Página de redirecionamento.

 

WooCommerce PagSeguro integrado

Mesmo existindo uma documentação razoável e levando-se em conta que não há muito o que configurar no plugin, ainda assim algumas pessoas podem não conseguir utiliza-lo, para resolver isso fiz um vídeo mostrando como configurar, como funciona a integração e como utilizar o plugin PagSeguro na sua loja.

Problemas e soluções

Provavelmente você enfrente algum problema com o plugin PagSeguro para WooCommerce, se isto ocorrer você pode tirar suas dúvidas diretamente conosco, iremos encontrar uma solução rapidamente.

  1. Quando faço o pagamento aparece a mensagem “Faça compras apenas em lojas seguras”, o que é isso?
    – Você precisa desabilitar a opção Aceitar pagamentos apenas via API 2.0, na sua conta PagSeguro. Desative a opção e clique em salvar. Seu plugin WooCommerce PagSeguro já estará funcionando corretamente.
  2. Porque o status das transações não estão mudando na minha loja WooCommerce?
    – Você precisa habilitar a página de redirecionamento em sua conta PagSeguro, para isso acesse sua conta PagSeguro clique em Integrações -> Página de redirecionamento. Role a tela até Página de redirecionamento dinâmicos, em Redirecionamento com código da transação clique em Ativado, digite notification_codee clique no botão Ativar.[alert]Entenda que o valor do campo “código da transação” precisa ser o mesmo no campo “código da transação” existente no plugin WooCommerce PagSeguro, se este valor for diferente as alterações de status não serão realizadas.[/alert][info]No WooCommerce 2.0 (ou superior) a URL de notificação ou Retorno dos dados deve ser sualoja.com/?wc-api=WC_Gateway_Pagseguro[/info]
  3. O plugin não funciona ou para de funcionar sem apresentar erros, e agora?
    – Você precisa ter habilitado a biblioteca cURL e simpleXML para que seja possível utilizar o plugin PagSeguro.
  4. Porque não consigo salvar alterações no painel do plugin?
    – Você deve estar utilizando uma versão desatualizada, basta atualizar o plugin para a versão mais recente. Este erro acontece principalmente quando você está utilizando o WooCommerce 2.0 mas o plugin do PagSeguro não está atualizado. Para atualizar baixe a versão mais recente através de sua conta e siga as instruções sobre Como atualizar plugins.
  5. Como resolvo o erro Fatal error: Class ‘woocommerce_order’ not found in /wp-content/plugins/woocommerce-gateway-pagseguro/PagSeguro.Gateway.php on line 302?
    – Este erro é bem comum em versões antigas dos plugin de pagamento para WooCommerce, veja esta página sobre como solucionar o erro “Fatal error: Class ‘woocommerce_order’ not found

Outros plugins WooCommerce

Além do Plugin WooCommerce PagSeguro, conheça os plugins para Corrigir moeda, calcular frete dos Correios WooCommerce CorreiosWooCommerce MoIP e Pagamento Digital.