# 📊 SISTEMA DE IMPORTAÇÃO XML - GUIA RÁPIDO

## 🎯 O que foi implementado

Um sistema **profissional e reutilizável** para importar dados de Notas Fiscais (XML) diretamente nos formulários do sistema.

---

## 📁 Arquivos Criados/Modificados

| Arquivo | Tipo | Descrição |
|---------|------|-----------|
| `/include/xml_parsers/nfe_parser.php` | ✨ Novo | Classe PHP para parse de XML |
| `/tms010_operacao/import_xml.php` | ✨ Novo | Endpoint de upload e processamento |
| `/tms010_operacao/cad.php` | 🔧 Modificado | Adicionado modal e botão de importação |
| `/tms010_operacao/teste_xml.php` | ✨ Novo | Página para testar imports |
| `/exemplos_xml/exemplo_nfe_completa.xml` | ✨ Novo | Arquivo XML de exemplo |
| `XML_IMPORT_README.md` | 📖 Novo | Documentação detalhada |

---

## 🚀 Como Usar

### Interface Visual (Recomendado)

1. **Abra a tela** de Operação de Transporte (`tms010_operacao/cad.php`)
2. **Clique no botão** "Importar XML" (no header do formulário)
3. **Arraste o arquivo** XML ou clique para selecionar
4. **Aguarde** o processamento
5. **Revise os dados** extraídos
6. **Clique** em "Preencher Formulário"

---

## 💾 Dados Extraídos

### Seção 1: Localização
✅ Número da NF | ✅ Série | ✅ Data de Emissão
✅ CNPJ Remetente | ✅ Endereço Remetente
✅ CNPJ Cliente | ✅ Endereço Destinatário
✅ Placa do Veículo | ✅ UF Veículo

### Seção 2: Cobrança (Valores)
✅ Valor Frete | ✅ Valor Seguro | ✅ Desconto
✅ Valor Total | ✅ Base ICMS | ✅ Impostos

### Seção 3: Recursos
✅ Peso Total | ✅ Qtd Itens | ✅ Modo de Frete

---

## 🧪 Testar o Sistema

**URL:** `http://seu-site/tms010_operacao/teste_xml.php`

Use o arquivo: `/exemplos_xml/exemplo_nfe_completa.xml`

---

## 🔄 Reutilizar em Outra Tela

1. **Copie a classe** `/include/xml_parsers/nfe_parser.php` (funciona em qualquer lugar)
2. **Crie endpoint similar** a `import_xml.php`
3. **Copie o modal HTML** do `cad.php`
4. **Adapte o mapeamento** de campos conforme sua tela

---

## 📊 Formatação Automática

| Campo | Exemplo |
|-------|---------|
| CNPJ | `12.345.678/0001-57` |
| CEP | `01234-567` |
| Data | `01/12/2025` |
| Valores | `3.000,00` |

---

## ✅ Recursos

- 🎨 Interface drag-and-drop
- ⚡ Processamento assíncrono
- ✔️ Validações automáticas
- 📊 Dados extraídos em JSON
- 🔄 Preenchimento automático
- 📱 Responsivo
- 🛡️ Seguro

---

**Status:** ✅ Pronto para Usar
**Veja:** `XML_IMPORT_README.md` para documentação completa
