Importar do ERP Litos
Se você usa o ERP Litos (da Global Sistemas Cloud), o Manto ERP conecta direto na serviço de integração pública do Litos e traz seus dados para ca, em poucos cliques.
O que vem
| Recurso | Vem? | Observação |
|---|---|---|
| Clientes | Sim | Dados cadastrais + contato |
| Fornecedores | Sim | Dados cadastrais + contato |
| Produtos | Sim | Cadastro principal (sem saldo de estoque inicial — vem em fase futura) |
| Contas a receber | Sim | Em aberto: EM PRAZO + VENCIDAS |
| Contas a pagar | Sim | Em aberto: EM PRAZO + VENCIDAS |
| Pedidos de venda históricos | Não (Fase 1) | Em planejamento para fase futura |
| Saldo inicial de estoque | Não (Fase 1) | Em planejamento |
| Movimento de caixa antigo | Não | Manto comeca do zero |
Como funciona — visao geral
- Você informa as credenciais de acesso do Litos (usuário + senha de.
- O Manto se autentica e lista o que tem para importar (quantos clientes, quantos produtos, etc.).
- Você escolhe o que quer trazer (todos ou marca os que quer).
- Tela de preview mostra o que vai entrar, marcado como:
- 🟢 CRIAR — registro novo.
- 🔵 ATUALIZAR — já existia, vai atualizar.
- ⚪ IGNORAR — você decidiu deixar de fora.
- 🔴 FALHA — dados invalidos, não da pra importar.
- Você confirma e o Manto importa.
Importante saber
Sem duplicar
O Manto identifica registros do Litos por chave externa (origem litos + ID original). Se você reimportar depois (porque cadastrou coisa nova no Litos), o Manto encontra e atualiza em vez de criar duplicado.
Marcador na origem
Cada registro importado fica marcado com "Origem: Importação Litos". Você vê esse selo nas listagens e telas — fácil de filtrar para limpar/revisar depois se quiser.
Sem sincronizacao automática
A importação Litos e sob demanda. Você escolhe quando rodar. Não tem sync continuo (planejado para fase futura). O fluxo de uso esperado:
- Importação inicial quando você vai comecar a usar o Manto.
- Reimportacao manual quando você sabe que cadastrou coisa nova no Litos e quer puxar para o Manto.
Após a transicao, você opera só no Manto — Litos vira histórico/backup.
Antes de comecar
- [ ] Plano Manto inclui Importação de ERP (e add-on Plus do catalogo). Veja na tela de Plano. Se não aparecer "Importação Litos" no menu, fale com o time comercial.
- [ ] Credenciais de serviço do Litos — peca ao seu administrador Litos ou no suporte da Global Sistemas. São usuário + senha de API (não e o login normal de operador).
- [ ] Cadastros base do Manto já prontos — empresa, filial, pelo menos 1 grupo e 1 categoria.
- [ ] Tempo reservado — uma importação grande (10.000 produtos + 5.000 clientes + 3.000 contas) leva 10-15 minutos. Faca num horário tranquilo.
Passo a passo
1. Abrir a tela
Menu Configurações > Integrações > Importação Litos.
2. Configurar credenciais
Primeira vez você informa:
| Campo | O que e |
|---|---|
| URL base | https://public.mantosistemas.com/api/litos (padrão) |
| Usuário | Fornecido pelo Litos |
| Senha | Fornecida pelo Litos |
| Codigo do cliente Litos | Seu codigo na Global (geralmente vem no contrato) |
Clique em Testar conexão. Se ok, o sistema mostra "Conectado a Litos como [empresa]".
As credenciais ficam cifradas no banco. Só você vê, você edita, você remove.
3. Escolher o que importar
A tela mostra cards para cada tipo de dado:
+----------------------------------+
| Clientes |
| Litos tem: 1.234 |
| Já no Manto: 0 |
| [ Importar 1.234 clientes ] |
+----------------------------------+
+----------------------------------+
| Fornecedores |
| Litos tem: 87 |
| Já no Manto: 0 |
| [ Importar 87 fornecedores ] |
+----------------------------------+
+----------------------------------+
| Produtos |
| Litos tem: 5.678 |
| Já no Manto: 12 |
| [ Importar 5.678 produtos ] |
+----------------------------------+
+----------------------------------+
| Contas a receber (em aberto) |
| Litos tem: 423 |
| Já no Manto: 0 |
| [ Importar 423 contas ] |
+----------------------------------+
+----------------------------------+
| Contas a pagar (em aberto) |
| Litos tem: 156 |
| Já no Manto: 0 |
| [ Importar 156 contas ] |
+----------------------------------+4. Ordem recomendada
A ordem que vai te dar menos retrabalho:
- Clientes primeiro.
- Fornecedores depois.
- Produtos depois.
- Contas a receber (dependem de clientes já terem sido importados).
- Contas a pagar (dependem de fornecedores).
O sistema não impede uma ordem diferente, mas pode dar mais conflitos.
5. Tela de preview
Após clicar em Importar [recurso], o Manto baixa os dados do Litos, gera o preview e mostra:
+----------------------------------------------------------------+
| Preview da importação — Clientes |
+----------------------------------------------------------------+
| 1.234 registros analisados |
| 🟢 1.180 CRIAR 🔵 12 ATUALIZAR 🔴 8 FALHA ⚪ 34 IGNORAR |
+----------------------------------------------------------------+
| |
| [ Filtrar por status: Todos ▾ ] [ Buscar ___________ ] |
| |
| Status | Nome | Documento | Acao |
| -------|-------------------|---------------|------------------|
| 🟢 CRIAR | Maria Silva | 123.456.789-00 | |
| 🟢 CRIAR | Joao Santos | 987.654.321-00 | |
| 🔵 ATUAL.| Padaria do Bairro| 12.345.678/0001| [ Ver diferença ]|
| 🔴 FALHA | "" (vazio) | invalido | [ Ver erro ] |
|... |
| |
| [ Cancelar ] [ Confirmar importação ] |
+----------------------------------------------------------------+Você pode:
- Filtrar por status para ver só as falhas, por exemplo.
- Clicar em cada linha para abrir os dados completos.
- Desmarcar registros individuais (vira IGNORAR).
- Ver as diferenças dos que vão ATUALIZAR.
- Ver o motivo das falhas.
6. Resolver as falhas
Falhas comuns:
| Motivo | O que fazer |
|---|---|
| Documento (CPF/CNPJ) invalido | Corrija no Litos, reimporte. Ou marque IGNORAR e cadastre depois manualmente. |
| Nome vazio | Idem — corrija no Litos. |
| Grupo/categoria sugerida não existe no Manto | Crie o grupo/categoria no Manto antes (ou aceite o "fallback" sugerido). |
| NCM do produto invalido | Corrija no Litos ou aceite o produto sem NCM (preencher depois). |
7. Confirmar
Clique em Confirmar importação. O Manto comeca a gravar.
Você vê uma barra de progresso em tempo real:
Importando clientes... 600/1180 (51%)A tela pode ser fechada — o processamento continua em background. Quando terminar, notificação no sino + e-mail (opcional).
8. Conferir
Após terminar, va nas listagens do Manto:
- Pessoas > Clientes — você vê os clientes importados com selo "Origem: Importação Litos".
- Filtre pela origem para revisar só os importados.
Reimportar depois
Cadastrou coisa nova no Litos depois da importação inicial? Quer puxar para o Manto?
Repita o processo. O Manto:
- Identifica os registros que já existem (chave externa Litos).
- Atualiza os que mudaram.
- Cria os novos.
- Não toca nos que não mudaram.
Você não perde nada que já editou no Manto — campos que você alterou no Manto não são sobrescritos pela reimportacao (logica de "última fonte vence" e configuravel por campo, mas o padrão seguro e Manto vence se o usuário tocou).
Limpar uma importação
Importou e deu errado? Quer recomecar?
Configurações > Integrações > Importação Litos > Histórico de execucoes > selecionar a importação > Reverter.
O sistema apaga todos os registros importados naquela execucao (só os marcados com a origem Litos da execucao especifica). Cuidado:
- Só funciona se você não editou os registros depois (registros editados ficam, sem o vínculo de origem).
- Não reverte movimento que já aconteceu em cima do registro (se o cliente foi importado e já recebeu um pedido, não da pra apagar).
Perguntas comuns
Posso usar Manto e Litos em paralelo por um tempo? Sim. Muitas empresas fazem rodada de 2-4 semanas em paralelo para validar. Após validar, "trava" o Litos e opera só no Manto. A reimportacao puxa o que foi cadastrado no Litos durante esse periodo.
O Litos vai saber que eu importei pelo Manto? Não. A importação e read-only no Litos. Você só consulta — não grava nada lá.
Quanto tempo dura a importação? Depende do volume. Estimativa:
- 1.000 clientes — 30 segundos.
- 10.000 produtos — 5 minutos.
- 5.000 contas — 2 minutos.
Total de uma empresa média: 10-15 minutos.
E se a conexão com o Litos cair no meio? O Manto retoma do onde parou na próxima tentativa. Os registros já gravados não são reprocessados.
Posso importar só um subconjunto (ex.: clientes ativos dos últimos 12 meses)? Na Fase 1, a importação traz tudo o que esta ativo no Litos. Filtros mais finos entram em fase futura. Por hora, você filtra depois — importa tudo e, no Manto, marca como inativo o que não precisa.
Importação tem custo? A importação em si não tem custo extra. Importação Litos e parte do add-on Plus do plano. Verifique seu contrato.