Pedidos y reembolsos de WooCommerce, cada uno vinculado a la visita que lo vendió.

01Lo que lee Tally

• Cada pedido pagado: en estado procesando, completado o reembolsado, o uno con fecha de pago que se canceló después. El contra reembolso cuenta desde «procesando»; los pedidos pendientes, en espera, fallidos y en borrador no son ventas.
• El total del pedido menos sus impuestos, con el envío y los cargos incluidos y los descuentos ya restados, leído con exactitud en la moneda del pedido y convertido a centavos de dólar estadounidense al tipo del Banco Central Europeo de su día.
• Cada reembolso en el momento en que se hizo, con el impuesto que devolvió: un reembolso por artículos lleva el suyo, y uno por importe devuelve la parte proporcional del pedido.
• Los últimos 365 días al conectar y, después, cada pedido en segundos mediante dos webhooks que añade Tally: pedido creado y pedido actualizado.
• Una sincronización cada 30 minutos que lee los pedidos modificados desde la anterior y reactiva un webhook desactivado, así que una entrega que nunca llegó no se pierde.
• Solo lo que necesitan las cifras: importes, fechas, estado, reembolsos y hashes de la clave del pedido y del email de facturación. Nunca se guardan nombres, direcciones, teléfonos ni artículos.

02Cómo encuentra una venta su visita

• Página de pedido recibidoCon el snippet de Tally en la tienda, la visita del comprador a la página de pedido recibido vincula el pedido con ese visitante: la clave del pedido que aparece en la dirección de la página se guarda solo como hash y se coteja con el pedido. Confianza alta, sin nada que añadir a WooCommerce.
• ID de visitante en el pedidoEl plugin de WordPress de Tally guarda el ID del visitante en el pedido durante el checkout, clásico o de bloques, así que también se vinculan los compradores que nunca llegan a esa página; sin el plugin, unas pocas líneas en functions.php hacen lo mismo. Confianza alta, en modo con cookie o tras el consentimiento.
• EmailEl email de facturación, convertido en hash al llegar, coincide con una llamada a tally('identify') en tu sitio. Confianza media.
• ReembolsosUn reembolso toma el vínculo del pedido cuyo dinero devuelve.

03Lo que no puede leer

04Cómo conectarlo

1. En la página Integrations de tu sitio, escribe la dirección de la tienda y elige Approve in WooCommerce, o usa el botón Connect WooCommerce to Tally del plugin de WordPress de Tally. La tienda pide a un administrador o gestor de la tienda que apruebe Tally y crea ella misma la clave.
2. O crea la clave a mano: en WordPress, abre WooCommerce, Settings, Advanced, REST API, elige Add key, pon Permissions en Read/Write y pega la consumer key y el consumer secret junto con la dirección de la tienda.
3. Read/Write es solo para los dos webhooks propios de Tally; nunca cambia un pedido. La clave se comprueba contra la tienda y luego llegan los últimos 365 días, reembolsos incluidos.
4. Instala el plugin de WordPress de Tally y pega tu Site ID: pone el snippet en cada página, también en la de pedido recibido, y guarda en el pedido el ID de visitante de cada comprador. O pega el snippet en el header de tu tema.
5. Sin el plugin, añade las líneas de functions.php de abajo para los compradores a los que una pasarela de pago nunca devuelve a la página de pedido recibido; la página Coverage también las da.

Lo que necesita la clave de la API REST

Tally pide una clave de la API REST 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 WooCommerce.

Sin el plugin: el ID del visitante guardado en el pedido (functions.php)

// Your theme's functions.php, or a code snippets plugin: saves the visitor's id on the
// order at checkout, for buyers who never reach the order-received page.
function tally_save_visitor_id( $order ) {
    $id = isset( $_COOKIE['_tally_vid'] ) ? $_COOKIE['_tally_vid'] : '';
    if ( preg_match( '/^[A-Za-z0-9_-]{8,64}$/', $id ) ) {
        $order->update_meta_data( 'tally_visitor_id', $id );
    }
}
add_action( 'woocommerce_checkout_create_order', 'tally_save_visitor_id' );
add_action( 'woocommerce_store_api_checkout_update_order_meta', 'tally_save_visitor_id' );

05Preguntas

• ¿Hay un plugin de WordPress?

  Sí, el plugin de WordPress de Tally. Pega tu Site ID y añade el snippet a cada página, deja fuera a los administradores con sesión iniciada, guarda el ID de visitante del comprador en cada pedido de WooCommerce durante el checkout, y su botón Connect WooCommerce to Tally abre la pantalla de aprobación de WooCommerce. Sustituye a las líneas de functions.php.

• ¿Puedo conectar sin copiar claves?

  Sí. Escribe la dirección de la tienda en la página Integrations y aprueba Tally en la propia pantalla de WooCommerce: la tienda crea una clave Read/Write y la entrega, y tú no copias nada. Revócala cuando quieras en WooCommerce, Settings, Advanced, REST API.

• ¿Y si falla la entrega de un webhook?

  WooCommerce no reintenta una entrega, y desactiva un webhook tras una serie de fallos. Cada 30 minutos, Tally lee los pedidos que cambiaron desde la última vez y reactiva un webhook desactivado, así que el pedido llega igualmente.

• ¿Funciona con el checkout de bloques?

  Sí. La página de pedido recibido es la misma tras ambos checkouts, y las líneas de functions.php guardan el ID del visitante tanto en el checkout clásico como en el de bloques; ambos se probaron en WooCommerce 11.2.

• Mi hosting elimina la cabecera Authorization. ¿Se conectará la tienda?

  Sí. Cuando una tienda responde como si no se hubiera enviado ninguna clave, Tally envía la clave como parámetros de consulta por HTTPS, como documenta WooCommerce, y a un sitio sin enlaces permanentes amigables se llega mediante ?rest_route=.