---
title: "Update Ponto Venda"
method: PUT
path: "/api/pontos-venda/{pv_id}"
tags: ["pontos-venda-protected"]
---

# Update Ponto Venda

`PUT /api/pontos-venda/{pv_id}`

Update an existing point of sale (protected endpoint).

Performs multi-table updates:
- Updates PV record
- Updates addresses if needed
- Updates emails if needed
- Updates invoice series
- Logs audit trail

Requires: Authentication
Returns: Updated PV object

## Path parameters

- `pv_id` integer, required

## Headers

- `x-api-token` string, nullable

## Request body

- PontoVendaUpdate — Update PV request - all fields optional.
  - `Nome` string, nullable
  - `NomeComercial` string, nullable
  - `DESIGANCAO` string, nullable
  - `Contacto` string, nullable
  - `NIPC` string, nullable
  - `NIF` string, nullable
  - `MORADASEDE` string, nullable
  - `CODPOSTSEDE` string, nullable
  - `LOCALIDADESEDE` string, nullable
  - `MORADA` string, nullable
  - `CODPOST` string, nullable
  - `LOCALIDADE` string, nullable
  - `EMAIL` string, nullable
  - `EMAILFINANCEIRO` string, nullable
  - `NOMESOC` string, nullable
  - `CC` string, nullable
  - `VALIDADECC` string, nullable
  - `BANCO` string, nullable
  - `IBANPRINCIPAL` string, nullable
  - `SWIFT` string, nullable
  - `TokenEasyData` string, nullable
  - `IDeasydata` string, nullable
  - `PassApp` string, nullable
  - `Serie` string, nullable
  - `Scuts` boolean, nullable
  - `CRM` boolean, nullable
  - `LogoURL` string, nullable

## Response `200`

Successful Response

- PontoVendaResponse — PV response model with database-generated fields.
  - `Nome` string, nullable — Point of sale name
  - `NomeComercial` string, nullable — Commercial name
  - `DESIGANCAO` string, nullable — Business name/Designation
  - `Contacto` string, nullable — Contact phone
  - `NIPC` string, nullable — Tax ID for HQ
  - `NIF` string, nullable — Partner tax ID
  - `MORADASEDE` string, nullable — HQ address
  - `CODPOSTSEDE` string, nullable — HQ postal code
  - `LOCALIDADESEDE` string, nullable — HQ city
  - `MORADA` string, nullable — Contact address
  - `CODPOST` string, nullable — Contact postal code
  - `LOCALIDADE` string, nullable — Contact city
  - `EMAIL` string, nullable — Primary email address
  - `EMAILFINANCEIRO` string, nullable — Financial email address
  - `NOMESOC` string, nullable — Partner/Shareholder name
  - `CC` string, nullable — ID card number
  - `VALIDADECC` string, nullable — ID card validity date
  - `BANCO` string, nullable — Bank name
  - `IBANPRINCIPAL` string, nullable — Primary IBAN
  - `SWIFT` string, nullable — SWIFT code
  - `TokenEasyData` string, nullable — EasyData API token
  - `IDeasydata` string, nullable — EasyData ID
  - `PassApp` string, nullable — App password
  - `Serie` string, nullable — Invoice series code
  - `Scuts` boolean, nullable — Highway tolls enabled
  - `CRM` boolean, nullable — CRM enabled
  - `LogoURL` string, nullable — Logo URL
  - `ID` integer, required — Point of sale ID
  - `IDempresa` integer, nullable — Company ID
  - `credit_balance_cents` integer — Credit balance in cents
  - `last_billed_at` string, date-time, nullable — Last billing date
  - `PASSEMAIL` string, nullable — Email password
  - `IDezdata` number, nullable — EZData ID
  - `Foto` string, nullable — Photo URL
  - `addresses` EnderecoResponse[], nullable
    - `morada` string, nullable — Street address
    - `codigopostal` string, nullable — Postal code
    - `localidade` string, nullable — City
    - `cidade` string, nullable — City (alternative)
    - `pais` string, nullable — Country
    - `principal` boolean, nullable — Is this the primary address
    - `ID` integer, required — Address ID
  - `emails` EmailResponse[], nullable
    - `email` string, nullable — Email address
    - `tipoemail` integer, nullable — Email type (3=PV main, 4=Financial)
    - `principal` boolean, nullable — Is this the primary email
    - `ID` integer, required — Email ID
    - `tipo_email` string, nullable — Human-readable email type

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)