Exportação de Dados via XML e Integração
O aplicativo oferece suporte à exportação de dados no formato XML (products.xml), permitindo a integração dos dados cadastrados com outros sistemas de gestão, ERPs, WMS, softwares de controle de estoque ou scripts automatizados.
Requisitos de Acesso
Assinatura PRO Requerida no App Individual
- Controle de Validades (Aplicativo Individual): A funcionalidade de exportação de dados (incluindo XML e Excel) é um recurso exclusivo para assinantes PRO. Ao tentar acessar o menu de exportação no plano gratuito, você será redirecionado para a tela de assinatura.
- Validades Times (Aplicativo Colaborativo): O recurso está disponível diretamente na tela de exportação, de acordo com as permissões concedidas ao seu perfil no Espaço de Trabalho.
Como Exportar o Arquivo XML
O processo de geração e exportação do arquivo XML pode ser realizado diretamente em ambos os aplicativos móveis:
- Abra o aplicativo (Controle de Validades ou Validades Times).
- Acesse o menu lateral (ou menu de navegação) e selecione a opção Importar & Exportar (ou Exportar).
- Na tela de exportação, navegue até a seção XML.
- Toque no botão Exportar em XML.
- O aplicativo processará os produtos, lotes, marcas, categorias e lojas cadastradas, gerando o arquivo
products.xml. - A janela nativa de compartilhamento do seu dispositivo (Android/iOS) será exibida, permitindo salvar o arquivo no armazenamento local, enviar por e-mail, WhatsApp ou salvar em serviços de nuvem (Google Drive, iCloud, OneDrive, etc.).
Estrutura do Arquivo XML Exportado
O arquivo XML possui uma estrutura hierárquica e padronizada. Veja abaixo um exemplo do arquivo gerado:
<data>
<total>
<products>5</products>
<brands>2</brands>
<categories>3</categories>
<stores>2</stores>
</total>
<brands>
<brand>
<id>1</id>
<name>Marca A</name>
</brand>
<brand>
<id>2</id>
<name>Marca B</name>
</brand>
</brands>
<categories>
<category>
<id>1</id>
<name>Categoria X</name>
</category>
<category>
<id>2</id>
<name>Categoria Y</name>
</category>
<category>
<id>3</id>
<name>Categoria Z</name>
</category>
</categories>
<stores>
<store>
<id>1</id>
<name>Loja 1</name>
</store>
<store>
<id>2</id>
<name>Loja 2</name>
</store>
</stores>
<products>
<product>
<name>Produto A</name>
<code>7891000100100</code>
<photo>produto_a.jpg</photo>
<daysToBeNext>10</daysToBeNext>
<created_at>2024-12-01</created_at>
<updated_at>2025-01-01</updated_at>
<batches>
<batch>
<name>Lote 1</name>
<expDate>2025-06-30</expDate>
<amount>100</amount>
<price>10.50</price>
<price_tmp>9.50</price_tmp>
<status>checked</status>
<created_at>2024-12-01</created_at>
<updated_at>2024-12-15</updated_at>
</batch>
<batch>
<name>Lote 2</name>
<expDate>2025-08-31</expDate>
<amount>50</amount>
<price></price>
<price_tmp></price_tmp>
<status>unchecked</status>
<created_at>2024-12-10</created_at>
<updated_at>2024-12-20</updated_at>
</batch>
</batches>
<brand>
<id>1</id>
</brand>
<category>
<id>1</id>
</category>
<store>
<id>1</id>
<name>Loja 1</name>
</store>
</product>
</products>
</data>
Mapeamento de Campos e Dicionário de Dados
| Tag XML | Descrição | Observações |
|---|---|---|
<total> | Contadores gerais do arquivo. | Contém a contagem de <products>, <brands>, <categories> e <stores>. |
<brands> / <brand> | Lista de marcas vinculadas aos produtos. | Contém <id> e <name>. |
<categories> / <category> | Lista de categorias de produtos. | Contém <id> e <name>. |
<stores> / <store> | Lista de lojas/filiais. | Contém <id> e <name>. |
<product> | Elemento principal do produto. | Contém os dados cadastrais e a lista de lotes associados. |
<name> (Produto) | Nome do produto. | Campo textual contendo o nome do item. |
<code> | Código de barras ou SKU. | Código EAN, GTIN ou identificador interno. |
<photo> | Nome/Caminho da foto do produto. | Referência da imagem salva localmente ou na nuvem. |
<daysToBeNext> | Dias de antecedência para alerta. | Número de dias pré-vencimento para notificação. |
<batches> / <batch> | Lista de lotes do produto. | Contém os dados individuais de cada lote cadastrado. |
<expDate> / <exp_date> | Data de vencimento do lote. | Formato AAAA-MM-DD. |
<amount> | Quantidade em estoque. | Valor numérico inteiro ou decimal. |
<price> | Preço de venda. | Preço do produto no lote. |
<price_tmp> | Preço promocional/temporário. | Preço promocional ou com desconto no lote. |
<status> | Estado de verificação do lote. | Retorna checked (Tratado/Verificado) ou unchecked (Pendente). |
<brand> / <category> / <store> (dentro de <product>) | Vínculos relacionais do produto. | Referencia o <id> correspondente cadastrado nas seções superiores. |
Passo a Passo para Integração com Outros Sistemas
- Verifique a Compatibilidade: Certifique-se de que seu ERP ou sistema receptor suporte leitura de arquivos XML.
- Mapeie os Campos: Relacione as tags XML exportadas com a estrutura de banco de dados do sistema de destino (ex.:
<name>do produto mapeado paraNome_Produto,<expDate>paraData_Validade). - Desenvolva ou Utilize Scripts de Importação: Caso o sistema de destino não possua importador XML nativo, crie um script (em Python, Node.js, PHP, C#, etc.) para ler a árvore XML e efetuar a gravação via banco de dados ou API REST.
- Garanta a Consistência e Faça Backup: Antes de executar a importação no sistema de destino, realize um backup completo do seu banco de dados.
- Realize Testes de Validação: Teste a importação primeiro com um subconjunto de dados para validar se datas, preços e quantidades foram importados corretamente.