No commit activity in last 3 years
No release in over 3 years
Gem to wrap incentivale.com.br API v3
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.16
~> 10.0

Runtime

 Project Readme

Incentivale v3 Ruby SDK

Gem para integrar com a API v3 da incentivale.com.br

Gem Version

Índice

  • Instalação
  • Configurando a autenticação
  • Exemplos de Uso:
    • Produtos
      • Listagem
    • Resgates
      • Criação
      • Consulta
    • Tracking do pedido
    • E-gift
      • Verificar disponibilidade
      • Transação
  • Documentação
  • Licença

Instalação

Adicione a seguinte linha no seu Gemfile:

gem 'incentivale-sdk-ruby', require: 'incentivale'

Depois, rode o bundle install.

Configurando a autenticação

Crie o arquivo incentivale.rb no caminho 'config/initializers' com os dados para autenticação com a sua conta:

Incentivale.configure do |config| 
  config.username = 'usuario@email.com' # Substitua pelo seu username de login
  config.password = 'senhaXXX' # Substitua pelo sua senha de login
  config.campaign = '02a3e18d37174beb93665dd40f11d106' # Substitua pelo seu token de identificação da campanha
  config.environment = :sandbox # Substitua pelo ambiente desejado (:sandbox / :production)
end

Produtos

Listagem

Serviço responsável em identificar os produtos do catálogo, negociado anteriormente junto ao comercial da Incentivale. Todos os produtos são identificados pelo SKU.

products = Incentivale.products.all

Resgates

Criação

Serviço responsável em enviar o resgate do pedido - Cartão físico, virtual, recarga, pague contas e cartão pré-pago.

redemption = Incentivale.redemption.create({ 
    cod_request: '45214',
    sku: 'CPVEX045V200',
    name: 'João de souza',
    cpf_cnpj: '045125478555',
    email: 'joao@teste.com',
    address: 'Rua frederico jorge',
    address_number: '1255',
    complement: 'Bloco A',
    district: 'Centro',
    city: 'Blumenau',
    state: 'SC',
    cep: '8978858',
    phone_contact: '4785552544',
    date_register: '2017-05-12',
    amount_premium: '3',
    price_premium: '',
    pay_bill_barcode: '',
    pay_bill_value: '',
    code_card: '' 
})

Consulta

Serviço responsável em identificar pedido do lote.

cod_request = 45214 # Controle do cliente
order = Incentivale.redemption.find(cod_request)

Tracking do pedido

Serviço responsável em identificar cada pedido individualmente, todos os pedidos acima de 3 (três) itens são enviados em lote. Ex: Pedido XXX com 5 itens = (Lote um - 2 itens / Lote dois - 3 itens)

cod_request = 45214 # Controle do cliente
tracking = Incentivale.tracking.find(cod_request)

E-gift

Verificar disponibilidade

Serviço responsável em verificar disponibilidade do produto em estoque.

sku = 'CPVMO083V50'
amount = 2
availability = Incentivale.egift.available?(sku, amount)

Transação

Serviço responsável em efetivar o E-gift.

egift = Incentivale.egift.create({
    cod_request: '4588',
    sku: 'CPVMO083V50',
    amount_premium: '2',
    name: 'João da silva',
    cpf_cnpj: '23432234234',
    email: 'joaodasilva@gmail.com' 
})

Documentação

Documentação oficial

Licença

The gem is available as open source under the terms of the MIT License.