Conecta WooCommerce y vincula cada pedido con su visita

01Conectar con un clic

1. 1

   En la página Integrations de tu sitio, abre WooCommerce. En Connect in one click, escribe la dirección de tu tienda y pulsa Approve in WooCommerce.

2. 2

   Tally indica qué se le dará: lee tus pedidos y reembolsos, añade dos webhooks y nunca cambia un pedido. Pulsa Continue to WooCommerce.

3. 3

   WooCommerce se abre en tu tienda y dice Tally would like to connect to your store. Inicia sesión si te lo pide (como administrador o gestor de la tienda) y pulsa Approve.

4. 4

   Vuelves a Integrations: WooCommerce is connected, y se están importando los últimos 365 días.

Con el plugin de WordPress en tu tienda, su botón Connect WooCommerce to Tally inicia la misma aprobación.

02O conecta con una clave de la API REST

1. 1

   Crea una clave de la API REST en WooCommerce

   Tally solo lee tus pedidos y reembolsos; lo único que escribe son sus dos webhooks propios. En el administrador de WordPress, abre WooCommerce › Settings › Advanced › REST API y elige Add key: elige tu usuario, pon Permissions en Read/Write y genera la clave (guía de WooCommerce). Esto es todo lo que Tally hace con ella:

   Permiso	Acceso	Por qué
   Orders	Lectura	Cada pedido pagado: su importe e impuestos, y el email del cliente (convertido en hash al instante, nunca guardado). Nunca se guardan nombres ni direcciones.
   Refunds	Lectura	Cuándo ocurrió cada reembolso y cuántos impuestos devolvió.
   Webhooks	Escritura	Tally añade sus dos webhooks propios (pedido creado, pedido actualizado), para que las ventas lleguen en segundos. No escribe nada más.

   Read/Write solo sirve para añadir los webhooks: Tally nunca cambia un pedido. Revoca la clave en el mismo lugar cuando quieras.

2. 2

   Pega la clave de la API REST

   En la página Integrations de tu sitio (o en el paso Payments al añadir un sitio), abre WooCommerce y rellena:

   • Store address: tal como aparece en el navegador. WooCommerce solo acepta claves por HTTPS.
   • Consumer key: se muestra una sola vez, junto con el secreto, al crear la clave. Tally guarda ambos cifrados y nunca vuelve a mostrarlos.
   • Consumer secret: empieza por cs_.

   Después pulsa Connect WooCommerce.

3. 3

   Tally lo comprueba e importa el último año

   Comprueba la clave contra tu tienda, añade sus dos webhooks propios para que los pedidos nuevos lleguen en cuanto ocurren e importa los últimos 365 días, reembolsos incluidos. Cada 30 minutos también lee los pedidos que cambiaron, así que una entrega que WooCommerce no pudo hacer nunca se pierde. Con el snippet de Tally en la tienda, la página de pedido recibido vincula cada pedido con la visita de su comprador.

03Qué lee y guarda Tally

• Dos webhooks, order.created y order.updated (que también se dispara con los reembolsos), traen los pedidos nuevos en segundos. Cada 30 minutos, Tally también lee los pedidos que cambiaron y vuelve a activar un webhook desactivado: WooCommerce nunca reintenta una entrega, y desactiva un webhook tras cinco fallos seguidos.
• Un pedido es una venta en cuanto está pagado: en estado procesando, completado o reembolsado, o con fecha de pago. Los pedidos pendientes, en espera y fallidos no son ventas. Su importe es el total menos impuestos, en la moneda del pedido; cada reembolso cuenta en su propia fecha.
• Lo que se guarda de un pedido: importes, fechas, estado, los ID de los reembolsos, el ID del visitante y hashes de la clave del pedido y del email de facturación. Nunca se guardan nombres, direcciones, teléfonos, direcciones IP ni artículos.
• Los pedidos de renovación de WooCommerce Subscriptions son pedidos como cualquier otro: cada uno es una venta, vinculada por su propia evidencia.

04Vincula cada pedido con su visita

Pon el snippet en cada página de la tienda, incluida la de pedido recibido (el header de tu tema, o un plugin que añada código al head de cada página). Cuando un comprador llega a esa página, el pedido se vincula con su visita, sin nada más que añadir a WooCommerce. Funciona en todos los modos, incluido el modo sin cookies.

<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>

Para los compradores que nunca llegan a esa página (con una pasarela que no los devuelve), guarda el ID del visitante en el pedido durante el checkout. Estas líneas funcionan con el checkout clásico y con el de bloques:

// 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' );

05Desconectar

Desconecta en la página Integrations: Tally quita sus webhooks de la tienda, y los pedidos ya importados se quedan, con sus comprobantes. No puede borrar por sí mismo la clave de la API REST, así que revócala en WooCommerce › Settings › Advanced › REST API.

06Comprueba que funciona

07Lo que no se lee