Pedidos y reembolsos de Squarespace, cada uno vinculado a la visita del comprador.

01Lo que lee Tally

• Cada pedido pagado, con la fecha en que se hizo, contado por su total menos impuestos: el envío se queda dentro, los descuentos ya están restados y el importe se lee al centavo en la moneda de la tienda.
• Cada reembolso en el día en que ocurrió, a partir de las transacciones del pedido, con su parte proporcional de los impuestos del pedido, ya que Squarespace no registra ninguno en un reembolso.
• Los últimos 365 días en cuanto conectas y, después, cada pedido nuevo en segundos mediante una suscripción de webhook, cuando la tienda se conecta con un clic.
• Una sincronización que lee cada pedido modificado desde la última vez: cada 30 minutos para una conexión con un clic y cada 10 para una clave de API, que no recibe notificaciones.
• Solo lo que necesitan las cifras: importes, fechas, estado del pago y hashes del email del cliente y del número de pedido. Nunca se guardan nombres, direcciones, teléfonos, artículos, respuestas de formularios ni notas.

02Cómo encuentra una venta su visita

• Página de estado del pedidoLas líneas de Tally en los campos Order Status Page y Order Confirmation Page de Code Injection envían el número de pedido cuando el comprador llega allí tras el checkout. Se convierte en hash al llegar y se coteja con el pedido. Confianza alta.
• EmailSin esas líneas, el email del cliente en el pedido, convertido en hash en cuanto se lee, vincula la venta cuando tu sitio llamó a tally('identify') con esa dirección. Confianza media.
• ReembolsosUn reembolso toma el vínculo del pedido de Squarespace cuyo dinero devuelve.

03Lo que no puede leer

04Cómo conectarlo

1. En la página Integrations de tu sitio, abre Squarespace y elige Connect with Squarespace y luego Continue to Squarespace. Inicia sesión como propietario del sitio o como administrador, elige el sitio y pulsa Allow en la página de confirmación de Squarespace.
2. La página de confirmación pide leer pedidos y transacciones con acceso offline, para que Tally siga leyendo entre tus visitas. Llegan los últimos 365 días, y una suscripción de webhook trae cada pedido a partir de entonces.
3. O crea una clave de API: en Squarespace, Settings, Developer Tools, Developer API Keys, con Orders y Transactions en solo lectura, y pégala en el mismo panel.
4. En Squarespace, abre Pages, Custom Code, Code Injection. Pega el snippet en Header, y las líneas de estado del pedido de abajo en los dos campos, Order Status Page y Order Confirmation Page.
5. Compruébalo desde una ventana privada, sin sesión iniciada: a un propietario con sesión iniciada se le envía al editor y nunca ve la tienda como un visitante.

Lo que necesita la clave de API

Tally pide una clave de API que solo pueda hacer esto y comprueba cada permiso con una llamada real al pegarla, así que se nombra el que falte:

Cómo crearla: la guía de Squarespace.

Las líneas del estado del pedido (los campos Order Status Page y Order Confirmation Page)

{.if firstPageView}
<script>
  window.tally = window.tally || function () { (tally.q = tally.q || []).push(arguments); };
  String('{orderId}').split(/[^0-9]+/).filter(Boolean).forEach(function (order) {
    tally('squarespace_order', { order: order });
  });
</script>
{.end}

05Preguntas

• ¿Tally cambia algo en mi tienda?

  No. Lee los pedidos y sus transacciones, y crea una suscripción de webhook para que le lleguen los pedidos nuevos; nunca cambia un pedido. El código en Code Injection solo cuenta visitas y envía el número de pedido desde la página de estado del pedido.

• ¿Por qué pegar las mismas líneas en dos campos de páginas de pedido?

  Squarespace envía a los compradores de productos físicos, descargas y servicios a su página de estado del pedido, y a los de tarjetas regalo, suscripciones y membresías a su página de confirmación del pedido. Con las líneas en ambas, cualquier tipo de pedido puede vincularse con su visita.

• ¿Conecto con un clic o con una clave de API?

  Con un clic si puedes. Squarespace solo da webhooks a las apps, así que una conexión con un clic ve cada pedido nuevo en segundos, mientras que los pedidos de una clave llegan cada 10 minutos. Ambas importan los últimos 365 días y vinculan los pedidos igual.

• ¿Se cuentan los pedidos de prueba?

  No. Un pedido hecho mientras el checkout del sitio está en modo de prueba no es una venta, así que queda fuera de los ingresos. El primer pedido vinculado que verás en Sales es real.

• ¿Cómo desconecto Tally de mi tienda?

  En el panel Extensions de Squarespace, en Connected extensions, o en la página Integrations de Tally; los pedidos ya importados se quedan, con sus comprobantes. Desconectarlo en Tally no lo quita de la lista de Squarespace, así que desconéctalo también allí.