v1

latestOpenAPI 3.1.0Proprietary2026-07-22134294785.0 KB

API

Actualizar compra

Actualiza una compra existente y devuelve el detalle persistido. El campo items es requerido y reemplaza los renglones de la compra. Requiere Idempotency-Key.

put/api/v1/purchases/{purchase_id}

Path parameters

purchase_idstring uuid required

ID de la compra

Headers

Idempotency-Keystring required

Clave estable para deduplicar reintentos de la misma operación.

Request body

supplier_idstring uuid

voucher_typeinteger required

import_document_role'commercial_invoice' | 'customs_dispatch' | 'customs_dispatch_reversal'

import_source_purchase_idstring uuid

ID de la factura comercial asociada al despacho aduanero.

import_nationalization_status'pending_nationalization' | 'partially_nationalized' | 'fully_nationalized'

customs_dispatch_numberstring

Numero de despacho aduanero informado por el proveedor. Hasta 32 caracteres.

supplier_invoice_numberstring

Numero de comprobante del proveedor. Hasta 120 caracteres.

invoice_datestring date

Fecha del comprobante en formato YYYY-MM-DD.

account_datestring date

Fecha contable de la compra en formato YYYY-MM-DD.

due_datestring date

Fecha de vencimiento en formato YYYY-MM-DD.

payment_term_daysinteger nullable

Cantidad de días hasta el vencimiento. Usá 0 para Contado. Se prefiere sobre paymentTermId.

vat_perception_amountinteger

national_tax_amountinteger

gross_income_tax_amountinteger

municipal_tax_amountinteger

internal_tax_amountinteger

other_tax_amountinteger

warehouse_idstring uuid nullable

products_receivedboolean

update_product_variant_costboolean

subtotalinteger

tax_amountinteger

totalinteger

discountinteger

exempt_amountinteger

non_taxed_amountinteger

base_amountinteger

notesstring

currency'PES' | 'DOL' required

exchange_ratenumber

pdf_pathstring

vat_category'goods' | 'fixed_assets' | 'leases' | 'services'

Response

Compra actualizada exitosamente

request_idstring required