Exportação de Dados via XML e Integração
A aplicação suporta a exportação de dados no formato XML (products.xml), permitindo a integração dos dados registados com outros sistemas de gestão, ERPs, WMS, softwares de controlo de stock ou scripts automatizados.
Requisitos de Acesso
Subscrição PRO Necessária na App Individual
- Controle de Validades (Aplicação Individual): A funcionalidade de exportação de dados (incluindo XML e Excel) é um recurso exclusivo para subscritores PRO. Ao tentar aceder ao menu de exportação no plano gratuito, será redirecionado para o ecrã de subscrição.
- Validades Times (Aplicação Colaborativa): O recurso está disponível diretamente no ecrã de exportação, de acordo com as permissões concedidas ao seu perfil no Espaço de Trabalho.
Como Exportar o Ficheiro XML
O processo de geração e exportação do ficheiro XML pode ser realizado diretamente em ambas as aplicações móveis:
- Abra a aplicação (Controle de Validades ou Validades Times).
- Aceda ao menu lateral (ou menu de navegação) e selecione a opção Importar & Exportar (ou Exportar).
- No ecrã de exportação, navegue até à secção XML.
- Toque no botão Exportar em XML.
- A aplicação processará os produtos, lotes, marcas, categorias e lojas registadas, gerando o ficheiro
products.xml. - A janela nativa de partilha do seu dispositivo (Android/iOS) será apresentada, permitindo guardar o ficheiro no armazenamento local, enviar por e-mail, WhatsApp ou guardar em serviços de nuvem (Google Drive, iCloud, OneDrive, etc.).
Estrutura do Ficheiro XML Exportado
O ficheiro XML possui uma estrutura hierárquica e padronizada. Veja abaixo um exemplo do ficheiro 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 ficheiro. | Contém a contagem de <products>, <brands>, <categories> e <stores>. |
<brands> / <brand> | Lista de marcas associadas 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 de registo e a lista de lotes associados. |
<name> (Produto) | Nome do produto. | Campo de texto com 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 guardada localmente ou na nuvem. |
<daysToBeNext> | Dias de antecedência para alerta. | Número de dias pré-validade para notificação. |
<batches> / <batch> | Lista de lotes do produto. | Contém os dados individuais de cada lote registado. |
<expDate> / <exp_date> | Data de validade do lote. | Formato AAAA-MM-DD. |
<amount> | Quantidade em stock. | 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>) | Ligações relacionais do produto. | Referencia o <id> correspondente registado nas secções superiores. |
Passo a Passo para Integração com Outros Sistemas
- Verifique a Compatibilidade: Certifique-se de que o seu ERP ou sistema recetor suporta leitura de ficheiros XML.
- Mapeie os Campos: Relacione as tags XML exportadas com a estrutura da base 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 base de dados ou API REST.
- Garanta a Consistência e Faça Backup: Antes de executar a importação no sistema de destino, realize uma cópia de segurança (backup) completa da sua base 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.