> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/comercial/almode.md). # Almode #### Visão Geral A integração entre o Consistem ERP e o sistema de Frente de Caixa (PDV) Almode foi desenvolvida com o objetivo de centralizar e automatizar a gestão do varejo para o ramo de confecção. Ela estabelece uma comunicação bidirecional que permite o envio automatizado de dados de produtos, tabelas de preços e movimentações de estoque do ERP para as lojas, bem como a captura em tempo real de notas fiscais de venda, devoluções, recebíveis e cadastros de novos clientes gerados nos PDVs para processamento financeiro e fiscal no Consistem.
Consistem ERPAlmode

Compatibilidade: 7.5 ou superiores do Consistem ERP.

Segmento: Atendimento exclusivo ao ramo de Confecção (Segmento Padrão liberado).
Módulos: Comercial, Financeiro, Estoque e Itens.
Licença: Aquisição de licença ALM ativa junto à Consistem.


Orientamos o acompanhamento da nossa equipe de consultores.

Aquisição de licença e implantação deve ser verificada com a empresa fornecedora de acordo com a quantidade de PDV.
Saiba mais
Licenciamento: Licença por quantidade de PDVs ativos acordada com o fornecedor.
Identificadores: Produtos devem estar ativos e possuir código de barras EAN/GTIN cadastrado (com flexibilização parametrizável para itens sem GTIN).
Estrutura: Configuração prévia dos terminais de PDV e amarração da série fiscal correspondente.
#### Configuração da Integração **No Consistem ERP** 1. **Ativação do Cadastro Geral:** Acesse o programa [Integração (CSINTEGRACAO010)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/integracao.md), selecione o código **ALM** (*Integração API Almode*) e acione o *Editar* ([Cadastro de Integração (CSINTEGRACAO010A)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao.md)).
1. Altere a **Situação** para *Ativo* (se mantido como *Inativo*, a comunicação falhará). Configure as URLs de *Host* e *Host de Homologação*, o usuário responsável e os e-mails para notificações de inconsistências.
2. **Parametrização Geral**: No botão **Específico** ([Configuração da Integração com Almode (CCPV111)](/comercial/manuais-de-telas/comercial-carteira-de-pedidos/configuracoes-da-carteira-de-pedidos/configuracao-da-integracao-com-almode.md)), defina as regras por filial/empresa: 1. **Natureza de Estoque:** Defina a natureza padrão da loja para monitoramento e sincronização de saldo. 2. **Padrões de Venda:** Informe o **Portador** e o **Tipo de Cobrança** genéricos, além do **Ramo de Atividade** padrão para novos clientes. 3. **Clientes e Fornecedores Padrão:** Indique os códigos de de/para para vendas e devoluções em que o consumidor final não se identificar.

Exemplo:
Cupons sem CPF

4. **Tabela de Preços:** No campo **Nome Tabela Preço Almode**, insira a correspondência exata do nome da tabela registrada na API para o Consistem exportar os preços corretamente.
3. **Amarração de Série Fiscal:** No botão **Série Fiscal**, vincule as séries enviadas pelas lojas Almode aos respectivos **Tipos de Nota** */* **CFOPs** internos do ERP.
4. **Regras de Cobrança por Administradora:** No botão **Tipo Venda**, configure o portador, tipo de cobrança e código de baixa automática específicos para cada modalidade de pagamento (Dinheiro, Crédito, Débito, Pix) e operadoras de cartão.
**No Almode** 1. Realize o login no painel administrativo com as credenciais de implantação. 2. Registre os usuários/vendedores e valide suas permissões de acesso a produtos, vendas e movimentação de estoque. 3. Vincule a **Série Fiscal** oficial disponibilizada para cada terminal de PDV instalado. 4. Certifique-se de alinhar os códigos e descrições das formas de pagamento e operadoras de cartão com os IDs cadastrados na rotina de tipos de venda do Consistem ERP. #### Como a Integração Funciona A comunicação entre os sistemas ocorre por meio de uma arquitetura API REST, utilizando o formato JSON para a troca de dados estruturados. O processo é assíncrono e baseado em uma fila de mensageria controlada por *tickets*. A execução técnica funciona através dos seguintes passos: 1. **Geração do Evento:** Sempre que ocorre uma inclusão ou alteração de dados no Consistem ERP (como a modificação de um preço, cadastro de produto ou movimentação de estoque na tabela `EXAMOV`), o sistema dispara um gatilho interno. 2. **Entrada na Fila de Tickets:** O envio das informações funciona através de um sistema de fila. Ao enviar o dado, o Consistem recebe um ticket com o status inicial de *Não Processado*. Caso o processamento na Almode ocorra com sucesso, o ticket desaparece. Se houver alguma inconsistência ou erro de validação, o ticket permanece retido e visível na tela [Consulta de Tickets Integração Almode (CCPV611)](/comercial/manuais-de-telas/comercial-carteira-de-pedidos/consultas-de-pedidos/consulta-de-tickets-integracao-almode.md) para que o usuário possa identificar a falha, corrigir e reenviar. 3. **Agrupamento em Lotes:** Para otimizar a performance da rede, o programa do Consistem agrupa as requisições em lotes (enviando pacotes de 10 produtos por vez, por exemplo) e faz o envio (*send*) para a API da Almode. 4. **Paginação e Consumo:** O Consistem consome os endpoints da Almode respeitando as regras de paginação da API parceira para ler e gravar os dados. 5. **Retorno e Limpeza da Fila:** * **Sucesso:** A Almode processa o JSON e devolve uma resposta positiva. O Consistem valida o retorno e o ticket desaparece automaticamente do grid da [Consulta de Tickets Integração Almode (CCPV611)](/comercial/manuais-de-telas/comercial-carteira-de-pedidos/consultas-de-pedidos/consulta-de-tickets-integracao-almode.md). * **Erro/Inconsistência:** Se houver rejeição, o ticket permanece travado na fila gerando uma notificação para o usuário realizar a correção e acionar o botão **Reenviar**.

Exemplo:
Um produto ativo que foi enviado sem variante de tamanho/cor ou sem código EAN/GTIN válido quando exigido.

#### Fluxo do Processo O fluxo operacional de dados é bidirecional e controlado por tarefas em segundo plano (*tasks*) agendadas no [Agendamento de Tarefas (CSTASK015)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md) do Consistem ERP. O comportamento segue rigorosamente o padrão de leiaute da Consistem dividido em três fluxos principais: 1. **Envio de Cadastros e Preços (Consistem** :arrow-right: **Almode)** 1. **Carga Inicial de Estoque:** A primeira sincronização de saldo de estoque deve ser realizada manualmente via importação de arquivo diretamente no painel Almode, visto que o sistema de PDV não possui uma API para receber a posição total e absoluta do estoque de uma só vez. 2. **Sincronização de Produtos:** As *tasks* monitoram o cadastro do módulo de engenharia. O Consistem envia os produtos ativos acompanhados de suas grades (itens filhos) e inclui uma tag especial com a informação da coleção da engenharia. É permitida a integração de produtos do segmento padrão e também de produtos sem código GTIN definido (conforme parametrização). 3. **Atualização de Tabelas de Preço:** Toda alteração de preço nas tabelas que possuem o de/para configurado na tela [Configuração da Integração com Almode (CCPV111)](https://ajuda.consistem.com.br/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/configuracoes-da-carteira-de-pedidos/configuracao-da-integracao-com-almode) aciona o novo endpoint `/api/public/tabela-de-preco/atualizar` (vinculado no [Cadastro de Integração (CSINTEGRACAO010A)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao.md)), atualizando os valores de venda no PDV instantaneamente. 4. **Movimentação Incremental de Estoque:** Após a carga inicial, qualquer entrada física de nota ou transferência aciona o endpoint `/api/public/depositos/{operacao}` para atualizar o saldo na loja de forma incremental. O sistema intercepta a tabela de movimentação do Consistem (`EXAMOV`) e filtra o processo para ignorar saídas vindas das vendas do próprio PDV, evitando duplicidade. 2. **Importação de Vendas (Almode** :arrow-right: **Consistem)** 1. **Emissão no PDV:** O cliente final realiza a compra na loja física e a Almode emite o cupom fiscal ou nota de venda. O estoque é baixado imediatamente na loja (por essa razão, o Consistem ***não*** envia movimentos de saída de venda de volta para o Almode, evitando duplicidade). 2. **Busca Automatizada:** A *task* de Importação de Vendas do Consistem realiza uma busca no endpoint `/api/public/vendas` da Almode. O ERP sempre grava o *timestamp* (data e hora) do último sucesso para retomar exatamente de onde parou no ciclo anterior. 3. **Tratamento de Clientes:** O Consistem recebe o JSON da venda. Se o cliente houver se identificado na loja e não existir no ERP, o Consistem cria o cadastro do cliente automaticamente. Se o consumidor não se identificar, o sistema atribui a venda ao "Cliente Padrão" definido na configuração. 4. **Integração Fiscal e Financeira:** A venda entra no Consistem como Nota Fiscal, gerando as duplicatas financeiras associadas à série fiscal mapeada. Se houver configuração de portador/administradora de cartão com baixa automática, o título já nasce com o status de *Baixado*. 3. **Importação de Notas de Devolução (Almode** :arrow-right: **Consistem)** 1. **Abertura da Devolução:** Uma nota de devolução de mercadoria ou troca é registrada na loja Almode. 2. **Captura via API Rest:** A *task* de Importação de Entradas/Devoluções localiza a transação na API da Almode. 3. **Identificação da NF Referenciada:** O programa do Consistem ERP lê o payload enviado pela Almode e faz a busca automatizada dos dados da Nota Fiscal Referenciada original (quando houver) para garantir a consistência tributária e a correta entrada do item de volta ao estoque do ERP. 4. **Estornos Manuais se necessário:** Em casos complexos de cancelamento ou devoluções totais, o fluxo alerta o suporte de que pode ser necessário realizar estornos manuais de baixas de duplicatas anteriores para que o fluxo fiscal termine o processamento sem travar no validador.

Esse conteúdo foi útil?

Sim Não

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/comercial/almode.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.