TecnoSpeed

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.

Componente Tecnospeed CCe

www.tecnospeed.com.br

Contedo
Sumrio
1.

2.

3.

4.

Apresentao .................................................................................................................... 4
1.1.

Apresentao do Produto .......................................................................................... 4

1.2.

Sobre Este Manual .....................................................................................................4

1.3.

Dicionrio CC-e .......................................................................................................... 4

Sobre Carta de Correo Eletrnica (CC-e) ......................................................................... 4

2.1.

O que Carta de Correo Eletrnica ........................................................................ 4

2.2.

Fluxo de Rotinas para uso da CC-e ............................................................................. 5

2.3.

Lista de Servios CC-e .............................................................................................. 5

Sobre o Componente Tecnospeed CCE .............................................................................. 6

3.1.

Entendendo o processo (Fluxograma) ........................................................................ 6

3.2.

O Componente .......................................................................................................... 6

3.3.

O Propriedades do Componente CCe ......................................................................... 7

3.4.

Linguagens Compatveis........................................................................................... 10

3.5.

Exemplo .................................................................................................................. 10

3.6.

Pr-requisitos para Emitente CCE ............................................................................ 11

3.7.

Certificados Digitais Compatveis ............................................................................. 11

Utilizando o Componente CCe ......................................................................................... 11

4.1.

Configurar o Certificado Digital ................................................................................ 11

4.2.

Configurando o Componente ................................................................................... 12

4.2.1

Configurar Via Arquivo .INI ............................................................................... 12

4.2.2

Configurar Propriedades .................................................................................. 13

4.3.

Gerar XML ............................................................................................................... 14

4.3.1

5.

Gerar XML via propriedades ............................................................................. 14

4.4.

Enviar CC-e .............................................................................................................. 14

4.5.

Consultar NF-e ......................................................................................................... 15

4.6.

Enviar CCe ao Destinatrio ....................................................................................... 15

Logs e Mensagens ........................................................................................................... 16

5.1.

Tabela de Cdigo de Erros e Descries de Mensagens Erros ................................... 16

6.

Instalando o Componente Tecnospeed CCe ..................................................................... 17

7.

Apoio .............................................................................................................................. 21
2

Componente Tecnospeed CCe

www.tecnospeed.com.br

8.

Consideraes ................................................................................................................. 22

Componente Tecnospeed CCe

www.tecnospeed.com.br

1.

Apresentao

1.1.

Apresentao do Produto

O Componente TecnoSpeed CCe uma soluo que permite aos desenvolvedores de

softwares integrar sistemas de gesto empresarial com o Projeto Carta de Correo Eletrnica
da Receita Federal. Seu principal objetivo diminuir o esforo envolvido no processo de
adequao dos sistemas ERPs para acesso aos servidores da SEFAZ, no envio e manipulao
de Carta de Correo Eletrnica bem como reduzir o impacto das constantes mudanas de
legislao sobre o software.
Nosso produto facilita essa integrao, atendendo a todos os padres tcnicos exigidos para a
comunicao com os servidores da Receita Federal.

1.2.

Sobre Este Manual

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.

Sobre Carta de Correo Eletrnica (CC-e)

2.1.

O que Carta de Correo Eletrnica

Os contribuintes emissores de Nota Fiscal Eletrnica (NF-e) podero, aps a concesso da

Autorizao de Uso da NF-e, sanar erros em campos especficos do documento, por meio de
Carta de Correo Eletrnica (CC-e), transmitida administrao tributria da Unidade da
Federao do emitente.
O Governo, representado pela SEFAZ, entra com os servidores estaduais que so
responsveis pela coleta das CC-es dos contribuintes. Os contribuintes por sua vez, so
responsveis por enviar suas informaes fiscais para tais servidores on-line. Este processo
4

Componente Tecnospeed CCe

www.tecnospeed.com.br

envolve o uso de tecnologias desconhecidas de grande parte dos desenvolvedores de

sistemas de gesto no Brasil, entre elas se pode citar: XML, Certificao Digital e
Webservices (SOAP).

2.2.

Fluxo de Rotinas para uso da CC-e

2.3.

Lista de Servios CC-e

A forma de processamento das solicitaes de servios da CL-e ser sncrona, com o

atendimento da solicitao de servio na mesma conexo. Assim, os servios da CL-e sero
implementados da seguinte forma:
SERVIO
Consulta de NF-e
Recepo de CC-e

IMPLEMENTAO
Sncrona
Sncrona
5

Componente Tecnospeed CCe

www.tecnospeed.com.br

3.

Sobre o Componente Tecnospeed CCE

3.1.

Entendendo o processo (Fluxograma)

3.2.

O Componente

O componente Tecnospeed CCe uma ferramenta composta por propriedades, mtodos e

eventos. Tais recursos so destinados integrao de sistemas com os WebServices
disponibilizados pela SEFAZ (Secretaria Estadual da Fazenda).
Alm de prover a comunicao com os Web Services da SEFAZ, podemos destacar as seguintes
funcionalidades:
Gerao de XML compatvel com os servidores da SEFAZ;
Assinatura de XML;
Consulta Situao da NF-e;
Gerao e Envio de XML ao destinatrio;
Envio da Carta de Correo Eletrnica;
Log de arquivos.
Este componente permite ao desenvolvedor integrao de maneira embarcada a fim de no
necessitar de outras aplicaes para seu funcionamento, podendo incorporar em seus
sistemas as funcionalidades supra citadas.

3.3.

O Propriedades do Componente CCe

COMPONENTE
spdCCe
Ambiente
ArquivoServidoresHom

ArquivoServidoresProd

CNPJ
DiretorioEsquemas
DiretorioLog

DiretorioTemplates
IgnoreInvalidCertificates
Name
PinCode
Proxy

Funo

Valor Aceito

Determina ao Componente o servidor com o qual dever interagir (Homologao

ou Produo).
Permite ao desenvolvedor configurar o diretrio (completo ou parcial) onde
encontra-se o arquivo nfeServidoresHom.ini que contm os endereos dos
webservices de Homologao.
Permite ao desenvolvedor configurar o diretrio (completo ou parcial) onde
encontra-se o arquivo nfeServidoresProd.ini que contm os endereos dos
webservices de Produo.
Propriedade que recebe o CNPJ do componente CCe
Propriedade que permite ao desenvolvedor configurar o diretrio (parcial ou
completo) onde esto contidos os arquivos de Esquema xsd.
Propriedade que permite ao desenvolvedor configurar o diretrio (parcial ou
completo) onde esto contidos os arquivos logs (arquivos .xml) das interaes com
os webservices.
Propriedade que permite ao desenvolvedor configurar o diretrio(parcial ou
completo) onde esto contidos os modelos que podem ser utilizados no sistema.
Ignora mensagens de erro sobre certificados invlidos, expirados e revogados
Propriedade que permite ao usurio trocar o nome do Componente.
Quando a propriedade TipoCertificado for SmartCard (certificado A3), pode-se
configurar o Pin Code do certificado digital
Propriedade que permite colocar o endereo do Proxy para conectar a internet.

akHomologacao ou
akProducao
cceServidoresHom.ini

cceServidoresProd.ini

CNPJ sem formatao

Esquemas\
Log\

Templates\
True ou False

IP do proxy

Componente Tecnospeed CCe

www.tecnospeed.com.br

COMPONENTE
Senha

Funo

Valor Aceito

Propriedade que permite ao desenvolvedor configurar a senha de acesso ao

Servidor Proxy.

Tag
TimeOut
TipoCertificado

Tempo de espera do Componente resposta do WebService (segundos).

Determina o repositrio na qual o certificado digital foi instalado.
*Obs: ckFile significa CurrentUserStore.

Nmero Inteiro
ckActiveDiretory,
ckFile, LocalMachine,
ckMemory ou Smart
Card.
Estados com 2 dgitos

CC

Permite configurar a SEFAZ na qual dever ser enviado a CCe.

Propriedade que permite informar o usurio do Proxy.
Propriedade que ativa a validao do XML antes de enviar ao SEFAZ.
Grupo de propriedades que permite a configurao para envio do email.
Propriedade relativa ao assunto do E-mail.
Propriedade boleana que deve ser que deve ser ativada quando o servidor de e-mail
exigir autenticao.
Propriedade que permite ao desenvolvedor o envio de uma cpia do e-mail.

CCo

Pripriedade que permite ao desenvolvedor enviar e-mails com cpias ocultas.

EmailDestinatario

Propriedade que permite o desenvolvedor configurar o e-mail do destinatrio.

EmailRemetente

Propriedade que permite o desenvolvedor configurar o e-mail do remetente.

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 Tecnospeed CCe

www.tecnospeed.com.br

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

Tempo de espera de envio de E-mail (milisegundos).

Nmero Inteiro
Propriedade que permite ao desenvolvedor configurar o usurio de autenticao do
servidor de e-mail.

3.4.

3.5.

Linguagens Compatveis
Delphi 7;
Delphi 2006;
Delphi 2007;
Delphi 2009;
Delphi 2010;

Exemplo

O Componente TecnoSpeed CCe possui alguns exemplos demonstrativos para auxiliar o

desenvolvedor a conhecer o funcionamento de suas principais caractersticas. Estas
demonstraes esto disponibilizadas na pasta de instalao do componente.

O exemplo demonstrativo de implementao do Componente TecnoSpeed CCe est disponvel

nas linguangens:

Delphi;

Pr-requisitos:

MSXML (instalado com o Componente CCe);

CAPICOM (instalado com o Componente Cce, podendo conter dependncias em outras
aplicaes);

Componente Tecnospeed CCe

www.tecnospeed.com.br

3.6.

Pr-requisitos para Emitente CCE

Para instalao e pleno funcionamento dos produtos TecnoSpeed CCe. necessrio atentar
para alguns requisitos bsicos:

3.7.

Computador com Sistema Operacional Microsoft Windows 32 bits;

Certificado Digital modelo A1ou A3 compatvel com os produtos TecnoSpeed CCe;
Credenciamento como Emitente de CCe junto a SEFAZ. Este processo fundamental
para emisso de CCe. Somente contribuintes devidamente cadastrados e autorizados
podero fazer uso dos WebServices da SEFAZ;
Acesso Internet (preferencialmente Banda Larga);

Certificados Digitais Compatveis

Os certificados digitais utilizados no sistema de carta de correo eletrnica (CCe), sero

emitidos por Autoridade Certificadora credenciada pela infraestrutura de Chaves Pblicas
Brasileira ICP-Brasil, de pessoa fsica ou jurdica, dos tipos A1 e A3.
A Tecnospeed recomenta os seguintes modelos de Certificados Digitais compatveis:

Certificados SERASA:
o A1;
o SmartCard;
o E-CNPJ;
o Certificados Certsign A1 e A3;
Certificados dos Correios A1 e A3;

Nota 1: Certificado Digital Pronova e tipo Servidor no so compatveis com os produtos

Tecnospeed CCe;
Nota 2: A Tecnospeed recomenda o uso dos certificados citados acima pois garante total
compatibilidade com o produto.

4.

Utilizando o Componente CCe

4.1.

Configurar o Certificado Digital

Para inicializar o processo de envio de Carta de Correo Eletrnica necessrio adquirir um

certificado digital. O Componente oferece um mtodo para listar todos os certificados
instalados na mquina, permitindo atribuir o nome do certificado a uma varivel ou
diretamente propriedade NomeCertificado do Componente CCe.

11

Componente Tecnospeed CCe

www.tecnospeed.com.br

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

4.2.1 Configurar Via Arquivo .INI

Para enviar a Carta de Correo Eletrnica para o Servidor SEFAZ podemos configurar o
Componente CCe atravs de um arquivo chamado cce.Config.ini. segue abaixo um exemplo
fictcio desta configurao:
[CCE]
UF=RS
NomeCertificado=CERTIFICADOTESTE
ArquivoServidoresHom=cceServidoresHom.ini
ArquivoServidoresProd=cceServidoresProd.ini
TipoCertificado=File
DiretorioEsquemas= Esquemas\
DiretorioTemplates= Templates\
DiretorioLog= \Log\
Ambiente=2
Repositorio=CURRENT_USER_STORE
ValidarEsquema=0
PINCODE=
[MAIL]
Servidor=
EmailRemetente=
Assunto=
Mensagem=
Usuario=
Senha=
TimeOut=30000
EmailDestinatario=
CCo=
CC=
Autenticacao=0
Porta=0

12

Componente Tecnospeed CCe

www.tecnospeed.com.br

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;

Procedure LoadConfig(const aConfFile: String = );

Este mtodo possui um parmetro default aConfigFile com o seguinte comportamento: caso
ele seja no seja informado, o componente procura pelo arquivo cceConfig.ini na pasta do
executvel a fim de preservar a sua retro compatibilidade. Ou seja, o componente continua
com o mesmo comportamento que apresentava anteriormente. A nova funcionalidade deste
mtodo reside na possibilidade de informar o caminho completo e o nome do arquivo ini
respectivo, tornando-se interessante para que o desenvolvedor consiga direcionar o arquivo
para uma pasta sua.
Como visto no exemplo acima, o componente pode carregar as suas propriedades a partir de
um arquivo ini. Caso o desenvolvedor queira salvar em um arquivo ini a partir das
propriedades j carregadas no componente, pode ser usado o mtodo SaveConfig:
procedure SaveConfig(const aConfigFile : string='');

4.2.2 Configurar Propriedades

Outra forma configurar individualmente as propriedades do Componente atravs do cdigo
de programao:
spdCCe.CNPJ := '0000000000000';
spdCCe.ArquivoServidoresHom := 'cceServidoresHom.ini';
spdCCe.ArquivoServidoresProd := 'cceServidoresProd.ini';
spdCCe.DiretorioLog:='Log\';
spdCCe.NomeCertificado.Text := CERTIFICADOTESTE;
spdCce.Usuario := 'teste';
spdCce.Senha := 'teste';
spdCce.Proxy := 'teste';

13

Componente Tecnospeed CCe

www.tecnospeed.com.br

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.3.1 Gerar XML via propriedades

Aps configurao das propriedades deve ser executada a funo abaixo passando como
parmetro a chave do DANFE, o texto de correo, data e hora do evento, cdigo do orgo e
nmero de sequncia.
ReturnValue := FspdCCe.MontarXmlCCe(1234544545656987898774564565445658, 'Texto
de Exemplo de Carta de Correcao Eletronica.', '15/06/2011 08:01:01', '35', 1);

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

Componente Tecnospeed CCe

www.tecnospeed.com.br

_XML_Assinado: Trata-se do XML assinado Pronto para Envio;

_ReturnXML: Trata-se do Retorno do XML aps envio a SEFAZ;
aNumLote: Trata-se do nmero de identificao do Lote de uma ou vrias Cces. Este campo
pode ser utilizado para controle interno do ERP e utilizado no momento da criao do nome
de um arquivo de Log de envio;

4.5.

Consultar NF-e

Uma possibilidade de uma consulta de NF-e no servidor utilizando o mtodo ConsultarNFe:

Exemplo:
_ReturnValue := spdCCe.ConsultarNFe(aChaveNFe);
aChaveNFe: chave de identificao da NF a ser consultada.

4.6.

Enviar CCe ao Destinatrio

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

Componente Tecnospeed CCe

www.tecnospeed.com.br

5.

Logs e Mensagens

5.1.

Tabela de Cdigo de Erros e Descries de Mensagens Erros

CDIGO
128
135
136
CDIGO
489
490
491
492
493
494
501
572
573
574
575
576
577
578
579
580
587
588
594

RESULTADO DO PROCESSAMENTO DA SOLICITAO

Lote de Evento Processado
Evento registrado e vinculado a NF-e
Evento registrado, mas no vinculado a NF-e
MOTIVOS DE NO ATENDIMENTO DA SOLICITAO
Rejeio: CNPJ informado invlido (DV ou zeros)
Rejeio: CPF informado invlido (DV ou zeros)
Rejeio: O tpEvento informado invlido
Rejeio: O verEvento informado invlido
Rejeio: Evento no atende o Schema XML especfico
Rejeio: Chave de Acesso inexistente
Rejeio: NF-e autorizada h mais de 30 dias (720 horas)
Rejeio: Erro atributo ID do evendo no corresponde a concatenao dos campos
(ID + tpEvento + chNFE + nSeqEvento)
Rejeio: Duplicidade de Evento
Rejeio: O autor do evento diverge do emissor da NF-e
Rejeio: O autor do evento diverge do destinatrio da NF-e
Rejeio: O autor do evendo no um orgo autorizado a gerar o evento
Rejeio: A data do evento no pode ser menot que a data de emisso da NF-e
Rejeio: A data do evento no pode ser maior que a data do processamento
Rejeio: A data do evendo no pode ser menor que a data de autorizao para NF-e
no emitida em contingncia
Rejeio: O evento exige uma NF-e Autorizada
Rejeio: Usar somente o namespace padro da NF-e
Rejeio: No permitida a presena de caracteres de edio no incio/fim da
mensagem ou entre as tags da mensagem
Rejeio: O nmero de sequencia do evento informado maior que o permitido

16

Componente Tecnospeed CCe

www.tecnospeed.com.br

6.

Instalando o Componente Tecnospeed CCe

O processo de instalao do componente Nfe extremamente simples. Basta navegar pelas

telas seguindo as orientaes recomendadas.

A primeira tela dar as boas vindas ao usurio e trar a informaes sobre qual verso
que ser instalada.

17

Componente Tecnospeed CCe

www.tecnospeed.com.br

Na tela a seguir, devemos escolher o local onde o Componente Tecnospeed CCe ser
instalado juntamente com suas demonstraes.

Aps escolher o local de instalao, necessrio indicar qual a linguagem o Componente

TecnoSpeed CCe ser instalado e quais aplicativos de demonstraes o acompanharo.

18

Componente Tecnospeed CCe

www.tecnospeed.com.br

Por padro, o instalador ir sugerir a pasta para os atalhos do Menu Iniciar do Sistema
Operacional.

Temos agora que definir se aps a instalao, o aplicativo de exemplo ser ou no

aberto.

19

Componente Tecnospeed CCe

www.tecnospeed.com.br

Nesta tela deve-se apenas conferir as configuraos escolhidas para que a instalao
tenha incio.

Aps todos os passos, apenas conclua a instalao.

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

Componente Tecnospeed CCe

www.tecnospeed.com.br

1 Clique no menu, opo Project;

2 V at Options ou utilize o atalho: Shift+Ctrl+F11;
3 Selecione a aba: Directories/Conditionals;
4 Em Search path, clique no boto ... e, finalmente, indique o caminho da pasta
Fontes que colamos na pasta de sua aplicao.

7.

Apoio

A TecnoSpeed tambm disponibiliza canais de apoio ao desenvolvedor, oferecendo materiais

como vdeo aulas, manuais on-line e frum. Os canais para suporte so:
http://www.tecnospeed.com.br/doc/componente Wiki com documentao e perguntas
frequentes;
21

Componente Tecnospeed CCe

www.tecnospeed.com.br

http://www.tecnospeed.com.br/forum - Frum online da TecnoSpeed;

http://www.tecnospeed.com.br/blog -Blog da TecnoSpeed com informaes sobre CCe e
produtos;
http://www.youtube.com/tecnospeedti - Canal TecnoSpeed no Youtube;

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