Skip to main content
POST
Crear venta (v2)

Authorizations

X-API-Key
string
header
required

API Key de la integración (Integraciones → Nueva Integración).

Body

application/json
branch_id
string<uuid>
required

Sucursal emisora (GET /branches).

customer_id
string<uuid>
required

Cliente receptor.

document_type
enum<string>
required

SV: fc, ccf, fex, nc, nd, nr. US: inv, cm, dm.

Available options:
fc,
ccf,
fex,
nc,
nd,
nr,
inv,
cm,
dm
payment_details
object[]
required
products
object[]
required
totals
object
required
date
string

Fecha y hora ISO 8601. Por defecto, ahora.

observation
string

Observaciones.

is_credit
boolean

Venta al crédito.

credit_days
integer

Días de crédito.

project_id
string<uuid>

Proyecto asociado.

point_of_sale_id
string<uuid>

Punto de venta emisor (de la sucursal y activo). Por defecto, el predeterminado de la sucursal.

cost_center_id
string<uuid>

Centro de costo de la venta (hoja y activo; GET /accounting/cost-centers). Va a las líneas de ingreso al contabilizar.

incoterm_id
string<uuid>

Incoterm (exportación).

cost_center_distribution_id
string<uuid> | null

Distribución activa (GET /accounting/cost-center-distributions): el ingreso se reparte entre sus centros por porcentaje. Excluyente con cost_center_id en el mismo nivel (422 Indique centro de costo o distribución, no ambos.).

currency_code
string

Moneda del documento (3 letras, por ejemplo GTQ). Debe estar activa para el negocio (GET /v2/currencies). Si se omite o es la moneda base, el documento es en moneda base. Todos los montos van en esta moneda.

Required string length: 3
exchange_rate
number

Unidades de moneda base por 1 unidad de currency_code. Si se omite, se usa la tasa vigente a la fecha del documento.

Required range: x > 0

Response

Documento emitido