# Integração com a VHSYS

_Tudo que a integração bidirecional com a VHSYS faz: clientes (PF/PJ), ordens de serviço, pedidos de venda, estoque, pagamentos, estornos e NFS-e._

> **💡 Dica**
>
> A integração é **automática nos dois sentidos**: você não precisa redigitar nada na VHSYS. Trabalhe normalmente no TecPet (agendar, adicionar serviço, receber) que a Ordem de Serviço, a conta a receber e a nota acompanham sozinhas.

A **VHSYS** é a integração fiscal mais completa do TecPet — **bidirecional**: o que acontece no TecPet (clientes, agendamentos, vendas, recebimentos) é refletido na VHSYS, e o que acontece na VHSYS (cadastros, baixas, cancelamentos) volta para o TecPet. Na prática, você opera só no TecPet e a parte fiscal/financeira **se mantém igual** nos dois sistemas, sozinha.

## Clientes (sincronização nos dois sentidos)

O [cadastro de clientes](/operacao/clientes-e-pets/cadastrar-um-cliente/) é mantido igual nos dois sistemas:
- **Criar** um cliente no TecPet cria o cliente na VHSYS;
- **Editar** atualiza os dados na VHSYS;
- **Remover** envia o cliente para a **lixeira** da VHSYS;
- Funciona para **pessoa física (CPF)** e **pessoa jurídica (CNPJ)**.

Se já existir um cliente na VHSYS com o **mesmo CPF/CNPJ**, o TecPet **vincula ao existente** em vez de duplicar (mesmo que você tenha dois cadastros no TecPet com o mesmo documento). E o caminho de volta também vale: criar/editar um cliente **na VHSYS** reflete no TecPet.

## Serviços viram Ordem de Serviço (OS)

Cada **agendamento** gera automaticamente, na VHSYS, uma **Ordem de Serviço (OS)** com os serviços e as parcelas, além de uma **conta a receber**. A OS tem dois estados principais:
- **Em Aberto** — ainda não foi paga;
- **Atendido** — paga/concluída.

Se você **adicionar ou remover serviços** no agendamento, a OS e a conta a receber são **atualizadas** com os novos valores na hora.

## Produtos viram Pedido de Venda (PV) e baixam estoque

Quando a fatura inclui **produtos**, a integração cria um **Pedido de Venda (PV)** na VHSYS (separado da OS de serviços). Ao receber o pagamento, a integração faz a **baixa de estoque** do produto na VHSYS. **Insumos de uso interno** (produtos consumidos no atendimento) também baixam o estoque, mas **não** entram como item de serviço na OS.

## Pagamentos

O pagamento pode ser registrado de duas formas, e ambas atualizam a VHSYS:
- **PDV (venda de balcão)** — quita a OS;
- **Contas a Receber** — dá baixa na conta a receber.

Ao pagar **100%**, a OS vai para **Atendido** e a conta a receber é baixada. Pagamentos **parciais** mantêm a OS **Em Aberto** com o valor pago/em aberto certinho até a quitação. **Descontos** e **acréscimos/juros** aplicados no recebimento também são refletidos. Há ainda a **baixa manual** direto pela agenda.

## Estorno (cancelar um pagamento)

Se um pagamento for **cancelado**, a integração reverte tudo:
- **Pelo TecPet** — ao cancelar os pagamentos da fatura;
- **Pela VHSYS** — ao apagar o recebimento lá.

O resultado é o mesmo: a fatura volta a **não paga**, e uma **nova OS Em Aberto** e uma **nova conta a receber** são geradas. O estorno funciona até em pagamentos divididos (ex.: parte Pix, parte cartão) — apagar um deles faz a reversão parcial.

## Nota fiscal (NFS-e)

A integração cuida da **NFS-e (Nota Fiscal de Serviço)**: cria a nota a partir da OS e permite **atualizá-la** e **emiti-la**. Assim, a nota sai a partir do mesmo atendimento, sem você redigitar nada na VHSYS.

## Quando algo falha

Os motivos mais comuns são **cadastro divergente** do cliente (CPF/CNPJ inválido, telefone duplicado ou inválido, dados obrigatórios faltando) e, para produtos, **estoque insuficiente**. A fatura mostra o estado da sincronização na coluna **Ordem de Serviço** (veja [O que muda com a integração ativa](/configuracao/integracoes/o-que-muda-com-a-integracao/)). Acerte o cadastro e **reprocesse**; persistindo, fale com o suporte.

## Como ativar

A conexão com a VHSYS é configurada pela **equipe TecPet** com as suas credenciais. **Fale com o suporte** para ativar.

> **⚠️ Atenção**
>
> Quando uma **nota não emite** ou a sincronização falha pela VHSYS, o motivo quase sempre é **cadastro divergente** do cliente (CPF/CNPJ inválido, telefone duplicado, dados faltando). Corrija a ficha do cliente no TecPet e reprocesse a fatura.

## Veja também

- [O que são as integrações](/configuracao/integracoes/o-que-sao-integracoes/)
- [Integração com o Bling](/configuracao/integracoes/integracao-bling/)
- [A fatura por dentro](/operacao/financeiro/a-fatura-por-dentro/)

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