Marketplace
Como funciona
A solução de Marketplace Gerencianet possibilita a qualquer conta Gerencianet a criação de uma plataforma multivendas. Com esta solução, você pode utilizar seu site para realizar as vendas e informar, através da integração, como deverá ser feita a divisão do valor recebido entre diferentes contas Gerencianet. Funciona para sua conta e também as dos seus parceiros.
As configurações de repasses são feitas ao nível de produto, e não de cobrança. Isso permite que você defina uma porcentagem X para sua conta receber na venda de um determinado produto e uma porcentagem Y para outro produto, mesmo que eles tenham sido comprados juntos.

Como integrar
Para integrar ao Marketplace Gerencianet, você precisa, primeiramente, realizar uma integração de geração de cobranças. Atualmente, existem duas formas de gerar cobrança via integração:
- API de pagamentos: seu site redireciona o cliente para a tela de pagamento da Gerencianet.
- Checkout Transparente: seu cliente efetua o pagamento sem sair do seu site.
Após concluir uma integração de geração de cobrança você poderá dar continuidade à sua integração de Marketplace.
Autorização de Contas de Recebimento
O integrador deverá cadastrar em sua conta Gerencianet as contas que estão autorizadas a receber valores de suas integrações. Apenas contas autorizadas estarão disponíveis para serem utilizadas na etapa seguinte, de configuração de repasses.
Para autorizar uma conta Gerencianet é necessário saber o Identificador Marketplace de Conta da mesma. Todas as contas possuem esse identificador marketplace e ele pode ser visualizado na tela Desenvolvedor >> Marketplace.
Portanto, para autorizar uma conta você precisa solicitar esse identificador marketplace de conta ao dono da conta e cadastrá-lo no link autorizar uma nova conta na tela Desenvolvedor >> Marketplace.
Cadastro de Configurações de Repasses
A configuração de repasse permite que você defina as porcentagens que cada conta deverá receber ao vender determinado item, incluindo a própria conta integradora.
Antes de cadastrar uma nova configuração, certifique-se de que todas as contas que devem receber repasses estejam autorizadas. Para cadastrar uma configuração de repasse, é necessário definir uma modalidade para a cobrança das taxas de intermediação Gerencianet. Existem duas modalidades:
- Modalidade 1: Todas as taxas serão cobradas da conta integradora. Nesta modalidade, se a porcentagem de repasse da conta for muito baixa, a ponto de não cobrir o débito da taxa, então a venda não poderá ser concretizada.
- Modalidade 2: A taxa é dissolvida proporcionalmente entre a conta integradora e todas as contas autorizadas selecionadas na configuração do repasse. Se uma determinada conta recebe 90% da venda, essa conta assumirá 90% da taxa.
Para cadastrar uma configuração de repasse, clique no link cadastre um novo repasse na tela Desenvolvedor >> Marketplace.
Ao finalizar o cadastro, um código será gerado para a configuração de repasse. Esse código deverá ser utilizado na integração, para identificar como será realizada a divisão de valores do item.
Integração: Utilização das Configurações de Repasses cadastradas
Identifique, na integração já realizada, o nó responsável pelas informações dos itens que estão sendo vendidos. Este nó deverá ser complementado com as informações do Marketplace, como destacado no exemplo a seguir:
- <item>
- <itemDescricao>Smartphone</itemDescricao>
- <itemValor>50000</itemValor>
- <itemQuantidade>5</itemQuantidade>
- <marketplace>
- <codigo>XXXXXX</codigo>
- </marketplace>
- </item>
Ao enviar a informação de marketplace para pelo menos um item, é necessário enviá-la para todos os itens daquela cobrança, para que seja possível dividi-los corretamente. Caso exista algum item sem informação de marketplace, uma configuração de repasse é gerada automaticamente, onde 100% do valor do item é repassado à conta integradora. O mesmo ocorre quando é enviado um código que não existe entre as configurações de repasses cadastradas na conta.
Descrição dos parâmetros de entrada
A descrição detalhada dos parâmetros adicionais de marketplace são informados na tabela a seguir:
Tag | Obrigatória | Descrição |
---|---|---|
marketplace | sim | Tag que engloba dados sobre o marketplace para o item. |
codigo | sim | Código de repasse atribuído ao item. (o mesmo código pode ser utilizado em vários itens) |
A descrição detalhada para os demais parâmetros a serem enviados na integração poderá ser obtida na documentação de API de pagamentos ou Checkout Transparente.