Manual de Integraao

Verso 2.0
Emisso direta via Boleto Bancrio Emisso via Mltiplas Formas de Pagamento Emisso de Faturas com cadastro em ambiente Gerncianet Integrao com Carrinho de Compras Acesso do Cliente Final em ambiente Gerncianet

TECNOLOGIA GERENCIANET 2011 CNPJ 09.089.356/0001-18

Sumrio
1. Emisso Direta de Boleto Bancrio 1.1. Gerao de Boleto sem cadastro de cliente 1.2. Gerao de Boleto com cadastro de cliente 2. Emisso Utilizando Mltiplas Formas de Pagamento 2.1. Cadastro em ambiente prprio 2.2. Cadastro em ambiente Gerncianet 3. Integrao com Carrinho de Compras 4. Acesso personalizado para seu cliente 2 2 3 8 8 9 12 14

Gerncianet Tecnologia em Pagamentos

Pgina 1

1. Emisso Direta de Boleto Bancrio

Na integrao de boleto bancrio, seu site repassa para nosso Sistema os dados necessrios para emisso do boleto, que gerado imediatamente e exibido de forma simples e direta.

SEU SITE
Dados - Produto Dados - Cliente

GERNCIANET

(via POST)
COMPRAR

PASSO-A-PASSO

Acesse o menu Configuraes / Validar Integrao e cadastre o domnio do seu site para autorizar a integrao com a sua conta. Para cada produto/servio que deseja realizar a integrao, insira um dos cdigos HTML a seguir como sendo o boto Finalizar Compra.

1.1- Cdigo HTML simplificado, sem insero do cliente no Sistema

Neste cdigo, o boleto gerado normalmente mas o cliente que realizou a compra no adicionado em seu sistema Gerncianet, um exemplo de cdigo para quem busca rapidez na finalizao da compra, visto que necessita de poucas informaes do cliente.
<form name="GerenciaNet" id="GerenciaNet" method="post" action="https://www.gerencianet.com.br/gerboleto.php"> <input name="login" type="hidden" id="login" value="GNT_001_LOG" /> <input name="item" type="hidden" id="item" value="GNT_002_INF" /> <input name="valor" type="hidden" id="valor" value="GNT_003_VAL" /> <input name="venc" type="hidden" id="venc" value="GNT_004_VEN" /> <input name="nome" type="hidden" value="GNT_006_NOM" /> <input name="email" type="hidden" value="GNT_007_EMA" /> <input name="cpf" type="hidden" value="GNT_008_CPF" /> <input name="retorno" type="hidden" value=" GNT_009_COD" /> <!-- Retirar este campo se no for utilizar retorno --> <input name="tipoResp" type="hidden" value=" GNT_010_RES" /> <input name="button" type="image" id="button" value="Submit" src="http://www.gerencianet.com.br/img/btnComprar.gif" /> </form>

Gerncianet Tecnologia em Pagamentos

Pgina 2

1.2- Cdigo HTML completo, com insero do cliente no Sistema (recomendvel)

Neste cdigo, o boleto gerado e as informaes passadas pelo cliente so inseridas em seu sistema Gerncianet, criando um novo cliente caso este j no exista, e possibilitando o acompanhamento de toda movimentao do mesmo, verificando faturas pagas, inadimplentes, identificando produtos ou servios que sejam de interesse do cliente, enfim, pode visualizar o perfil de cada indivduo que contrata seus servios e adquire seus produtos. Neste tipo de integrao, os dados do cliente so repassados diretamente pelo seu site, utilizando um formulrio prprio ou a obteno a partir de um banco de dados prprio. Em ambos os casos, preciso que o programador esteja atento s validaes de dados para evitar o envio de informaes incorretas ao sistema, o que pode impedir a gerao do boleto bancrio. Um exemplo de validao seria a verificao do nmero de dgitos contidos no CEP, que deve ser 8, sem hfen ou qualquer caractere especial. Caso voc no possua um formulrio com validaes adequadas mas seja de seu interesse que os dados sejam adicionados ao sistema Gerncianet, existe a opo de utilizao do carrinho de compras Gerncianet. (Ver Integrao Carrinho de Compras).
<form name="GerenciaNet" id="GerenciaNet" method="post" action="https://www.gerencianet.com.br/gerboleto.php"> <input name="login" type="hidden" id="login" value="GNT_001_LOG" /> <input name="item" type="hidden" id="item" value="GNT_002_INF" /> <input name="valor" type="hidden" id="valor" value="GNT_003_VAL" /> <input name="venc" type="hidden" id="venc" value="GNT_004_VEN" /> <input name="periodicidade" type="hidden" id="periodicidade" value="GNT_005_PER" /> <input name="nome" type="hidden" value="GNT_006_NOM" /> <input name="email" type="hidden" value="GNT_007_EMA" /> <input name="cpf" type="hidden" value="GNT_008_CPF" /> <input name="retorno" type="hidden" value=" GNT_009_COD" /> <!-- Retirar este campo se no for utilizar retorno --> <input name="tipoResp" type="hidden" value="GNT_010_RES" /> <input name="telefone" type="hidden" value="GNT_011_TEL" /> <input name="ie" type="hidden" value="GNT_012_IES" /> <input name="cep" type="hidden" value="GNT_013_CEP" /> <input name="rua" type="hidden" value="GNT_014_RUA" /> <input name="numero" type="hidden" value="GNT_015_NUM" /> <input name="complemento" type="hidden" value="GNT_016_COM" /> <input name="bairro" type="hidden" value="GNT_017_CPF" /> <input name="cidade" type="hidden" value="GNT_018_CID" /> <input name="senha" type="hidden" value="GNT_019_SEN" /> <input name="uf" type="hidden" value="GNT_020_UF" /> <input name="button" type="image" id="button" value="Submit" src="http://www.gerencianet.com.br/img/btnComprar.gif" /> </form>

ATENO: Todos os cdigos marcados em vermelho so obrigatrios e devem ser substitudos por informaes do seu cliente. Os campos em azul so opcionais. Um maior detalhamento sobre o que cada cdigo significa pode ser visualizado na tabela a seguir. Gerncianet Tecnologia em Pagamentos

Pgina 3

CDIGO GNT_001_LOG

SIGNIFICADO Seu login Gerncianet.

GNT_002_INF

Informao sobre o item comprado: Neste local, preciso inserir o NOME do produto ou do servio que est sendo vendido. (No utilize acentos).

GNT_003_VAL

Valor do Produto / Servio: O valor no deve ter os caracteres R$, e deve possuir uma vrgula separando o real do centavo, exemplo: 45,00. Obs: Para valores superiores a R$ 1000,00, no utilize separao de milhar, exemplo: 2340,00.

GNT_004_VEN
(opcional)

Data do vencimento do boleto bancrio: A data dever estar no formato dd/mm/aaaa. Deixe este campo em branco para utilizar o prazo padro definido em sua conta Gerncianet.

GNT_005_PER
(opcional)

Periodicidade do Boleto Bancrio: Escolhendo um valor entre 0 e 24, voc poder definir uma periodicidade para o boleto. Peridiocidade 0: Cobrana nica. Peridiocidade 1: Cobrana mensal. (O mesmo boleto ser enviado para o mesmo cliente todo ms). Peridiocidade 2: Cobrana bimestral. (O mesmo boleto ser enviado para o mesmo cliente a cada 2 meses). E assim por diante.

GNT_006_NOM

Nome Completo do Cliente.

GNT_007_EMA
(opcional)

E-mail do cliente.

GNT_008_CPF

CPF do cliente.

GNT_009_COD
(opcional)

Cdigo de Retorno: Em integraes mais complexas, possvel permitir a consulta de detalhes e status de suas cobranas via XML. O cdigo retorno pode ser qualquer sequncia de caracteres (mximo 40), desde que seja nico para cada cobrana. A consulta realizada atravs da url: https://www.gerencianet.com.br/retornoxml.php?cod=X&retorno=Y. Sendo: X: Login da conta Gerncianet. Y: Cdigo retorno de uma determinada fatura.

Gerncianet Tecnologia em Pagamentos

Pgina 4

GNT_010_RES
(opcional)

Tipo de Resposta: Nesse campo existem as opes de obter como resposta um XML com o status da integrao ou um HTML, que gera o boleto. Resposta HTML enviar html Resposta em XML enviar xml

GNT_011_TEL

Nmero do telefone do cliente com DDD, sem parnteses ou hfens. Ex: 03135510580.

GNT_012_IES
(opcional)

Caso o cliente seja pessoa jurdica, insira o nmero de Inscrio Estadual.

GNT_013_CEP

CEP do cliente sem hfen. Ex: 35400000.

GNT_014_RUA

Nome da rua onde o cliente mora.

GNT_015_NUM

Nmero da residncia do cliente.

GNT_016_COM
(opcional)

Complemento de endereo do cliente.

GNT_017_BAI

Nome do bairro onde o cliente mora.

GNT_018_CID

Nome da cidade onde o cliente mora.

GNT_019_SEN

Senha pessoal do cliente. Esta poder ser utilizada pelo cliente para acessos futuros. Ateno! No se trata da senha de sua conta, mas sim de uma senha especfica para o cliente. Se este campo no for informado o sistema gerar uma senha aleatria para o cliente. Se o email do cliente foi informado ser enviado em email com os dados de acesso.

GNT_020_UF

Sigla do estado onde o cliente mora em letras maisculas. (ex.: MG)

Gerncianet Tecnologia em Pagamentos

Pgina 5

EXEMPLO PRTICO
Para facilitar o processo de integrao com seu site, mostramos aqui um exemplo prtico de utilizao da Emisso Direta de Boleto Bancrio. Nos cdigos HTML exibidos anteriormente, todos os campos encontram-se com tipo hidden, ou oculto. O que significa que nenhum destes ser exibido visualmente para o cliente que est realizando a compra. Estes campos devem permanecer desta forma apenas se os dados do cliente estiverem sendo adicionados de um banco de dados interno do site, por exemplo: <? $cepCliente = "Seleciona do Banco o CEP do cliente que est realizando a compra. " ?> <input name="cep" type="hidden" value="<? echo $cepCliente; ?>" /> Neste caso, os dados sero capturados do Banco e o cliente no precisa digit-los. Entretanto, se no existe um Banco de Dados com estas informaes, os campos podem ter o tipo modificado para text, exibindo-os para que cada cliente digite sua informao no momento da compra. Mas lembre-se: os dados que no se referem ao cliente, mas sim sua conta, devem continuar com o tipo hidden. Mostramos a seguir um exemplo de formulrio que captura informaes necessrias do cliente. Primeiramente, como o formulrio aparece na tela, e em seguida, seu cdigo HTML.

Formulrio 01 Modo Design

Gerncianet Tecnologia em Pagamentos

Pgina 6

<form name="GerenciaNet" id="GerenciaNet" method="post" action="https://www.gerencianet.com.br/gerboleto.php"> <h1>FORMULRIO DE EMISSO DE FATURA</h1><br /><br /> <input name="login" type="hidden" id="login" value="1234-5" /> <input name="item" type="hidden" id="item" value="Notebook Exemplo" /> <input name="valor" type="hidden" id="valor" value="1000,00" /> <input name="venc" type="hidden" id="venc" value="" /> <input name="periodicidade" type="hidden" id="periodicidade" value="0" /> Nome completo:* <input name="nome" type="text" value="" /><br /> E-mail:* <input name="email" type="text" value="" /><br /> CPF:* <input name="cpf" type="text" value="" /><br /> Telefone: <input name="telefone" type="text" value="" /><br /> Nmero de Inscrio Estadual (se empresa): <input name="ie" type="text" value="" /><br /> CEP:* <input name="cep" type="text" value="" /><br /> Rua:* <input name="rua" type="text" value="" /><br /> Nmero da residncia:* <input name="numero" type="text" value="" /><br /> Complemento:* <input name="complemento" type="text" value="" /><br /> Bairro:* <input name="bairro" type="text" value="" /><br /> Cidade:* <input name="cidade" type="text" value="" /><br /> UF:* <input name="uf" type="text" value="" /><br /> Senha:* <input name="senha" type="password" value="" /><br /> <input name="button" type="image" id="button" value="Submit" src="https://www.gerencianet.com.br/img/botboleto.gif" /><br /> </form>

Formulrio 01 Modo Cdigo

NOTA Cdigos completos sobre este tipo de Integrao podem ser baixados atravs do link: https://www.gerencianet.com.br/downloads/Integracao01.rar

Gerncianet Tecnologia em Pagamentos

Pgina 7

UTILIZANDO A FUNO TIPO DE RESPOSTA

Existem duas opes para se obter a resposta de integrao com o sistema, sendo a resposta em XML ou em HTML. O tipo de resposta um campo opcional e tem como default a resposta em HTML, que gera automaticamente o boleto. Ao se optar por uma resposta em XML retornado o status da integrao, chave da fatura, nmero do retorno, link para consulta do retorno, lote e o link para visualizar a fatura. No caso do status ser falha na integrao retornado um XML com a listagen dos erros. Dois exemplos de respostas XML so exemplificado a seguir:
<?xml version="1.0" encoding="utf-8" ?> <gerencianet> <status>Falha na integracao</status> <erro>login no informado</erro> <erro>item no informado</erro> <erro>valor no informado </erro> <erro>cpf no informado</erro> <erro>formulario incompleto</erro> </gerencianet>

XML 01 - Exemplo com falha na integrao

<?xml version="1.0" encoding="utf-8" ?> <gerencianet> <status>integracao realizada com sucesso</status> <chave>20029-9874563-AXB85</chave> <retorno>numero do retorno</retorno> <consultaRetorno>link para consulta do retorno</consultaRetorno> <lote>20029-9874563-AXB85</lote> <link>https://contagerencianet.com.br/fatura/leitura.php?lote=20 010_90_CAXI9&chave=A4XB-20029-9874563-AXB85 </link> </gerencianet>

XML 02 - Exemplo de integrao realizada com sucesso

UTILIZANDO A FUNO DE RETORNO

O campo retorno possibilita a visualizao de status das faturas emitidas em um momento posterior emisso. Para utilizar esta ferramenta preciso ter em mente que cada cobrana deve possuir um cdigo nico. Ou seja, deve ser criada uma lgica para a definio dos cdigos de forma que este no se repita. Este cdigo ser utilizado nas consultas de status sobre a fatura, e enviado no mesmo POST utilizado para envio dos outros dados. Para que a fatura seja relacionada ao cdigo de retorno escolhido, basta envilo atravs do seguinte trecho: <input name="retorno" type="hidden" value="exemplo_254169" /> Para visualizar detalhes da fatura emitida acesse o link, semelhante ao exemplo a seguir:
Gerncianet Tecnologia em Pagamentos Pgina 8

https://www.gerencianet.com.br/retornoxml.php?COD=LoginGerencianet&retorno=exemplo_254169

O mesmo retornar um documento XML como mostrado a seguir:

<?xml version="1.0" encoding="utf-8"?> <gerencianet> <cliente> <codigoCliente>34</codigoCliente> <cliente>Carlos Macedo</cliente> <cpfcnpj>14563285471</cpfcnpj> <email>carlosmacedo@gerencianet.com.br</email> </cliente> <cobranca> <chave>20029-9667240-FIBGHI7</chave> <pedido>9667240</pedido> <dataHora>2011-05-07 16:22:52</dataHora> <retorno>145ASSSD2q564854</retorno> <pagconf>n</pagconf> <status>pagamento confirmado manualmente</status> <periodicidade></periodicidade> <opsPagamento>pag4;pag1;pag2</opsPagamento> <pagamento>pag1</pagamento> <desconto>1000</desconto> <total>2500</total> <vencimento>2011-01-01</vencimento> <taxaBoleto>0</taxaBoleto> </cobranca> <item> <produto>SERVICO</produto> <quantidade>1</quantidade> <valorUnitario>2500</valorUnitario> </item> </gerencianet>

2. Emisso com Mltiplas Formas de Pagamento

Nesta integrao, disponibilizamos para seu cliente todas as formas de pagamento previamente definidas por voc no Sistema Gerncianet. O cliente poder escolher dentre as opes, como deseja realizar o pagamento. As opes de pagamento que disponibilizamos no Sistema so: Boleto Bancrio Carto de crdito Visa Carto de Crdito MASTERCARD Depsito Bancrio Cheque

Gerncianet Tecnologia em Pagamentos

Pgina 9

No menu Configuraes possvel determinar quais formas de pagamentos devem ser exibidas para seus clientes. possvel definir, por exemplo, que os clientes somente podero efetuar pagamentos atravs de boletos e cartes. SEU SITE GERNCIANET
OPES PAG: 1. 2. COMPRAR 3.

GERNCIANET

PASSO-A-PASSO

Acesse o menu Configuraes / Validar Integrao e cadastre o domnio do seu site para autorizar a integrao com a sua conta. Para cada produto/servio que deseja realizar a integrao, insira um dos cdigos HTML a seguir como sendo o boto Finalizar Compra.

2.1- Cadastro de Cliente em Ambiente Prprio

Neste cdigo, o site precisa repassar os dados do cliente via POST para a Gerncianet, ou seja, necessrio que o site possua um formulrio para obteno destes dados em algum momento. Caso o site no possua qualquer ferramenta para captura destes dados, possvel utilizar nosso ambiente para realizar o cadastro. Neste caso, veja o prximo tpico: Cadastro de cliente em ambiente Gerncianet.
<form name="GerenciaNet" id="GerenciaNet" method="post" action="https://www.gerencianet.com.br/modulo.php"> <input name="login" type="hidden" id="login" value="GNT_001_LOG" /> <input name="item" type="hidden" id="item" value="GNT_002_INF" /> <input name="valor" type="hidden" id="valor" value="GNT_003_VAL" /> <input name="venc" type="hidden" id="venc" value="GNT_004_VEN" /> <input name="periodicidade" type="hidden" id="periodicidade" value="GNT_005_PER" /> <input name="nome" type="hidden" value="GNT_006_NOM" /> <input name="email" type="hidden" value="GNT_007_EMA" /> <input name="cpf" type="hidden" value="GNT_008_CPF" /> <input name="retorno" type="hidden" value=" GNT_009_COD" /> <!-- Retirar este campo se no for utilizar retorno --> <input name="tipoResp" type="hidden" value=" GNT_010_RES" /> <input name="telefone" type="hidden" value="GNT_011_TEL" />

Gerncianet Tecnologia em Pagamentos

Pgina 10

<input name="ie" type="hidden" value="GNT_012_IES" /> <input name="cep" type="hidden" value="GNT_013_CEP" /> <input name="rua" type="hidden" value="GNT_014_RUA" /> <input name="numero" type="hidden" value="GNT_015_NUM" /> <input name="complemento" type="hidden" value="GNT_016_COM" /> <input name="bairro" type="hidden" value="GNT_017_CPF" /> <input name="cidade" type="hidden" value="GNT_018_CID" /> <input name="senha" type="hidden" value="GNT_019_SEN" /> <input name="button" type="image" id="button" value="Submit" src="http://www.gerencianet.com.br/img/btnComprar.gif" /> </form>

2.2- Cadastro de Cliente em Ambiente Gerncianet

Neste cdigo, a Gerncianet disponibiliza um formulrio para que o seu cliente entre com as informaes pessoais diretamente em ambiente Gerncianet. Aps a captura dos dados, so mostradas as formas de pagamento que o cliente tem a possibilidade de escolher, em seguida a fatura gerada conforme a escolha.
<form name="GerenciaNet" id="GerenciaNet" method="post" action="https://www.gerencianet.com.br/modulo.php"> <input name="login" type="hidden" id="login" value="GNT_001_LOG" /> <input name="item" type="hidden" id="item" value="GNT_002_INF" /> <input name="valor" type="hidden" id="valor" value="GNT_003_VAL" /> <input name="venc" type="hidden" id="venc" value="GNT_004_VEN" /> <input name="periodicidade" type="hidden" id="periodicidade" value="GNT_005_PER" /> <input name="retorno" type="hidden" value=" GNT_009_COD" /> <!-- Retirar este campo se no for utilizar retorno --> <input name="tipoResp" type="hidden" value=" GNT_010_RES" /> <input name="button" type="image" id="button" value="Submit" src="http://www.gerencianet.com.br/img/btnComprar.gif" /> </form>

ATENO: Todos os cdigos marcados em vermelho so. Os campos em azul so opcionais. Um maior detalhamento sobre o que cada cdigo significa pode ser visualizado na tabela da Pgina 4.

EXEMPLO PRTICO
Para facilitar o processo de integrao com seu site, mostramos aqui um exemplo prtico de utilizao da Emisso Utilizando Mltiplas Formas de Pagamento. O exemplo exibido aqui se refere Integrao de Mltiplas Formas de Pagamento com cadastro em ambiente Gerncianet, visto que a integrao utilizando ambiente prprio se difere do Exemplo Prtico anterior (ver Pgina 5) apenas pelo endereo do atributo action. Ao utilizar este tipo de integrao em ambiente Gerncianet, seu site no precisar capturar quaisquer dados do cliente, tudo ficar por conta do nosso Sistema.
Gerncianet Tecnologia em Pagamentos Pgina 11

Os dados enviados so referentes apenas conta e ao produto que est sendo adquirido, portanto, estes dados viro essencialemente de campos do tipo hidden, como mostrado a seguir.
<form name="GerenciaNet" id="GerenciaNet" method="post" action="https://www.gerencianet.com.br/modulo.php"> <input name="login" type="hidden" id="login" value="1234-5" /> <input name="item" type="hidden" id="item" value="Notebook Exemplo" /> <input name="valor" type="hidden" id="valor" value="1000,00" /> <input name="venc" type="hidden" id="venc" value="" /> <input name="periodicidade" type="hidden" id="periodicidade" value="0" /> <input name="button" type="image" id="button" value="Submit" src="https://www.gerencianet.com.br/img/botboleto.gif" /> </form>

Formulrio 01 Modo Cdigo

Para o cliente, no ser exibido nenhum formulrio no site, entretanto, a partir do momento em que ele clica no boto da compra, uma tela da Gerncianet solicita algumas informaes de cadastro. A tela exibida pode ser personalizada com cores e logomarca no menu Configuraes / Layout do Carrinho.

Formulrio 02 Modo Design (Ambiente Gerncianet) NOTA Cdigos completos sobre este tipo de integrao podem ser baixados atravs do link: https://www.gerencianet.com.br/downloads/Integracao02.rar

Gerncianet Tecnologia em Pagamentos

Pgina 12

UTILIZANDO A FUNO TIPO DE RESPOSTA

Existem duas opes para se obter como resposta de integrao com o sistema, sendo um XML ou um HTML. O tipo de resposta um campo opcional e tem como default a resposta em HTML, que gera automaticamente o boleto. Ao optar por um XML dado como resposta um XML informando o status da integrao, que pode ser integrao realizada com sucesso, juntamente com a chave da fatura, o nmero do retorno, um link para consulta do retorno, o lote e o link para visualizar a fatura. No caso do status ser falha na integrao retornado um XML com a listagem dos erros. Um exemplo de resposta XML exemplificado a seguir:
<?xml version="1.0" encoding="utf-8"?> <gerencianet> <status>Falha na integracao</status> <erro>email invalido</erro> <erro>telefone no foi informado</erro> <erro>CEP no foi informado</erro> <erro>rua no foi informada</erro> <erro>bairro no foi informado</erro> <erro>cidade no foi informada</erro> <erro>numero no foi informado</erro> </gerencianet>

XML 03 - Exemplo com falha na integrao

<?xml version="1.0" encoding="utf-8" ?> <gerencianet> <status>integracao realizada com sucesso</status> <chave>20029-9874563-AXB85</chave> <retorno>numero do retorno</retorno> <consultaRetorno>link para consulta do retorno</consultaRetorno> <lote>20029-9874563-AXB85</lote> <link>https://contagerencianet.com.br/fatura/leitura.php?lote=20 010_90_CAXI9&chave=A4XB-20029-9874563-AXB85 </link> </gerencianet>

XML 04 - Exemplo de integrao realizada com sucesso

UTILIZANDO A FUNO DE RETORNO

Existem alguns fatores que podem dificultar o controle de faturas da loja, como alta quantidade de produtos e servios, nmero elevado de vendas, etc. Para facilitar este controle, criamos a ferramenta de retorno, que possibilita a visualizao de detalhes das faturas em um momento posterior emisso. Para utilizar esta ferramenta preciso ter em mente que cada cobrana deve possuir um cdigo nico. Ou seja, deve ser criada uma lgica para a definio dos cdigos de forma que este no se repita. Este cdigo ser utilizado nas consultas de status sobre a fatura, e enviado no mesmo POST utilizado para envio dos outros dados. Para que a fatura seja relacionada ao cdigo de retorno escolhido, basta envilo atravs do seguinte trecho: <input name="retorno" type="hidden" value="exemplo_254169" />
Gerncianet Tecnologia em Pagamentos Pgina 13

Para visualizar detalhes da fatura emitida acesse o link, semelhante ao exemplo a seguir:
https://www.gerencianet.com.br/retornoxml.php?cod=LoginGerencianet&retorno=exemplo_254169

O mesmo retornar um documento XML como mostrado a seguir:

<?xml version="1.0" encoding="utf-8"?> <gerencianet> <cliente> <codigoCliente>34</codigoCliente> <cliente>Carlos Macedo</cliente> <cpfcnpj>14563285471</cpfcnpj> <email>carlosmacedo@gerencianet.com.br</email> </cliente> <cobranca> <chave>20029-9667240-FIBGHI7</chave> <pedido>9667240</pedido> <dataHora>2011-05-07 16:22:52</dataHora> <retorno>145ASSSD2q564854</retorno> <pagconf>n</pagconf> <status>pagamento confirmado manualmente</status> <periodicidade></periodicidade> <opsPagamento>pag4;pag1;pag2</opsPagamento> <pagamento>pag1</pagamento> <desconto>1000</desconto> <total>2500</total> <vencimento>2011-01-01</vencimento> <taxaBoleto>0</taxaBoleto> </cobranca> <item> <produto>SERVICO</produto> <quantidade>1</quantidade> <valorUnitario>2500</valorUnitario> </item> </gerencianet>

3. Integrao com Carrinho de Compras

As integraes vistas at este momento, possibilitam a compra de um produto/servio por vez, visto que cada clique de compra representa um cdigo de uma fatura nica. Para possibilitar a compra de vrios produtos em uma mesma cobrana, preciso fazer a integrao com a ferramenta de Carrinho de Compras Gerncianet. Esta ferramenta Gerncianet possibilita a adio/remoo de produtos de um Carrinho de Compras Virtual, bem como definio das quantidades de cada produto adicionado. Ao inserir um domnio para validar a integrao, uma chave de integrao criada. Esta chave possibilitar a integrao do seu site com nosso Sistema. Cada produto da sua loja, ter um link do tipo:
<a href="http://www.gerencianet.com.br/carrinho/index.php?cprod=1&chave=05c311f2e3a18218cc908">Comprar</a>

Gerncianet Tecnologia em Pagamentos

Pgina 14

Onde cprod o cdigo do produto (que pode ser visualizado em Servios / Listar Produtos e Servios, Coluna Cdigo.) e chave o nmero da chave de integrao (que pode ser obtido em Configuraes / Validar Integrao, Coluna Chave de integrao). Este mesmo cdigo HTML pode ser utilizado tanto para linkar produtos quanto para linkar servios. Ao clicar no boto Comprar, seu cliente ser direcionado para o Carrinho de Compras Gerncianet. Enquanto o cliente estiver navegando em seu site, o carrinho armazener as informaes dos produtos e servios que foram adicionados ao carrinho, a qualquer momento a compra poder ser finalizada, e uma nica fatura ser emitida a cada finalizao, englobando todos os produtos, servios e respectivas quantidades que foram adicionados anteriormente. Nesta integrao, no preciso enviar informaes sobre o cliente, pois o Carrinho de Compras est preparado para solicitar todo e qualquer dado necessrio para cadastro do mesmo e emisso da fatura. Abaixo apresentamos um fluxograma dos passos que seu cliente seguir para comprar o produto. A Gerncianet oferece a voc um Carrinho de Compras bem intuitivo e com poucos passos at a finalizao.

Visualizao dos Produtos

Login do Cliente

Definio da Forma de Pagamento

Finalizao da Compra

UTILIZANDO CUPONS DE DESCONTO

A Gerncianet oferece a voc a ferramenta de Cupons de Desconto. Atravs desta, possvel criar cupons para Frete Grtis (escolhendo o tipo PAC ou SEDEX), descontos em valor real e descontos em porcentagem. Alm disso, possvel definir um valor mnimo da compra para que o cupom possa ser
Gerncianet Tecnologia em Pagamentos Pgina 15

utilizado. Por exemplo: Frete Grtis em toda a loja para compras acima de R$ 199,00. O cupom tambm pode ser nico, como um desonto de 10% para um cliente que est fazendo aniversrio, por exemplo. Para criar um Cupom, acesse o menu Configuraes / Cupons de Desconto e clique no boto Gerar Cupom. Ser aberta uma tela de configuraes como mostrada a seguir:

Os campos de valor Mnimo da Compra e Validade do Cupom no so obrigatrios. Deixando-os em branco, o vendedor estar concordando que o cupom poder ser utilizado para qualquer valor de compra, e no existe validade, ou seja, o cupom existir enquanto estiver cadastrado (para exclu-lo, basta selecionar a linha correspondente e clicar em Excluir.).

4. Acesso Personalizado para seu Cliente

No momento que um cliente realiza uma compra, os dados do mesmo so utilizados para um cadastro no Sistema Gerncianet exceto quando se utiliza a Integrao de Boleto Direto sem cadastro. Dentre as informaes requisitadas para este cadastro, solicitamos um e-mail e uma senha, que possibilitaro um acesso externo a seu cliente, para que ele possa imprimir segunda via de boletos, visualizar todas as faturas que pagou, deixou de pagar, os produtos que foram adquiridos e respectivas datas, enfim, obter todo o controle de todas as faturas que recebeu a partir de sua loja virtual. Link de acesso: https://www.gerencianet.com.br/clientes.php?cod=loginGerencianet Nesta pgina, possvel tanto realizar o cadastro, quanto acessar a rea restrita. Se o cliente j tiver efetuado pelo menos uma compra no site, ento o mesmo j possui um cadastro e est apto a acessar a rea restrita. Se no houver realizado nenhuma compra ainda, poder ainda sim se cadastrar como

Gerncianet Tecnologia em Pagamentos

Pgina 16

cliente da loja, e medida que realiza compras no site, suas faturas aparecem em sua rea restrita, como na imagem a seguir:

Gerncianet Tecnologia em Pagamentos

Pgina 17