2014
Envio de Eventos para CT-e
16 de setembro de 2014Índice
-- 1. Índice
- 2. Envio de Eventos para CT-e
- 3. O que é um evento?
- 4. Eventos de Cancelamento e Multimodal
- 5. Evento de Prestação do Serviço em Desacordo
- 6. Evento de Comprovante de Entrega do CT-e
- 7. Evento de Insucesso na Entrega do CT-e
- 8. Evento de Carta de Correção
- 8.1. Situações para emissão de CC-e
- 8.2. Prazo para emitir uma CC-e
- 8.3. Quantidade de Cartas de Correção
- 8.4. Layout da CC-e
- 9. Como enviar um evento?
Envio de Eventos para CT-e
Neste artigo, abordaremos a emissão de eventos do CT-e, que, por sua vez, é realizada pelo mesmo Web Service utilizado para enviar o CT-e. Entre os principais eventos, destacam-se: Cancelamento, Multimodal, Prestação de serviço em desacordo, Insucesso na Entrega do CT-e e Comprovante de Entrega do CT-e.
O que é um evento?
Um evento representa o registro de um fato que ocorreu com o CT-e após sua autorização de uso. Tanto o contribuinte quanto o Fisco podem emitir esses eventos. Além disso, alguns eventos, como o de cancelamento, podem modificar a situação do documento. A seguir, explicamos cada tipo de evento e o procedimento necessário para seu envio.
Eventos de Cancelamento e Multimodal
Para os eventos de Cancelamento e Multimodal, a geração do XML segue a mesma estrutura, com exceção das tags específicas de cada evento. Clique aqui para fazer o download do manual de geração do XML dos eventos.
Além disso, disponibilizamos um arquivo de esquema XML, que é útil para gerar o XML corretamente. Recomenda-se, portanto, validar o arquivo gerado contra o esquema antes de enviá-lo ao InvoiCy. Clique aqui para baixar o arquivo de esquema.
Evento de Prestação do Serviço em Desacordo
Para enviar este evento, use o layout de eventos, ajustando os campos conforme necessário. Informe na tag <Evedet> a descrição “Prestação do serviço em Desacordo” e preencha a tag <indDesacordo> com o valor ‘1’. Você também pode adicionar observações do tomador na tag <Observacao>. Para ver um exemplo completo do XML do evento, clique aqui.
Evento de Comprovante de Entrega do CT-e
O envio do evento de comprovante de entrega do CT-e segue a mesma estrutura dos demais eventos. No entanto, há uma diferença: ele inclui um novo grupo na estrutura, o grupo <CompEntrega>, que detalha as informações da entrega do documento. Para obter mais informações sobre este evento, consulte o artigo específico aqui.
Evento de Insucesso na Entrega do CT-e
O evento de insucesso na entrega segue, portanto, uma estrutura semelhante à dos demais eventos, com a adição de campos específicos relacionados à natureza desse evento, como o grupo <InsucessoEntrega>. Para obter mais detalhes sobre este evento, consulte o artigo dedicado aqui.
Evento de Carta de Correção
Considere alguns pontos importantes ao emitir uma Carta de Correção Eletrônica (CC-e), como as situações permitidas para emissão, prazos e quantidade de correções.
Situações para emissão de CC-e
Utilize a CC-e para corrigir erros na emissão do documento fiscal, mas evite nos seguintes casos:
- Variáveis que determinam o valor do imposto, como base de cálculo, alíquota, quantidade e valor da operação.
- Correção de dados cadastrais relacionados ao remetente ou destinatário.
- Alteração na data de emissão ou saída da mercadoria.
Prazo para emitir uma CC-e
O emissor tem até 720 horas (30 dias) após a autorização do CT-e para emitir uma CC-e.
Quantidade de Cartas de Correção
É possível emitir até 20 Cartas de Correção para cada CT-e. A CC-e corrige erros na emissão do documento fiscal, exceto nos seguintes casos. A versão mais recente substitui as anteriores, incluindo todas as correções feitas anteriormente.
Layout da CC-e
O layout para envio de uma CC-e é o mesmo utilizado para o envio de CT-e. Apenas os campos a serem corrigidos devem ser alterados, substituindo a tag <Envio> por <EnvioEvento>.
Em nosso exemplo, mostramos como corrigir o valor do campo <natOp>, com o layout de CT-e à esquerda e o de CC-e à direita, destacando a alteração das tags.

Para entender melhor, disponibilizamos um exemplo do arquivo XML para o evento de CC-e. Clique aqui para baixar. E para acessar o manual de geração do XML de eventos para CC-e, clique aqui.
Use a CC-e para corrigir erros na emissão do documento fiscal, exceto nos seguintes casos. Lembre-se de que não é possível corrigir a data e hora de emissão. O valor na tag <EveDh> será usado para transmitir o evento à SEFAZ; se estiver em branco, o InvoiCy usará o horário do servidor, o que pode causar falhas caso haja diferença de fuso horário com a SEFAZ.
Após a autorização da CC-e, você pode baixar o arquivo XML gerado e imprimir o PDF da última CC-e autorizada. A impressão pode ser feita tanto na tela inicial, clicando sobre o ícone de impressão, quanto na tela de Detalhes do documento, na aba “Eventos”.
Ao efetuar a impressão pela tela inicial, aparecerá uma opção para você usuário escolher se deseja imprimir o PDF do DACTE ou o PDF da Carta de Correção, conforme a imagem a seguir. Destacando que essa opção aparece apenas para os documentos que possuem uma Carta de Correção já autorizada.

Acessando a tela de detalhes do documento, aba Eventos, também é possível baixar os arquivos xml dos eventos e imprimir apenas o PDF da última CC-e autorizada, conforme imagem a seguir.

Clicando sobre o conteúdo da grid é aberta a tela de detalhes do evento, contendo mais informações sobre a Carta de Correção enviada.

Como enviar um evento?
Siga estes passos para enviar um evento:
- Envie um novo CT-e: Pode ser um CT-e novo ou um já autorizado, desde que o status seja “autorizado”.
- Gere o XML do evento: Você deverá gerar a estrutura do XML de acordo com o evento desejado, seguindo o layout de eventos no caso de eventos de Cancelamento e Multimodal. Ou o layout de eventos no caso de uma Carta de Correção.
Para facilitar o seu entendimento, anexamos a este artigo um exemplo completo de cancelamento de um CT-e através do WS de integração do InvoiCy. Clique aqui e realize o download do documento.
- Consuma o Web Service do InvoiCy: Após gerar o XML, consuma o Web Service de integração do InvoiCy conforme descrito no artigo “Integrando com o módulo CT-e”.
- Obtenha o retorno do envio: Após o envio, verifique o retorno para confirmar se a operação foi realizada com sucesso.
O layout de retorno do Web Service para eventos, é o mesmo retornado no momento da emissão do CT-e. Para os eventos, estarão preenchidas as tags específicas no retorno, como o EveTp e EveId, como mostra a imagem abaixo.

Artigos Relacionados: