VHSYS integration

VHSYS is TecPet’s most complete fiscal integration — two-way: what happens in TecPet (customers, appointments, sales, receipts) is reflected in VHSYS, and what happens in VHSYS (records, write-downs, cancellations) comes back to TecPet. In practice, you operate only in TecPet and the fiscal/financial side stays in sync across both systems on its own.

Customers (synced both ways)

The customer record is kept identical in both systems:

Creating a customer in TecPet creates it in VHSYS;
Editing updates the data in VHSYS;
Removing sends the customer to the VHSYS trash;
Works for individuals (Tax ID) and companies (company Tax ID).

If a customer with the same Tax ID already exists in VHSYS, TecPet links to the existing one instead of duplicating (even if you have two TecPet records with the same document). And the reverse path also works: creating/editing a customer in VHSYS reflects in TecPet.

Services become a Service Order (OS)

Each appointment automatically generates, in VHSYS, a Service Order (OS) with the services and installments, plus a receivable. The OS has two main states:

Open (Em Aberto) — not paid yet;
Served (Atendido) — paid/completed.

If you add or remove services on the appointment, the OS and the receivable are updated with the new values right away.

Products become a Sales Order (PV) and reduce stock

When the invoice includes products, the integration creates a Sales Order (PV) in VHSYS (separate from the services OS). On payment, the integration reduces the product’s stock in VHSYS. Internal-use supplies (products consumed during the service) also reduce stock, but do not appear as a service line on the OS.

Payments

Payment can be registered in two ways, and both update VHSYS:

POS (counter sale) — settles the OS;
Receivables — writes down the receivable.

When paid 100%, the OS becomes Served and the receivable is written down. Partial payments keep the OS Open with the exact paid/open amounts until settled. Discounts and surcharges/interest applied at receipt are also reflected. There’s also a manual write-down straight from the calendar.

Reversal (cancelling a payment)

If a payment is cancelled, the integration reverses everything:

From TecPet — by cancelling the invoice’s payments;
From VHSYS — by deleting the receipt there.

The result is the same: the invoice goes back to unpaid, and a new Open OS and a new receivable are generated. Reversal even works with split payments (e.g. part Pix, part card) — deleting one of them does a partial reversal.

Invoice (NFS-e)

The integration handles the NFS-e (Service Invoice): it creates the invoice from the OS and lets you update and issue it. So the invoice comes out from the same visit, with no retyping in VHSYS.

When something fails

The most common reasons are a divergent customer record (invalid Tax ID, duplicate or invalid phone, missing required data) and, for products, insufficient stock. The invoice shows the sync state in the Service Order column (see What changes with the integration on). Fix the record and reprocess; if it persists, contact support.

How to enable it

The VHSYS connection is set up by the TecPet team with your credentials. Contact support to enable it.