> 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/entradas/gecex-importacao.md). # Gecex Importação ### Visão Geral A integração automatizada entre o Consistem ERP e o sistema especialista GECEX (Gerenciamento de Comércio Exterior) consolida uma solução robusta voltada ao monitoramento, controle e gerenciamento de operações de importação e exportação. A ferramenta otimiza e facilita a geração da Nota Fiscal de Entrada ao importar diretamente os dados da minuta da Declaração de Importação (DI) originada no GECEX. Com o preenchimento eletrônico e automatizado de notas fiscais complexas, elimina-se o risco de erros tributários, lentidão burocrática e digitação manual repetitiva. A solução atua de forma nativa e totalmente integrada aos processos corporativos de Pedido de Compra, Nota Fiscal de Entrada, Contas a Pagar, Escrita Fiscal e Estoques. ### Requisitos
Consistem ERPGecex Importação

Compatibilidade: 7.5 ou superiores do Consistem ERP (recomenda-se a versão 7.6 ou superior para total usabilidade dos recursos descritos na ficha técnica).
Módulos: Pedido de Compra, Contas a Pagar, Escrita Fiscal e Estoques - Itens.
Licença: Aquisição de licença EIG 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
### Configuração da Integração **No Consistem ERP:** 1. Acesse o programa [Configuração Integração GECEX (CCEIG000)](/entradas/manuais-de-telas/entradas-integracao-gecex/configuracao/configuracao-integracao-gecex.md), ative a integração, defina o tipo de importação, as URLs dos WebServices estruturados e vincule os usuários específicos para a central de notificações.
2. Na [Aba Emissão de NF](/entradas/manuais-de-telas/entradas-integracao-gecex/configuracao/configuracao-integracao-gecex.md), vincule as séries fiscais e configure os parâmetros de entrada que o sistema interpretará conforme a destinação/finalidade das mercadorias da minuta: 1. **Parâmetro NF Entrada 1**: Atribua para os itens com finalidade de matéria-prima (ou regra principal). 2. **Parâmetro NF Entrada 2**: Atribua para os itens com finalidade exclusiva de consumo. 3. **Parâmetro NF Entrada 3**: Atribua para os itens com finalidade exclusiva de revenda. 4. **Parâmetro NF Entrada 4**: Atribua para os itens com finalidade exclusiva de imobilizado.
3. Acesse o programa [Cadastro do Código de Empresa GECEX (CCEIG010)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/cadastro-do-codigo-de-empresa-gecex.md) e informe o código da empresa no Consistem ERP que realizará as integrações como filial, associando-o ao respectivo código cadastrado na estrutura do GECEX.

Não é permitido salvar o código do GECEX zerado ou em branco.

4. Acesse o programa [Cadastro de Tipo de Carga GECEX (CCEIG020)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/cadastro-de-tipo-de-carga-gecex.md) e cadastre o código e a descrição do tipo de carga idênticos aos utilizados no GECEX. Essa etapa é obrigatória para que o sistema preencha a informação de **Espécie** automaticamente na Nota Fiscal.
5. Acesse o programa [Cadastro do Tipo de Outras Despesas de Importação (CCEIG030)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/cadastro-do-tipo-de-outras-despesas-de-importacao.md) para registrar os códigos e descrições das despesas não aduaneiras que devem compor e somar ao custo de entrada dos materiais.
6. Acesse o programa [Cadastro de Fornecedor para FINIMP (CCEIG050)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/cadastro-de-fornecedor-para-finimp.md) e relacione o código do fornecedor a um banco (portador) e conta corrente específicos, determinando se o Contas a Pagar automático gerado pela integração usará moeda nacional ou estrangeira, a carteira de cobrança e a quantidade de dias adicionais de vencimento.
**No Gecex Importação:** 1. Acesse o sistema externo GECEX e realize a parametrização para que o Código do Processo de Importação gerado coincida exatamente com o número do Pedido de Compras enviado originalmente pelo Consistem ERP. Essa consistência é indispensável para viabilizar as amarrações financeiras automáticas e a posterior conciliação contábil das antecipações. ### Como a Integração Funciona O intercâmbio de dados e a comunicação técnica entre as plataformas são realizados por meio de WebServices estruturados sob a arquitetura REST, seguindo as diretrizes abaixo: 1. **Utilize a nova estrutura de WebServices baseada em REST:** Certifique-se de que a comunicação utilize o barramento REST, que substitui o antigo padrão SOAP. Esta arquitetura elimina a necessidade de alterar o projeto central do WebService no caso de inclusões, alterações ou exclusões de tags nos XMLs, exigindo apenas o tratamento flexível das tags diretamente no conector. 2. **Disponibilize os XMLs com as tags necessárias para a operação:** O Consistem ERP está parametrizado para ler as tags oficiais detalhadas nos leiautes e ignorar tags adicionais enviadas pelo GECEX que não estejam mapeadas no escopo padrão (elas não serão lidas nem gravadas), evitando falhas ou rejeições de comunicação no conector. 3. **Consuma os dados de produtos têxteis via API dedicada:** Para cenários específicos que envolvem mercadorias com engenharia têxtil, realize a consulta de dados genéricos corporativos de itens utilizando o endpoint REST exclusivo `GET /api/gecex/v10/itemGenerico/` ### Estruturas de Dados e Leiautes Disponibilizados Os arquivos de esquema (extensão `.xsd`) detalhados ao longo desta documentação servem para parametrizar e validar a integridade dos dados trafegados entre os sistemas. Eles são indispensáveis para mapear as mensagens XML enviadas de forma nativa pelo GECEX de modo que o conector do ERP as reconheça e processe sem falhas estruturais. * **Download do pacote de leiautes:** Para realizar a importação e o mapeamento diretamente em suas ferramentas de desenvolvimento ou geradores de classes, utilize o arquivo compactado disponibilizado abaixo: {% file src="/files/HGdGx8SgxFCBGKMT1y9u" %} ### Fluxo do Processo O fluxo operacional e a troca de arquivos XML entre os sistemas baseiam-se nas estruturas de validação XSD e devem ser executados conforme as seguintes etapas: 1. **Transmissão do Pedido de Compra (Consistem ERP** :arrow-right: **GECEX)** 1. **Gatilho de Liberação:** Cadastre o Pedido de Compra do tipo *Importação* no programa [Geração de Pedido de Compra (CCESU090)](/entradas/manuais-de-telas/entradas-compras-e-procurement/compra/geracao-de-pedido-de-compra.md) e altere a situação de bloqueio para *Liberado* para disparar a integração. 2. **Envio de Itens e Parceiros:** Certifique-se de que o sistema transmita primeiro todos os itens/produtos e, na sequência, todos os parceiros envolvidos (fornecedores, transportadoras, despachantes) associados ao pedido. 3. **Envio do Pedido:** Aguarde a conclusão sem erros das transmissões de itens e parceiros para que o ERP envie o Pedido de Compra de Importação completo ao GECEX. O conector só reprocessará o envio completo do documento se houver alguma alteração estrutural no ERP. 4. **Auditoria e Reenvio Manual:** Caso ocorram falhas na fila de integração, acesse aos seguintes programas de suporte: 1. [Consulta Integração GECEX (CCEIG610)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/consulta-integracao-gecex.md): Filtre pelo tipo de documento desejado (Pedido, Produto, Parceiro, Nota Fiscal ou Docs à Pagar) para verificar o status e acesse aos logs de erro detalhados ([Consulta Log de Integração de Pedido (CCEIG611)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/consulta-integracao-gecex.md) a [Consulta de Log de Integração de Liquidação de Documentos a Pagar no GECEX (CCEIG615)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/consulta-de-log-de-integracao-de-liquidacao-de-documentos-a-pagar-no-gecex.md)). 2. [Consulta Parceiros para Integração GECEX (CCEIG620)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/consulta-parceiros-para-integracao-gecex.md): Utilize o botão **Manutenção** para ajustar a classificação do parceiro no GECEX antes de forçar o envio pelo botão **Enviar Parceiro**. 3. [Consulta Portador para Integração GECEX (CCEIG650)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/consulta-portador-para-integracao-gecex.md): Valide se o campo **CNPJ Agência** está preenchido no programa [Cadastro de Portador (CCAPL025)](/cadastros-gerais/manuais-de-telas/cadastros-gerais/cadastro-de-portador.md) e utilize o botão **Enviar Parceiro** para transmitir os dados bancários manualmente. 2. **Provisionamento do Contas a Pagar (GECEX** :arrow-right: **Consistem ERP)** 1. **Inclusão de Títulos e Despesas:** Envie o arquivo estruturado sob o leiaute `Layout_FIN192_Cadastro_Contas_a_Pagar.xsd` para registrar automaticamente os documentos de Contas a Pagar (em moeda nacional ou estrangeira) relativos às despesas do processo. O nó `` deve amarrar o pedido original, enquanto as tags `` e `` garantem o rastreio aduaneiro. 2. **Estorno de Títulos:** Caso uma obrigação seja cancelada na plataforma aduaneira, envie o leiaute `Layout_FIN186_Exclusao_Contas_a_Pagar.xsd` referenciando as tags `` e `` para remover o lançamento preventivo no ERP. 3. **Liquidação de Antecipações (GECEX** :arrow-right: **Consistem ERP)** 1. **Baixa de Adiantamentos Cambiais:** Transmita o arquivo utilizando o leiaute `Layout_FIN187_Liquidacao_Contas_a_Pagar.xsd` para registrar a liquidação em moeda estrangeira no ERP. Forneça obrigatoriamente o número da liquidação (``), o valor na moeda de origem (``), a taxa cambial (``) e o valor convertido para moeda nacional (``). 2. **Estorno de Liquidação:** Envie o arquivo sob o leiaute `Layout_FIN188_Exclusao_Liquidacao.xsd` para desfazer e estornar a liquidação de moeda estrangeira no ERP em caso de cancelamento do fechamento de câmbio. 4. **Processamento da Minuta da DI (GECEX** :arrow-right: **Consistem ERP)** 1. **Disponibilização da Minuta:** Transmita o leiaute `Layout_EXP1505_Minuta_de_Nota_Fiscal.xsd` contendo os dados de nacionalização assim que a Declaração de Importação (DI) for registrada. Os nós principais devem contemplar os dados da capa (``), como número da DI, data e taxas de câmbio, e os dados das linhas dos itens (``), detalhando o código do produto (``), pesos, quantidades e a abertura detalhada de impostos (II, IPI, ICMS, PIS, COFINS e AFRMM). 5. **Recebimento Físico e Efetivação Fiscal (No Consistem ERP)** 1. **Validação da Minuta:** Acesse o programa [Consulta de Minuta para Emissão de NF de Entrada (CCEIG640)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/consulta-de-minuta-para-emissao-de-nf-de-entrada.md), informe o número da minuta e valide as informações de Incoterms, locais de despacho e amarração de produtos. Se existirem divergências insanáveis, utilize a opção Declinar Documento para rejeitar a sequência e aguardar uma nova transmissão corrigida. 2. **Ajuste de Despesas Locais:** Se houver custos logísticos nacionais ou taxas portuárias complementares, associe-as à minuta utilizando o programa [Cadastros de Outras Despesas para Minuta de NF (CCEIG040)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/cadastros-de-outras-despesas-para-minuta-de-nf.md) antes de prosseguir. 3. **Emissão da Nota Fiscal:** Clique no botão **Emitir NF**. O sistema efetuará a validação da coluna **Finalidade** dos itens (visualizada no programa [Consulta das Adições da Minuta (CCEIG641)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/consulta-das-adicoes-da-minuta.md)) e aplicará de forma automática as regras de prioridade configuradas na [Aba Emissão NF (CCEIG000TAB2)](/entradas/manuais-de-telas/entradas-integracao-gecex/configuracao/configuracao-integracao-gecex/aba-emissao-nf.md) para determinar o perfil fiscal de entrada. 4. **Homologação e Entrada Física:** Transmita e autorize a NF-e na SEFAZ por meio do programa [Monitor da Nota Fiscal Eletrônica (CCFTN610)](/comercial/manuais-de-telas/comercial-faturamento/faturamento/monitor-da-nota-fiscal-eletronica.md). Após a aprovação, acesse ao programa [Data de Entrada da Mercadoria (CCEIG640B)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/data-de-entrada-da-mercadoria.md) para efetivar a entrada física, atualizar os saldos de estoque e registrar a escrita fiscal. 5. **Retorno de Confirmação:** Aguarde que o ERP devolva automaticamente ao GECEX o código do documento fiscal definitivo gerado e os seus valores validados para o encerramento do fluxo no sistema externo. 6. **Correções Pós-emissão:** Caso seja identificada alguma falha após a geração, utilize o botão **Estornar NF Entrada** no programa [Consulta de Minuta para Emissão de NF de Entrada (CCEIG640)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/consulta-de-minuta-para-emissao-de-nf-de-entrada.md) para excluir a nota fiscal, atualizar os estoques e retornar a minuta para o status de *Não Processado* para que possa ser corrigida. 6. **Liquidação de Custos Nacionais (Consistem ERP** :arrow-right: **GECEX)** 1. **Baixa Financeira:** Processe o pagamento de prestadores nacionais (como despachantes ou transportadoras) diretamente no módulo Financeiro padrão da Consistem. Assim que o Contas a Pagar receber a baixa, certifique-se de que o ERP envie uma notificação automática ao GECEX contendo o número do documento de liquidação e o valor pago para refletir a baixa correspondente no controle aduaneiro. 7. **Conciliação e Fechamento Periódico** 1. **Ajuste de Variação Cambial:** Monitore as variações ocorridas entre as datas de provisionamento e as liquidações internacionais. Se a empresa não possuir o módulo de Contabilidade integrado nativamente ao Financeiro do Consistem ERP, envie o leiaute `Layout_FIN470_Contabilizacao_Monetaria.xsd` contendo as partidas de débito/crédito e históricos para realizar as conciliações externas. 2. **Rateio por Centros de Custo:** Caso alguma conta contábil movimentada exija Centro de Custo (conforme cadastro no programa [Cadastro dos Centros de Custo por Conta Contábil (CCCTC005)](/contabil-fiscal/manuais-de-telas/contabil-fiscal-contabilidade/cadastro-de-plano-contabil/cadastro-dos-centros-de-custo-por-conta-contabil.md)) e possua mais de um vínculo ativo, execute o rateio de forma explícita através do programa [Contabilização por Centros de Custo (CCCTL056)](/comercial/manuais-de-telas/comercial-comissao-sobre-vendas/manutencoes-de-comissoes-de-representantes/contabilizacao-por-centros-de-custo.md). 3. **Auditoria de Fechamento:** Acesse o programa [Geração de Conciliação por Processo de Importação (CCEIG660)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/geracao-de-conciliacao-por-processo-de-importacao.md), informe o **Mês/Ano** e apure os saldos de débitos e créditos acumulados nas contas transitórias de importação e despesas. Adote as seguintes ações de controle no grid: 1. **Detalhar Processo:** Use o botão para abrir o programa secundário [Detalhar Lançamentos do Processo de Importação (CCEIG661)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/detalhar-lancamentos-do-processo-de-importacao.md) e analisar os lançamentos individuais do processo selecionado. 2. **Validar / Fechar Período:** Execute o encerramento e o bloqueio contábil do mês consultado assim que os saldos estiverem devidamente reconciliados. 3. **Reabrir Período:** Utilize esta opção se precisar reabrir um mês com status *Fechado* para ajustes retroativos. 4. **Log de Erros:** Monitore o programa [Log de Erro de Lançamentos em Processos Encerrados (CCEIG662)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/log-de-erro-de-lancamentos-em-processos-encerrados.md) para acusar e tratar lançamentos indevidos efetuados em processos que já haviam sido listados como encerrados. 5. **Lançamentos sem Identificação:** Acesse ao programa [Lançamentos sem identificação de Processo de Importação (CCEIG663)](/entradas/manuais-de-telas/entradas-integracao-gecex/integracao-gecex/lancamentos-sem-identificacao-de-processo-de-importacao.md) para extrair e corrigir lançamentos órfãos nas contas transitórias que tenham sido realizados sem a devida amarração ao número do processo de importação.

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/entradas/gecex-importacao.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.