Pular para o conteúdo

Operações agrícolas independentes / construídas para o próximo turno

Vendas

Sua loja agrícola vende online. Os registros de sua fazenda continuam atualizados.

A caixa CSA esgotou na terça à noite enquanto você limpava os filtros. Boas notícias, exceto que os pedidos estão no Shopify e os registros de sua fazenda ainda não os conhecem. Qual colheita preenche essas caixas? Quanto a semana realmente arrecadou na loja, no mercado e no atacado? Até que alguém copie os pedidos, o registro da fazenda fica atrás da vitrine.

Uma loja que funciona enquanto você trabalha é apenas metade da vitória. A outra metade é um registro de fazenda que permanece atualizado sem que você atue como mensageiro entre dois sistemas.

Como realmente funciona

FarmHub importa pedidos de sua loja Shopify. O fluxo é de entrada, webhook first e tem como escopo sua loja.

  • Webhooks de pedido são o sinal principal. Quando um pedido é criado ou atualizado no Shopify, o Shopify envia um webhook ao FarmHub. FarmHub verifica a assinatura do webhook antes de confiar nela e, em seguida, importa o pedido como um registro de vendas.
  • Uma varredura de reconciliação captura o que os webhooks perdem. O FarmHub relê periodicamente os pedidos atualizados recentemente do Shopify, para que um webhook perdido não se torne uma venda perdida.
  • A conexão tem como escopo sua loja. Você insere seu domínio myshopify.com no momento da conexão e autoriza na tela OAuth da sua própria loja. Cada chamada de API está enraizada na sua loja e em mais ninguém.
  • Os preços são convertidos exatamente. Shopify envia valores decimais. FarmHub os converte em centavos inteiros para que os totais dos pedidos correspondam ao centavo. Isso pressupõe uma moeda de 2 casas decimais, o padrão para as vitrines que o FarmHub visa hoje.

Pedidos importados juntam-se ao resto da operação: acúmulos de custos de colheita, lucratividade por safra e lançamentos contábeis limpos downstream se você também conectar QuickBooks ou Xero.

COM QUE VOCÊ PODE CONTAR

Com o que você pode contar

As partes em que você confia, declaradas claramente:

  • OAuth por loja, credenciais criptografadas. Você autoriza FarmHub em sua própria loja com escopo read_orders. O token de acesso é armazenado criptografado por conexão.
  • webhooks com assinatura verificada. Cada evento de pedido de entrada é verificado criptograficamente como proveniente do Shopify antes da importação. Postagens forjadas não entram no seu registro de fazenda.
  • Importações idempotentes. Um pedido visto duas vezes, pelo webhook e pela varredura de reconciliação, torna-se um registro de vendas. As atualizações de pedidos revisam o registro existente em vez de duplicá-lo.
  • Kill switch e linhas de auditoria encadeadas por hash. Desative a conexão instantaneamente, se necessário. A atividade de importação chega a um log de auditoria cujas linhas são encadeadas por hash e invioláveis.

O que não fazemos

O que não fazemos:

  • FarmHub não escreve para sua loja Shopify. Nenhuma edição de produto, nenhuma alteração de preço, nenhuma ação de atendimento. O escopo é read_orders e o fluxo é somente importação.
  • FarmHub não gerencia a contagem de estoque da sua loja no Shopify.
  • FarmHub não é uma plataforma de comércio eletrônico. O Shopify mantém esse trabalho e o mantém bem.

Configuração, honestamente

Você precisa de uma loja Shopify e permissão para instalar aplicativos nela.

  1. No FarmHub, abra Integrações e escolha Shopify.
  2. Insira o domínio da sua loja (sua-loja.myshopify.com).
  3. Aprove a conexão na tela OAuth da sua loja. FarmHub solicita acesso de leitura apenas aos pedidos.
  4. Faça ou aguarde um pedido e confirme que ele chega ao FarmHub como registro de vendas.

Perguntas que os agricultores fazem

Quais dados do Shopify o FarmHub acessa?

Somente pedidos. O escopo do OAuth é read_orders. FarmHub importa eventos de pedidos por meio de webhook verificado e os protege com uma varredura periódica de pedidos atualizados recentemente.

O FarmHub pode alterar minha loja, produtos ou preços?

Não. A integração é somente leitura para o Shopify. FarmHub nunca escreve na sua loja.

O que acontece quando um pedido é editado ou cancelado no Shopify?

Os webhooks de atualização de pedidos revisam o registro de vendas existente do FarmHub em vez de criar uma duplicata, para que o registro da fazenda siga a vitrine.

Preciso autorizar novamente a conexão periodicamente?

Não, hoje. A Shopify emite tokens de acesso offline que não expiram de acordo com uma programação, de modo que a conexão permanece ativa sem uma tela de novo consentimento. Shopify anunciou mudanças no comportamento do token offline para aplicativos públicos a partir de 1º de janeiro de 2027, e o FarmHub seguirá essa orientação quando chegar. O token é armazenado criptografado e você pode revogar a conexão de qualquer lado a qualquer momento.

Como os webhooks permanecem confiáveis?

Cada webhook é verificado por assinatura como genuíno do Shopify antes que o FarmHub importe qualquer coisa. Postagens não verificadas são rejeitadas.

PRONTO PARA O PRÓXIMO TURNO

Deixe a loja e o registro da fazenda concordarem

Conecte sua loja Shopify e cada pedido online será arquivado no registro da fazenda ao qual pertence. Você cresce, a loja vende, o recorde continua.

Comece gratuitamente