Академический Документы
Профессиональный Документы
Культура Документы
Tecnologia da Informao
COMPONENTE CCe
CARTA DE CORREO ELETRNICA
Guia de Integrao do TecnoSpeed Componente CCe, a soluo completa e inteligente de
envio de CCe.
Contedo
Sumrio
1.
2.
3.
4.
Apresentao .................................................................................................................... 4
1.1.
1.2.
1.3.
2.2.
2.3.
3.2.
O Componente .......................................................................................................... 6
3.3.
3.4.
Linguagens Compatveis........................................................................................... 10
3.5.
Exemplo .................................................................................................................. 10
3.6.
3.7.
4.2.
4.2.1
4.2.2
4.3.
4.3.1
5.
4.4.
4.5.
4.6.
6.
7.
Apoio .............................................................................................................................. 21
2
8.
Consideraes ................................................................................................................. 22
1.
Apresentao
1.1.
Apresentao do Produto
1.2.
Este manual visa explicar, por meio de exemplos, como o esenvolvedor dever integrar seu
produto ao Componente CCe, para que este faa o trabalho de envio das Cartas de Correes
ao(s) WebServices(SOAP).
pressuposto e fundamental que o desenvolvedor j tenha conhecimento prvio dos manuais
de emisso e o manual tcnico que pode ser encontrado na pasta \Utils \Manuais no local de
instalao do Componente CCe.
1.3.
Dicionrio CC-e
CCe Carta de Correo Eletrnica;
DANFE Documento Auxiliar de Nota Fiscal Eletrnica;
NF-e Nota Fiscal Eletrnica;
SEFAZ Secretaria da Fazenda;
UF Unidades Federadas.
WebService Soluo utilizada na integrao e comunicao entre sistemas,
possibilitando o envio e recebimento de dados em formato XML;
XML eXtended Markup Language. uma recomendao da W3C para gerar
linguagens de marcao para necessidades especiais.
2.
2.1.
2.2.
2.3.
IMPLEMENTAO
Sncrona
Sncrona
5
3.
3.1.
3.2.
O Componente
3.3.
COMPONENTE
spdCCe
Ambiente
ArquivoServidoresHom
ArquivoServidoresProd
CNPJ
DiretorioEsquemas
DiretorioLog
DiretorioTemplates
IgnoreInvalidCertificates
Name
PinCode
Proxy
Funo
Valor Aceito
akHomologacao ou
akProducao
cceServidoresHom.ini
cceServidoresProd.ini
Templates\
True ou False
IP do proxy
COMPONENTE
Senha
Funo
Valor Aceito
Tag
TimeOut
TipoCertificado
Nmero Inteiro
ckActiveDiretory,
ckFile, LocalMachine,
ckMemory ou Smart
Card.
Estados com 2 dgitos
CC
CCo
EmailDestinatario
EmailRemetente
UF
Usuario
ValidarEsquemaAntesEnvio
spdCCe.EmailSettings
Assunto
Autenticacao
True ou False
True ou False.
Emails separados por
vrgula
Emails separados por
vrgula
Emails separados por
vrgula
Emails separados por
vrgula
COMPONENTE
Mensagem
Porta
Senha
ServidorSMTP
TimeOut
Usuario
Funo
Propriedade que permite ao desenvolvedor escrever o corpo sa mensagem
Propriedade que permite ao desenvolvedor configurar a porta de conexo com o
servidor de SMTP/SMTPS necessria para envio de e-mail
Propriedade que permite ao desenvolvedor configurar a senha do e-mail
Propriedade onde pode ser configurado o endereo do servidor de envio de e-mail
(SMTP/SMTPS).
Valor Aceito
Cadeia de caracteres
Nmero inteiro
Nmero inteiro
Nmero inteiro
3.4.
3.5.
Linguagens Compatveis
Delphi 7;
Delphi 2006;
Delphi 2007;
Delphi 2009;
Delphi 2010;
Exemplo
Delphi;
Pr-requisitos:
3.6.
Para instalao e pleno funcionamento dos produtos TecnoSpeed CCe. necessrio atentar
para alguns requisitos bsicos:
3.7.
Certificados SERASA:
o A1;
o SmartCard;
o E-CNPJ;
o Certificados Certsign A1 e A3;
Certificados dos Correios A1 e A3;
4.
4.1.
11
Abaixo temos o exemplo deste mtodo, alimentando os itens de um TlistBox (Delphi) uma vez
que possvel mais de um certificado digital instalado na mquina.
Exemplo:
spdCCe.ListarCertificados(frmSelectCertificate.lbList.Items);
4.2.
Configurando o Componente
12
Aps configurado, deve ser feita chamada ao mtodo LoadConfig como demonstrado abaixo:
...
Begin
...
//Chama o mtodo LoadConfig onde foram definidas as propriedades para
serem carregadas
spdCCe.LoadConfig;
...
End;
13
spdCce.TimeOut := 10;
spdCce.DiretorioEsquemas := 'Esquemas\ ';
spdCce.DiretorioTemplates := 'Templates\ ';
spdCce.IgnoreInvalidCertificates := True;
spdCce.ValidarEsquemaAntesEnvio := True;
spdCCe.EmailSettings.ServidorSMTP
:=
spdCCe.EmailSettings.EmailRemetente
:=
spdCCe.EmailSettings.EmailDestinatario :=
spdCCe.EmailSettings.Assunto
:=
spdCCe.EmailSettings.Mensagem
:=
spdCCe.EmailSettings.Usuario
:=
spdCCe.EmailSettings.Senha
:=
spdCCe.EmailSettings.autenticacao
:=
spdCCe.EmailSettings.CCo
:=
4.3.
Gerar XML
4.4.
Enviar CC-e
O envio de uma Carta de Correo Eletrnica s em completo caso XML esteja assinado. Para
isto o Componente disponibiliza o mtodo chamado AssinarCCe. Aps a assinatura podemos
utilizar o mtodo EnviarCCe e com isto enviar a CCe para a SEFAZ. Para melhor entender segue
abaixo a demonstrao de comandos.
Exemplo:
//Partimos do princpio que as variveis _ReturnValue, _XML_Assinado E _ReturnXML j tenha
sido declaradas e alimentadas com o XML de Envio conforme explicao no tpico 4.3.1.
_XML_Assinado := spdCCe.AssinatCCe(_ReturnValue);
_ReturnXML := spdCCe.EnviarCCe(aNumLote, _XMl_Assinado);
Onde:
_ReturnValue: Trata-se do XML sem assinatura;
14
4.5.
Consultar NF-e
4.6.
O Componente TecnoSpeed CCe permite ao usurio enviar o arquivo XML para o destinatrio,
isto pode ser realizado atravs do mtodo EnviarXMLCCeDestinatario:
spdCCe. EnviarXMLCCeDestinatario(aFileName);
aFileName: nome do arquivo xml que ser enviado no email, este arquivo pode ser encontrado
na pasta raiz do componente, dentro da pasta Xml Destinatrio;
15
5.
Logs e Mensagens
5.1.
CDIGO
128
135
136
CDIGO
489
490
491
492
493
494
501
572
573
574
575
576
577
578
579
580
587
588
594
16
6.
A primeira tela dar as boas vindas ao usurio e trar a informaes sobre qual verso
que ser instalada.
17
Na tela a seguir, devemos escolher o local onde o Componente Tecnospeed CCe ser
instalado juntamente com suas demonstraes.
18
Por padro, o instalador ir sugerir a pasta para os atalhos do Menu Iniciar do Sistema
Operacional.
19
Nesta tela deve-se apenas conferir as configuraos escolhidas para que a instalao
tenha incio.
Aps ter o Componente CCe instalado, copie a pasta Fontes, que est na raiz da instalao do
Componente TecnoSpeed CCe para a pasta aonde se encontra sua aplicao. Feito isso, vamos
configurar o Componente CCe para seu projeto Delphi. Siga os passos abaixo:
20
7.
Apoio
8.
Consideraes
Este material foi elaborado com o intuito de auxiliar no processo de integrao entre o
Componente CCe e Sistemas ERPs. Para sua elaborao, foram levadas em conta situaes
encontradas no dia a dia dos desenvolvedores que j utilizam os produtos TecnoSpeed.
Visando sempre oferecer produtos de qualidade, nossa Equipe mantm um canal direto com o
cliente para crticas ou sugestes sobre os materiais que acompanham seus produtos. Envie
um e-mail para: componente@tecnospeed.com.br.
22