# Focuslink documentation | WebKoding

How to install, licence and update Focuslink. Send WooCommerce orders to Teamleader Focus as invoices and deals, and get paid invoices back.

Source: https://webkodingtheme.com/docs/focuslink/

---

# Focuslink documentation

Send WooCommerce orders to Teamleader Focus as invoices and deals, and get paid invoices back.
Back to Focuslink — Teamleader WooCommerce Integration (Teamleader Focus) Open the demo

## Before you start

- •WordPress 6.5 or newer, WooCommerce 8.0 or newer, PHP 7.4 or newer
- •Your own Teamleader Focus account
- •An integration registered (free) in the Teamleader Marketplace build area — Focuslink shows the exact redirect URI to paste there
- •Tax rates set up in Teamleader that match the ones your shop charges
Runs on your own WordPress and talks to your own Teamleader Focus account, through an integration you register in the Teamleader Marketplace. Nothing routes through us.

## What it does not do

- —It is not made, endorsed or supported by Teamleader. It is an independent plugin that uses Teamleader Focus’s public API with your own account.
- —It does not include a Teamleader Focus account. You need your own, and an integration you register in the Teamleader Marketplace; Teamleader’s own plans and limits apply.
- —It syncs customers, invoices and deals. It does not sync products, stock or prices from Teamleader back into WooCommerce.
- —Paid invoices are the only thing that flows back: an invoice paid in Teamleader sets the order to Completed or Processing. Other changes made in Teamleader stay there.

## What is in the download

One installable WordPress plugin ZIP: the Teamleader Focus connection, customer and company sync, invoices, deals with quotations, the paid-invoice webhook, tax rate mapping, the background queue and the sync log. Documentation as HTML. GPL code, HPOS-compatible.
Data goes only to the Teamleader Focus API and Teamleader’s OAuth server, and only once you connect: customer names, email addresses, phone numbers, billing addresses, VAT numbers and order lines. The client secret and tokens are stored encrypted with a key derived from your WordPress salts.

## Connecting Teamleader Focus

Plugins → Add New → Upload Plugin, activate. WooCommerce must already be active. Go to WooCommerce → Focuslink and copy the redirect URI shown there.
In the Teamleader Marketplace, open Build, create an integration, paste the redirect URI and copy its client ID and client secret.
Paste them into Focuslink, save, and click “Connect to Teamleader Focus”. Then choose the department, check the tax rate mapping and your sync settings.

## What syncs, and when

When an order reaches one of the statuses you tick, the contact is found by email or created, a company is added for business buyers, and a draft invoice is created with the product lines, shipping, fees and discounts. You can book it straight away instead, and set the payment term.
Optionally each order also becomes a deal, in the phase you choose, with a quotation holding the order lines, and can be marked as won.
Tax rates with the same percentage are matched automatically. An order using a rate with no Teamleader match fails with that reason in the sync log, so nothing is invoiced at the wrong rate.

## Licence, updates and support

- One licence covers 1 WordPress site.
- 1 year of updates, from the date of purchase.
- 1 year of email support.
- Instant download + licence key by email
- 30-day money-back guarantee
Questions this page does not answer go to support@webkoding.com . If you bought from us and cannot find your licence key, look it up here .

## Common questions

### Do I need a Teamleader Focus account?

Yes. Focuslink connects your store to your own Teamleader Focus account, through an integration you register in the Teamleader Marketplace. The registration is free; Teamleader’s plans and limits apply to your account. Focuslink is not affiliated with Teamleader.

### Can the same order end up in Teamleader twice?

No. The Teamleader ids are stored on the order and each step is skipped once done. If a sync is interrupted after the invoice was created, the next run finds it by the order number instead of creating another one. Returning customers are matched by email, so contacts are not duplicated either.

### What about business customers and VAT numbers?

An order with a billing company or a VAT number creates or finds a company in Teamleader, links the contact to it and invoices the company. You tell Focuslink which order fields your checkout or VAT plugin stores the VAT number in.

### How are coupons and prices including tax handled?

Lines are always sent excluding tax. Coupon discounts become one negative line per tax rate, so the Teamleader total matches the WooCommerce total. Shipping and fees become lines too.

### What if Teamleader is down or the rate limit is hit?

Everything runs in the background on Action Scheduler. A failed job is retried after 1, 5 and 30 minutes, then 2 and 6 hours, and a rate limit waits until Teamleader’s reset time. After that it shows as Failed in the sync log with a Retry button.

### How does a paid invoice reach WooCommerce?

Focuslink registers a webhook in Teamleader for you. When an invoice is paid there, it reads the invoice back from Teamleader before touching the order — the webhook is never trusted on its own — and sets the order to Completed or Processing, whichever you chose.

### Can I sync orders from before I installed it?

Yes. Sync past orders sends orders from a date range through the same queue, with the same never-twice checks.

### Does it work with HPOS and the block checkout?

Yes. Order data is read and written only through WooCommerce’s order API.
