Ventas
Tu tienda agrícola vende en línea. Los registros de su granja se mantienen actualizados.
La caja de CSA se agotó el martes por la noche mientras limpiabas los filtros. Buenas noticias, excepto que los pedidos se encuentran en Shopify y los registros de tu granja aún no los conocen. ¿Qué cosecha llena esas cajas? ¿Cuáles fueron realmente los ingresos brutos de la semana en la tienda, el mercado y el comercio mayorista? Hasta que alguien copie los pedidos, el registro de la granja estará detrás del escaparate.
Una tienda que funciona mientras usted trabaja es sólo la mitad de la ganancia. La otra mitad es un registro agrícola que se mantiene actualizado sin que usted actúe como mensajero entre dos sistemas.
Cómo funciona realmente
FarmHub importa pedidos de tu tienda Shopify. El flujo es entrante, primero el webhook y tiene como alcance su tienda.
- Los webhooks de pedidos son la señal principal. Cuando se crea o actualiza un pedido en Shopify, Shopify envía a FarmHub un webhook. FarmHub verifica la firma del webhook antes de confiar en él y luego importa el pedido como un registro de ventas.
- Un barrido de reconciliación detecta lo que los webhooks pasan por alto. FarmHub vuelve a leer periódicamente los pedidos actualizados recientemente de Shopify, para que un webhook eliminado no se convierta en una venta perdida.
- La conexión tiene como alcance su tienda. Ingresas tu dominio myshopify.com en el momento de conectarte y lo autorizas en la pantalla OAuth de tu propia tienda. Cada llamada a la API tiene su origen en su tienda, en la de nadie más.
- Los precios se convierten exactamente. Shopify envía cantidades decimales. FarmHub los convierte a centavos enteros para que los totales de los pedidos coincidan con el centavo. Esto supone una moneda de 2 decimales, la predeterminada para las tiendas a las que se dirige FarmHub en la actualidad.
Los pedidos importados se unen al resto de la operación: acumulación de costos de cosecha, rentabilidad por cultivo y asientos contables limpios posteriores si también conecta QuickBooks o Xero.
EN QUÉ PUEDES CONTAR
En qué puedes contar
Las partes en las que confía, expresadas claramente:
- OAuth por tienda, credenciales cifradas. Autoriza a FarmHub en su propia tienda con un alcance read_orders. El token de acceso se almacena cifrado por conexión.
- Webhooks con firma verificada. Se verifica criptográficamente que cada evento de pedido entrante proviene de Shopify antes de la importación. Las publicaciones falsificadas no ingresan en el registro de su granja.
- Importaciones idempotentes. Un pedido visto dos veces, por webhook y por barrido de conciliación, se convierte en un registro de ventas. Las actualizaciones de pedidos revisan el registro existente en lugar de duplicarlo.
- Kill switch y filas de auditoría encadenadas mediante hash. Desactive la conexión al instante si es necesario. La actividad de importación llega a un registro de auditoría cuyas filas están encadenadas mediante hash y son a prueba de manipulaciones.
Lo que no hacemos
Lo que no hacemos:
- FarmHub no escribe en tu tienda Shopify. Sin modificaciones de productos, sin cambios de precios, sin acciones de cumplimiento. El alcance es read_orders y el flujo es de solo importación.
- FarmHub no administra los recuentos de inventario de su tienda en Shopify.
- FarmHub no es una plataforma de comercio electrónico. Shopify mantiene ese trabajo y lo mantiene bien.
Configuración, honestamente
Necesitas una tienda Shopify y permiso para instalar aplicaciones en ella.
- En FarmHub, abre Integraciones y elige Shopify.
- Ingresa el dominio de tu tienda (tu-tienda.myshopify.com).
- Aprueba la conexión en la pantalla OAuth de tu tienda. FarmHub solicita acceso de lectura únicamente a los pedidos.
- Realizar o esperar un pedido y confirmar que llegue a FarmHub como registro de ventas.
Preguntas que hacen los agricultores
¿A qué datos de Shopify accede FarmHub?
Sólo pedidos. El alcance de OAuth es read_orders. FarmHub importa eventos de pedidos mediante webhook verificado y los respalda con un barrido periódico de los pedidos actualizados recientemente.
¿Puede FarmHub cambiar mi tienda, productos o precios?
No. La integración es de solo lectura hacia Shopify. FarmHub nunca escribe en su tienda.
¿Qué sucede cuando se edita o cancela un pedido en Shopify?
Los webhooks de actualización de pedidos revisan el registro de ventas existente de FarmHub en lugar de crear un duplicado, por lo que el registro de la granja sigue el escaparate.
¿Necesito volver a autorizar la conexión periódicamente?
No, hoy. Shopify emite tokens de acceso sin conexión que no caducan según un cronograma, por lo que la conexión permanece activa sin una pantalla de nuevo consentimiento. Shopify ha anunciado cambios en el comportamiento de los tokens fuera de línea para aplicaciones públicas a partir del 1 de enero de 2027, y FarmHub seguirá esa guía cuando llegue. El token se almacena cifrado y puedes revocar la conexión desde cualquier lado en cualquier momento.
¿Cómo mantienen los webhooks confiables?
Se verifica la firma de cada webhook como genuino de Shopify antes de que FarmHub importe algo. Las publicaciones no verificadas se rechazan.
LISTO PARA EL PRÓXIMO TURNO
Que la tienda y el registro de la granja estén de acuerdo
Conecta tu tienda Shopify y cada pedido en línea se archiva en el registro de la granja al que pertenece. Creces, la tienda vende, el récord se mantiene.
Empieza gratis