# PROC003 - Cancelar DC-e

<table border="1" id="bkmrk-%C2%A0-projeto%2Fsistema%3Age" style="border-collapse: collapse; width: 100.123%; height: 49px;"><tbody><tr style="border-style: solid;"><td rowspan="3" style="width: 26.6667%; height: 49px; border-color: black; border-top-style: hidden; border-left-style: hidden; border-bottom-style: hidden;">  
<span style="color: #000000;"> [![logosoften1.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/scaled-1680-/logosoften1.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/logosoften1.png)</span>

</td><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Projeto/Sistema:**</span>  
<span style="color: #000000;">DC-e GerencieAqui</span></td><td class="align-center" style="width: 23.3333%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do *Template:***</span>  
<span style="color: #000000;">1.2</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Processo:**</span>  
<span style="color: #000000;">Cancelar DC-e</span></td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do Documento:**</span>  
<span style="color: #000000;">1.0</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Responsável(eis):** </span>  
<span style="color: #000000;">Daniela Taino</span></td><td class="align-center" style="width: 23.3333%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Data:** </span>

<span style="color: #000000;">28/04/2026</span>

</td></tr></tbody></table>

#####  

##### <span style="color: #000000;">**1. Introdução**</span>

<span style="color: #000000;"> Essa documentação visa descrever o processo de cancelamento de uma DC-e.</span>

##### <span style="color: #000000;">**2. Processos**</span>

<table cellpadding="9" cellspacing="0" id="bkmrk-processo-envolvidos-" style="width: 100%; height: 127px;" width="100%"><tbody><tr style="height: 35px;" valign="top"><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%; height: 35px;" width="27%"><span style="font-size: small; color: #000000;">**Processo**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 19%; height: 35px;" width="19%"><span style="font-size: small; color: #000000;">**Envolvidos**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%; height: 35px;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Entrada**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%; height: 35px;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Saída**</span>

</td></tr><tr style="height: 46px;" valign="top"><td style="border-style: solid; border-color: black; height: 46px; width: 27%;" width="27%"><span style="color: #000000;">PROC001 - Listagem de DC-e</span></td><td style="border-style: solid; border-color: black; height: 46px; width: 19%;" width="19%"> </td><td style="width: 27%; height: 46px;" width="27%"><span style="color: #000000;">Listagem dos DC-e lançados</span></td><td style="border-style: solid; border-color: black; height: 46px; width: 27%;" width="27%"></td></tr><tr style="height: 46px;"><td style="border-style: solid; border-color: black; height: 46px; width: 27%;"><span style="color: #000000;">PROC002 - Novo DC-e</span></td><td style="border-style: solid; border-color: black; height: 46px; width: 19%;"><span style="color: #000000;">-</span></td><td style="border-style: solid; border-color: black; height: 46px; width: 27%;"><span style="color: #000000;">Novos DC-e ou edição de DC-e já lançados</span>

</td><td style="border-style: solid; border-color: black; height: 46px; width: 27%;"><span style="color: #000000;">DC-e cadastrado ou alterado</span>

</td></tr><tr><td style="border-style: solid; border-color: black; width: 27%;"><span style="color: #000000;">PROC002 - Cancelar DC-e</span></td><td style="border-style: solid; border-color: black; width: 19%;"><span style="color: #000000;"> </span></td><td style="border-style: solid; border-color: black; width: 27%;"><span style="color: #000000;">DC-e autorizado</span>

</td><td style="border-style: solid; border-color: black; width: 27%;"><span style="color: #000000;">DC-e cancelado</span>

</td></tr></tbody></table>

#### <span style="color: #000000;">**Processos Relacionados** </span>

- - - - - -

<span style="color: #000000;">[PROC002 - Novo DC-e](https://docs.softensistemas.com.br/books/dce-documentacao-de-conteudo-eletronica/page/proc002-novo-dc-e)</span>

#### <span style="color: #000000;">**Especificação Funcional**</span>

- - - - - -

#### <span style="color: #000000;">**PROC003 Cancelar DC-e**</span>

##### <span style="color: #000000;">***Protótipo de Tela:***</span>

<span style="color: #000000;">[![image-1777420044424.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/scaled-1680-/image-1777420044424.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/image-1777420044424.png)</span>

<span style="color: #000000;">*Imagem I - Dialog de cancelamento de DC-e*</span>

##### <span style="color: #000000;">***Descrição dos Campos:***</span>

<table border="1" cellpadding="7" cellspacing="0" id="bkmrk-campo-tipo-tamanho-o" style="width: 832px; height: 442px;"><tbody><tr style="height: 57px;" valign="top"><td bgcolor="#acb9ca" style="width: 206.989px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">**Campo**</span>

</td><td bgcolor="#acb9ca" style="width: 116.989px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">**Tipo**</span>

</td><td bgcolor="#acb9ca" style="width: 80.9659px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">**Tamanho**</span>

</td><td bgcolor="#acb9ca" style="width: 110px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">**Obrig. ?**</span>

</td><td bgcolor="#acb9ca" style="width: 116.989px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">**Máscara**</span>

</td><td bgcolor="#acb9ca" style="width: 200px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">**Observações**</span>

</td></tr><tr style="height: 35px;"><td style="width: 206.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Justificativa</span></td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Texto</span>

</td><td style="width: 80.9659px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">255</span>

</td><td style="width: 110px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Sim</span>

</td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 200px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td></tr><tr style="height: 35px;"><td style="width: 206.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Enviar Cancelamento</span></td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Botão</span>

</td><td style="width: 80.9659px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;"> </span>

</td><td style="width: 110px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;"> </span>

</td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;"> </span>

</td><td style="width: 200px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;"> </span>

</td></tr><tr style="height: 35px;"><td style="width: 206.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Seq</span>

</td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">*Column Header*</span>

</td><td style="width: 80.9659px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 110px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 200px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Possibiilidade de ordenação ASC ou DESC </span>

</td></tr><tr style="height: 35px;"><td style="width: 206.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Correção</span>

</td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;"> *Column Header*</span>

</td><td style="width: 80.9659px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 110px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;"> -</span>

</td><td style="width: 200px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Possibiilidade de ordenação ASC ou DESC </span>

</td></tr><tr style="height: 35px;"><td style="width: 206.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Status</span>

</td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">*Column Header* </span>

</td><td style="width: 80.9659px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 110px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">- </span>

</td><td style="width: 200px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Possibiilidade de ordenação ASC ou DESC . Opções disponíveis: AUTORIZADO ou ERRO</span>

</td></tr><tr style="height: 35px;"><td style="width: 206.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Menu</span>

</td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">*Column Header*</span>

</td><td style="width: 80.9659px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 110px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 116.989px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 200px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">A escolher entre:  
Emitir PDF, Baixar XML e Excluir</span>

</td></tr></tbody></table>

#####  

##### <span style="color: #000000;">***Regras de Interface:***</span>

<span style="color: #000000;">**1. Justificativa:** conforme e justificativa for sendo preenchida, a quantidade de caracteres restantes deve ser subtraida. </span>  
<span style="color: #000000;">**2. Enviar cancelamento**: o padrão deve estar desabilitado, por padrão. Deve ser habilitado se, e somente se, 15 ou mais caracteres forem preenchidos na justificativa de cancelamento. </span>  
<span style="color: #000000;">**3. Status:** o status deverá seguir as cores padrão do sistema: "AUTORIZADO" (verde) ou "ERRO" (vermelho), partir dos valores do bit "autorizado" na tabela. O tooltip do status deve ser exibido de acordo com o conteúdo da coluna "situacao". </span>  
<span style="color: #000000;">**4. Menu**:</span>

- <span style="color: #000000;">**Emitir PDF**: a opção deverá estar habilitada somente se o cancelamento da DCe estiver autorizado. O clique na opção deverá abrir o comprovante do evento em uma dialog, como acontece com a NFe (alterar tudo que está NFe para DCe e remover o CCe do protocolo).</span>

<span style="color: #000000;">[![image-1777421265154.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/scaled-1680-/image-1777421265154.png) ](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/image-1777421265154.png)</span>

<span style="color: #000000;">*Imagem II - Referência para comprovante de cancelamento da DC-e.*</span>

- <span style="color: #000000;">**Baixar XML**: a opção deverá estar habilitada somente se o evento de cancelamento da DCe estiver autorizado. O clique na opção deverá realizar o download do XML de autorização do evento.</span>
- <span style="color: #000000;">**Excluir:** a opção deverã estar habilitada somente se o evento de cancelamento não estiver autorizado. A exclusão de um registro remove a linha da exibição na grid e a mensagem deve ser exibida "Evento excluido com o sucesso!". </span>

<span style="color: #000000;">**5**. A paginação deve ocorrer a partir de 3 eventos enviados (a autorização acontece só para um, mas o usuário pode tentar o envio várias vezes).</span>

##### <span style="color: #000000;">***Regras de Negócio:*** </span>

<span style="color: #000000;">**1. Enviar cancelamento:** o clique no botão deve realizar a montagem do XML descrito em [Anexo I - Exemplos de XML (cancelamento e retorno)](https://docs.softensistemas.com.br/books/dc-e-documentacao-de-conteudo-eletronica/page/anexo-i-exemplos-de-xml-cancelamento-e-retorno) e realizar o envio para o WS DCeRecepcaoEvento, de acordo com o ambiente configurado:</span>

<table border="1" id="bkmrk-ambiente-de-produ%C3%A7%C3%A3o" style="border-collapse: collapse; width: 100%; height: 288px;"><tbody><tr style="height: 29px;"><th colspan="3" style="width: 19.1358%; height: 29px;"><span style="color: #000000;">**Ambiente de Produção**</span></th></tr><tr style="height: 29px;"><th style="width: 19.1358%; height: 29px;"><span style="color: #000000;">**Serviço**</span></th><th style="width: 7.65432%; height: 29px;"><span style="color: #000000;">**Versão**</span></th><th style="width: 33.2099%; height: 29px;"><span style="color: #000000;">**URL**</span></th></tr><tr style="height: 46px;"><td style="width: 19.1358%; height: 46px;"><span style="color: #000000;">DCeRecepcaoEvento</span></td><td style="width: 7.65432%; height: 46px;"><span style="color: #000000;">1.00</span></td><td style="width: 33.2099%; height: 46px;"><span style="color: #000000;">https://dce.fazenda.pr.gov.br/dce/DCeRecepcaoEvento?wsdl</span></td></tr></tbody></table>

<table border="1" id="bkmrk-ambiente-de-homologa" style="border-collapse: collapse; width: 100%; height: 288px;"><tbody><tr style="height: 29px;"><th colspan="3" style="width: 19.1358%; height: 29px;"><span style="color: #000000;">**Ambiente de Homologação**</span></th></tr><tr style="height: 29px;"><th style="width: 19.1358%; height: 29px;"><span style="color: #000000;">**Serviço**</span></th><th style="width: 7.65432%; height: 29px;"><span style="color: #000000;">**Versão**</span></th><th style="width: 33.2099%; height: 29px;"><span style="color: #000000;">**URL**</span></th></tr><tr style="height: 46px;"><td style="width: 19.1358%; height: 46px;"><span style="color: #000000;">DCeRecepcaoEvento</span></td><td style="width: 7.65432%; height: 46px;"><span style="color: #000000;">1.00</span></td><td style="width: 33.2099%; height: 46px;"><span style="color: #000000;">https://dce.fazenda.pr.gov.br/dce/DCeRecepcaoEvento?wsdl</span></td></tr></tbody></table>

<span style="color: #000000;">  
<span style="color: #000000;">2. Caso o retorno do WS seja "101 - Cancelamento de DCe Homologado" o bit "autorizado" deve ser marcado como verdadeiro no banco de dados e na coluna "situacao" deve ser inserido o texto Cancelamento de DCe Homologado. Em caso de erro (situação diferente de 101), o motivo do erro deve ser inserido na coluna "situacao" e o bit "autorizado" não sofre alterações de valor. Em todo caso, o arquivo é gravado em disco com o padrão de nomenclatura usado para NFe -&gt; DCe\[CHAVE\]-canc.xml (para os autorizados) e -cancRet.xml para os erros.  
**3**. **Baixar XML:** é feita a busca na pasta da empresa e dce, e é feito o download do arquivo DCe\[CHAVE\]-canc.xml.  
**4. Excluir**: a exclusão deve deletar tudo vinculado a respectiva linha no banco de dados. </span></span>

##### <span style="color: #000000;">***Questões Técnicas:***</span>

<span style="color: #000000;">A nova tabela deverá ser criada no banco de dados para armazenar o evento:</span>

```SQL
CREATE TABLE `dceevento` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `nSeqEvento` int(11) NOT NULL, // sequencial a partir do último registro inserido da dceId
  `tipo` int(1) NOT NULL, // 1 = cancelamento
  `xCorrecao` varchar(255) DEFAULT NULL, // Justificativa
  `empresaId` bigint(20) DEFAULT NULL,
  `dceId` bigint(20) DEFAULT NULL,
  `autorizado` bit(1) NOT NULL,
  `motivo` varchar(255) DEFAULT NULL,
  `situacao` int(11) DEFAULT NULL,
)
```