Anda di halaman 1dari 28

Conhecimento de Transporte eletrnico

Manual de Orientaes Contribuinte

As unidades federadas que mantm o Web Service disponvel mesmo quando o servio esteja
paralisado, devero implementar as validaes 108 e 109. Estas validaes podero ser
dispensadas caso o Web Service no fique disponvel quando o servio estiver paralisado.
Caso a SEFAZ Autorizadora trabalhe na modalidade de SEFAZ Virtual de Contingncia (SVC),
sugere-se que esta mantenha uma tabela de UF atendidas indicando para cada uma se o
Ambiente de Autorizao Normal ou SVC, e ainda, o status de ativao da SVC para cada UF
e o prazo de encerramento desta modalidade.
Validao das Informaes de Controle da Chamada ao Web Service
Validao das Informaes de Controle da Chamada ao Web Service
#

Regra de Validao

Aplic.

Msg

Efeito

C01 Elemento cteCabecMsg inexistente no SOAP Header

Facult.

242

Rej.

C02 Campo cUF inexistente no elemento cteCabecMsg do SOAP Header

Obrig.

409

Rej.

C03 Se Ambiente de Autorizao Normal:


Verificar se a UF informada no cUF atendida pelo WebService
C04 Se Ambiente de Autorizao SVC:
Verificar se UF informada no campo cUF atendida na SVC-[SP/RS]:

Obrig.

410

Rej.

Obrig.

513

Rej.

C05 Campo versaoDados inexistente no elemento cteCabecMsg do SOAP Obrig.


Header
C06 Verso dos Dados informada superior verso vigente
Facult.

411

Rej.

238

Rej.

C07 Verso dos Dados no suportada

239

Rej.

Obrig.

Os dados referentes verso do leiaute do lote e UF de origem do emissor dos conhecimentos


so informados no elemento cteCabecMsg do SOAP Header (para maiores detalhes vide item
3.4.1).
A aplicao dever validar os campos cUF e versaoDados, rejeitando a mensagem recebida em
caso de informaes inexistentes ou invlidas.
O cabealho compreende a verso do Schema XML da mensagem contida na rea de dados
que ser utilizado pelo Web Service.
Validao da rea de Dados
a) Validao da Forma da rea de Dados
Validao da Mensagem do Pedido de Consulta de Lote
#

Regra de Validao

Aplic.

Msg

Efeito

D01 Verifica Schema XML da rea de Dados

Obrig.

215

Rej.

D02 Verifica a existncia de qualquer namespace diverso do namespace


padro do CT-e (http://www.portalfiscal.inf.br/cte)
D03 Verifica a existncia de caracteres de edio no incio ou fim da
mensagem ou entre as tags

Facul.

598

Rej.

Facul.

599

Rej.

D04 Verifica o uso de prefixo no namespace

Obrig.

404

Rej.

D05 XML utiliza codificao diferente de UTF-8

Obrig.

402

Rej.

Pg. 53 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

b) Validao das Regras de Negcio da Consulta Recibo


A seguir so realizadas as seguintes validaes:
Validao da Consulta Recibo
#

Regra de Validao

Aplic.

Msg

Efeito

E01 Tipo do ambiente do CT-e difere do ambiente do Web Service

Obrig.

252

Rej.

E02 UF do Recibo difere da UF Autorizadora

Obrig.

248

Rej.

E03 Tipo Autorizador do Recibo no compatvel com o rgo Autorizador

Obrig.

473

Rej.

E04 - Verifica se o Lote no est na fila de sada, nem na fila de entrada

Obrig.

106

Rej.

E05 - Verifica se o Lote no est na fila de resposta, mas est na fila de


entrada
E06 CNPJ do transmissor do lote difere do CNPJ do transmissor da consulta

Obrig.

105

Rej.

Obrig.

223

Rej.

(0 ou 1=SEFAZ normal, 3=SEFAZ VIRTUAL-RS,5=SEFAZ VIRTUAL-SP,


7 = SVC-RS, 8 = SVC-SP)

Final do Processamento
A mensagem de retorno poder ser:

Lote processado cStat=104, com os resultados individuais de processamento dos CTe do lote;
Lote em processamento cStat=105, o aplicativo do contribuinte dever fazer uma
nova consulta;
Lote no localizado cStat=106, o aplicativo do contribuinte dever providenciar o
reenvio da mensagem;
Recibo ou CNPJ do requisitante com problemas cStat= 248 ou 223, o aplicativo do
contribuinte dever sanar o problema;

O Ambiente de Autorizao SVC retornar apenas resultado de processamento dos lotes


enviados para a SVC, ou seja, caso um lote tenha sido enviado SEFAZ original e logo aps
esta tenha acionado a SVC, a consulta sobre este lote somente poder ser direcionada SEFAZ
original quando esta restabelecer seu servio, j os lotes enviados para a SVC podero ser
consultados diretamente neste ambiente a qualquer tempo, independente da SVC estar ativa
para recepo.

Pg. 54 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

4.3

Web Service - CteInutilizacao

Inutilizao de numerao de CT -e
Contribuinte

Secretaria de Fazenda Estadual


Web Service :
CteInutilizacao
cteInutilizacaoCT

Inutilizao de Numerao
Client CTe

Proc.
Ret

Retorno

Inutilizacao
Aplicao CT -e

Funo: servio destinado ao atendimento de solicitaes de inutilizao de numerao de CTe.


Processo: sncrono.
Mtodo: cteInutilizacaoCT
Leiaute Mensagem de Entrada
Entrada: Estrutura XML contendo a mensagem de solicitao de inutilizao.
Schema XML: inutCTe _v99.99.xsd
Ele

Pai

DP01 inutCTe

Campo

Raiz

Tipo Ocor. Tam. Dec.


-

Descrio/Observao

DP02 versao

DP01

1-1

1-4

DP03 infInut

DP01

1-1

DP04 Id

ID

DP03

1-1

41

Identificador da TAG a ser assinada formada com


Cdigo da UF + CNPJ + modelo + srie + nro
inicial e nro final precedida do literal ID

DP05 tpAmb

DP03

1-1

Identificao do Ambiente:
1 Produo / 2 - Homologao

DP06 xServ

DP03

1-1

10

Servio solicitado: INUTILIZAR

DP07 cUF

DP03

1-1

Cdigo da UF do solicitante

DP08 ano

DP03

1-1

Ano de inutilizao da numerao

DP09 CNPJ

DP03

1-1

14

CNPJ do emitente

DP10 mod

DP03

1-1

Modelo do CT-e

TAG raiz
2

Verso do leiaute
Dados do Pedido
TAG a ser assinada

DP11 serie

DP03

1-1

1-3

Srie do CT -e

DP12 nCTIni

DP03

1-1

1-9

Nmero do CT -e inicial a ser inutilizado

DP13 nCTFin

DP03

1-1

1-9

Nmero do CT -e final a ser inutilizado

DP14 xJust

DP03

1-1

15255

Informar a justificativa do pedido de inutilizao

DP15 Signature

DP01

xml

1-1

Assinatura XML do grupo identificado pelo


atributo ID

Pg. 55 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

Leiaute Mensagem de Retorno


Retorno: Estrutura XML contendo a mensagem do resultado da solicitao de inutilizao:
Schema XML: retInutCte_v99.99.xsd
#

Campo

DR01 retInutCTe

Ele

Pai

Raiz

Tipo Ocor. Tam. Dec.


-

Descrio/Observao
TAG raiz da Resposta

DR02 versao

DR01

1-1

1-4

DR03 infInut

DR01

1-1

Verso do leiaute

DR04 Id

ID

DR03

0-1

17

Identificador da TAG a ser assinada. Informar


somente se a UF assinar a resposta.
Em caso de assinatura da resposta pela SEFAZ,
deve-se preencher o campo com o Nro do
Protocolo, precedido com o literal ID.

DR05 tpAmb

DR03

1-1

Identificao do Ambiente:
1 Produo / 2 Homologao

DR06 verAplic

DR03

1-1

1-20

DR07 cStat

DR03

1-1

DR08 xMotivo

DR03

1-1

1-255

DR09 cUF

DR03

1-1

Dados da resposta - TAG a ser assinada

Verso do Aplicativo que processou o pedido de


inutilizao
Cdigo do status da resposta (vide item 5.1.1)
Descrio literal do status da resposta
Cdigo da UF que atendeu a solicitao

Os campos a seguir so obrigatrios no caso de homologao da inutilizao cStat=102.


Os campos de dhRecbto e nProt no sero preenchidos em caso de erro
DR10 ano

DR03

0-1

Ano de inutilizao da numerao

DR11 CNPJ

DR03

0-1

14

CNPJ do emitente

DR12 mod

DR03

0-1

Modelo do CT-e

DR13 serie

DR03

0-1

1-3

Srie do CT-e

DR14 nCTIni

DR03

0-1

1-9

Nmero do CT-e inicial a ser inutilizada


Nmero do CT-e final a ser inutilizada

DR15 nCTFin

DR03

0-1

1-9

DR16 dhRecbto

DR03

0-1

Data e hora de processamento


Formato = AAAA-MM-DDTHH:MM:SS
Preenchido com data e hora da gravao no
Banco de Dados em caso de Confirmao.
Em caso de Rejeio, com data e hora do
recebimento do Pedido.

DR17 nProt

DR03

0-1

15

Nmero do Protocolo de Inutilizao (vide item


6.6).
O controle de numerao do Protocolo nico
para todos os servios.

DR18 Signature

DR01

xml

0-1

Assinatura XML do grupo identificado pelo


atributo ID
A deciso de assinar a mensagem fica a critrio
da UF interessada.

Descrio do Processo de Web Service


Esse mtodo responsabiliza-se por receber as solicitaes referentes inutilizao de faixas de
numerao de Conhecimentos de Transportes eletrnicos. Ao receber a solicitao, a aplicao
CT-e realiza o processamento e devolve o resultado para o aplicativo do transmissor.
A mensagem de pedido de inutilizao de numerao de CT-e um documento eletrnico
assinado digitalmente pelo emitente do CT-e.
As validaes e os procedimentos abaixo so obrigatrios.

Pg. 56 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

Validao do Certificado de Transmisso


Validao do Certificado Digital do Transmissor (protocolo SSL)
#

Regra de Validao

Crtica

Msg

Efeito

A01 Certificado de Transmissor Invlido:


- Certificado de Transmissor inexistente na mensagem
- Verso difere "3"
- Basic Constraint = true (no pode ser Certificado de AC)
- KeyUsage no define "Autenticao Cliente"

Obrig.

280

Rej.

A02 Validade do Certificado (data de incio e data de fim)

Obrig.

281

Rej.

A03 Verifica a Cadeia de Certificao:


- Certificado da AC emissora no cadastrado na SEFAZ
- Certificado de AC revogado
- Certificado no assinado pela AC emissora do Certificado

Obrig.

283

Rej.

A04 LCR do Certificado de Transmissor


- Falta o endereo da LCR (CRL DistributionPoint)
- LCR indisponvel
- LCR invlida
A05 Certificado do Transmissor revogado

Obrig.

286

Rej.

Obrig.

284

Rej.

A06 Certificado Raiz difere da "ICP-Brasil"

Obrig.

285

Rej.

A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig.

282

Rej.

As validaes de A01, A02, A03, A04 e A05 sero realizadas pelo protocolo SSL e no precisam
ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode
falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam
ICP-BR no repositrio de certificados digitais do servidor de Web Service da SEFAZ
Autorizadora.
Validao Inicial da Mensagem no Web Service
Validao Inicial da Mensagem no Web Service
#

Regra de Validao

Aplic.

Msg

Efeito

B01 Tamanho do XML de Dados superior a 500 kBytes

Obrig.

214

Rej.

B02 XML de Dados Mal Formado

Facult.

243

Rej.

B03 Verifica se o Servio est Paralisado Momentaneamente

Obrig.

108

Rej.

B04 Verifica se o Servio est Paralisado sem Previso

Obrig.

109

Rej.

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB). A aplicao do
contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso
isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho
da mensagem for implementado por configuraes do ambiente de rede da SEFAZ Autorizadora
(ex.: controle no firewall). No caso de controle de tamanho ter sido implementado por aplicativo,
teremos a devoluo da mensagem de erro 214.
No momento do recebimento da mensagem no Web Service, a critrio de cada unidade federada
autorizadora, poder ser verificado se o XML de dados esteja bem formado. Esta verificao
til para as UF que desejam armazenar o XML de dados em estrutura XML de banco de dados.

Pg. 57 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

As unidades federadas que mantm o Web Service disponvel mesmo quando o servio esteja
paralisado, devero implementar as validaes 108 e 109. Estas validaes podero ser
dispensadas caso o Web Service no fique disponvel quando o servio estiver paralisado.
Caso a SEFAZ Autorizadora trabalhe na modalidade de SEFAZ Virtual de Contingncia (SVC),
sugere-se que esta mantenha uma tabela de UF atendidas indicando para cada uma se o
Ambiente de Autorizao Normal ou SVC, e ainda, o status de ativao da SVC para cada UF
e o prazo de encerramento desta modalidade.
Importante: O servio de inutilizao no est disponvel para a SEFAZ Virtual de Contingncia.
Validao das Informaes de Controle da Chamada ao Web Service
Validao das Informaes de Controle da Chamada ao Web Service
#

Regra de Validao

Aplic.

Msg

Efeito

C01 Elemento cteCabecMsg inexistente no SOAP Header

Facult.

242

Rej.

C02 Campo cUF inexistente no elemento cteCabecMsg do SOAP Header

Obrig.

409

Rej.

C03 Se Ambiente de Autorizao Normal:


Verificar se a UF informada no cUF atendida pelo WebService

Obrig.

410

Rej.

C04 Se Ambiente de Autorizao SVC:


Obrig.
- Servio no disponvel na SVC
C05 Campo versaoDados inexistente no elemento cteCabecMsg do SOAP Obrig.
Header

518

Rej.

411

Rej.

C06 Verso dos Dados informada superior verso vigente

Facult.

238

Rej.

C07 Verso dos Dados no suportada

Obrig.

239

Rej.

A informao da verso do leiaute do lote e a UF de origem do emissor dos conhecimentos so


informadas no elemento cteCabecMsg do SOAP Header (para maiores detalhes vide item 3.4.1).
A aplicao validar os campos cUF e versaoDados, rejeitando a mensagem recebida em caso
de informaes inexistentes ou invlidas.
O cabealho contm a verso do Schema XML da mensagem contida na rea de dados utilizada
pelo Web Service.
Validao da rea de Dados
a) Validao da Forma da rea de Dados
Validao da Mensagem do Pedido de Inutilizao de numerao de CT-e.
#

Regra de Validao

Aplic.

Msg

Efeito

D01 Verifica Schema XML da rea de Dados

Obrig.

215

Rej.

D02 Verifica a existncia de qualquer namespace diverso do namespace


padro do CT-e (http://www.portalfiscal.inf.br/cte)
D03 Verifica a existncia de caracteres de edio no incio ou fim da
mensagem ou entre as tags

Facul.

598

Rej.

Facul.

599

Rej.

D04 Verifica o uso de prefixo no namespace

Obrig.

404

Rej.

D05 XML utiliza codificao diferente de UTF-8

Obrig.

402

Rej.

Pg. 58 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

b) Validao do Certificado Digital Utilizado na Assinatura


Validao do Certificado Digital Utilizado na Assinatura Digital
#

Regra de Validao

Aplic.

Msg

Efeito

E01 Certificado de Assinatura invlido:


- Certificado de Assinatura inexistente na mensagem (*validado tambm
pelo Schema)
- Verso difere "3"
- Basic Constraints = true (no pode ser Certificado de AC)
- KeyUsage no define "Assinatura Digital" e No Recusa

Obrig.

290

Rej.

E02 Validade do Certificado (data de incio e data de fim)

Obrig.

291

Rej.

E03 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)


E04 Verifica Cadeia de Certificao:
- Certificado da AC emissora no cadastrado na SEFAZ
- Certificado de AC revogado
- Certificado no assinado pela AC emissora do Certificado

Obrig.

292

Rej.

Obrig.

293

Rej.

E05 LCR do Certificado de Assinatura:


- Falta o endereo da LCR (CRLDistributionPoint)
- Erro no acesso a LCR

Obrig.

296

Rej.

E06 Certificado de Assinatura revogado

Obrig.

294

Rej.

E07 Certificado Raiz difere da ICP-Brasil

Obrig.

295

Rej.

Aplic.

Msg

Efeito

F01 Assinatura difere do padro do Projeto:


- No assinado o atributo "ID" (falta "Reference URI" na assinatura)
(*validado tambm pelo Schema)
- Faltam os "Transform Algorithm" previstos na assinatura ("C14N" e
"Enveloped")
Estas validaes so implementadas pelo Schema XML da Signature

Obrig.

298

Rej.

F02 Valor da assinatura (SignatureValue) difere do valor calculado

Obrig.

297

Rej.

F03 CNPJ-Base do Emitente difere do CNPJ-Base do Certificado Digital

Obrig.

213

Rej.

Aplic.

Msg

Efeito

I01 Tipo do ambiente do CT-e difere do ambiente do Web Service

Obrig.

252

Rej.

I02 UF do Pedido de inutilizao difere da UF Autorizadora

Obrig.

250

Rej

I03 Verificar se a serie informada est na faixa entre 890-899 (reservada)

Obrig.

670

Rej.

I04 Ano da Inutilizao no pode ser superior ao Ano atual

Obrig.

471

Rej.

I05 Ano da inutilizao no pode ser inferior a 2008

Obrig.

472

Rej.

I06 Nmero da Faixa Inicial maior do que o nmero Final

Obrig.

224

Rej

I07 Quantidade mxima de numerao a inutilizar ultrapassa o limite (10.000


nmeros)

Obrig.

201

Rej

c) Validao da Assinatura Digital


Validao da Assinatura Digital
#

Regra de Validao

d) Validao das Regras de Negcio da Inutilizao de Numerao de CT-e


Pedido de Inutilizao de Numerao de CT-e Regras de Negcios
#

Regra de Validao

Pg. 59 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

I08 Campo ID invlido


- Falta literal ID
- Chave de acesso do campo ID difere do campo correspondente
I09 Acesso Cadastro Contribuinte:
- Verificar Emitente no autorizado a emitir CT-e

Obrig

227

Rej.

Obrig.

203

Rej

I10 - Verificar Situao Fiscal irregular do Emitente

Obrig.

240

Rej

I11 Acesso BD CTE-Inutilizao (Chave: CNPJ Emit, Modelo, Srie, nCTIni,


nCTFim)::
- Verificar se existe um pedido de inutilizao igual.

Obrig.

682

Rej.

I12 Acesso BD CTE-Inutilizao:


- Verificar se algum Nro da Faixa de Inutilizao atual pertence a uma
faixa anterior
I13 Acesso BD CTE (Chave: CNPJ Emit, Modelo, Srie, Nro):
- Verificar se existe CT-e utilizada na faixa de inutilizao solicitada

Obrig.

256

Rej

Obrig.

241

Rej

I14 Acessar BD CTE-EVENTOS (Chave: CNPJ Emit, Modelo, Srie, Nro


obtidos na chave de acesso):
- Verificar se existe EPEC aguardando CT-e nessa faixa de numerao

Obrig.

696

Rej.

Para cada inutilizao de numerao de CT-e homologada cria-se um novo protocolo de status
para CT-e, com a atribuio de um nmero de protocolo nico (vide item 6.6).
Final do Processamento
No caso de homologao da Inutilizao retornar o cStat = 102.

Pg. 60 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

4.4

Web Service CteConsulta Protocolo

Consulta situao atual da CT -e


Contribuinte

Secretaria de Fazenda Estadual


Web Service :
CteConsulta
cteConsultaCT

Consulta CT -e
Client CTe

Proc.
Consulta CT -e
Ret

Retorno

Aplicao CT -e

Funo: servio destinado ao atendimento de solicitaes de consulta da situao atual do CT-e


na Base de Dados do Portal da Secretaria de Fazenda Estadual.
Processo: sncrono.
Mtodo: cteConsultaCT
Leiaute Mensagem de Entrada
Entrada: Estrutura XML contendo a chave de acesso do CT-e.
Schema XML: consSitCte_v99.99.xsd
#

Campo

Ele

Pai

Raiz

EP02 versao

EP01

1-1

1-4

EP03 tpAmb

EP01

1-1

Identificao do Ambiente:
1 Produo / 2 - Homologao

EP04 xServ

EP01

1-1

Servio solicitado
CONSULTAR

EP05 chCTe

EP01

1-1

44

Chave de Acesso do CT-e composto por Cdigo


da UF + AAMM da emisso + CNPJ do Emitente
+ Modelo, Srie e Nmero do CT-e + Forma de
Emisso + Cdigo Numrico + DV.

EP01 consSitCTe

Tipo Ocor. Tam. Dec.

Descrio/Observao
TAG raiz

Verso do leiaute

Leiaute Mensagem de Retorno


Retorno: Estrutura XML contendo a mensagem do resultado da consulta de protocolo:
Schema XML: retConsSitCte_v99.99.xsd
#

Campo

Ele

Pai

Raiz

ER02 versao

ER01

ER03 tpAmb

ER01

ER01 retConsSitCTe

Tipo Ocor. Tam. Dec.


-

1-1

1-4

1-1

Descrio/Observao
TAG raiz da Resposta

Verso do leiaute
Identificao do Ambiente:

Pg. 61 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

1 Produo / 2 Homologao
ER04 verAplic

ER01

1-1

1-20

ER05 cStat

ER01

1-1

Verso do Aplicativo que processou a consulta

ER06 xMotivo

ER01

1-1

1-255

ER07 cUF

ER01

1-1

Cdigo da UF que atendeu a solicitao

Cdigo do status da resposta


Descrio literal do status da resposta

ER08 protCTe

CG ER01

xml

0-1

Protocolo de autorizao ou denegao de uso


do CT-e (vide item 4.2.2).
Informar se localizado um CT-e com cStat = 100
(uso autorizado) ou 110 (uso denegado).

ER09 retCancCTe

CG ER01

xml

0-1

Protocolo de homologao de cancelamento de


CT-e (vide item 4.3.2).
Informar se localizado um CT-e com cStat = 101
(cancelado).

xml

0-N

Informao do evento e respectivo Protocolo


de registro de Evento

ER10 procEventoCTe

ER01

Descrio do Processo de Web Service


Esse mtodo responsabiliza-se por receber as solicitaes referentes consulta de situao de
Conhecimentos de Transporte eletrnicos enviados para as Secretarias de Fazendas Estaduais.
Permite-se o acesso somente pela chave nica de identificao do CT-e.
O aplicativo do contribuinte envia a solicitao para o Web Service da Secretaria de Fazenda
Estadual autorizadora. Ao receber a solicitao, a aplicao do Portal da Secretaria de Fazenda
Estadual processar a solicitao de consulta, validando a Chave de Acesso do CT-e. Em
seguida retornar uma mensagem contendo a situao atual do CT-e na Base de Dados e o
respectivo Protocolo (mensagem de Autorizao de uso, Denegao e os eventos que estiverem
associados ao CT-e (informaes do evento e protocolo de registro de evento).
As validaes e os procedimentos abaixo so obrigatrios.
Validao do Certificado de Transmisso
Validao do Certificado Digital do Transmissor (protocolo SSL)
#

Regra de Validao

Crtica

Msg

Efeito

A01 Certificado de Transmissor Invlido:


- Certificado de Transmissor inexistente na mensagem
- Verso difere "3"
- Basic Constraint = true (no pode ser Certificado de AC)
- KeyUsage no define "Autenticao Cliente"

Obrig.

280

Rej.

A02 Validade do Certificado (data de incio e data de fim)

Obrig.

281

Rej.

A03 Verifica a Cadeia de Certificao:


- Certificado da AC emissora no cadastrado na SEFAZ
- Certificado de AC revogado
- Certificado no assinado pela AC emissora do Certificado

Obrig.

283

Rej.

A04 LCR do Certificado de Transmissor


- Falta o endereo da LCR (CRL DistributionPoint)
- LCR indisponvel
- LCR invlida
A05 Certificado do Transmissor revogado

Obrig.

286

Rej.

Obrig.

284

Rej.

A06 Certificado Raiz difere da "ICP-Brasil"

Obrig.

285

Rej.

A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig.

282

Rej.

Pg. 62 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

As validaes de A01, A02, A03, A04 e A05 sero realizadas pelo protocolo SSL e no precisam
ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode
falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam
ICP-BR no repositrio de certificados digitais do servidor de Web Service da SEFAZ
autorizadora.
Validao Inicial da Mensagem no Web Service
Validao Inicial da Mensagem no Web Service
#

Regra de Validao

Aplic.

Msg

Efeito

B01 Tamanho do XML de Dados superior a 500 kBytes

Obrig.

214

Rej.

B02 XML de Dados Mal Formado

Facult.

243

Rej.

B03 Verifica se o Servio est Paralisado Momentaneamente

Obrig.

108

Rej.

B04 Verifica se o Servio est Paralisado sem Previso

Obrig.

109

Rej.

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB). A aplicao do
contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso
isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho
da mensagem for implementado por configuraes do ambiente de rede da SEFAZ (ex.: controle
no firewall). No caso de controle de tamanho ter sido implementado por aplicativo, teremos a
devoluo da mensagem de erro 214.
No momento do recebimento da mensagem no Web Service, a critrio de cada unidade federada
autorizadora, poder ser verificado se o XML de dados esteja bem formado. Esta verificao
til para as UF que desejam armazenar o XML de dados em estrutura XML de banco de dados.
As unidades federadas que mantm o Web Service disponvel mesmo quando o servio esteja
paralisado, devero implementar as validaes 108 e 109. Estas validaes podero ser
dispensadas caso o Web Service no fique disponvel quando o servio estiver paralisado.
Caso a SEFAZ Autorizadora trabalhe na modalidade de SEFAZ Virtual de Contingncia (SVC),
sugere-se que esta mantenha uma tabela de UF atendidas indicando para cada uma se o
Ambiente de Autorizao Normal ou SVC, e ainda, o status de ativao da SVC para cada UF
e o prazo de encerramento desta modalidade.
Restrio: A consulta situao no Ambiente de Autorizao SVC somente poder ser realizada
para documentos autorizados nesta forma de contingncia nas SVC-[SP/RS].
Validao das Informaes de Controle da Chamada ao Web Service
Validao das Informaes de Controle da Chamada ao Web Service
#

Regra de Validao

Aplic.

Msg

Efeito

C01 Elemento cteCabecMsg inexistente no SOAP Header

Facult.

242

Rej.

C02 Campo cUF inexistente no elemento cteCabecMsg do SOAP Header

Obrig.

409

Rej.

C03 Se Ambiente de Autorizao Normal:


Verificar se a UF informada no cUF atendida pelo WebService
C04 Se Ambiente de Autorizao SVC:
Verificar se UF informada no campo cUF atendida na SVC-[SP/RS]:

Obrig.

410

Rej.

Obrig.

513

Rej.

C05 Campo versaoDados inexistente no elemento cteCabecMsg do SOAP Obrig.


Header
C06 Verso dos Dados informada superior verso vigente
Facult.

411

Rej.

238

Rej.

C07 Verso dos Dados no suportada

239

Rej.

Obrig.

Pg. 63 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

A informao da verso do leiaute do lote e a UF de origem do emissor dos conhecimentos so


informadas no elemento cteCabecMsg do SOAP Header (para maiores detalhes vide item 3.4.1).
A aplicao validar os campos cUF e versaoDados, rejeitando a mensagem recebida em caso
de informaes inexistentes ou invlidas.
O cabealho contm a verso do Schema XML da mensagem contida na rea utilizada pelo Web
Service.
Validao da rea de Dados
a) Validao da Forma da rea de Dados
Validao da Mensagem do Pedido de Consulta de Situao de CT-e.
#

Regra de Validao

Aplic.

Msg

Efeito

D01 Verifica Schema XML da rea de Dados

Obrig.

215

Rej.

D02 Verifica a existncia de qualquer namespace diverso do namespace


padro do CT-e (http://www.portalfiscal.inf.br/cte)
D03 Verifica a existncia de caracteres de edio no incio ou fim da
mensagem ou entre as tags

Facul.

598

Rej.

Facul.

599

Rej.

D04 Verifica o uso de prefixo no namespace

Obrig.

404

Rej.

D05 XML utiliza codificao diferente de UTF-8

Obrig.

402

Rej.

b) Validao das Regras de Negcio da Consulta CT-e


A seguir realizam-se as seguintes validaes:
Validao do Pedido de Consulta de sStuao de CT-e Regras de Negcio
#

Regra de Validao

Aplic.

Msg

Efeito

J01 Tipo do ambiente do CT-e difere do ambiente do Web Service

Obrig.

252

Rej.

J02 UF da Chave de Acesso difere da UF Autorizadora

Obrig.

226

Rej.

J03 Validar DV da Chave de Acesso

Obrig.

236

Rej.

J04 Chave de acesso invlida (Ano < 2009 ou Ano maior que Ano corrente)

Obrig.

592

Rej.

J05 Chave de acesso invlida (Ms = 0 ou Ms > 12)

Obrig.

593

Rej.

J06 Chave de acesso invlida (CNPJ zerado ou digito invlido)

Obrig.

594

Rej.

J07 Chave de acesso invlida (modelo diferente de 57)

Obrig.

595

Rej.

J08 Chave de acesso invlida (numero CT = 0)

Obrig.

596

Rej.

J09 Acesso BD CTE (Chave: Ano, CNPJ Emit, Modelo, Srie, Nro):
- Verificar se CT-e no existe

Obrig.

217

Rej.

J10 - Verificar se campo Cdigo Numrico informado na Chave de Acesso Obrig.


diferente do existente no BD

216

Rej.

OBS: SE o CT-e no existir, dever ser verificado em BD CTEEVENTOS (Chave:CNPJ Emit, Modelo, Srie, Nro obtidos na chave de
acesso do CT-e)
Verificar se existe EPEC para a chave natural do CT-e:
Se existir dever ser retornado apenas o procEvento

Pg. 64 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

J11 Chave de Acesso difere da existente em BD (opcionalmente a descrio


do erro, campo xMotivo, tem concatenada a Chave de Acesso, quando o
autor da consulta for o emissor)

Obrig.

600

Rej.

Final do Processamento
O processamento do pedido de consulta de status de CT-e pode resultar em uma mensagem de
erro caso o CT-e no seja localizado. Caso localizado, retorna a situao atual do CT-e,
apresentando o cStat com um dos valores, 100 (Autorizado o Uso do CT-e), 101
(Cancelamento de CT-e homologado), 110 (Uso Denegado) alm do respectivo protocolo de
autorizao de uso, denegao de uso e registro de eventos.
O Ambiente de Autorizao SVC retornar apenas status de CT-e autorizados na SVC, ou seja,
caso um documento tenha sido autorizado na SEFAZ original e logo aps esta tenha acionado a
SVC, a consulta sobre este CT-e somente poder ser direcionada SEFAZ original quando esta
restabelecer seu servio, j os documentos autorizados na SVC podero ser consultados
diretamente neste ambiente a qualquer tempo, independente da SVC estar ativa para recepo.
O evento de carta de correo dever constar apenas uma vez no procEventoCTe, sendo
exibido apenas a ocorrncia mais recente desse tipo de evento.

Pg. 65 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

4.5

Web Service CteStatusServico

Consulta Status do Servio


Contribuinte

Secretaria de Fazenda Estadual


Web Service :
CteStatusServico
cteStatusServicoCT

Consulta Status
Client CTe

Proc.
Ret

Consulta Status

Retorno

Aplicao CT -e

Funo: servio destinado consulta do status do servio prestado pelo Portal da Secretaria de
Fazenda Estadual.
Processo: sncrono.
Mtodo: cteStatusServicoCT
Leiaute Mensagem de Entrada
Entrada: Estrutura XML para a consulta do status do servio.
Schema XML: consStatServ_v99.99.xsd
#

Campo

Ele

Pai

Raiz

FP02 versao

FP01

1-1

1-4

FP03 tpAmb

FP01

1-1

Identificao do Ambiente:
1 Produo / 2 - Homologao

FP04 xServ

FP01

1-1

Servio solicitado
STATUS

FP01 consStatServCte

Tipo Ocor. Tam. Dec.

Descrio/Observao
TAG raiz

Verso do leiaute

Leiaute Mensagem de Retorno


Retorno: Estrutura XML contendo a mensagem do resultado da consulta do status do servio:
Schema XML: retconsStatServ _v99.99.xsd
#

Campo

Ele

FR01 retConsStatServCte Raiz

Pai

Tipo Ocor. Tam. Dec.

FR02 versao

FR01

1-1

1-4

FR03 tpAmb

FR01

1-1

FR04 verAplic

FR01

1-1

1-20

FR05 cStat

FR01

1-1

FR06 xMotivo

FR01

1-1

1-60

Descrio/Observao
TAG raiz da Resposta

Verso do leiaute
Identificao do Ambiente:
1 Produo / 2 - Homologao
Verso do Aplicativo que processou a consulta
Cdigo do status da resposta
Descrio literal do status da resposta

Pg. 66 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

FR07 cUF

FR01

1-1

Cdigo da UF que atendeu a solicitao

FR08 dhRecbto

FR01

1-1

Data e hora de recebimento


Formato = AAAA-MM-DDTHH:MM:SS
Preenchido com data e hora do recebimento do
Pedido

FR09 tMed

FR01

0-1

1-4

FR10 dhRetorno

FR01

0-1

FR11 xObs

FR01

0-1

1-255

Tempo mdio de resposta do servio (em


segundos) dos ltimos 5 minutos
Preencher com data e hora previstas para o
retorno do Web Service, no formato AAA-MMDDTHH:MM:SS
Informaes adicionais para o Contribuinte

Descrio do Processo de Web Service


Esse mtodo responsabiliza-se por receber as solicitaes referentes consulta do status do
servio do Portal da Secretaria de Fazenda Estadual.
O aplicativo do contribuinte envia a solicitao para o Web Service da Secretaria de Fazenda
Estadual. Ao receber a solicitao, a aplicao do Portal da Secretaria de Fazenda Estadual
processar a solicitao de consulta e retornar mensagem contendo o status do servio.
A empresa que construir aplicativo que se mantenha em permanente "loop" de consulta a este
Web Service, dever aguardar um tempo mnimo de 3 minutos entre uma consulta e outra,
evitando sobrecarga desnecessria dos servidores da SEFAZ autorizadora.
As validaes e os procedimentos abaixo so obrigatrios.
Validao do Certificado de Transmisso
Validao do Certificado Digital do Transmissor (protocolo SSL)
#

Regra de Validao

Crtica

Msg

Efeito

A01 Certificado de Transmissor Invlido:


- Certificado de Transmissor inexistente na mensagem
- Verso difere "3"
- Basic Constraint = true (no pode ser Certificado de AC)
- KeyUsage no define "Autenticao Cliente"

Obrig.

280

Rej.

A02 Validade do Certificado (data de incio e data de fim)

Obrig.

281

Rej.

A03 Verifica a Cadeia de Certificao:


- Certificado da AC emissora no cadastrado na SEFAZ
- Certificado de AC revogado
- Certificado no assinado pela AC emissora do Certificado

Obrig.

283

Rej.

A04 LCR do Certificado de Transmissor


- Falta o endereo da LCR (CRL DistributionPoint)
- LCR indisponvel
- LCR invlida
A05 Certificado do Transmissor revogado

Obrig.

286

Rej.

Obrig.

284

Rej.

A06 Certificado Raiz difere da "ICP-Brasil"

Obrig.

285

Rej.

A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig.

282

Rej.

As validaes de A01, A02, A03, A04 e A05 sero realizadas pelo protocolo SSL e no precisam
ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode
falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam

Pg. 67 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

ICP-BR no repositrio de certificados digitais do servidor de Web Service da SEFAZ


autorizadora.

Validao Inicial da Mensagem no Web Service


Validao Inicial da Mensagem no Web Service
#

Regra de Validao

Aplic.

Msg

Efeito

B01 Tamanho do XML de Dados superior a 500 Kbytes

Obrig.

214

Rej.

B02 XML de Dados Mal Formado

Facult.

243

Rej.

B03 Verifica se o Servio est Paralisado Momentaneamente

Obrig.

108

Rej.

B04 Verifica se o Servio est Paralisado sem Previso

Obrig.

109

Rej.

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB). A aplicao do
contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso
isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho
da mensagem for implementado por configuraes do ambiente de rede da SEFAZ (ex.: controle
no firewall). No caso de controle de tamanho ter sido implementado por aplicativo, teremos a
devoluo da mensagem de erro 214.
No momento do recebimento da mensagem no Web Service, a critrio de cada unidade federada
autorizadora, poder ser verificado se o XML de dados esteja bem formado. Esta verificao
til para as UF que desejam armazenar o XML de dados em estrutura XML de banco de dados.
As unidades federadas que mantm o Web Service disponvel mesmo quando o servio esteja
paralisado, devero implementar as validaes 108 e 109. Estas validaes podero ser
dispensadas caso o Web Service no fique disponvel quando o servio estiver paralisado.

Validao das Informaes de Controle da Chamada ao Web Service


Validao das Informaes de Controle da Chamada ao Web Service
#

Regra de Validao

Aplic.

Msg

Efeito

C01 Elemento cteCabecMsg inexistente no SOAP Header

Facult.

242

Rej.

C02 Campo cUF inexistente no elemento cteCabecMsg do SOAP Header

Obrig.

409

Rej.

C03 Se Ambiente de Autorizao Normal:


Verificar se a UF informada no cUF atendida pelo WebService
C04 Se Ambiente de Autorizao SVC:
Verificar se UF informada no campo cUF atendida na SVC-[SP/RS]:

Obrig.

410

Rej.

Obrig.

513

Rej.

C05 Se Ambiente de Autorizao SVC:


Obrig.
Verificar se SVC est ativa para a UF informada
C06 Campo versaoDados inexistente no elemento cteCabecMsg do SOAP Obrig.
Header

114

Rej.

411

Rej.

C07 Verso dos Dados informada superior verso vigente

Facult.

238

Rej.

C08 Verso dos Dados no suportada

Obrig.

239

Rej.

A informao da verso do leiaute do lote e a UF de origem do emissor dos conhecimentos so


informadas no elemento cteCabecMsg do SOAP Header (para maiores detalhes vide item 3.4.1).
A aplicao validar os campos cUF e versaoDados, rejeitando a mensagem recebida em caso
de informaes inexistentes ou invlidas.

Pg. 68 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

O cabealho contm a verso do Schema XML da mensagem contida na rea utilizada pelo Web
Service.
Validao da rea de Dados
a) Validao da Forma da rea de Dados
Validao da Mensagem da Consulta de Status de Servio
#

Regra de Validao

Aplic.

Msg

Efeito
Rej.

D01 Verifica Schema XML da rea de Dados

Obrig.

215

D02 Verifica a existncia de qualquer namespace diverso do namespace


padro do CT-e (http://www.portalfiscal.inf.br/cte)

Facul.

598

Rej.

D03 Verifica a existncia de caracteres de edio no incio ou fim da


mensagem ou entre as tags
D04 Verifica o uso de prefixo no namespace

Facul.

599

Rej.

Obrig.

404

Rej.

D05 XML utiliza codificao diferente de UTF-8

Obrig.

402

Rej.

b) Validao das Regras de Negcios da Consulta Status de Servio do CT-e


Validao do Pedido de Consulta de Status de Servio Regras de Negcios
#

Regra de Validao

Aplic.

Msg

Efeito

K01 Tipo do ambiente do CT-e difere do ambiente do Web Service

Obrig.

252

Rej.

K03 Verifica se o Servidor de Processamento est Paralisado


Momentaneamente

Obrig.

108

K04 Verifica se o Servidor de Processamento est Paralisado sem Previso

Obrig.

109

Final do Processamento
O processamento do pedido de consulta de status de Servio pode resultar em uma mensagem
de erro ou retornar a situao atual do Servidor de Processamento, cdigos de situao 107
(Servio em Operao), 108 (Servio Paralisado Momentaneamente) e 109 (Servio
Paralisado sem Previso). Pode-se utilizar o campo xObs, a critrio da UF, para fornecer
maiores informaes ao contribuinte, como por exemplo: manuteno programada,
modificao de verso do aplicativo, previso de retorno, etc.
Se o Ambiente de Autorizao for SVC-[SP/RS] e a UF informada estiver com o servio de
contingncia ativado, a resposta dever ser: 113 - Servio SVC em operao. Desativao
prevista para a UF em dd/mm/aa, s hh:mm horas

Pg. 69 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

4.6

Web Service CadConsultaCadastro

Consulta Cadastro
Contribuinte

Secretaria de Fazenda Estadual


Web Service
:
CadConsultaCadastro
Proc .
Consulta Cadastro

consultaCadastro

Consulta
Ret

Client NFe

Retorno

Cadastro de
Contribuintes

Funo: Servio para consultar o cadastro de contribuintes do ICMS de uma unidade federada.
Processo: sncrono.
Mtodo: consultaCadastro
Descrio do Processo de Web Service
Esse Web Service oferece a consulta pblica do cadastro de contribuintes do ICMS de uma
unidade federada.
Qualquer UF poder oferecer o Web Service, sendo obrigatrio para as UFs que autorizam a
emisso de qualquer espcie de Documento Fiscal eletrnico - DF-e.
Apenas as empresas autorizadas a emitir Documentos Fiscais eletrnicos utilizaro esse servio.
A UF que oferecer o Web Service verificar se o CNPJ da empresa solicitante consta no
cadastro nacional de emissores de Documentos Fiscais eletrnicos - DF-e.
A identificao da empresa solicitante do servio ser realizada atravs do CNPJ contido na
extenso otherName OID=2.16.76.1.3.3 do certificado digital utilizado na conexo SSL.
Importante ressaltar que esse Web Service no tem a mesma disponibilidade dos demais Web
Services do CT-e, em razo disto, sugere-se que no se implemente esse servio dentro do
fluxo normal de emisso do CT-e e sim como um servio alternativo.
O aplicativo do contribuinte envia a solicitao para o Web Service da Secretaria de Fazenda
Estadual. Ao receb-la, a aplicao do Portal da Secretaria de Fazenda Estadual processar a
solicitao de consulta, validando o argumento de pesquisa informado (CNPJ ou CPF ou IE), e
retornar mensagem contendo a situao cadastral atual do contribuinte no cadastro de
contribuintes do ICMS.

Onde Obter as Definies deste Web Service


As definies do Web Service de Consulta Cadastro encontram-se centralizadas no manual da
Nota Fiscal Eletrnica. Para informaes mais detalhadas, consultar o Manual de Orientaes do
Contribuinte da NF-e, disponvel em http://www.nfe.fazenda.gov.br .

Pg. 70 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

Onde Obter os Schemas XML deste Web Service


Os schemas XML utilizados pelo Web Service de Consulta Cadastro encontram-se disponveis
no endereo http://www.nfe.fazenda.gov.br .

Pg. 71 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

4.7

Sistema de Registro de Eventos

Sistema de Registro de Eventos


Emissor CT-e

WS da Fazenda
Web Service :
RecepcaoEvento

Proc .

Envio de Evento do CT-e

cteRecepcaoEvento
Ret

Cliente
SRE

Recepo
Aplicao SRE

Retorno

Funo: servio destinado recepo de mensagem de Evento do CT-e


Processo: sncrono.
Mtodo: cteRecepcaoEvento
Leiaute Mensagem de Entrada
Entrada: Estrutura XML com o Evento (Parte Geral)
Schema XML: eventoCTe_v9.99.xsd
#

Campo

EP01 eventoCTe

Ele

Pai

Rai
z

Tipo Ocor. Tam. Dec.


-

EP02 versao
EP03 infEvento

A EP01
G EP01

1-1
1-1

1-4

EP04 Id

ID EP03

1-1

52

EP05 cOrgao

EP03

1-1

EP06 tpAmb

EP03

1-1

Descrio/Observao
TAG raiz

Verso do leiaute geral dos eventos


Grupo de informaes do registro do Evento
Identificador da TAG a ser assinada, a regra
de formao do Id :
ID+
tpEvento+
chave
do
CT-e+
nSeqEvento
Cdigo do rgo de recepo do Evento.
Utilizar a Tabela do IBGE extendida, utilizar
90 para identificar SUFRAMA
Identificao do Ambiente:
1 Produo 2 Homologao
Informar o CNPJ do autor do Evento

EP07 CNPJ

EP03

1-1

14

EP08 chCTe

EP03

1-1

44

EP09 dhEvento

EP03

1-1

EP10 tpEvento

EP03

1-1

EP11 nSeqEvento

EP03

1-1

1-2

EP12 detEvento

G EP03

1-1

Sequencial do evento para o mesmo tipo de


evento. Para maioria dos eventos ser 1,
nos casos em que possa existir mais de um
evento o autor do evento deve numerar de
forma sequencial.
Informaes do evento especfico.

EP13 versaoEvento
EP14 any

A
E

1-4 2

Verso do leiaute especfico do evento.


XML do evento. Insira neste local o XML

EP12 N
EP12 XML

1-1
1-1

Chave de Acesso do CT-e vinculado ao


Evento
Data e hora do evento no formato AAAAMM-DDThh:mm:ss
Tipo do Evento

Pg. 72 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

especfico do tipo de evento (cancelamento,


EPEC, carta de correo).
EP15 Signature

G EP01 XML

Assinatura XML do grupo identificado pelo


atributo Id

1-1

Diagrama Simplificado do Schema: eventoCTe_v9.99.xsd

Leiaute Mensagem de Retorno


Retorno: Estrutura XML contendo a mensagem do resultado do evento:
Schema XML: retEventoCTe _v99.99.xsd
#

Campo

ER01 retEvento

Ele

Pai

Raiz

Tip
Ocor. Tam. Dec.
o
-

Descrio/Observao
TAG raiz do Resultado do Envio do Evento

ER02 versao
ER03 infEvento

A ER01 N
G ER01

1-1
1-1

1-4

Verso do leiaute
Grupo de informaes do registro do Evento

ER04 Id

ID ER03 C

0-1

17

Identificador da TAG a ser assinada,


somente deve ser informado se o rgo de
registro assinar a resposta.
Em caso de assinatura da resposta pelo
rgo de registro, preencher com o nmero
do protocolo, precedido pela literal ID

ER05 tpAmb

ER03 N

1-1

ER06 verAplic

ER03 C

1-1

1-20

Identificao do Ambiente:
1 Produo / 2 Homologao
Verso da aplicao que registrou o Evento,
utilizar literal que permita a identificao do

Pg. 73 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

ER07 cOrgao

ER03 N

1-1

ER08 cStat
ER09 xMotivo

E
E

ER03 N
ER03 C

1-1
1-1

3
1-255

rgo, como a sigla da UF ou do rgo.


Cdigo da UF que registrou o Evento.
Utilizar 90 para o SUFRAMA
Cdigo do status da resposta
Descrio do status da resposta

Os campos a seguir so obrigatrios no caso de homologao do evento cStat= 134, 135 ou 136.
Os campos de dhRegEvento e nProt no sero preenchidos em caso de erro
ER10 chCTe
E ER03 N
0-1
44
Chave de Acesso do CT-e vinculado ao
evento
ER11 tpEvento

ER03 N

0-1

ER12 xEvento
ER13 nSeqEvento

E
E

ER03 C
ER03 N

0-1
0-1

5-60
1-2

ER14 dhRegEvento

ER03 D

0-1

ER15 nProt

ER15 N

0-1

ER16 Signature

G ER01 XM
L

0-1

15

Cdigo do Tipo do Evento


Descrio do Evento
Seqencial do evento para o mesmo tipo de
evento. Para maioria dos eventos ser 1,
nos casos em que possa existir mais de um
evento o autor do evento deve numerar de
forma seqencial.
Data e hora de registro do evento formato
AAAA-MM-DDThh:mm:ss, se o evento for
rejeitado informar a data e hora de
recebimento do evento.
Nmero do protocolo de registro do evento
Assinatura Digital do documento XML, a
assinatura dever ser aplicada no elemento
infEvento. A deciso de assinar a
mensagem fica a critrio do Ambiente
Autorizador

Pg. 74 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

Diagrama Simplificado Schema de retorno: retEventoCTe _v99.99.xsd

Descrio do Processo de Web Service


Este mtodo responsvel por receber as solicitaes referentes ao registro de eventos de CTe. Ao receber a solicitao do transmissor, a aplicao da SEFAZ Autorizadora realiza o
processamento da solicitao e devolve o resultado do processamento para o aplicativo do
mesmo.
O WS de Eventos acionado pelo interessado (emissor ou rgo pblico) que deve enviar
mensagem de registro de evento.
Validao do Certificado de Transmisso
#

Validao do Certificado Digital do Transmissor (protocolo SSL)


Regra de Validao
Crtica
Msg

Efeito

A01

Certificado de Transmissor Invlido:


- Certificado de Transmissor inexistente na mensagem
- Verso difere 3
- Basic Constraint = true (no pode ser Certificado de AC)
- KeyUsage no define Autenticao Cliente

Obrig.

280

Rej.

A02

Validade do Certificado (data incio e data fim)

Obrig.

281

Rej.

A03

Verifica a Cadeia de Certificao:


- Certificado da AC emissora no cadastrado na SEFAZ
- Certificado de AC revogado
- Certificado no assinado pela AC emissora do Certificado

Obrig.

283

Rej.

Pg. 75 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

A04
A05
A06
A07

LCR do Certificado de Transmissor


- Falta o endereo da LCR (CRL DistributionPoint)
- LCR indisponvel
- LCR invlida
Certificado do Transmissor revogado
Certificado Raiz difere da ICP-Brasil
Falta a extenso de CNPJ no Certificado (OtherName
OID=2.16.76.1.3.3)

Obrig.

286

Rej.

Obrig.
Obrig.

284
285

Rej.
Rej.

Obrig.

282

Rej.

As validaes de A01, A02, A03, A04 e A05 so realizadas pelo protocolo SSL e no precisam
ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode
falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam
ICP-Brasil no repositrio de certificados digitais do servidor de Web Service da SEFAZ.
Validao Inicial da Mensagem no Web Service
#
B01
B02
B03
B04

Validao Inicial da Mensagem no Web Service


Regra de Validao
Crtica
Tamanho do XML de Dados superior a 500 Kbytes
Obrig.
XML de Dados Mal Formado
Facult.
Verifica se o Servio est Paralisado Momentaneamente
Obrig.
Verifica se o Servio est Paralisado sem Previso
Obrig.

Msg
214
243
108
109

Efeito
Rej.
Rej.
Rej.
Rej.

A mensagem ser descartada se o tamanho exceder o limite previsto (10 KB). A aplicao do
contribuinte no poder permitir a gerao de mensagem com tamanho superior a 10 KB. Caso
isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho
da mensagem for implementado por configuraes do ambiente de rede da SEFAZ (ex.: controle
no firewall). No caso do controle de tamanho ser implementado por aplicativo teremos a
devoluo da mensagem de erro 214.
No momento do recebimento da mensagem no Web Service, a critrio de cada unidade
federada, pode-se verificar se o XML de dados est bem formado. Essa verificao til para as
UF que desejam armazenar o XML de dados em estrutura XML de banco de dados.
O Ambiente Autorizador que mantm o Web Service disponvel, mesmo quando o servio estiver
paralisado, dever implementar as verificaes 108 e 109. Estas validaes podero ser
dispensadas se o Web Service no ficar disponvel quando o servio estiver paralisado.
Caso a SEFAZ Autorizadora trabalhe na modalidade de SEFAZ Virtual de Contingncia (SVC),
sugere-se que esta mantenha uma tabela de UF atendidas indicando para cada uma se o
Ambiente de Autorizao Normal ou SVC, e ainda, o status de ativao da SVC para cada UF
e o prazo de encerramento desta modalidade.
Validao das informaes de controle da chamada ao Web Service
#
C01
C02
C03

C04

Validao das informaes de controle da chamada ao Web Service


Regra de Validao
Crtica
Msg
Elemento cteCabecMsg inexistente no SOAP Header
Facult.
242
Campo cUF inexistente no elemento cteCabecMsg do
Obrig.
409
SOAP Header
Se Ambiente de Autorizao Normal:
Verificar se a UF informada no cUF atendida pelo
Obrig.
410
WebService
Se Ambiente de Autorizao SVC:
Verificar se UF informada no campo cUF atendida na
Obrig.
513
SVC-[SP/RS]

Efeito
Rej.
Rej.
Rej.

Rej.

Pg. 76 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

C05
C06
C07

Campo versaoDados inexistente no elemento cteCabecMsg


do SOAP Header
Verso dos Dados informada superior verso vigente
Verso dos Dados no suportada

Obrig.

411

Rej.

Facult.
Obrig.

238
239

Rej.
Rej.

A informao da verso do leiaute CT-e e a UF de origem do emissor do CT-e so informadas


no elemento cteCabecMsg do SOAP Header.
A aplicao dever validar os campos cUF e versaoDados, rejeitando o lote recebido em caso de
informaes inexistentes ou invlidas. O campo versaoDados contm a verso do Schema XML
da mensagem contida na rea de dados que ser utilizado pelo Web Service.
As validaes C03 e C04 dependem do tipo de evento para determinar sua aplicao, o evento
do tipo EPEC somente ser aceito pela SVC, portanto a UF desse evento dever ser atendida
pela SVC requisitada.
Futuros eventos diferentes de EPEC (Ex: Registro de Passagem, Carta de Correo, etc) no
sero aceitos na SVC, portanto a UF desses tipos de evento devero ser atendidas pela SEFAZ
em modo de autorizao normal.
As regras que iro determinar quando um evento ser aceito por determinado ambiente de
autorizao (Normal / SVC) sero especificadas em cada evento.
Validao da rea de Dados
a) Validao da Forma da rea de Dados
#
D01
D02
D03
D04
D05

Validao da Mensagem do Pedido de Encerramento


Regra de Validao
Crtica
Verifica Schema XML da rea de Dados (parte Geral)
Obrig.
Verifica a existncia de qualquer namespace diverso do
namespace padro do CT-e
Facult.
(http://www.portalfiscal.inf.br/cte)
Verifica a existncia de caracteres de edio no incio ou fim
Facult.
da mensagem ou entre as tags
Verifica o uso de prefixo no namespace
Obrig.
XML utiliza codificao diferente de UTF-8
Obrig.

Msg
215

Efeito
Rej.

598

Rej.

599

Rej.

404
402

Rej.
Rej.

b) Validao do Certificado Digital utilizado na Assinatura


#

E01

E02
E03

E04

Validao do Certificado Digital utilizado na Assinatura Digital


Regra de Validao
Crtica
Msg
Certificado de Assinatura Invlido:
- Certificado de Assinatura inexistente na mensagem
- Verso difere 3
- Basic Constraint = true (no pode ser Certificado de AC)
- KeyUsage no define Autenticao Cliente
Validade do Certificado (data incio e data fim)
Falta a extenso de CNPJ no Certificado (OtherName
OID=2.16.76.1.3.3)
Verifica a Cadeia de Certificao:
- Certificado da AC emissora no cadastrado na SEFAZ
- Certificado de AC revogado
- Certificado no assinado pela AC emissora do Certificado

Efeito

Obrig.

290

Rej.

Obrig.

291

Rej.

Obrig.

292

Rej.

Obrig.

293

Rej.

Pg. 77 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

E05

LCR do Certificado de Assinatura


- Falta o endereo da LCR (CRL DistributionPoint)
- Erro no acesso LCR

Obrig.

296

Rej.

E06
E07

Certificado de Assinatura revogado


Certificado Raiz difere da ICP-Brasil

Obrig.
Obrig.

294
295

Rej.
Rej.

Regra de Validao

Crtica

Msg

Efeito

F01

Assinatura difere do padro do Projeto:


- No assinado o atributo ID (falta Reference URI na
assinatura)
(*validado tambm pelo Schema)
- Faltam os Transform Algorithm previstos na assinatura
(C14N e Enveloped)
Estas validaes so implementadas pelo Schema XML da
Signature

Obrig.

298

Rej.

F02

Valor da assinatura (SignatureValue) difere do valor


calculado

Obrig.

297

Rej.

F03

CNPJ-Base do Autor difere do CNPJ-Base do Certificado


Digital

Obrig.

213

Rej.

c) Validao da Assinatura Digital


Validao da Assinatura Digital
#

d) Validao do Evento Parte Geral


Validao Geral do Evento
#
L01
L02
L03

Regra de Validao

Crtica

Msg

Efeito

Tipo do ambiente difere do ambiente do Web Service

Obrig.

252

Rej.

Obrig.

677

Rej.

Obrig.

670

Rej.

Cdigo do rgo de recepo do Evento diverge do


solicitado
Verificar se a serie informada na chave de acesso est
na faixa entre 890-899 (reservada)

L04

CNPJ do autor do evento informado invlido (DV ou


zeros)

Obrig.

627

Rej.

L05

Validar se atributo Id corresponde concatenao dos


campos evento (ID + tpEvento + chCTe + nSeqEvento)

Obrig.

628

Rej.

L06

Verificar se o tpEvento vlido

Obrig.

629

Rej.

Obrig.

516

Rej.

L07

Se Ambiente de Autorizao SVC:


- Tipo de Emisso (obtido na chave de acesso) difere do
tpEmis da SVC (7=SVC-RS e 8=SVC-SP)
Verificar Schema da parte especfica do Evento

L08

OBS: Utilizar o tpEvento + o atributo versaoEvento para


identificar qual schema deve ser validado.

Obrig.

630

Rej.

L09

Chave de Acesso: Dgito Verificador invlido

Obrig.

236

Rej.

L10

Chave de acesso invlida (Ano < 2009 ou Ano maior que


Ano corrente)

Obrig.

592

Rej.

L11

Chave de acesso invlida (Ms = 0 ou Ms > 12)

Obrig.

593

Rej.

L12

Chave de acesso invlida (CNPJ zerado ou digito


invlido)

Obrig.

594

Rej.

Pg. 78 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

L13

Chave de acesso invlida (modelo diferente de 57)

Obrig.

595

Rej.

L14

Chave de acesso invlida (numero CTe = 0)

Obrig.

596

Rej.

L15

Verificar duplicidade do evento (cOrgao + tpEvento +


chCTe + nSeqEvento)

Obrig.

631

Rej.

Obrig.

632

Rej.

Obrig.

633

Rej.

Obrig.

217

Rej.

Obrig.

216

Rej.

Obrig.

600

Rej.

Obrig.

634

Rej.

Obrig.

637

Rej.

Obrig.

635

Rej.

L21

Se evento do emissor verificar se CNPJ do Autor


diferente do CNPJ da chave de acesso do CT-e
Se evento do Fisco/RFB/Outros rgos, verificar se
CNPJ do Autor consta da tabela de rgos autorizados a
gerar evento.
Se evento exige CT-e:
Acesso BD CT-e (Chave: CNPJ Emit, Modelo, Srie, N):
- Verificar se CT-e no existe
Se existir o CT-e: (Independente do evento exigir):
- Cdigo Numrico informado na Chave de Acesso
diferente do existente no BD
Se existir o CT-e: (Independente do evento exigir)
Chave de Acesso difere da existente em BD
(opcionalmente a descrio do erro, campo xMotivo, tem
concatenada a Chave de Acesso)
Data do evento no pode ser menor que a data de
emisso do CT-e, se existir.

L22

Data do evento no pode ser menor que a data de


autorizao do CT-e, se existir

L16
L17

L18

L19

L20

L23

Data do evento no pode ser maior que a data de


processamento.
(o
Ambiente
Autorizador
deve
considerar a hora local do emissor para a validao). A
SEFAZ deve tolerar uma diferena mxima de 5 minutos
em funo da sincronizao de horrio de servidores.

Processamento das validaes especficas do evento


Sero definidas no item 5 deste Manual correspondente a cada evento.
Final do Processamento do Evento
O processamento do evento pode resultar em:
Rejeio o Evento ser descartado, com retorno do cdigo do status do motivo da
rejeio;
Recebido pelo Sistema de Registro de Eventos, com vinculao do evento no
respectivo CT-e, o Evento ser armazenado no repositrio do Sistema de Registro de
Eventos com a vinculao do Evento no respectivo CT-e (cStat=135);
Recebido pelo Sistema de Registro de Eventos vinculao do evento ao
respectivo CT-e prejudicado o Evento ser armazenado no repositrio do Sistema
de Registro de Eventos, a vinculao do evento ao respectivo CT-e fica prejudicada face
a inexistncia do CT-e no momento do recebimento do Evento (cStat=136);
Recebido pelo Sistema de Registro de Eventos, com vinculao do evento no
respectivo CT-e com situao diferente de Autorizado, o Evento ser armazenado no
repositrio do Sistema de Registro de Eventos com a vinculao do Evento no respectivo
CT-e retornando um alerta com a situao do CT-e (cStat=134);

O Ambiente Autorizador dever compartilhar os eventos autorizados no Sistema de Registro de


Eventos com o Ambiente Nacional atravs do sistema de compartilhamento.

Pg. 79 / 189

Conhecimento de Transporte eletrnico


Manual de Orientaes Contribuinte

5. Sistema de Registro de Eventos (Parte Especfica)


5.1 Evento Prvio de Emisso em Contingncia (EPEC)
Funo: evento destinado ao atendimento de solicitaes de emisso em contingncia de CT-e.
Autor do Evento: O autor do evento o emissor do CT-e. A mensagem XML do evento ser
assinada com o certificado digital que tenha o CNPJ base do Emissor do CT-e.
Cdigo do Tipo de Evento: 110113 (Este Evento no exige CT-e)
Leiaute Mensagem do evento EPEC
Entrada: Estrutura XML ser inserida na tag de tipo any da Parte Geral do WebService de
Registro de Eventos.
Schema XML: evEPECCTe_v9.99.xsd
#

Campo

EP01 evEPECCTe

Ele

Pai

Tipo Ocor. Tam. Dec.


-

1-1

EP02 descEvento

EP01

1-1

12

EP04 xJust

EP01

1-1

1-255

Descrio/Observao
Schema XML de validao do evento EPEC
110113
Descrio do Evento - EPEC
Informar a justificativa da entrada em contingencia

EP05 vICMS

EP01

1-1

13

Valor do ICMS

EP06 vTPrest

EP01

1-1

13

Valor Total da Prestao do Servio

EP07 vCarga

EP01

1-1

13

Valor Total da carga

EP08 toma04

EP01

1-1

EP09 toma

EP08

1-1

EP10 UF

Grupo de informaes do tomador


-

Tipo de tomador do servio, preencher com:


0-Remetente;
1-Expedidor;
2-Recebedor;
3-Destinatrio;
4-Outro

EP08

1-1

UF do Tomador do Servio

EP11 CNPJ

CE EP08

1-1

14

CNPJ do Tomador

EP12 CPF

CE EP08

1-1

11

CPF do Tomador

EP13 IE

EP08

0-1

14

Informar a IE do tomador ou ISENTO se tomador


contribuinte do ICMS isento de inscrio no
cadastro de contribuintes do ICMS. Caso o
tomador no seja contribuinte do ICMS no
informar o contedo.

EP14 Modal

EP01

1-1

Modal de transporte, preencher com:


01-Rodovirio;
02-Areo;
03-Aquavirio;
04-Ferrovirio;
05-Dutovirio;
06-Multimodal;

EP15 UFIni

EP01

1-1

UF de inicio da prestao

EP16 UFFIm

EP01

1-1

UF de fim da prestao

Pg. 80 / 189