Skip to main content
POST
Crear nueva factura en estado DRAFT

Authorizations

Authorization
string
header
required

Token de sesión Better Auth para rutas de backoffice; las rutas de portal usan su token propio.

Body

application/json
type
enum<string>
required

Tipo de factura

Available options:
MANUAL,
MENSUAL
receiver_name
string
required

Nombre del receptor

issue_date
string
required

Fecha de emisión (YYYY-MM-DD)

due_date
string
required

Fecha de vencimiento (YYYY-MM-DD)

receiver_rut
string

RUT del receptor

receiver_address
string

Dirección del receptor

receiver_ciudad
string

Ciudad del receptor

receiver_comuna
string

Comuna del receptor

receiver_giro
string

Giro del receptor

payment_terms_days
number
default:10

Días de plazo de pago

concept
string

Concepto / descripción general

internal_notes
string

Notas internas

public_notes
string

Notas públicas

dte_type
string

Tipo de documento DTE: FACTURA o BOLETA

references
object[]

Referencias de la factura

client_id
string

UUID del cliente

billing_client_id
string

UUID de la empresa legal receptora. Debe pertenecer a la misma jerarquía que el origen.

receiver_email
string

Email del receptor

periodo
string

Período (YYYY-MM) para facturas mensuales

uf_value_at_creation
number

Valor UF al momento de creación

line_items
object[]

Líneas de la factura

Response

201 - application/json
id
string
required
type
string
required
status
string
required
receiver_name
string
required
issue_date
string<date-time>
required
due_date
string<date-time>
required
subtotal
number
required
discount_total
number
required
net_amount
number
required
tax_rate
number
required
tax_amount
number
required
total_amount
number
required
amount_paid
number
required
client_credit_balance
number
required

Saldo a favor disponible del cliente desde sobrepagos de otras facturas

payment_terms_days
number
required
invoice_type
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
client_id
object
receiver_rut
object
receiver_email
object
receiver_address
object
receiver_ciudad
object
receiver_comuna
object
receiver_giro
object
tax_amount_override
object
total_amount_override
object
uf_value_at_creation
object
folio_prefix
object
folio_number
object
internal_notes
object
public_notes
object
concept
object
periodo
object
credit_note_for_id
object
credit_note_reason
object
factura_id
object
parent_client_id
object
billing_client_id
object
oc_number
object
hes_number
object
requires_oc
boolean
requires_hes
boolean
detail_xlsx_url
object
last_dte_error
object
dte_retry_count
number
dte_local_status
object

local_status del DTE más reciente (estado del XML ante el SII)

sii_status_detail
object

Detalle libre devuelto por el SII para el DTE más reciente

created_by
object
deleted_at
object