---
title: "Actualizar metadatos de venta"
method: PATCH
path: "/api/v1/sales/{sale_id}"
tags: ["API"]
---

# Actualizar metadatos de venta

`PATCH /api/v1/sales/{sale_id}`

Actualiza solo metadatos operativos de una venta: notas, referencia de integracion externa y vendedor. No permite modificar items, importes, pagos ni datos fiscales.

## Path parameters

- `sale_id` string, uuid, required

## Request body

- ApiSaleMetadataPatchRequest — Actualizacion parcial de metadatos operativos de venta. Envia al menos un campo. integration_source e integration_id deben enviarse juntos; para limpiar la referencia externa, envia ambos en null.
  - `notes` string, nullable — Notas operativas de la venta. Enviar null o string vacio para limpiar.
  - `integration_source` string, nullable — Fuente de integracion externa. Debe enviarse junto con integrationId.
  - `integration_id` string, nullable — ID de referencia externa. Debe enviarse junto con integrationSource.
  - `salesperson_id` string, uuid — ID del miembro/vendedor que debe quedar asociado a la venta.

## Response `200`

Venta actualizada exitosamente

- ApiSaleDetailResponse
  - `request_id` string, required
  - `data` object, required
    - `object` 'sale'
    - `id` string, uuid
    - `accounting` ApiSharedObject799d3e3f37
      - `object` 'accounting_evidence', required
      - `status` 'not_enabled' | 'not_applicable' | 'pending' | 'posted' | 'failed', required
      - `journal_entry_ids` string[], required
      - `journal_entries_url` string, nullable, required
      - `warnings` ApiSharedObject76de9df039[], required
        - `code` string, required
        - `message` string, required
    - `document` ApiSharedObject44d94dc68b
      - `file` ApiSharedObject890679c3fd, required — Document availability. The URL requires bearer authentication and never contains a storage path or signed query string.
        - `status` 'ready' | 'pending' | 'failed' | 'missing', required
        - `url` string, nullable, required — Stable authenticated La Pyme API path. Present only when status is ready; follow redirects when downloading.
    - `customer` object, nullable
    - `amounts` object
    - `items` object[]
    - `payments` object
    - `applications` object
    - `fiscal` object
    - `integration` object
    - `reverses_voucher` object, nullable
    - `audit` object

## Other responses

- `400` — Payload invalido o metadatos no permitidos
- `401` — API key faltante o invalida
- `403` — Scopes insuficientes
- `404` — Venta no encontrada
- `409` — La referencia de integracion ya esta asociada a otra venta
- `429` — Límite de solicitudes excedido para la organización
- `500` — Error interno del servidor

---

[API](https://skmtc.net/lapyme/apis/la-pyme-api.md) · [All operations](https://skmtc.net/lapyme/apis/la-pyme-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lapyme/la-pyme-api/versions/414f57f28498/schema)