Summer Cart

Integração com o Summer Cart

Um carrinho de compras PHP completo e fácil de usar.

O Summer Cart possui todas as ferramentas e recursos para que lojistas online criem facilmente uma loja do início ao fim. Seja para vender algumas especialidades de nicho ou listar centenas de produtos populares, você terá grande visibilidade e destaque por meio de uma loja cuidadosamente desenvolvida.

Como integrar o PostAffiliatePro ao Summer Cart

A integração do Post Affiliate Pro com o Summer Cart exige modificar não só o rodapé da sua loja (para adicionar o código de rastreamento de cliques), mas também 2 classes do carrinho de compras. Veja os detalhes da integração abaixo.

Integração de Cliques

O código de rastreamento de cliques deve ser inserido no arquivo skins//customer/footer.tmpl.

Se você não encontrar esse arquivo no seu tema, basta copiá-lo do diretório skeleton para o diretório do seu tema e adicionar o código de rastreamento de cliques, disponível para você no Post Affiliate Pro (menu Ferramentas -> Integração -> Rastreamento de cliques)

Adicione esse código antes da tag </body> no template footer.tmpl.

Integração de Vendas

A integração de vendas ocorre em 2 etapas e é feita por meio de chamadas de requisições à API PAP diretamente do código PHP do seu carrinho de compras para o Post Affiliate Pro.

Na primeira etapa, é criada uma transação no Post Affiliate Pro (status Pendente) e, posteriormente, quando o pedido é entregue ao cliente, a transação no Post Affiliate Pro muda para status Aprovado.

Etapa de Adição de Transação

Seu carrinho de compras criará o pedido no momento em que o visitante for redirecionado para o processador de pagamento (ex: Paypal). Nesse mesmo instante, é criada a transação no Post Affiliate Pro (status Pendente).

Abra o arquivo do carrinho de compras: /include/sc/util/order/OrdersInProgress.php

para que possamos inserir o código de rastreamento de vendas ao final da classe scOrdersInProgress.

Para rastrear todo o pedido como 1 transação (comissão) no Post Affiliate Pro (mesmo que vários itens sejam comprados no mesmo pedido), utilize o código a seguir:

private function registerNewPostAffiliateProTransaction($order) {
    include_once('<PATH_TO_PAP_API>/PapApi.class.php');
    $saleTracker = new Pap_Api_SaleTracker('https://URL_TO_PostAffiliatePro/scripts/sale.php');

    $productIDs = '';
    $items = $order->getOrderItems();
    foreach($items as $item) {
       $productIDs .= $item->get('OrderItemProductCode').',';
    }

    $sale = $saleTracker->createSale();
    $papOrderDetails = $order->getOrderTotalLines();
    $sale->setTotalCost($papOrderDetails[0]->get('OrderTotalLineCustomerCurrencyAmount'));
    $sale->setOrderID($order->getPK());
    $sale->setProductID($productIDs);
 
    $saleTracker->register();
}

Se preferir que cada item comprado seja rastreado como uma transação (comissão) separada no Post Affiliate Pro, utilize o seguinte código:

private function registerNewPostAffiliateProTransaction($order) {
    include_once('<PATH_TO_PAP_API>/PapApi.class.php');
    $saleTracker = new Pap_Api_SaleTracker('https://URL_TO_PostAffiliatePro/scripts/sale.php');
      $items = $order->getOrderItems();
      foreach($items as $item) {
          $sale = $saleTracker->createSale();
          $sale->setTotalCost($item->get('OrderItemTotal'));
          $sale->setOrderID($order->getPK());
          $sale->setProductID($item->get('OrderItemProductCode'));
      }
      $saleTracker->register();
    }

IMPORTANTE: este método deve ser inserido antes do final da classe, ou seja, antes do último } no arquivo /include/sc/util/order/OrdersInProgress.php

IMPORTANTE: Não se esqueça de substituir <PATH_TO_PAP_API> pelo caminho correto do arquivo PapApi.class.php.

O arquivo PapApi.class.php pode ser baixado de sua instalação do Post Affiliate Pro no menu Ferramentas -> Integração -> Integração API.

Copie para seu servidor, onde está instalada sua loja, e defina o caminho correto no local de <PATH_TO_PAP_API>.

Etapa de Adição de Transação

Agora devemos utilizar o método registerNewPostAffiliateProTransaction, adicionado na etapa anterior.

Adicione a seguinte linha de código no método createOrder, logo antes da última linha:

return $this->_lastOrderId;


$this->registerNewPostAffiliateProTransaction($order);

Alterando o status da transação

O status das transações no Post Affiliate Pro pode ser controlado alterando o status do pedido no seu carrinho de compras.

O código abaixo irá alterar o status da transação PAP para Aprovado se você definir o pedido como Entregue.

E irá definir o status da transação PAP como Recusado se o pedido for Cancelado, Falhou ou Devolvido.

Edite o arquivo do carrinho de compras /include/sc/domainobj/Order.php e ao final da classe Order adicione o seguinte método:

private function updatePostAffiliateProTransaction() {
  try {
      include_once('<PATH_TO_PAP_API>/PapApi.class.php');
    $session = new Gpf_Api_Session("https://URL_TO_PostAffiliatePro/scripts/server.php");

    if(!$session->login("<MERCHANT_USERNAME>","<MERCHANT_PASSWORD>")) {
      return false;
    }


    $request = new Pap_Api_TransactionsGrid($session);
    $request->addFilter("orderid", Gpf_Data_Filter::LIKE, $this->getPK());
    $request->addFilter("rtype", Gpf_Data_Filter::EQUALS, 'S');
    try {
        $request->sendNow();
        $grid = $request->getGrid();
        $recordset = $grid->getRecordset();
    } catch (Exception $e) {
      return false;
    }

    foreach($recordset as $rec) {
      $transaction = new Pap_Api_Transaction($session);
      $transaction->setTransid($rec->get('transid'));
      try {
          if(!$transaction->load()) {
           return false;
          } else {
             if ($transaction->getStatus() != 'D') {
              $newStatus = '';
              switch($this->get('OrderStatus')) {
                case scOrderStatus::ORDER_STATUS_UNFINISHED:
                  case scOrderStatus::ORDER_STATUS_PAYMENT_PENDING:
                  case scOrderStatus::ORDER_STATUS_NEW:
                  case scOrderStatus::ORDER_STATUS_IN_PROGRESS:
                  case scOrderStatus::ORDER_STATUS_ON_HOLD:
                  case scOrderStatus::ORDER_STATUS_QUEUED:
                    $newStatus = 'P';
                    break;
                  case scOrderStatus::ORDER_STATUS_RETURNED:
                case scOrderStatus::ORDER_STATUS_PAYMENT_FAILED:
                  case scOrderStatus::ORDER_STATUS_CANCELLED:
                    $newStatus = 'D';
                    break;
                  case scOrderStatus::ORDER_STATUS_DELIVERED:
                    $newStatus = 'A';
                    break;
                  default:
                    return false;
              }
              // alterando o status da transação
              if (strlen($newStatus) && $transaction->getStatus() != $newStatus) {
                $transaction->setStatus($newStatus);
                $transaction->save();
              }
           }
          }
      } catch (Exception $e) {
        return false;
      }
    }
    } catch (Exception $e) {
      return false;
    }
    return true;
}

IMPORTANTE: este método deve ser inserido antes do final da classe, ou seja, antes do último } no arquivo /include/sc/domainobj/Order.php

IMPORTANTE: Não se esqueça de substituir <PATH_TO_PAP_API> pelo caminho correto do arquivo PapApi.class.php.

O arquivo PapApi.class.php pode ser baixado da sua instalação do Post Affiliate Pro no menu Ferramentas -> Integração -> Integração API.

Copie para seu servidor, onde está instalada sua loja, e defina o caminho correto no local de <PATH_TO_PAP_API>.

IMPORTANTE: No lugar de <MERCHANT_USERNAME> utilize seu nome de usuário de comerciante e, em <MERCHANT_PASSWORD>, sua senha. A requisição da API usará suas credenciais para acessar as transações em sua instalação do Post Affiliate Pro.

Alterando o status da transação

Agora devemos utilizar o método que adicionamos à classe Order.

Adicione a seguinte linha de código (conforme mostrado abaixo) no arquivo /include/sc/domainobj/Order.php ao final dos métodos updateOrderStatus e setOrderStatus.

$this->updatePostAffiliateProTransaction();

Status Personalizados de Pedido

Se você planeja utilizar status personalizados de pedido no seu Summer Cart, deve adaptar o método updatePostAffiliateProTransaction no arquivo /include/sc/domainobj/Order.php.

Na função switch, adicione novas instruções case, onde o valor será o ID do seu status personalizado.

O que é o Summer Cart?

O Summer Cart é uma solução completa de software para e-commerce desenvolvida para facilitar a criação e gestão de lojas virtuais. Ele permite que empresas de todos os tamanhos estabeleçam uma presença online robusta com facilidade. Oferecendo uma ampla gama de recursos, como gerenciamento de catálogo de produtos, processamento de pedidos, gestão de relacionamento com o cliente e ferramentas integradas de marketing, o Summer Cart serve como uma plataforma tudo-em-um para negócios de e-commerce iniciantes e já consolidados.

Desenvolvido pela Mirchev Ideas, uma empresa de software búlgara fundada por Georgi Mirchev, o Summer Cart estreou em 2008. Concebido com o objetivo de tornar o varejo online acessível e econômico para empresas na Bulgária, rapidamente ganhou espaço no mercado. Em 2014, o Summer Cart já era a base de mais de 2.700 lojas online, demonstrando sua versatilidade e o valor que trouxe ao cenário do e-commerce.

O Summer Cart atende principalmente pequenas e médias empresas (PMEs) de diversos setores, como moda, eletrônicos e artigos para o lar. Sua interface amigável e conjunto abrangente de recursos o tornam uma escolha ideal para quem busca uma solução integrada. Com design responsivo para dispositivos móveis, suporte multilíngue e multimoeda, além de funcionalidades B2B avançadas, o Summer Cart permite que empresas ampliem seu alcance e aumentem as vendas online com facilidade.

Principais Recursos do Summer Cart

• Ferramentas de Otimização SEO: Melhore a visibilidade da sua loja nos buscadores para atrair mais clientes.
• Painel Administrativo Avançado: Gerencie sua loja com eficiência, contando com mais de 1.000 funcionalidades.
• Design Responsivo e Personalizável: Crie uma vitrine online única e com ótima aparência em qualquer dispositivo.
• Ferramentas Avançadas de Vendas e Marketing: Impulsione suas vendas com recursos como recuperação de carrinho abandonado.
• Suporte Internacional: Atenda a um público global com opções multilíngues e multimoeda.
• Medidas de Segurança Robusta: Proteja os dados dos clientes com recursos de segurança avançados.

Opções de Preço do Summer Cart

O Summer Cart oferece planos flexíveis para atender diversas necessidades empresariais, variando de US$ 222 a US$ 829 por ano. Cada nível oferece diferentes recursos e níveis de suporte, permitindo que as empresas escolham o plano que melhor se adequa às suas demandas. Para informações detalhadas sobre preços, acesse a Página Oficial de Preços do Summer Cart .

Opinião de Usuários sobre o Summer Cart

Embora avaliações específicas de usuários não estejam acessíveis aqui, os feedbacks geralmente destacam os recursos extensos e a interface amigável do Summer Cart. Alguns usuários observam que pode haver uma curva de aprendizado devido à profundidade do software, e que o preço pode ser um fator a ser considerado por algumas empresas. Para depoimentos e avaliações detalhadas, recomenda-se consultar plataformas especializadas como o G2.

Vídeo de Avaliação do Summer Cart

• Análise detalhada do software de e-commerce Summer Cart

Alternativas ao Summer Cart

Se você está buscando outras opções além do Summer Cart, considere estas plataformas de e-commerce populares:

• BigCommerce
• Spocket
• Payhip
• Rap Booster
• Weebly Ecommerce
• WooCommerce
• PrestaShop
• OpenCart
• Wix
• Squarespace

Essas alternativas oferecem uma variedade de recursos e modelos de preços que podem se ajustar às necessidades específicas do seu negócio.