Ventas
Cada toque en la mesa del mercado se convierte en un récord agrícola.
Termina el sábado. El lector de Square dice que usted recibió $1,840. ¿Pero qué cultivos se venden? ¿Qué lotes abandonaron la finca? ¿Qué ganó realmente ese dinero? El lector conoce el total y nada más que sus registros necesitan. Entonces, las ventas se guardan en Square, las cosechas se guardan en el registro de su granja y la conexión entre ellas es una persona cansada con una hoja de cálculo el domingo.
Vender a través de Square y registrar en un sistema agrícola solía significar hacer el mismo día de trabajo dos veces. El segundo paso es el que se omite, y una vez que se omite, sus cifras de rentabilidad y su cadena de trazabilidad tienen un agujero.
Cómo funciona realmente
FarmHub importa desde Square. Las ventas fluyen entrantes, desde su lector hasta los registros de su granja, sin una exportación manual en el medio.
- Los webhooks son la señal principal. Cuando un pedido se liquida en Square, Square 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. Minutos, no domingos.
- Un barrido de conciliación detiene los webhooks perdidos. Los webhooks pueden desaparecer en la red de cualquier persona. FarmHub busca periódicamente sus pedidos de Square e importa todo lo que los webhooks omitieron, para que un mensaje caído no se convierta en un agujero en sus libros.
- Tú eliges la ubicación. Durante la configuración, usted elige qué ubicación de Square se importa a FarmHub. Un puesto agrícola y una empresa fuera de la granja pueden permanecer separados.
- Los reembolsos se realizan como reembolsos. Los reembolsos de Square se importan como registros de ventas con montos negativos, por lo que su historial de ingresos refleja lo que realmente sucedió, no solo la mitad optimista.
- El dinero se mantiene exacto. Las cantidades se mueven como valores enteros de unidades menores propios de Square (centavos para USD, unidades enteras para monedas con cero decimales como JPY) con la moneda adjunta, nunca en punto flotante. Lo que Square cobró es lo que registra FarmHub.
Una vez que las ventas llegan a FarmHub, se unen al resto de su operación: acumulaciones de costos por cosecha, informes de rentabilidad y, si también conecta QuickBooks o Xero, los asientos contables posteriores.
EN QUÉ PUEDES CONTAR
En qué puedes contar
La mecánica en la que confías:
- Conexión OAuth2, credenciales cifradas. Usted autoriza a través de la propia pantalla de Square con alcances de lectura para pedidos, pagos y perfil de comerciante. Los tokens se almacenan cifrados por conexión y FarmHub los actualiza automáticamente antes de que caduquen.
- Webhooks con firma verificada. Se verifica criptográficamente que los eventos entrantes provienen de Square antes de que FarmHub importe algo. Las publicaciones falsificadas no se convierten en registros de ventas.
- Importaciones idempotentes. Un pedido que llega dos veces, una por webhook y otra por barrido de conciliación, se convierte en un registro de ventas, no en dos.
- Desconexión y seguimiento de auditoría. Puede desactivar la conexión al instante y la actividad de importación se registra en filas de auditoría encadenadas mediante hash.
Lo que no hacemos
Lo que no hace esta integración:
- FarmHub no envía nada a Square. No crea artículos, no cambia precios ni toca su catálogo. El flujo es solo de importación.
- FarmHub no procesa pagos. Square sigue siendo su procesador y su terminal.
- FarmHub no fusiona ubicaciones. Cada conexión se importa desde la ubicación que eligió.
Configuración, honestamente
Necesita una cuenta de Square con al menos una ubicación.
- En FarmHub, abra Integraciones y elija Square.
- Autorizar a través de la pantalla OAuth de Square. FarmHub solicita acceso de lectura a pedidos, pagos y su perfil de comerciante.
- Elija la ubicación de Square desde donde importar.
- Realice una venta de prueba o espere la siguiente venta real y observe cómo llega como un récord de ventas de FarmHub.
Preguntas que hacen los agricultores
¿Qué tan rápido aparecen las ventas de Square en FarmHub?
Square envía un webhook cuando se crea o actualiza un pedido, y FarmHub lo importa a su llegada después de verificar la firma. Si se omite un webhook, un barrido de conciliación periódico detecta el pedido más tarde.
¿Se importan los reembolsos?
Sí. Los reembolsos de Square son eventos separados y FarmHub los importa como registros de ventas de cantidades negativas para que los ingresos reflejen la realidad.
¿Se puede importar dos veces el mismo pedido?
No. Las importaciones son idempotentes. Un pedido que llega mediante webhook y barrido de conciliación se resuelve en un único registro de ventas.
¿FarmHub cambia algo en mi cuenta de Square?
No. La integración es solo entrante, con alcances de lectura. FarmHub nunca escribe en su catálogo, precios o transacciones de Square.
¿Qué pasa si vendo en varias ubicaciones?
Cada conexión importa desde una ubicación de Square que usted elige en la configuración, para que pueda controlar exactamente qué ventas ingresan al registro de la granja.
LISTO PARA EL PRÓXIMO TURNO
Cerrar la brecha entre el lector y el registro
Conecte Square y deje que las ventas del sábado se registren solas, coincidiendo con los cultivos y lotes que las generaron. El domingo recupera su tarde.
Empieza gratis