> 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/geovendas.md). # Geovendas Integração | Comercial ### Visão geral A integração entre o Geovendas e o Consistem ERP tem como objetivo principal otimizar e agilizar o processo de vendas externas. A solução permite que a equipe de vendas em campo acesse informações cruciais diretamente no aplicativo Geovendas e registre pedidos de forma integrada ao ERP, eliminando a digitação manual, reduzindo custos operacionais e garantindo a consistência dos dados comerciais entre as plataformas em tempo real. ### Requisitos
Consistem ERPGeovendas

Compatibilidade: 7.5 ou superiores do Consistem ERP.

Módulos: Comercial - Carteira de Pedidos e Estoques.
Consistem API

Licença: Aquisição de licença GEOV 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.

Saiba mais

Conta/Ambiente ativo na plataforma Geovendas com permissões de acesso administrativo.
Credenciais de API (Token / Chave de Autenticação e URLs dos Endpoints).
Conectividade de rede entre o servidor do Consistem ERP e os serviços web do Geovendas.
### Configuração da integração #### No Consistem ERP: 1. Acesse o programa [Configuração de Disponibilidade de Acabados (CCPV158)](/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/configuracoes-da-carteira-de-pedidos/configuracao-de-disponibilidade-de-acabados.md), informe a **Empresa** desejada e vincule as **Naturezas de Estoque** que devem compor o cálculo de disponibilidade de produtos acabados. 2. Acesse o programa [Agendamento de Tarefas (CSTASK015)](/modulos/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md), crie uma nova tarefa selecionando o módulo *Comercial - Carteira de Pedidos* e a tarefa *Calcular Disponibilidade de Acabados*. 1. Defina a frequência de execução automática para gerar as tabelas consolidadas que alimentam a consulta externa. 3. Acesse o programa [Consulta de Disponibilidade de Acabados (CCPV672)](/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/consultas-gerais-do-comercial/consulta-de-disponibilidade-de-acabados.md) para filtrar produtos e confirmar que os saldos de estoque, pedidos e pronta entrega estão sendo calculados corretamente após o agendamento. #### No Geovendas: 1. Acesse o painel de administração da plataforma Geovendas na seção de Integrações / Configurações de API. 2. Configure a URL de conexão da API REST do Consistem ERP e insira a chave/token de autenticação. 3. Realize o mapeamento dos campos das entidades (Clientes, Produtos, Tabelas de Preço e Pedidos) para correlacionar os atributos da Consistem com a base do Geovendas. 4. Defina a periodicidade para a carga/sincronização de dados cadastrais e ative o envio automático de pedidos de venda. ### Como a integração funciona A troca de dados entre os sistemas ocorre via webservices baseados em APIs REST, utilizando o formato de comunicação JSON sob protocolo seguro HTTPS. A integração é bidirecional e abrange os seguintes fluxos e funcionalidades: **O que a Consistem Envia** O Consistem ERP disponibiliza dados formatados para atualizar a base móvel do Geovendas: * **Busca/Envio de Dados de Clientes:** Sincronização contínua de cadastros, endereços, regras financeiras e limites de crédito. * **Busca/Envio de Dados de Produtos:** Atualização do portfólio, unidades de medida e agrupamentos. * **Busca/Envio de Tabelas de Preço:** Envio dos valores vigentes e regras comerciais praticadas pela empresa. * **Consulta de Estoque e Disponibilidade:** Disponibilização em tempo real das tabelas consolidadas com as seguintes métricas: * *Saldo Estoque:* Quantidade física nas naturezas configuradas ([Configuração de Disponibilidade de Acabados (CCPV158)](/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/configuracoes-da-carteira-de-pedidos/configuracao-de-disponibilidade-de-acabados.md)). * *Pedidos de Compra:* Quantidade em ordens de compra em aberto com fornecedores. * *Pedidos de Venda:* Quantidade reservada na carteira de pedidos em aberto. * *Pronta Entrega:* Calculada por `Saldo em Estoque - Pedidos de Venda`. * *Disponibilidade:* Calculada por `(Saldo em Estoque + Pedidos de Compra) - Pedidos de Venda`. **O que a Consistem Recebe** A partir da digitação efetuada pela equipe de vendas externas no aplicativo: * **Inserção de Pedidos no Consistem ERP:** * Transmissão do cabeçalho do pedido (Cliente, Vendedor, Condição de Pagamento, Tabela de Preço, Emissão, Observações). * Transmissão dos itens do pedido (Código do Produto, Quantidade, Preço e Descontos). ### Fluxo do processo O fluxo de trabalho da integração ocorre de forma automatizada e estruturada através das seguintes etapas: 1. **Consolidação de Dados no ERP:** A tarefa agendada no programa [Agendamento de Tarefas (CSTASK015)](/modulos/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md) roda periodicamente no Consistem ERP, processando os saldos com base nas regras do programa [Configuração de Disponibilidade de Acabados (CCPV158)](/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/configuracoes-da-carteira-de-pedidos/configuracao-de-disponibilidade-de-acabados.md) e populando tabelas otimizadas com o cálculo de disponibilidade de produtos acabados. 2. **Geração e Envio de Dados (Consistem** :arrow-right: **Geovendas):** O Consistem ERP disponibiliza as informações de Clientes, Produtos, Tabelas de Preço e Saldos de Estoque formatadas rigorosamente no leiaute da Consistem. 3. **Consumo de Dados pelo Geovendas:** O Geovendas consome as APIs de integração, interpreta os dados recebidos no leiaute da Consistem e sincroniza sua base local, disponibilizando as informações aos vendedores em campo. 4. **Operação e Registro no Campo:** O vendedor utiliza o Geovendas para consultar dados e cadastrar novos pedidos de venda com visibilidade real de estoque e precificação. 5. **Envio do Pedido (Geovendas** :arrow-right: **Consistem):** Ao finalizar a venda, o Geovendas transmite a estrutura do pedido convertida para o leiaute da Consistem diretamente para o endpoint de recepção do ERP. 6. **Processamento e Gravado na Carteira:** O Consistem ERP valida o pacote de dados recebido no leiaute da Consistem, insere a solicitação na Carteira de Pedidos de Venda, reserva o estoque do item e permite a consulta atualizada no sistema de retaguarda (como na tela [Consulta de Disponibilidade de Acabados (CCPV672)](/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/consultas-gerais-do-comercial/consulta-de-disponibilidade-de-acabados.md)), finalizando o ciclo com sucesso.

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/geovendas.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.