Skip to main content
POST

Authorizations

Authorization
string
header
required

Incluí tu API key en el header Authorization con el prefijo Bearer.

Headers

Lapyme-Version
enum<string>

Versión fechada del contrato de creación de ventas. Usá 2026-08-20 en integraciones nuevas. Omitirla conserva el contrato de entrada histórico deprecado; ambos contratos calculan el IVA una sola vez.

Available options:
2026-08-20
Idempotency-Key
string
required

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

Required string length: 1 - 255
X-Request-Id
string

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

Required string length: 1 - 255

Body

application/json

Crea una venta. El tipo de comprobante define cómo se lee items[].unitPrice: neto sin IVA para comprobantes A (1, 2 y 3) y final con IVA incluido para comprobantes a consumidor final como B (6, 7 y 8). total se compara con el total canónico y la venta se rechaza si no coinciden.

voucher_type
required
Required range: 1 <= x <= 95
point_of_sale_id
string<uuid>
required
invoice_date
string<date>
required
currency
enum<string>
required
Available options:
ARS,
USD
items
object[]
required
Minimum array length: 1
total
integer
required

Total final esperado en centavos. La API lo compara con el total canónico antes de crear la venta o cualquier efecto durable.

Required range: x >= 0
customer_id
string<uuid>
customer_tax_category_override
string
Required string length: 1 - 120
register_id
string<uuid>
operator_id
string<uuid>
integration_source
string

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

Required string length: 1 - 120
integration_id
string

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

Required string length: 1 - 255
due_date
string<date>
service_from
string<date>
service_to
string<date>
exchange_rate
number
same_currency_payment
boolean
notes
string
Maximum string length: 1000
discount_type
enum<string>
Available options:
percentage,
amount
discount_value
number
Required range: x >= 0
national_perception_amount
integer
Required range: x >= 0
gross_income_perception_amount
integer
Required range: x >= 0
gross_income_tax_breakdown
object[]
municipal_perception_amount
integer
Required range: x >= 0
internal_tribute_amount
integer
Required range: x >= 0
uncategorized_vat_perception_amount
integer
Required range: x >= 0
other_tribute_amount
integer
Required range: x >= 0
payment_methods
object[]
is_full_amount_pending
boolean

Response

Venta creada exitosamente

request_id
string
required
data
object
required
warnings
object[]
required