# PROC001 - Cancelar DC-e

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

</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;">GERENCIAMENTO DE PROJETOS</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;">Descrição Processo</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: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Responsável(eis):** </span>  
<span style="color: #000000;">-</span></td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Data:** </span>

<span style="color: #000000;">05/01/2026</span>

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

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

Essa documentação visa descrever o processo de cancelamento de uma DC-e.

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

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

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

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" 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%"><span style="font-size: small; color: #000000;">**Dados de Saída**</span>

</td></tr><tr valign="top"><td style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">Processo</span>

</td><td style="border-style: solid; border-color: black;" width="19%"><span style="font-size: small; color: #000000;">N/A</span>

</td><td style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">N/A</span>

</td><td style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">N/A</span>

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

#### **Processos Relacionados** 

- - - - - -

Documentação Exemplo 1   
  
Documentação Exemplo 2

#### **Especificação Funcional**

- - - - - -

#### **PROC001 - Cancelar DC-e:**

##### ***Protótipo de Tela:***

[![image-1778007151392.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-05/scaled-1680-/image-1778007151392.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-05/image-1778007151392.png)

[Imagem I - Nova tela de Evento](https://docs.softensistemas.com.br/uploads/images/gallery/2026-05/image-1778007151392.png)

[![image-1778008064591.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-05/scaled-1680-/image-1778008064591.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-05/image-1778008064591.png)[Imagem II - Tela de Evento de cancelamento](https://docs.softensistemas.com.br/uploads/images/gallery/2026-05/image-1778007151392.png)

##### ***Descrição dos Campos:***

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

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

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

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

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

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

</td></tr><tr style="height: 80px;"><td style="width: 135px; border-style: solid; border-color: black; height: 80px;"><span style="color: #000000;">Tipo de Evento</span></td><td style="width: 135px; border-style: solid; border-color: black; height: 80px;"><span style="color: #000000;">ComboBox</span>

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

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

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

</td><td style="width: 135px; border-style: solid; border-color: black; height: 80px;"><span style="color: #000000;">Deve conter a opção:   
Cancelamento</span>

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

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

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

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

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

</td></tr><tr style="height: 35px;"><td style="width: 135px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">DESCRIÇÃO</span></td><td style="width: 135px; border-style: solid; border-color: black; height: 35px;">*<span style="color: #000000;">Column Header</span>*

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

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

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

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

</td></tr><tr style="height: 29px;"><td class="align-center" colspan="6" style="width: 810px; border-style: solid; border-color: black; height: 29px;">Tela de preenchimento do evento</td></tr><tr style="height: 35px;"><td style="width: 135px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Num. Ordem</span></td><td style="width: 135px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Texto</span>

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

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

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

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

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

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

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

</td></tr><tr style="height: 35px;"><td style="width: 135px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Chave DCe</span></td><td style="width: 135px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Texto</span>

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

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

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

</td></tr><tr style="height: 35px;"><td style="width: 135px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Descrição do Evento (Mudança ou Justificativa)</span></td><td style="width: 135px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Texto</span>

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

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

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

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

</td></tr><tr><td style="width: 135px; border-style: solid; border-color: black;"><span style="color: #000000;">Protocolo</span></td><td style="width: 135px; border-style: solid; border-color: black;"><span style="color: #000000;">Texto</span>

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

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

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

</td><td style="width: 135px; border-style: solid; border-color: black;"><span style="color: #000000;">Apenas Visualização</span>

</td></tr><tr><td style="width: 135px; border-style: solid; border-color: black;"><span style="color: #000000;">Data e Hora</span></td><td style="width: 135px; border-style: solid; border-color: black;"><span style="color: #000000;">Texto</span>

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

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

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

</td><td style="width: 135px; border-style: solid; border-color: black;"><span style="color: #000000;">Apenas Visualização</span>

</td></tr><tr style="height: 49px;"><td style="width: 135px; border-style: solid; border-color: black; height: 49px;"><span style="color: #000000;">Enviar e Autorizar</span></td><td style="width: 135px; border-style: solid; border-color: black; height: 49px;"><span style="color: #000000;">Botão</span>

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

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

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

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

</td></tr><tr style="height: 80px;"><td style="width: 135px; border-style: solid; border-color: black; height: 80px;"><span style="color: #000000;">Emitir Comprovante</span>

</td><td style="width: 135px; border-style: solid; border-color: black; height: 49px;"><span style="color: #000000;">Botão</span>

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

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

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

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

</td></tr><tr style="height: 80px;"><td style="width: 135px; border-style: solid; border-color: black; height: 80px;"><span style="color: #000000;">Enviar Email</span>

</td><td style="width: 135px; border-style: solid; border-color: black; height: 49px;"><span style="color: #000000;">Botão</span>

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

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

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

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

</td></tr><tr style="height: 147px;"><td style="width: 135px; border-style: solid; border-color: black; height: 147px;"><span style="color: #000000;">Deletar</span>

</td><td style="width: 135px; border-style: solid; border-color: black; height: 49px;"><span style="color: #000000;">Botão</span>

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

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

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

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

</td></tr><tr style="height: 80px;"><td style="width: 135px; border-style: solid; border-color: black; height: 80px;"><span style="color: #000000;">Sair</span>

</td><td style="width: 135px; border-style: solid; border-color: black; height: 49px;"><span style="color: #000000;">Botão</span>

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

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

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

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

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

##### ***Regras de Interface:***

**1. Emitir Comprovante**: o padrão deve estar desabilitado, por padrão. Deve ser habilitado caso o evento esteja autorizado. O clique na opção deverá abrir o comprovante do evento em uma dialog, como acontece com os restantes dos eventos. Exemplo do evento da NF-e para seguir o padrão.:

[![image-1778010900487.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-05/scaled-1680-/image-1778010900487.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-05/image-1778010900487.png)

  
<span style="color: #000000;">**2. Enviar Email**: o padrão deve estar desabilitado, por padrão. Deve ser habilitado caso o evento esteja autorizado.</span>  
<span style="color: #000000;">**3. Deletar**: o padrão deve estar desabilitado, por padrão. Deve ser habilitado caso o evento esteja salvo mas não autorizado.  
4\. Caso seja autorizado o Evento, deve ficar marcado como "AUTORIZADO" no topo da tela.</span>

##### ***Regras de Negócio:***

***1*****.<span style="color: #000000;">Enviar e Autorizar:</span>**<span style="color: #000000;"> Deve iniciar o processo do envio para o governo.</span>

<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. Em caso de erro (situação diferente de 101) 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.</span>

##### ***Questões Técnicas:***

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:

<table border="1" id="bkmrk-ambiente-de-produ%C3%A7%C3%A3o" style="height: 93px;" width="805"><tbody><tr><td class="align-center" colspan="3" style="width: 804px; border-style: solid; border-color: black;">**Ambiente de Produção**</td></tr><tr><td style="width: 268px; border-style: solid; border-color: black;">**Serviço**</td><td style="width: 268px; border-style: solid; border-color: black;">**Versão**</td><td style="width: 268px; border-style: solid; border-color: black;">**URL**</td></tr><tr><td style="width: 268px; border-style: solid; border-color: black;">DCeRecepcaoEvento</td><td style="width: 268px; border-style: solid; border-color: black;">1.00</td><td style="width: 268px; border-style: solid; border-color: black;">https://dce.fazenda.pr.gov.br/dce/DCeRecepcaoEvento?wsdl</td></tr></tbody></table>

<table border="1" id="bkmrk-ambiente-de-homologa" style="height: 116px;" width="803"><tbody><tr><td class="align-center" colspan="3" style="width: 802px; border-style: solid; border-color: black;">**Ambiente de Homologação**</td></tr><tr><td style="width: 267.328px; border-style: solid; border-color: black;">**Serviço**</td><td style="width: 267.328px; border-style: solid; border-color: black;">**Versão**</td><td style="width: 267.344px; border-style: solid; border-color: black;">**URL**</td></tr><tr><td style="width: 267.328px; border-style: solid; border-color: black;">DCeRecepcaoEvento</td><td style="width: 267.328px; border-style: solid; border-color: black;">1.00</td><td style="width: 267.344px; border-style: solid; border-color: black;">https://dce.fazenda.pr.gov.br/dce/DCeRecepcaoEvento?wsdl</td></tr></tbody></table>

2\. A nova tabela deverá ser criada no banco de dados para armazenar o evento:

```SQL
CREATE TABLE DCE_EVENTO (
  ID AUTOINCREMENT PRIMARY KEY,
  TIPO_EVENTO TEXT(10),
  SEQUENCIA INTEGER NOT NULL,
  CHAVE_DCE TEXT(44) NOT NULL,
  DETALHE_EVENTO TEXT(255) NOT NULL,
  DCe INTEGER NOT NULL,
  AUTORIZADO YESNO DEFAULT 0,
  arqCC TEXT(200),
  Protocolo TEXT(30),
  RegDtHr TEXT(30)
);
```

©SOFTEN SISTEMAS 2026