# VHSYS integration

_Everything the two-way VHSYS integration does: customers (individual/company), service orders, sales orders, stock, payments, reversals and service invoices._

> **💡 Tip**
>
> The integration is **automatic in both directions**: you don't need to retype anything in VHSYS. Just work normally in TecPet (schedule, add a service, take payment) and the Service Order, the receivable and the invoice follow on their own.

**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](/en/operacao/clientes-e-pets/cadastrar-um-cliente/) 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](/en/configuracao/integracoes/o-que-muda-com-a-integracao/)). 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.

> **⚠️ Heads up**
>
> When an **invoice fails to issue** or the sync fails via VHSYS, the reason is almost always a **divergent customer record** (invalid Tax ID, duplicate phone, missing data). Fix the customer record in TecPet and reprocess the invoice.

## See also

- [What integrations are](/en/configuracao/integracoes/o-que-sao-integracoes/)
- [Bling integration](/en/configuracao/integracoes/integracao-bling/)
- [Inside the invoice](/en/operacao/financeiro/a-fatura-por-dentro/)

---
_feature: integracao-vhsys · atualizado em 2026-06-10 · fonte: https://help.tec.pet/en/configuracao/integracoes/integracao-vhsys/ — TecPet Central de Ajuda_