# 3. Importação dados XML DI para banco de dados

<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;">  
 ![Softensistemas Logo](https://www.softensistemas.com.br/assets/img/logo.webp)

</td><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Projeto/Sistema:**</span>  
Função importar DI XML - GA</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.1</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;">Importação dados XML DI para banco de dados</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;">Gustavo Fernandes</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;">04/10/2024</span>

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

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

<span style="color: #000000;">**Este processo visa exemplificar a importação do XML DI e vinculação com o banco de dados.**</span>

##### <span style="color: #000000;">**2. Processo de importação XML DI para o GA**</span>

[![image-1728060437866.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/scaled-1680-/image-1728060437866.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/image-1728060437866.png)

I - Fluxograma Exemplo

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

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

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

</td></tr><tr style="height: 57px;" valign="top"><td style="border-style: solid; border-color: black; height: 57px;" width="27%"><span style="font-size: small; color: #000000;">Importando XML DI</span>

</td><td style="border-style: solid; border-color: black; height: 57px;" width="19%"><span style="font-size: small; color: #000000;">XML e Sistema</span>

</td><td style="border-style: solid; border-color: black; height: 57px;" width="27%"><span style="font-size: small; color: #000000;">Verificação das TAG XML e cálculos necessários</span>

</td><td style="border-style: solid; border-color: black; height: 57px;" width="27%"><span style="font-size: small; color: #000000;">Retorna se foi importado com sucesso ou erro</span>

</td></tr><tr style="height: 35px;"><td style="border-style: solid; border-color: black; height: 35px;"><span style="font-size: small; color: #000000;">Se der algum erro na hora de gerar a NFe</span>

</td><td style="border-style: solid; border-color: black; height: 35px;"><span style="font-size: small; color: #000000;">XML e Sistema</span>

</td><td style="border-style: solid; border-color: black; height: 35px;"><span style="font-size: small; color: #000000;">Verificando TAG XML</span>

</td><td style="border-style: solid; border-color: black; height: 35px;">Retorna mensage de erro na tela

</td></tr><tr><td style="border-style: solid; border-color: black;"><span style="font-size: small; color: #000000;">Importado com sucesso!</span>

</td><td style="border-style: solid; border-color: black;"><span style="font-size: small; color: #000000;">XML e Sistema</span>

</td><td style="border-style: solid; border-color: black;"><span style="font-size: small; color: #000000;">Geração da NFe, alimentar BD ref NFe e NFeproduto</span>

</td><td style="border-style: solid; border-color: black;">Gera NFe no sistema dando opção de editar/salvar e enviar!

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

#### **Processos Relacionados** 

- - - - - -

[Protótipo de tela para importar DI](https://docs.softensistemas.com.br/books/importar-xml-di-ga/page/1-prototipo-de-tela-para-importar-di "Protótipo de tela para importar DI")

[Validação XML DI](https://docs.softensistemas.com.br/books/importar-xml-di-ga/page/2-validacao-xml-di "Validação XML DI")

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

- - - - - -

#### **PROC003 Importação NFe:**

[![image-1728389868590.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/scaled-1680-/image-1728389868590.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/image-1728389868590.png)

I - Seguir mesmo padrão da "Importar XML"

**OBS:**

Não é necessário uma validação do tipo "Erro ao Importar XML", pois, isto é validado antes mesmo de importar, na prévia gerada, conforme o docs - [Validação XML DI](https://docs.softensistemas.com.br/books/importar-xml-di-ga/page/2-validacao-xml-di "Validação XML DI")

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

Seguir o mesmo padrão do GA, ao se importar um XML.

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

**1.** Seguir o mesmo padrão do GA, ao se importar um XML.

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

**1.** Seguir o mesmo padrão do GA, ao se importar um XML.

#### **PROC004 Geração NFe:**

##### **4.1 Dados da Nota Fiscal:**

##### ***Tela atual:***

[![image-1730394914170.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/scaled-1680-/image-1730394914170.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/image-1730394914170.png)

I - Exemplo dados gerados NFe

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

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

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

</td><td style="width: 246px; border-style: solid; border-color: black; background-color: #adbccb; height: 35px;"><span style="color: #000000;">**VALOR DO CAMPO**</span>

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

</td></tr><tr style="height: 35px;"><td style="width: 161px; border-style: solid; border-color: black; height: 35px;">&lt;fornecedorNome&gt;

</td><td style="width: 163px; border-style: solid; border-color: black; height: 35px;">Cliente

</td><td style="width: 246px; border-style: solid; border-color: black; height: 35px;">GENUINE AUTOPARTS LTD

</td><td style="width: 243px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Nome fornecedor do XML</span>

</td></tr><tr style="height: 57px;"><td style="width: 161px; border-style: solid; border-color: black; height: 57px;">-

</td><td style="width: 163px; border-style: solid; border-color: black; height: 57px;">CFOP padrão

</td><td style="width: 246px; border-style: solid; border-color: black; height: 57px;">3102

</td><td style="width: 243px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Sistema deve preencher por padrão "3.102"</span>

</td></tr><tr style="height: 80px;"><td style="width: 161px; border-style: solid; border-color: black; height: 80px;">-

</td><td style="width: 163px; border-style: solid; border-color: black; height: 80px;">Natureza

</td><td style="width: 246px; border-style: solid; border-color: black; height: 80px;"><span style="color: #000000;">COMPRA PARA COMERCIALIZAÇÃO</span>

</td><td style="width: 243px; border-style: solid; border-color: black; height: 80px;"><span style="color: #000000;">Sistema deve preencher por padrão "COMPRA PARA COMERCIALIZAÇÃO"</span>

</td></tr><tr style="height: 35px;"><td style="width: 161px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 163px; border-style: solid; border-color: black; height: 35px;">Data Emissão

</td><td style="width: 246px; border-style: solid; border-color: black; height: 35px;">08/10/2024

</td><td style="width: 243px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Seguir padrão do GA</span>

</td></tr><tr style="height: 35px;"><td style="width: 161px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 163px; border-style: solid; border-color: black; height: 35px;">Data Saída

</td><td style="width: 246px; border-style: solid; border-color: black; height: 35px;">08/10/2024

</td><td style="width: 243px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Seguir padrão do GA</span>

</td></tr><tr style="height: 35px;"><td style="width: 161px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 163px; border-style: solid; border-color: black; height: 35px;">Vendedor

</td><td style="width: 246px; border-style: solid; border-color: black; height: 35px;"></td><td style="width: 243px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Seguir padrão do GA</span>

</td></tr><tr style="height: 35px;"><td style="width: 161px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 163px; border-style: solid; border-color: black; height: 35px;">Chave de Acesso

</td><td style="width: 246px; border-style: solid; border-color: black; height: 35px;">NFe35241007...

</td><td style="width: 243px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Seguir padrão do GA</span>

</td></tr><tr style="height: 57px;"><td style="width: 161px; border-style: solid; border-color: black; height: 57px;">&lt;viaTransportePaisTransportadorCodigo&gt;

</td><td style="width: 163px; border-style: solid; border-color: black; height: 57px;">Cód. do País

</td><td style="width: 246px; border-style: solid; border-color: black; height: 57px;">607

</td><td style="width: 243px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Cód país do XML </span>

</td></tr><tr><td style="width: 161px; border-style: solid; border-color: black;">&lt;viaTransportePaisTransportadorNome&gt;

</td><td style="width: 163px; border-style: solid; border-color: black;">Nome do País

</td><td style="width: 246px; border-style: solid; border-color: black;">PORTUGAL

</td><td style="width: 243px; border-style: solid; border-color: black;"><span style="color: #000000;">Nome país do XML</span>

</td></tr><tr><td style="width: 161px; border-style: solid; border-color: black;">-

</td><td style="width: 163px; border-style: solid; border-color: black;">UF de Embarque

</td><td style="width: 246px; border-style: solid; border-color: black;"></td><td style="width: 243px; border-style: solid; border-color: black;"><span style="color: #000000;">Este campo não estará ai quando for importação, futuramente será ajustado, pois, só deve ser preenchido em caso de exportação.</span>

</td></tr><tr><td style="width: 161px; border-style: solid; border-color: black;">-

</td><td style="width: 163px; border-style: solid; border-color: black;">Local de Embarque

</td><td style="width: 246px; border-style: solid; border-color: black;"></td><td style="width: 243px; border-style: solid; border-color: black;"><span style="color: #000000;">Este campo não estará ai quando for importação, futuramente será ajustado, pois, só deve ser preenchido em caso de exportação.</span>

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

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

**1.** Os<span style="color: #000000;"> campos - **UF de Embarque** e **Local de Embarque** deverá ser oculto, quando for importação, iniciando-se com CFOP de digito 3 por exemplo, só devem ser preenchido em caso de NFe exportação.</span>

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

**1.** Seguir o mesmo padrão do GA, ao se importar um XML.

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

**1.** Seguir o mesmo padrão do GA, ao se importar um XML.

##### **4.2 Itens da Nota:** 

##### ***Tela atual:***

[![image-1730394786702.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/scaled-1680-/image-1730394786702.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/image-1730394786702.png)

II - Exemplo dados gerados dos itens da NFe

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

**OBS:** *Apenas descrição em relaçãoque foge do padrão, o restante seguir o padrão do GA.*

<table border="1" cellpadding="7" cellspacing="0" id="bkmrk-campo-sistema-valor-" style="width: 652px;"><tbody><tr style="height: 35px;" valign="top"><td bgcolor="#acb9ca" style="width: 163px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**CAMPO SISTEMA**</span>

</td><td style="width: 246px; border-style: solid; border-color: black; background-color: #adbccb; height: 35px;"><span style="color: #000000;">**VALOR DO CAMPO**</span>

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

</td></tr><tr><td style="width: 163px; border-style: solid; border-color: black;">CFOP

</td><td style="width: 246px; border-style: solid; border-color: black;">3102

</td><td style="width: 243px; border-style: solid; border-color: black;"><span style="color: #000000;">Por padrão sempre preencher "3102", quando se importa XML DI</span>

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

##### ***Regras de Interface e Questões Técnicas:***

**1.** Seguir o mesmo padrão do GA, ao se importar um XML.

##### **4.3 Ver/Editar (Produto):**

©SOFTEN SISTEMAS 2024