##### **1. Introdução**
Essa documentação visa descrever o processo de criação da tela de preenchimento da DC-e.
##### **2. Processo**
**Processo**
**Envolvidos**
**Dados de Entrada**
**Dados de Saída**
PROC001 - Listagem de DC-e
Listagem dos DC-e lançados
PROC002 - Nova DC-e
-
Novos DC-e ou edição de DC-e já lançados
DC-e cadastrado ou alterado
PROC003 - Gerenciador de DC-e
-
-
Listagem de DC-es salvas em banco
PROC004 Emissão de DC-e
-
Envio de DC-e a SEFAZ
Arquivo XML
#### **Processos Relacionados**
- - - - - -
[PROC001 - Listagem de DC-e](https://docs.softensistemas.com.br/books/dc-e-declaracao-de-conteudo-eletronica-siem/page/proc001-listagem)
[PROC003 - Gerenciador de DC-e](https://docs.softensistemas.com.br/books/dc-e-declaracao-de-conteudo-eletronica-siem/page/proc003-gerenciador-de-dc-e)
[PROC004 - Emissão de DC-e](https://docs.softensistemas.com.br/books/dc-e-declaracao-de-conteudo-eletronica-siem/page/proc004-emissao-de-dc-e)
#### **Especificação Funcional**
- - - - - -
#### **PROC002 - Nova DC-e:**
##### ***Protótipo de Tela:***
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-05/image-1778085456781.png)
*Imagem I - Protótipo de tela para o lançamento de uma nova DC-e.*
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/image-1776273178684.png)
*Imagem II - Informações adicionais do produto.*
##### ***Descrição dos Campos:***
A escolher entre: Transporte Próprio, Correios e Terceiros
CNPJ da Transportadora
Texto
18
-
00.000.000/0000-00
Máscara de CNPJ padrão do sistema
Observações
Texto
5000
-
-
-
Finalidade
ComboBox
-
-
-
A escolher entre: DC-e Normal e Contingência Offline
Cancelar
Botão
-
-
-
-
CONFIRMAR
Botão
-
-
-
-
Pré-visualizar DC-e
CheckBox
-
-
-
-
##### ***Regras de Interface:***
1. **DC-e Num:** Campo visual, deve trazer o código da DC-e em banco. Ao abrir a primeira vez ficará como zero, pois é definido após salvar.
2. **Data Emissão**: Considerar o valor padrão como a data "hoje" do computador.
3. **Remetente**: Por padrão bloqueado. Campo código do cadastro de clientes. Ao ser digitado o código e apertado 'Enter' o cadastro correspondente deve ser vinculado e o nome do cliente preenchido. Caso seja digitado zero e aperte o 'Enter', deve ser aberta a tela de busca de clientes. Esse campo somente será desbloqueado quando o tipo de emissor mencionadono [PROC001 - Criação das configurações associadas](https://docs.softensistemas.com.br/books/dce-documentacao-de-conteudo-eletronica/page/proc000-criacao-das-configuracoes-associadas) for "Transportadora".
1. Q / [](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/image-1776273366139.png): Deve abrir a tela de busca de clientes.
4. **Destinatário:** Campo código do cadastro de clientes. Ao ser digitado o código e apertado 'Enter' o cadastro correspondente deve ser vinculado e o nome do cliente preenchido. Caso seja digitado zero e aperte o 'Enter', deve ser aberta a tela de busca de clientes.
1. Q / [](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/image-1776273366139.png): Deve abrir a tela de busca de clientes.
5. **Produto**: Campo código do cadastro de produtos. Ao ser digitado o código e apertado 'Enter' o cadastro correspondente deve ser vinculado e a descrição do produto preenchida. Caso seja digitado zero e aperte o 'Enter', deve ser aberta a tela de busca de produtos. Caso esteja configurado o controle de estoque e o produto não possua saldo, retornar o aviso em tela "Usuário sem permissão para baixar item sem estoque!"
1. 1. Q / [](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/image-1776273366139.png): Deve abrir a tela de busca de produtos.
6. **Informações Adicionais :** o clique no Link deve realizar a abertura da *dialog* para inserção de informações complementares sobre o produto específico. O tamanho do campo é de 500 caracteres e a informação só a é salva com o clique no botão "Salvar". (Imagem II)
7. **LE:** Por padrão bloqueado. Campo referente ao Local de Estoque, deve ser liberado caso esteja configurado no sistema o uso de Local de Estoque.
8. **Tipos de Estoque:** Os controles de tipo de estoque como Validade, Grade, N. Serie, Arma devem aparecer logo abaixo da descrição do produto para o preenchimento do usuário. Comportamento padrão do sistema.[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/image-1776275396431.png)[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/image-1776275445034.png)
9. **Valor Unitario:** Com o foco no valor do valor unitario, ao apertar "Enter" no teclado deve ser feitas as validações para a inserção do produto. Caso algum campo não esteja preenchido, exibir uma mensagem de aviso. Exemplo: "Erro! verifique o preenchimento dos campos obrigatórios." Caso todos os campos obrigatórios estejam preenchidos, o produto deve inserido na *grid* de listagem de produtos inseridos.
10. **Valor Total**: Campo desabilitado por padrão. Realiza o calculo da Quantidade \* Valor Unitário em tela.
11. **Inserir[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/image-1776372706619.png):** o botão inserir deve realizar a validação dos campos obrigatórios para a inserção de um produto. Caso algum campo não esteja preenchido, exibir uma mensagem de aviso. Exemplo: "Erro! verifique o preenchimento dos campos obrigatórios." Caso todos os campos obrigatórios estejam preenchidos, o produto deve inserido na *grid* de listagem de produtos inseridos.
12. **Listagem:**
1. **Excluir:** A ação para deletar um registro inserido na listagem é na ação da tecla 'Delete' no teclado.
13. **Label TOTAL(R$):** Deve representar a soma dos valores totais de todos os itens inseridos na listagem.
14. **Modalidade de Transporte:** valor padrão: Transporte Próprio**.**
15. **CNPJ da Transportadora:** campo desabilitado por padrão. Deve estar habilitado somente quando a modalidade de transporte selecionada for "Terceiros".
16. **Finalidade de Emissão:** Por padrão deve ser "DC-e Normal"
17. **Cancelar:** O clique no botão "Cancelar" deve finalizar tela.
18. **Confirmar:** deve validar os campos de preenchimento obrigatório e caso um ou mais campos não estejam preenchidos, deve exibir uma mensagem de erro. Exemplo "Erro! verifique o preenchimento dos campos obrigatórios.". Caso a DC-e possa ser salva, exibir a mensagem "DCE salvo com código {código da DC-e}".
##### ***Regras de Negócio:**
1. **Tipo de Emissão:** o tipo de emissão deve ser armazenado no banco de acordo com a nomenclatura do manual: 1=Emissão normal (não em contingência);9=Contingência off-line da DCe.
2. **Adicionar Produto:** Deve ser validado se o usuário possui restrição para não vender sem estoque. Caso esteja configurado para não vender sem estoque, o item não será vínculado.
3. **Valor Total:** o valor total é calculado a partir da multiplicação entre o Valor Unitário e a Quantidade.
4. **Confirmar:** caso o DC-e possa ser salvo, deve realizar o salvamento do registro no banco de dados. Caso seja uma edição, o registro deve ser atualizado no banco de dados. Nesse momento também deve ser realizado o fluxo de movimento do estoque.O arquivo XML já deve ser gerado nesse momento.
5. O fluxo de numeração da DC-e deverá seguir o que já existe para os outros documentos fiscais. Para evitar duas pessoas numerando o mesmo documento ao mesmo tempo, usar a mesma regra de validação dos outros documentos para impedir modificação no mesmo número ou registro.
##### ***Questões Técnicas:***
1. Deverão ser criadas novas tabelas no banco de dados para armazenamento das novas informações.
```SQL
CREATE TABLE FATURAMENTO_DCE (
codigoDCe INTEGER,
data DATETIME,
responsavelEmissao INTEGER,
destinatario INTEGER,
emitente INTEGER,
valorTotal DECIMAL(13,2),
modalidadeTransporte INTEGER NOT NULL,
cnpjTerceiros TEXT(18),
observacao MEMO,
DCe_stAssinado BOOLEAN NOT NULL,
DCe_stAutorizado BOOLEAN NOT NULL,
DCe_stCancelado BOOLEAN NOT NULL,
DCe_stEnviado BOOLEAN NOT NULL,
DCe_stValidado BOOLEAN NOT NULL,
ambiente TEXT(255),
cDV LONG NOT NULL,
cMDFe LONG NOT NULL,
ArqXML TEXT(255),
chaveAcesso TEXT(255),
chaveConf TEXT(255),
serieDCe LONG NOT NULL,
procEmi LONG NOT NULL,
protAutoriza TEXT(255),
tpEmis LONG NOT NULL,
tpEmit LONG NOT NULL,
ufEmit TEXT(255),
verProc TEXT(255),
geradoEstoque BOOLEAN NOT NULL,
cteVinculado TEXT(255),
CONSTRAINT fk_dce_destinatario
FOREIGN KEY (destinatarioId) REFERENCES Cad_Cliente (Codigo),
CONSTRAINT fk_dce_emitente
FOREIGN KEY (emitenteId) REFERENCES Cad_Cliente (Codigo)
);
```
```SQL
CREATE TABLE FATURAMENTO_DCE_ITEM (
id AUTOINCREMENT PRIMARY KEY,
produto INTEGER NOT NULL,
nomeProduto TEXT(120) NOT NULL,
informacoesAdicionais TEXT(500),
quant DECIMAL(19,10) NOT NULL,
valorCusto DECIMAL(19,4) NOT NULL,
vlTotal DECIMAL(19,2),
vlTotalLiq DECIMAL(19,2),
vlUnit DECIMAL(19,10) NOT NULL,
dceId INTEGER NOT NULL,
gradeId INTEGER,
lote TEXT(255),
validade DATETIME,
tamanho TEXT(15),
cor INTEGER,
nSerie TEXT(15)
CONSTRAINT fk_dceitem_dce
FOREIGN KEY (dceId) REFERENCES FATURAMENTO_DCE (codigoDCe),
CONSTRAINT fk_dceitem_produto
FOREIGN KEY (produtoId) REFERENCES Estoque_Itens (Codigo)
);
```
**2.** Exemplo de arquivo XML a ser salvo no path do sistema pasta /DCe/{numero do documento}/.
##### **1. Introdução**Essa documentação visa descrever o fluxo do gerenciador da DC-e.
##### **2. Processo (adicionar fluxograma exemplo)**
[](https://docs.softensistemas.com.br/uploads/images/gallery/2024-08/image-1724162109370.png)
I - Fluxograma Exemplo
**Processo**
**Envolvidos**
**Dados de Entrada**
**Dados de Saída**
PROC001 - Listagem de DC-e
Listagem dos DC-e lançados
PROC002 - Nova DC-e
-
Novos DC-e ou edição de DC-e já lançados
DC-e cadastrado ou alterado
PROC003 - Gerenciador de DC-e
-
-
Listagem de DC-es salvas em banco
PROC004 - Emissão de DC-e
-
Envio de DC-e a SEFAZ
Arquivo XML
#### **Processos Relacionados**
- - - - - -
[PROC001 - Listagem de DC-e](https://docs.softensistemas.com.br/books/dc-e-declaracao-de-conteudo-eletronica-siem/page/proc001-listagem)
[PROC002 - Nova DC-e](https://docs.softensistemas.com.br/books/dc-e-declaracao-de-conteudo-eletronica-siem/page/proc002-nova-dc-e)
[PROC004 - Emissão de DC-e](https://docs.softensistemas.com.br/books/dc-e-declaracao-de-conteudo-eletronica-siem/page/proc004-emissao-de-dc-e)
#### **Especificação Funcional**
- - - - - -
#### **PROC001 Gerenciador DC-e:**
##### ***Protótipo de Tela:***
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-04/image-1776458930661.png)
##### ***Descrição dos Campos:***
**Campo**
**Tipo**
**Tamanho**
**Obrig. ?**
**Máscara**
**Observações**
Período dos DC-es
DatePicker
-
Sim
-
-
Filtro Origem/Destino
RadioButton
-
Sim
-
Seleção do filtro de busca. Origem = Remetente; Destino = Destinatário.
##### **1. Introdução**
Essa documentação visa descrever o processo de envio da DC-e ao governo.
##### **2. Processo**
**Processo**
**Envolvidos**
**Dados de Entrada**
**Dados de Saída**
PROC001 - Listagem de DC-e
Listagem dos DC-e lançados
PROC002 - Nova DC-e
-
Novos DC-e ou edição de DC-e já lançados
DC-e cadastrado ou alterado
PROC003 - Gerenciador de DC-e
-
-
Listagem de DC-es salvas em banco
PROC004 - Emissão de DC-e
-
Envio de DC-e a SEFAZ
Arquivo XML
#### **Processos Relacionados**
- - - - - -
[PROC001 - Listagem de DC-e](https://docs.softensistemas.com.br/books/dc-e-declaracao-de-conteudo-eletronica-siem/page/proc001-listagem)[PROC002 - Nova DC-e](https://docs.softensistemas.com.br/books/dc-e-declaracao-de-conteudo-eletronica-siem/page/proc002-nova-dc-e)[PROC003 - Gerenciador de DC-e](https://docs.softensistemas.com.br/books/dc-e-declaracao-de-conteudo-eletronica-siem/page/proc003-gerenciador-de-dc-e)
#### **Especificação Funcional**
- - - - - -
#### **PROC004 Emissão de DC-e:**
##### **1. Regras de Interface****1**. A autorização é síncrona, deve ser aberto a tela de resultado de envio, tela já existente no envio de outros documentos ao governo.**2**. Caso a DC-e não possa ser assinada (certificado não vinculado, inválido ou vencido), deverá ser exibida a mensagem de erro de certificado digital vencido. **3**. Se a DC-e for rejeitada pelo governo, o erro deverá ser exibido em tela: "Erro! \[MENSAGEM NO CAMPO situacao DO BANCO DE DADOS\]. Caso seja autorizado, deve apresentar a mensagem "DC-e Autorizada".
##### **3. Regras de Negócio** **1**. A primeira etapa é a assinatura do documento com o certificado A1 ou A3 da empresa. O processo de assinatura segue o algoritmo padrão que já utilizado nos outros documentos fiscais. Caso tudo ocorra sem problemas com a assinatura, o bit DCe\_stAssinado deverá ser marcado como verdadeiro.**2**. Depois da assinatura e geração completa, o processo de envio ao WS deverá ser realizado. Ao realizar o envio, o bit DCe\_stEnviado deverá ser marcado, independente do retorno de sucesso ou erro. **3**. Se o "cStat" do XML for 100, indica que o documento foi autorizado, então o bit DCe\_stAutorizado deve ser marcado como verdadeiro e o protocolo de autorização armazenado em "protAutoriza". Caso seja diferente de 100, isso indica que o governo retornou algum erro, então o bit não deverá ser marcado. **4**. Criar na pasta da empresa o diretorio "DCE" para armazenar os XMLs de envio (sem e com assinatura), retorno e eventos. O PDF sempre será gerado a cada requisição de impressão via JasperReport. Esse caminho deverá ser armazenado na tabela "dce" na coluna " caminhoArquivoXML". Validar sempre se a pasta existe e realizar a criação para primeiros envios. **5**. Os seguintes Webservices devem ser utlizados de acordo com o ambiente configurado (homologação ou produção) -> DCeAutorizacao e DCeConsulta.
**Processo:**
PROC006 - Transformar DC-e selecionados em CT-e
**Versão do Documento:**1.0
**Responsável(eis):** Luís Leite
**Data:** 06/05/2026
##### **1. Introdução****Este processo visa exemplificar a documentação para criação da função de transformar DC-e em CT-e.**
##### **2. Processo**
**Processo**
**Envolvidos**
**Dados de Entrada**
**Dados de Saída**
PROC006 - Transformar DC-e selecionados em CT-e
-
DC-e autorizada em banco
CT-e previamente preenchido
#### **Processos Relacionados**
- - - - - -
Documentação Exemplo 1
Documentação Exemplo 2
#### **Especificação Funcional**
- - - - - -
#### **PROC006.1 Configuração de importação:**
##### ***Regras de Negócio:***
***1.*** Deve ser adicionada a seguinte configuração 2 em banco:
**Setor**
**Configuração**
CTE
Importar DCe para mesmo CTE com MESMO: (0=SEPARADO(PADRAO)/1=EMITENTE e DESTINATARIO/2=EMITENTE/3=DESTINATARIO):
#### **PROC006.2 Adição de Função Gerar CTe:**
##### ***Protótipo de Tela:***
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-05/image-1778086543812.png)
Imagem I - Novo botão Gerar CTe
##### ***Descrição dos Campos:***