Sign in

v1

latestOpenAPI 3.1.0Proprietary2026-07-22134294785.0 KB
API

Crear compra

Registra una compra y devuelve la operación creada junto con sus efectos de stock y contabilidad.

post/api/v1/purchases

Headers

Idempotency-Keystring required

Clave única para evitar duplicados al reintentar la misma creación de compra.

X-Request-Idstring

ID opcional de la solicitud para trazabilidad. Si se omite, el servidor genera uno.

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_id'days_7' | 'days_15' | 'days_30' | 'days_45' | 'days_60' | 'days_90' | 'days_30_60' | 'days_30_60_90'
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'
status'draft' | 'confirmed'

Response

Compra creada exitosamente

request_idstring required