Páginas filhas
  • ER_CTe_v3.00

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 Este documento é material de especificação dos requisitos de manutenção, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais 

Especificação

Produto

TSS

Módulo

CT-e

Segmento Executor

Serviços

Chamado

 

País

( X ) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Objetivo

Demonstrar as implementações necessárias para atender o Manual de Orientações do Contribuinte versão 3.00 

Este Manual tem por objetivo a definição das especificações e critérios técnicos necessários para a integração entre os Portais das Secretarias de Fazendas dos Estados e os sistemas de informações das empresas emissoras de Conhecimento de Transportes Eletrônicos - CT-e.

Identificação e vigência do Manual:

  • Data de início da vigência no ambiente de homologação (modelo 57) -  
  • Data de início da vigência no ambiente de homologação (modelo 67) -  
  • Data de início da vigência no ambiente de produção (modelo 57) -  
  • Data de início da vigência no ambiente de produção (modelo 67) -
  • Data final da vigência da versão 2.00 -

 

Definição da Regra de Negócio

A versão 3.00 introduz novas possibilidades de emissão do Conhecimento de Transporte para outros serviços, visando substituir a Nota Fiscal de Serviço de Transporte modelo 7 no que se refere aos serviços que não envolvem o transporte de cargas, a saber:

  • Transporte de Pessoas;
  • Transporte de Valores;
  • Excesso de Bagagem

Na primeira versão, o novo documento modelo 67 será desenvolvido para atender exclusivamente as prestações de serviço de Transporte de Pessoas, com a possibilidade de ser expandido futuramente para os outros serviços através de revisão do Manual ou Notas Técnicas.

Serviços Compartilhados - Modelo 57 e Modelo 67

A SEFAZ disponibilizou um novo Web Service de Recepção CT-e Outros Serviços (modelo 67) dedicado à autorização síncrona desse novo CT-e.

O modelo 67 utilizará os mesmos Web Services do modelo 57 para suprir os demais serviços essenciais para o contribuinte:

  • Consulta Situação;
  • Inutilização numérica;
  • Recepção de Eventos;
  • Consulta Status Serviço.

O Web Service de retorno de recepção não será necessário ao modelo 67 uma vez que o mesmo deverá responder de forma síncrona em uma conexão, para tal, o lote CT-e Outros Serviços deverá conter apenas um documento por vez, documento este que será enviado também através do método REMESSA do Web Service NFESBRA.

Eventos

Para contemplar os dois modelos de CT-e previstos (57 e 67), o sistema de registro de eventos da SEFAZ Autorizadora deverá identificar na chave de acesso do CT-e o modelo indicado e aplicar as regras conforme o estabelecido para cada um caso haja alguma diferença específica para os eventos comuns aos dois documentos.

Existe a possibilidade de ocorrerem eventos específicos para um modelo e para outros não e também a possibilidade de ambos utilizarem o mesmo tipo de evento, como no caso do evento de Cancelamento.

Observe no quadro abaixo a aplicação do evento conforme o modelo de CT-e:

 

Tipo de EventoModelo de CT-eDescrição EventoTipo de Autor do EventoLocal EventoCT-e deve existir?
11011057 e 67Carta de CorreçãoEmitenteSefaz AutorizadoraSim
11011157 e 67CancelamentoEmitenteSefaz AutorizadoraSim
11011357EPECEmitenteSVCNão
11016057Registro do MultimodalEmitenteSefaz AutorizadoraSim
11017067Informações da GTV *NOVOEmitenteSefaz AutorizadoraSim
61011057 e 67Prestação do Serviço em Desacordo *NOVOTomadorSefaz AutorizadoraSim

 

110170 - Evento Informações da GTV

  • Evento para que o emitente do CT-e OS do tipo serviço Transporte de Valores possa informar as GTV relacionadas com a prestação do serviço.

610110 - Evento Prestação de Serviço em Desacordo

  • Evento para que o tomador possa informar ao fisco que o documento CT-e que o relaciona está em desacordo com a prestação de serviço.

Leiautes Modelo 57 e Modelo 67

O CT-e sofreu alterações em seu leiaute.

Consulte o Manual de Orientações do Contribuinte - Versão 3.00 - 08/09/2016 (PDF) para verificação das alterações do modelo 57 e a estrutura do novo modelo 67.

É imprescindível a leitura completa deste MOC para entendimento das alterações pertinentes à versão 3.00

Web Services e Métodos TSS

Serão utilizados os métodos dos Web Services abaixo:

Web Service SPEDCFGNFE

  • Método CFGEPECCTE


O objetivo deste método é configurar os parâmetros dos Eventos do CT-e. Ele deve ser utilizado para configurar o uso dos seguintes eventos: EPEC, Cancelamento, CC-e, Registro do Multimodal, Informações da GTV e Prestação do Serviço em Desacordo.

Os parâmetros de entrada do método são:

<soap:Body>

  <USERTOKEN>STRING</USERTOKEN>

  <ID_ENT>STRING</ID_ENT>

  <VERSAOGERALEPEC>STRING</VERSAOGERALEPEC>

  <VERSAOEVENEPEC>STRING</VERSAOEVENEPEC>

  <VERSAOGERALCANC>STRING</VERSAOGERALCANC>

  <VERSAOEVENCANC>STRING</VERSAOEVENCANC>

  <VERSAOGERALCCE>STRING</VERSAOGERALCCE>

  <VERSAOEVENCCE>STRING</VERSAOEVENCCE>

  <VERSAOGERALMULT>STRING</VERSAOGERALMULT>

  <VERSAOEVENMULT>STRING</VERSAOEVENMULT>

  <VERSAOGERALGTV>STRING</VERSAOGERALGTV>

  <VERSAOEVENGTV>STRING</VERSAOEVENGTV>

  <VERSAOGERALDESAC>STRING</VERSAOGERALDESAC>

  <VERSAOEVENDESAC>STRING</VERSAOEVENDESAC>

  <SEQLOTEEPEC>INTEGER</SEQLOTEEPEC>

  <CTECANCEVENTO>BOOLEAN</CTECANCEVENTO> 

</soap:Body>

 

NomePaiTipoTam.Ocor.Observações
CFGEPECCTE
---1-1Tag raiz.
USERTOKENCFGEPECCTEA51-1Deverá ser preenchido com o valor “TOTVS”.
ID_ENTCFGEPECCTEA61-1ID da entidade a ser utilizada.
VERSAOGERALEPECCFGEPECCTEA1-41-1Versão do leiaute geral do evento EPEC
VERSAOEVENEPECCFGEPECCTEA1-41-1Versão do leiaute específico do evento EPEC
VERSAOGERALCANCCFGEPECCTEA1-41-1Versão do leiaute geral do evento Cancelamento
VERSAOEVENCANCCFGEPECCTEA1-41-1

Versão do leiaute específico do evento de Cancelamento

VERSAOGERALCCECFGEPECCTEA1-41-1Versão do leiaute geral do evento Carta de Correção
VERSAOEVENCCECFGEPECCTEA1-41-1Versão do leiaute específico do evento Carta de Correção
VERSAOGERALMULTCFGEPECCTEA1-40-1Versão do leiaute geral do evento Registro do Multimodal
VERSAOEVENMULTCFGEPECCTEA1-40-1Versão do leiaute específico do evento Registro do Multimodal
VERSAOGERALGTVCFGEPECCTEA1-40-1Versão do leiaute geral do evento Informações da GTV
VERSAOEVENGTVCFGEPECCTEA1-40-1Versão do leiaute específico do evento Informações da GTV
VERSAOGERALDESACCFGEPECCTEA1-40-1Versão do leiaute geral do evento Prestação do Serviço em Desacordo
VERSAOEVENDESACCFGEPECCTEA1-40-1Versão do leiaute específico do evento Prestação do Serviço em Desacordo
SEQLOTEEPECCFGEPECCTEN--0-1Número sequencial do lote.
CTECANCEVENTOCFGEPECCTEL--1-1

Indica se o cancelamento será realizado por evento ou não.

Os valores possíveis são:

 - TRUE para sim

-  FALSE para não

 

Os parâmetros de saída do método são:

<CFGEPECRESULT>

  <SEQLOTEEPEC>INTEGER</SEQLOTEEPEC>

  <VERSAOEVENCANC>STRING</VERSAOEVENCANC>

  <VERSAOEVENCCE>STRING</VERSAOEVENCCE>

  <VERSAOEVENEPEC>STRING</VERSAOEVENEPEC>

  <VERSAOEVENMULT>STRING</VERSAOEVENMULT>

  <VERSAOGERALCANC>STRING</VERSAOGERALCANC>

  <VERSAOGERALCCE>STRING</VERSAOGERALCCE>

  <VERSAOGERALEPEC>STRING</VERSAOGERALEPEC>

  <VERSAOGERALMULT>STRING</VERSAOGERALMULT>

  <VERSAOGERALGTV>STRING</VERSAOGERALGTV>

  <VERSAOEVENGTV>STRING</VERSAOEVENGTV>

  <VERSAOGERALDESAC>STRING</VERSAOGERALDESAC>

  <VERSAOEVENDESAC>STRING</VERSAOEVENDESAC>

<CTECANCEVENTO>STRING</CTECANCEVENTO> 

</CFGEEPECRESULT>

 

NomePaiTipoTam.Ocor.Observações
CFGEPECRESULTCFGEPECCTERESPONSE--1-1Tag raiz do retorno
CTECANCEVENTO CFGEPECRESULT A1-1 Indica se o cancelamento será realizado por evento ou não.

Os valores possíveis são:

  • 1-Cancelamento por evento habilitado
  • 0-Cancelamento por evento não habilitado
 SEQLOTEEPEC CFGEPECRESULT N0-1  Número sequencial do lote.
VERSAOEVENCANCCFGEPECRESULTA1-40-1Versão do leiaute específico do evento Cancelamento
VERSAOEVENCCECFGEPECRESULTA1-40-1Versão do leiaute específico do evento Carta de Correção
VERSAOEVENEPECCFGEPECRESULTA1-40-1Versão do leiaute específico do evento EPEC
VERSAOEVENMULTCFGEPECRESULTA1-40-1Versão do leiaute específico do evento Registro do Multimodal
VERSAOGERALCANCCFGEPECRESULTA1-40-1Versão do leiaute geral do evento Cancelamento
VERSAOGERALCCECFGEPECRESULTA1-40-1Versão do leiaute geral do evento Carta de Correção
VERSAOGERALEPECCFGEPECRESULTA1-40-1Versão do leiaute geral do evento EPEC
VERSAOGERALMULTCFGEPECRESULTA1-40-1Versão do leiaute geral do evento Registro do Multimodal
VERSAOGERALGTVCFGEPECRESULTA1-40-1Versão do leiaute geral do evento Informações da GTV
VERSAOEVENGTVCFGEPECRESULTA1-40-1Versão do leiaute específico do evento Informações da GTV
VERSAOGERALDESACCFGEPECRESULTA1-40-1Versão do leiaute geral do evento Prestação do Serviço em Desacordo
VERSAOEVENDESACCFGEPECRESULTA1-40-1Versão do leiaute específico do evento Prestação do Serviço em Desacordo

 

Soap Fault

FaultObservações
Invalid TokenO parâmetro USERTOKEN foi informado incorretamente.
001Código de entidade inválida.
002Código de entidade em branco.
003Versão do leiaute geral do evento EPEC inválida.
004Versão do leiaute específico do evento EPEC inválida.
005Versão do leiaute geral do evento de Cancelamento inválida.
006Versão do leiaute específico do evento de Cancelamento inválida.
007Versão do leiaute geral do evento de Carta de Correção inválida.
008Versão do leiaute específico do evento de Carta de Correção inválida.
009Versão do leiaute geral do evento de Registro do Multimodal inválida.
010Versão do leiaute específico do evento de Registro do Multimodal inválida.
011Versão do leiaute geral do evento de Registro do Multimodal inválida.
012Versão do leiaute geral do evento Informações da GTV inválida.
013Versão do leiaute específico do evento Informações da GTV inválida.
014Versão do leiaute geral do evento Prestação do Serviço em Desacordo inválida.
015Versão do leiaute específico do evento Prestação do Serviço em Desacordo inválida.

 

  • Método CFGVERSAOCTE

O objetivo deste método é informar ao TSS para qual versão deve converter o XML recebido do ERP. Caso a versão não seja informada o método irá retornar a lista de versões disponíveis. Caso a versão informada seja 0.00 o método irá retornar a versão configurada. Caso a versão informada seja 9.99 o método não ira configurar a versão.

 

Os parâmetros de entrada do método são:

 <soap:Body>

   <USERTOKEN>STRING</USERTOKEN>
   <ID_ENT>STRING</ID_ENT>
   <VERSAO>STRING</VERSAO>
</soap:Body>

 

Nome
Pai
Tipo
Tam.
Ocor.
Observações

CFGVERSAOCTE

 

 

 

 

Tag raiz da requisição

USERTOKEN

CFGVERSAOCTE

A

5

1-1

Deverá ser preenchido com o valor “TOTVS”.

ID_ENT

CFGVERSAOCTE

A

6

1-1

ID da entidade a ser utilizada.

VERSAO

CFGVERSAOCTE

A

1-4

1-1

Informe branco para saber as versões admitidas pelo Totvs Service Soa separadas por pipe ‘|’, ‘0.00’ para saber a versão configurada atualmente ou uma versão valida para que o parâmetro seja alterado.

Versões possíveis: 2.00|3.00

 

Os parâmetros de saída do método são:

 <soap:Body>

   <CFGVERSAOCTERESPONSE>
    <CFGVERSAOCTERESULT>STRING</CFGVERSAOCTERESULT>
   </CFGVERSAOCTERESPONSE>
</soap:Body>

 

Nome
Pai
Tipo
Tam.
Ocor.
Observações

CFGVERSAOCTERESPONSE

-

-

-

1-1

Tag raíz do retorno.

CFGVERSAOCTERESULT

CFGVERSAOCTERESPONSE

A

1-250

0-1

Retorna vazio caso o parâmetro seja configurado corretamente.

Se passado em branco retorna as possíveis versões de configuração:

9.99|2.00|3.00

 

Soap Fault

FaultObservações
Invalid TokenO parâmetro USERTOKEN foi passado incorretamente.
001Código de entidade inválida.
002Código de entidade em branco.
003Versão incorreta.

 

  • Método RETORNARDOCUMENTO
 

Web Service NFESBRA

  • Método REMESSA

Método destinado à remessa de documentos fiscais eletrônicos. Este método recebe o XML do documento e assegura a transmissão para a SEFAZ.

Os parâmetros de entrada do método são:
<soap:Body>
   <USERTOKEN>STRING</USERTOKEN>
   <ID_ENT>STRING</ID_ENT>
   <NFE>
      <NOTAS>
         <NFES>
            <ID>STRING</ID>
            <XML>BASE64BINARY</XML>
         </NFES>
         <NFES>
            <ID>STRING</ID>
            <XML>BASE64BINARY</XML>
         </NFES>
      </NOTAS>
   </NFE>
</soap:Body>
NomePaiTipoTam.Ocor.Observações
USERTOKEN--A51-1Deverá ser preenchido com o valor “TOTVS”.
ID_ENT     
NFE     
NOTAS     
NFES     
ID     
XML     
MAIL     

 

Os parâmetros de saída do método são:

 

NomePaiTipoTam.Ocor.Observações
      
      

 

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.