Skip to main content
POST
Registrar compra (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.

provider_id
string<uuid>
required

Proveedor.

document_type
enum<string>
required

Tipo de documento.

Available options:
ccf,
fse,
ticket
date
string<date>
required

Fecha.

is_credit
boolean
required

Al crédito.

products
object[]
required
totals
object
required
credit_days
integer

Días de crédito.

observation
string

Observaciones.

number_control
string

Número de control del DTE.

generation_code
string

Código de generación.

stamp
string

Sello.

cost_center_id
string<uuid>

Centro de costo de la compra (hoja y activo; GET /accounting/cost-centers).

cost_center_distribution_id
string<uuid> | null

Distribución activa: el gasto 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

Compra registrada