CompNet 3 - Ficha de Compensação Bancária via Web
=================================================
Conteúdo:
---------
- COMPNET.DLL - componente ISAPI que gera a imagem do boleto bancário.
- COMPNET.EXE - componente CGI que gera a imagem do boleto bancário.
- COMPNET.BMP - imagem básica do boleto.
- IPTESTE.EXE - Verifica o IP do servidor. Execute-o antes de fazer o pedido.
- COMPNET.CFG - Arquivo de configuração do CompNet.
Requisitos:
-----------
Windows NT 4.0 ou Windows 95
IIS 2 ou superior
Instalação :
-----------
- copie a COMPNET.DLL ou COMPNET.EXE para um diretório visível via WEB.
- escolha um diretorio de trabalho para o CompNet.
- dê acesso de leitura e gravação a esse diretório para a conta do IIS.
- edite o arquivo COMPNET.CFG e coloque-o no mesmo diretório da DLL/EXE
ou no diretório do Windows (opção mais segura).
Arquivo de Configuração
-----------------------
Os dados entre chaves "{}" devem ser subistituidos pelos dados correspondente.
[Compnet]
IP={número IP do servidor}
Dir={diretório de trabalho do CompNet}
Senha={senha fornecida pela ASW}
TL=(tipo de licença: 1- duas contas / 2 - vinte contas / 9 - ilimitada}
Fonte={nome da fonte para preenchimento do boleto}
Corpo=(tamanho da fonte acima}
[{nome da conta}]
cgccpf={CNPJ ou CPF do cedente}
cedente={nome do cedente}
Banco={nome ou sigla do banco a se colocada no boleto}
localpagto={texto para o campo "Local de Pagamento"}
agencod={agencia e conta ou convênio}
especiedoc={espécie do documento}
aceite={aceite}
usobco=)texto de uso do banco}
carteira={carteira}
moeda={moeda}
instr1={primeira linha das instrucões}
instr2={segunda linha das instrucões}
instr3={terceira linha das instrucões}
instr4={quarta linha das instrucões}
instr5={quinta linha das instrucões}
Utilizacão do CompNet:
----------------------
Além dos dados informados no arquivo de configuração, deve-se passa os outros dados por de duas maneiras: Via HTML ou arquivo.
1) via HTML - inserir no fonte HTML o seguinte trecho:

2) via arquivo - gere um arquivo texto no diretório de trabalho do CompNet com a seguinte estrutura:
----------- inicio do arquivo ----------(não incluir no arquivo)
conta=xxxxx
cgccpf - 99.999.999/9999-99
cedente - XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
banco - XXXXXXXX
localpagto - XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
agencod - XXXXXXXXXXXXXXXXX
especiedoc - XXXXXXXX
aceite - XXX
usobanco - XXXXXXXXXX
carteira - XXXXXXXX
moeda - XXXXX
datadoc=99/99/9999
numdoc=9999999999
quant=999
vencto=99/99/9999
nossonum=9999999999
valor=9.999,99
sacado=XXXXXXXXXXXXXXXXXXXXXXXXXX
cgccpfsac=99.999.999/0001-99
codbar=12345678901234567890123456789012345678901234
sacador=XXXXXXXXXXXXXXXXXXXXXXX
instr1=XXXXXXXXXXXXXXXXXXXXXXXXX
instr2=XXXXXXXXXXXXXXXXXXXXXXXX
instr3=XXXXXXXXXXXXXXXX
instr4=XXXXXXXXXXXXXXXXXXXXX
instr5=XXXXXXXXXXXXXXXXXXX
----------- fim do arquivo -------------(não incluir no arquivo)
e insira o seguinte trecho no HTML:

Não utilize espaços nos parametros. Substitua-os por "+" ou "%20".
No Netscape, a chamada direta no browser não funciona. ë necessário fazer a chamada a partir de uma página HTML.
Descrição dos dados:
====================
No HTML ou arquivo:
conta - mnemônico da conta
cgccpf - cgc ou cgc do cedente
cedente - razão social ou nome do cedente
banco - nome reduzido do banco (pode mas não é recomendado passar de 15 caracteres.
localpagto - campo "local de Pagamento" - (60)
agencod - campo "Agência/Código do Cedente" - (20)
especiedoc - campo "Espécie de Documento" - (10)
aceite - campo "Aceite" - (3)
usobanco - campo "Uso do Banco" - (10)
carteira - campo "Carteira" - (8)
moeda - campo "Moeda" - (8)
datadoc - data do documento - formatada
numdoc - numero do documento
quant - quantidade quando a moeda não for REAL.
vencto - data do vencimento - formatada ou texto.
nossonum - campo "Nosso Número"
valor - campo "Valor do Documento" - formatado.
sacado - Nome do Sacado
cgc - cgc ou cpf do sacado
codbar - algarismos do código de barras (44 posições)
Obs. A quinta posição é o dígito verificador do código de barras.
Se não for numérica, será calculado pelo CompNet.
sacador - Sacador ou avalista
instr1 a instr5 - campo "Instruções" - 5 linhas (60)
MascaraCB - Mascara do Código de Barras (até 44) - As posições diferentes de '#' substituirão os caracteres informados em 'CODBAR'.
MascaraBMP - Nome do arquivo básico da imagem do boleto. Se não informado assume "compnet.bmp".
Nas licenças ilimitadas podem ser informados pelo arquivo de dados e pela chamada HTML também os seguintes parametros:
- cgccpf - cgc ou cgc do cedente
- cedente - razão social ou nome do cedente
- banco - nome reduzido do banco (pode mas não é recomendado passar de 15 caracteres.
- localpagto - campo "local de Pagamento" - (60)
- agencod - campo "Agência/Código do Cedente" - (20)
- especiedoc - campo "Espécie de Documento" - (10)
- aceite - campo "Aceite" - (3)
- usobanco - campo "Uso do Banco" - (10)
- carteira - campo "Carteira" - (8)
- moeda - campo "Moeda" - (8)
Nos dados que podem estar em mais de um meio, por exemplo "instr1", terá prioridade o informado via HTML, em segundo o informado no arquivo de dados e por ultimo o do arquivo de configuração.
Imagem do Boleto
----------------
O arquivo da imagem básica do boleto deve ter o padrão BMP com 256 cores com 640 por 550 pixels.
Caracteres Especias
-------------------
para utilizar caracteres especiais basta substituí-lo por "%" seguido co código hexadecimal do caracter desejado.
Ex. Para incluir "&" em algum paramentro substituia-o por "%26". Para "%"use "%25".
Registro:
---------
O registro do software se dará pelo pagamento do boleto. Em seguida, será enviada a senha para uso do CompNet no servidor e tipo de licença informado. Use o utilitário IPTeste.exe para verificar o IP que seu servidor está informando.
Enquanto a senha não for implantada corretamente, a imagem do boleto conterá a palavra "MODELO". Todas as demais caracteristicas estarão funcinando.
Atenção para as linhas "Senha" e "TL" no arquivo de configuração "compnet.cfg". Elas devem estar com os dados enviados no email de liberação.
Suporte:
--------
suporte@asw.com.br
ASW Sistemas Ltda.
C.Postal 29.110
CEP 20542-970 Rio de Janeiro - RJ
Tel. (021) 2268-1147
E-mail: asw@asw.com.br
www.asw.com.br