# Integración con VHSYS

_Todo lo que hace la integración bidireccional con VHSYS: clientes (PF/PJ), órdenes de servicio, pedidos de venta, stock, pagos, estornos y NFS-e._

> **💡 Consejo**
>
> La integración es **automática en ambos sentidos**: no necesitas reescribir nada en VHSYS. Trabaja normalmente en TecPet (agendar, agregar servicio, cobrar) y la Orden de Servicio, la cuenta por cobrar y la factura acompañan solas.

**VHSYS** es la integración fiscal más completa de TecPet — **bidireccional**: lo que pasa en TecPet (clientes, turnos, ventas, cobros) se refleja en VHSYS, y lo que pasa en VHSYS (registros, bajas, cancelaciones) vuelve a TecPet. En la práctica, operas solo en TecPet y la parte fiscal/financiera **se mantiene igual** en ambos sistemas, sola.

## Clientes (sincronizados en ambos sentidos)

El [registro de clientes](/es/operacao/clientes-e-pets/cadastrar-um-cliente/) se mantiene igual en ambos sistemas:
- **Crear** un cliente en TecPet lo crea en VHSYS;
- **Editar** actualiza los datos en VHSYS;
- **Eliminar** envía el cliente a la **papelera** de VHSYS;
- Funciona para **persona física (CPF)** y **persona jurídica (CNPJ)**.

Si ya existe un cliente en VHSYS con el **mismo CPF/CNPJ**, TecPet **lo vincula al existente** en vez de duplicar (aunque tengas dos registros en TecPet con el mismo documento). Y el camino de vuelta también vale: crear/editar un cliente **en VHSYS** se refleja en TecPet.

## Los servicios se vuelven Orden de Servicio (OS)

Cada **turno** genera automáticamente, en VHSYS, una **Orden de Servicio (OS)** con los servicios y las cuotas, además de una **cuenta por cobrar**. La OS tiene dos estados principales:
- **Abierta (Em Aberto)** — aún no pagada;
- **Atendida (Atendido)** — pagada/concluida.

Si **agregas o quitas servicios** en el turno, la OS y la cuenta por cobrar se **actualizan** con los nuevos valores al instante.

## Los productos se vuelven Pedido de Venta (PV) y bajan stock

Cuando la factura incluye **productos**, la integración crea un **Pedido de Venta (PV)** en VHSYS (separado de la OS de servicios). Al recibir el pago, la integración hace la **baja de stock** del producto en VHSYS. Los **insumos de uso interno** (productos consumidos en la atención) también bajan stock, pero **no** entran como ítem de servicio en la OS.

## Pagos

El pago puede registrarse de dos formas, y ambas actualizan VHSYS:
- **PDV (venta de mostrador)** — salda la OS;
- **Cuentas por Cobrar** — da de baja la cuenta por cobrar.

Al pagar **100%**, la OS pasa a **Atendida** y la cuenta por cobrar se da de baja. Los pagos **parciales** mantienen la OS **Abierta** con los montos pagado/abierto exactos hasta saldar. Los **descuentos** y **recargos/intereses** aplicados al cobro también se reflejan. También existe la **baja manual** directo desde la agenda.

## Estorno (cancelar un pago)

Si un pago se **cancela**, la integración revierte todo:
- **Desde TecPet** — al cancelar los pagos de la factura;
- **Desde VHSYS** — al borrar el cobro allí.

El resultado es el mismo: la factura vuelve a **no pagada**, y se generan una **nueva OS Abierta** y una **nueva cuenta por cobrar**. El estorno funciona incluso con pagos divididos (ej.: parte Pix, parte tarjeta) — borrar uno hace la reversión parcial.

## Factura (NFS-e)

La integración maneja la **NFS-e (Factura de Servicio)**: crea la factura a partir de la OS y permite **actualizarla** y **emitirla**. Así, la factura sale desde la misma atención, sin reescribir nada en VHSYS.

## Cuando algo falla

Los motivos más comunes son un **registro divergente** del cliente (CPF/CNPJ inválido, teléfono duplicado o inválido, datos obligatorios faltantes) y, para productos, **stock insuficiente**. La factura muestra el estado de la sincronización en la columna **Orden de Servicio** (mira [Qué cambia con la integración activa](/es/configuracao/integracoes/o-que-muda-com-a-integracao/)). Corrige el registro y **reprocesa**; si persiste, habla con el soporte.

## Cómo activarla

La conexión con VHSYS la configura el **equipo TecPet** con tus credenciales. **Habla con el soporte** para activarla.

> **⚠️ Atención**
>
> Cuando una **factura no emite** o la sincronización falla por VHSYS, el motivo casi siempre es un **registro divergente** del cliente (CPF/CNPJ inválido, teléfono duplicado, datos faltantes). Corrige la ficha del cliente en TecPet y reprocesa la factura.

## Ver también

- [Qué son las integraciones](/es/configuracao/integracoes/o-que-sao-integracoes/)
- [Integración con el Bling](/es/configuracao/integracoes/integracao-bling/)
- [La factura por dentro](/es/operacao/financeiro/a-fatura-por-dentro/)

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