---
title: "Integração Field x Omie"
description: "Este é o manual da integração entre Field Control e Omie"
url: https://ajuda.fieldcontrol.com.br/pt-br/articles/246-integracao-field-x-omie
collection: "Integrações"
updated: 2026-08-27
language: pt-br
---

# Integração Field x Omie

Este é o manual da integração entre Field Control e Omie

# Doc - Omie V2

Doc - Omie V2 Esta é uma integração distinta da integração padrão com a Omie. Enquanto a integração padrão conecta clientes, produtos, OS e orçamentos entre os dois sistemas, o Controle de Estoque Omie é uma integração focada exclusivamente em estoque, com uma lógica própria de funcionamento: o Field opera em modo espelho da Omie.

## Como funciona

A integração é predominantemente unidirecional — os dados vão da Omie para o Field, não o contrário. O objetivo é trazer os cadastros e movimentações de estoque da Omie para o Field, mantendo tudo sincronizado em um único lugar. Existem duas exceções a essa regra: transferências entre depósitos, que podem ser realizadas nos dois sistemas e são refletidas entre eles; e a utilização de itens em OS, em que a baixa registrada no Field é automaticamente refletida no estoque da Omie — sem necessidade de nenhuma ação manual no ERP. Com a integração ativa, o Field bloqueia ações de criação e edição nas páginas impactadas — Movimentações, Depósitos, Estoques, Produtos e Peças — que passam a funcionar apenas em modo de consulta e acompanhamento. Isso garante que o dado oficial continue sendo sempre a Omie, evitando divergências entre os sistemas.

## O que é sincronizado

A integração mantém três categorias de dados sincronizados automaticamente da Omie para o Field:

Produtos e Peças: O Field replica os cadastros de itens da Omie para manter o catálogo de estoque consistente para consulta e operação. Depósitos: Os depósitos cadastrados na Omie são espelhados no Field, permitindo acompanhar saldos por local e evitar confusão entre almoxarifados e filiais. Movimentações: O Field reflete as movimentações realizadas na Omie, registros de entrada e saída e correções de saldo. Contudo as transferências ainda podem ser feitas no Field e refletidas na Omie e vice-versa, é a única exceção.

## Procedimentos necessários para ativação

## Token de API do Field

O primeiro passo é o mais importante: capturar a chave de API do Field, disponível no Menu Lateral, na aba Configurações > API de Integração > Nova chave.

Depois é necessário nomear a chave de integração com o nome de preferência e clicar em Criar.

A chave de API só é mostrada para o usuário no momento da criação (após clicar em criar), por isso se atente às situação na qual o cliente se enquadra: Chave de API já gerada e o cliente tem ela registrada: não é necessário criar uma nova chave. Apenas é preciso passar a chave para o time de produto para que os desenvolvedores façam a inserção da chave no banco.

![](https://staticfiles.gleap.io/ghelparticle/GoVJg7VZoMDqJtlPvWlKNdI1C4xK7Kn7UWtQ54OSt1ZnorXWYSdg1iLaYKQ9w6uK0CSWEhE1PkS.png)

![](https://staticfiles.gleap.io/ghelparticle/b49bGBkmhnys8rlzOKRPLHROVthIXeqrb0UaGxlhwwwxCnTomXKObYdnSPPTtdbfjl5f41g27kW.png)

Chave de API já gerada e o cliente não tem ela registrada: é necessário criar uma nova chave, salvá-la e depois passá-la para o time de produto para que os desenvolvedores façam a inserção da chave no banco. Chave de API não foi gerada ainda: é necessário criar a chave, salvá-la e depois passá-la para o time de produto para que os desenvolvedores façam a inserção da chave no banco.

Exemplo de chave de integração

OBS: não se esqueça de salvar a chave, em nenhuma hipótese feche a aba sem salvar a chave e anotá-la em um local de fácil acesso e enviá-la ao time de produto. Depois de criada a chave, não exclua. O próximo passo é adicionar uma URL de callback em Webhooks de integração, que está disponível na mesma página, Configurações > API de Integração. Para adicionar a Webhook de integração basta clicar no local indicado :

![](https://staticfiles.gleap.io/ghelparticle/zjxG06JMobSTdfGL9kGtT0F1IyR40l8BU0vv94Uh1pI3LcRT7XUMjKVDqyekppgcpaMoD1D9cRk.png)

![](https://staticfiles.gleap.io/ghelparticle/jl9kWl5lJNaQyUTEotYd3t3YD7KyqJfJnFzDCa04Go9tBMtwnlsmXbspvCpLSbBbmmIFRQDEbZS.png)

Após clicar no local indicado, abre uma modal para criação de novo Webhook, com alguns campos para serem preenchidos: URL: Colar o seguinte endereço para funcionamento correto do Webhook https://shagrat-2.fieldcontrol.com.br/webhook-callback Autenticação: Marcar a opção “Nenhuma”. Eventos de Webhook: Existem duas possibilidades de escolha Adicionar todos os eventos de webhook: significa que caso essa opção seja escolhida, todos os dados possíveis poderão ser passados de um sistema para outro. Selecionar eventos de webhook individualmente: significa que caso essa opção seja escolhida, os dados que serão passados de um sistema para outro poderão ser escolhidos através de algumas caixas de seleção.

Criação de Webhook

## App key e App secret da Omie

Diferentemente do Field, a Omie utiliza dois tokens de autenticação: o app key e o app secret. O primeiro passo consiste em entrar no site oficial da Omie através do Link: https://developer.omie.com.br/. Após entrar no link (e se necessário fazer login), clique em Aplicativos.

![](https://staticfiles.gleap.io/ghelparticle/dIZaRsLo3WFBmDzuHJaehJF0FF1NLFY5lNAh2oe3jwpohHnswxJw0eyX24TMUyB5XzRm3zmWh5h.png)

Depois clique no nome da empresa, que fica dentro de uma tarja na cor azul claro.

Em seguida clique em Gerar nova chave de acesso.

Após a geração dos tokens na Omie, é necessário retornar ao painel do Field para terminar a configuração da integração. No Menu Lateral, na aba de Loja > Integrações, entre na integração da Omie | Controle de Estoque clicando no botão Configurar.

![](https://staticfiles.gleap.io/ghelparticle/cmMmmeEzr3WJbFtWU4Tc7rwJJpqqgZbiu6FmObNuSBFUbC6BQoeKuwU2u4jKctOoxHP1nsWZUS0.png)

![](https://staticfiles.gleap.io/ghelparticle/BtmO8kdMwtFYET3j2lz7SUutbmPAO27Rb9nvhPjOmfyzXhQ7cpiUxLvozV8JJ5CO4OWMX4c6HfL.png)

![](https://staticfiles.gleap.io/ghelparticle/FqQO8uCCNndjYFmrD8x1giFIPs4qoYj8c5YizMq2CKGZpve3uYmh7dU1sIHZMClgMIn9RHmFCmF.png)

Depois basta clicar no botão Editar

Em seguida insira os tokens gerados na Loja de Integração da Omie nos respectivos campos de App Key e App Secret. Após a inserção dos tokens, clique em Salvar.

## Sincronizações

![](https://staticfiles.gleap.io/ghelparticle/4v9LF6VwvkWk6bMPZFuuQktBUbl3uOtnFF5pXJLmceKhaFfc2IFROB4exi8kCbnk6qIWDiwWuWW.png)

![](https://staticfiles.gleap.io/ghelparticle/SMBn1UGZReBkqbh8hFtOcp9TuzPQ5lHTAmqVWqtEChnTjN8sZ8zcgPV2ARR3kK10FcO8zSs0eBO.png)

![](https://staticfiles.gleap.io/ghelparticle/V0DVzpA5HRNihjaBJXDew7cAjeiDPuqV3In973bTdAyGyAnxnFwgUtbClNLab1Uh6Ny0UsnCmRF.png)

A aba de Sincronizações exibe o status e os detalhes de cada sincronização ativa — produtos, peças, depósitos e movimentações — permitindo acompanhar quando cada uma foi executada pela última vez e se está funcionando corretamente. Nessa aba que de fato a integração é configurada.

## Sincronização de produtos

Na configuração de produtos, após ativar a sincronização, o gestor seleciona quais famílias cadastradas na Omie deseja trazer para o Field, apenas os produtos das famílias selecionadas serão sincronizados. Para selecionar as famílias basta clicar em Adicionar família Omie. O campo Ocorre a cada… indica de quanto em quanto tempo, os produtos serão importados da Omie. Exemplo: dois produtos novos acabaram de ser importados para o Field, após o intervalo de execução (5 minutos por exemplo), os produtos cadastrados após essa importação serão puxados. Esse campo funciona da mesma forma para as outras sincronizações. Definidas as famílias é possível acompanhar pela página de monitoramento se a sincronização foi feita com sucesso.

Configurando a Sincronização de Produtos Para acessar a Página de Monitoramento clique em:

![](https://staticfiles.gleap.io/ghelparticle/DO4BXfEWtEEzFQSV65xyeC9ReHkpwbH39zmsAxHCN6cV5qloLundHu2Sl7bcUHL7myGw7fH4VHU.png)

Com a sincronização ativa, a página de Produtos no Field entra em modo leitura: não é possível criar novos produtos nem editar os existentes diretamente no Field. Um aviso é exibido na tela para informar o usuário sobre essa restrição e orientá-lo a realizar as alterações na Omie.

Produtos na Omie que foram importados para o Field

![](https://staticfiles.gleap.io/ghelparticle/VeRgpGWClSbGq4nHy6FglCRMOWBL0VNtwyJmwNz26oVgJtJFcyjJBlYXG4iJhUTuhjTIAx1wUJN.png)

![](https://staticfiles.gleap.io/ghelparticle/V6xBlsp3NZ6vZlf6v4OUQ1OoN7Nz81Mm7Zn3Dc9s2Do3OyWEWCjmMxBeylTsIo1PQtjZ9hRa1p5.png)

Produtos no Field que foram importados da Omie

## Sincronização de peças

O funcionamento é equivalente ao de produtos: o gestor seleciona quais famílias da Omie deseja sincronizar com o Field. Para selecionar as famílias basta clicar em Adicionar família Omie. O campo Ocorre a cada… indica de quanto em quanto tempo, as peças serão importadas da Omie. Esse campo funciona da mesma forma que nas outras sincronizações. Definidas as famílias é possível acompanhar pela página de monitoramento se a sincronização foi feita com sucesso.

Configurando a Sincronização de Peças

![](https://staticfiles.gleap.io/ghelparticle/VMhN2HzGQCdkaQemKMjvPfYcWTs7I7KdLW1rQICkEsCp26qSzwCh7ls0uSz5fOtmQG8bmDfFmus.png)

![](https://staticfiles.gleap.io/ghelparticle/uWPEBCX3lT7GGJAHektXoeMUNmPSc9ILlUTmMEoXsAuHE4FxKIBES01jC5Apo2ATb86r3UFoRLd.png)

Com a sincronização ativa, a página de Peças também entra em modo leitura — criação e edição de peças ficam desabilitadas no Field e precisam ser feitas diretamente na Omie.

Peças na Omie que foram importadas para o Field

Peças no Field que foram importadas da Omie

![](https://staticfiles.gleap.io/ghelparticle/COBgE9LjKIsuKuzNRZc26k6HzL7rVkIFoSK2eXXJ6NeBNaZ3xZkIIq6VCs5K4NI3mQxXoQD9x9x.png)

![](https://staticfiles.gleap.io/ghelparticle/4fKDjXxlyIfVgxOQb4XJVPcmJrCIIAXNPjVhf0HaG5CiEavojuWIds48KP5kGJZb4BmYmwnpXkY.png)

## Sincronização de equipamentos

A sincronização de equipamentos segue a mesma lógica das demais: com a integração ativa, os equipamentos passam a ser gerenciados pela Omie como fonte de verdade. O campo Ocorre a cada… indica de quanto em quanto tempo, os equipamentos serão importados da Omie. Esse campo funciona da mesma forma que nas outras sincronizações. Definidas as famílias é possível acompanhar pela página de monitoramento se a sincronização foi feita com sucesso.

Configurando a Sincronização de Equipamentos

O Field entra em modo leitura para os registros impactados, exibindo o aviso de restrição ao usuário.

![](https://staticfiles.gleap.io/ghelparticle/kupHHU3kNmiBGbrqqPo32DHEjmgaaT0Fus5kFqaI3WN3FIXbo43gFrEuvUyjokLx0kBHkUGntjU.png)

Equipamentos na Omie que foram importados para o Field

Equipamentos no Field que foram importados da Omie

## Sincronização de depósitos

Os depósitos cadastrados na Omie são espelhados no Field, incluindo criação, alteração e inativação. Para adicionar um depósito, clique no botão Adicionar

![](https://staticfiles.gleap.io/ghelparticle/YnPg8kffEfep131nJUQfCfxXIbKhqz2OigP6lGCg5sysiy4Mzn9WFMX2zDMEwzdmqqUg0NXJ4bi.png)

![](https://staticfiles.gleap.io/ghelparticle/DEfy36ybJJ62ngNx8h7wXsUjRzH38EaAHfawAQvi1Zh4c8mVXDm3VVbPGnExfrDDlvNQaPY8YwO.png)

depósito, e selecione quais depósitos devem ser importados.

Configurando a Sincronização de Depósitos

Após seleção do depósito que será importado é possível vincular esse depósito a algum colaborador e esse depósito passa a ser entendido como inventário no Field, mas isso não é obrigatório. No próximo tópico desta documentação esse assunto será abordado.

Depósitos sincronizados Para saber mais sobre o cadastro de Locais de Estoque na Omie consulte o conteúdo disponibilizado pela própria Omie . Com a sincronização ativa, os depósitos no Field entram em modo leitura — qualquer criação ou ajuste deve ser feito na Omie e será refletido automaticamente no Field.

![](https://staticfiles.gleap.io/ghelparticle/QaJGpwDnFg2bxxWSDfE79ea1UdvP2fB3XG5wTSl3KRZzoBC47cgXdrlza5VfadQZBqO0W15FTYz.png)

![](https://staticfiles.gleap.io/ghelparticle/Ziddcd867Y8bhJ149Be9ysrTeRHEeI3g8hSDMlX3BMbsbU7sBOwAyfqVDm3k4OkTzwP4mNqdip4.png)

Depósitos na Omie que foram importados para o Field

Depósitos no Field que foram importados da Omie

## Vínculo com colaboradores

Ao configurar a sincronização de depósitos, o gestor pode vincular cada depósito da Omie a um colaborador do Field. Esse vínculo define como o depósito será tratado no sistema:

![](https://staticfiles.gleap.io/ghelparticle/f1PN1N77TD2J23nbqB9Udnw9YqARZcY8GsVHQR0SUZKw8uYxQRGhv0zBwxtUcs4cH5xOIuDoMwl.png)

![](https://staticfiles.gleap.io/ghelparticle/c8Y5czSgULjHcdRC2HYesPApuEDd4wEs4AXp1DaaVNX9K3p5j9t0ZJ2sfzvfupPpnrg52nPL4l6.png)

Com vínculo: o depósito sincronizado vira o inventário (mochila) daquele colaborador, mantendo o estoque vinculado a ele.

Depósito Omie definido como inventário no Field

Sem vínculo: o depósito permanece como um depósito físico (galpão), sem associação a nenhum colaborador.

Depósito Omie definido como depósito no Field

Ao remover o vínculo: o depósito volta a ser atualizado pela Omie normalmente, e o inventário do colaborador mantém os itens que já tinha — não há exclusão de estoque ao desvincular.

![](https://staticfiles.gleap.io/ghelparticle/AHyd7gvq7zUtkmi99xj8Kof0bs3YO8arKhimj5siKoKw8qivgqId0E7TJxyMFPfGy8JxlaaLOT9.png)

![](https://staticfiles.gleap.io/ghelparticle/k4nQQDH6SzyZDdeDuRvhMDQeIPkgIX9q6RwQrd2M6r4vXO8LsAltuwKKV2bBGBC7sOh5jM8Yg3E.png)

Observação: caso o colaborador que se deseja vincular tenha um inventário arquivado, é necessário desarquivá-lo antes de realizar o vínculo. Para isso, acesse Menu Lateral > Inventários e clique no botão Filtrar

Filtre pelos arquivados,

Abra o inventário desejado clicando no botão Ações e clique em Desarquivar. Após isso, o vínculo pode ser feito normalmente.

![](https://staticfiles.gleap.io/ghelparticle/mt12EOIep1fz3E9F07i31da2djT8I580fWx7lB3eBMWA9XasuLj7JSUxkKsjXfHw1LtCCWchgs5.png)

![](https://staticfiles.gleap.io/ghelparticle/OnwmaWxBCn8ZGumIIMz8erhNEsV8i1Ei8aINMDDBy5wfGwD8OMsxdeXYyJYchtYnOYkmIVD9qsX.png)

Desarquivamento de Inventário de colaborador

## Sincronização de movimentações

As movimentações de estoque passam a ser controladas exclusivamente pela Omie. Com a integração ativa, não é possível registrar entradas ou saídas (entradas e saídas são refletidas diretamente da Omie). Transferências podem ser realizadas em ambos os sistemas e são refletidas entre eles: uma transferência feita no Field é refletida na Omie, e vice-versa.

Configurando a Sincronização de Movimentações

A página de Movimentações no Field fica disponível apenas para consulta das entradas e saídas, mas ainda disponível para transferências. Para saber mais sobre as movimentações na Omie consulte o conteúdo disponibilizado pela própria Omie.

![](https://staticfiles.gleap.io/ghelparticle/7gTeQpcGtypU7rBQGlmSbwiZ4FoRo31VOWb1pekLzZ8soIvEaqGrf7hj97xZiJ3w4CaJ9utSuu2.png)

![](https://staticfiles.gleap.io/ghelparticle/suIfsCtkNuw5zS7oOmuIArnHYq68yjb2SVgduIQ2NpTl68QNgtoqrcJCzNSS5uaJ466ETO5bEWQ.png)

Movimentações feitas na Omie que foram importadas para o Field

Movimentações no Field que foram importadas da Omie

## Utilização de Itens na OS

Quando um produto ou peça é utilizado em uma atividade dentro do Field e a saída é registrada, essa movimentação é automaticamente refletida no estoque da Omie — ou seja, a baixa ocorre nos dois sistemas simultaneamente, sem necessidade de nenhuma ação manual na Omie.

![](https://staticfiles.gleap.io/ghelparticle/uiH5Ybun0DwEXrtOVJHGGM0EztXViSfUfWmam4ic1dbvp0U1pmOb9PQ8ZYL0EN01tLooiDPn0wY.png)

![](https://staticfiles.gleap.io/ghelparticle/vuFPvy4e3PN8xoJq2RaEnUjGEwsecE43XkFqzA5Z1SejwVRM4oudtOGROONg2LWA21FU7HLh3JO.png)

Da mesma forma, caso o item utilizado precise ser devolvido — por exemplo, se o produto errado foi selecionado — a devolução também é registrada no Field e refletida na Omie, revertendo a baixa e voltando o saldo ao estado anterior. Essa movimentação de saída e de retorno fica registrada no histórico do depósito correspondente, dentro da página de Movimentações. Observação: a sincronização da baixa na Omie ocorre com um intervalo de até 60 segundos após o registro da utilização no Field.

3 unidades do produto "chaveimaginaria" registradas na OS

![](https://staticfiles.gleap.io/ghelparticle/dSi5FqZS0XSNdU5L1HoT4cgRNj1EnUtZCx4KG7ZoBLmWiaOR9BADNmK6wPCQ0YJvZtPI27eJxV1.png)

Quantidade do produto na Omie antes e após utilização na OS do Field

![](https://staticfiles.gleap.io/ghelparticle/6YGL9DzLt6JKqCDk4sf02UwfRLofMfMjS340pUt6fIuebd4DXG5lSgNxcV9pqWpuMLCrPcw0V7U.png)
