v1

latestOpenAPI 3.1.0Proprietary2026-07-22134294785.0 KB

API

Crear venta

Registra una venta y devuelve la operación creada junto con sus efectos fiscales, de stock, pagos y contabilidad. Idempotency-Key solo protege reintentos; si necesitás guardar una referencia externa visible, enviá integration_source e integration_id en el cuerpo.

post/api/v1/sales

Headers

Idempotency-Keystring required

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

X-Request-Idstring

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

Request body

customer_idstring uuid

customer_tax_category_overridestring

point_of_sale_idstring uuid required

register_idstring uuid

operator_idstring uuid

integration_sourcestring

Fuente de integracion externa para buscar/conciliar la venta. Debe enviarse junto con integrationId.

integration_idstring

ID de referencia externa visible en la venta. Debe enviarse junto con integrationSource; no se deriva del header Idempotency-Key.

invoice_datestring date required

due_datestring date

service_fromstring date

service_tostring date

currency'PES' | 'DOL' required

exchange_ratenumber

same_currency_paymentboolean

notesstring

discount_type'percentage' | 'amount'

discount_valuenumber

discount_amountinteger

subtotalinteger

tax_amountinteger

totalinteger

exempt_amountinteger

non_taxed_amountinteger

tributes_amountinteger

national_perception_amountinteger

gross_income_perception_amountinteger

municipal_perception_amountinteger

internal_tribute_amountinteger

uncategorized_vat_perception_amountinteger

other_tribute_amountinteger

is_full_amount_pendingboolean

Response

Venta creada exitosamente

request_idstring required