Emitir un documento
post /v1/facturacion/documentos
Emite un documento tributario: toma un folio del tipo pedido, lo timbra, lo firma y lo guarda. En el borde sólo se exigen emisor_id y tipo; el resto es el documento, que valida el motor.
Responde
201 con el documento emitido. Emitir no lo manda al SII: eso es POST …/envios.Con
Idempotency-Key, reintentar devuelve el mismo documento en vez de gastar otro folio.Para boletas (39, 41) usa
montos_brutos: true: el precio ya trae el IVA adentro.Autenticación
Requiere API key (sk_live_… · sk_test_…) en la cabecera
authorization: Bearer …. Ver autenticación.
Parámetros
| Nombre | En | Tipo | Descripción |
|---|---|---|---|
Idempotency-Key | header | string | Reintentar con la misma clave devuelve el run existente; no crea otro ni factura de nuevo. |
Cuerpo de la petición
emisor_id string obligatorio
tipo integer obligatorio
fecha_emision string
receptor object
rut string obligatorio
razon_social string obligatorio
giro string
direccion string
comuna string
detalle object[]
nombre string obligatorio
cantidad number obligatorio
precio_unitario number obligatorio
exento boolean
montos_brutos boolean
observaciones string
Respuesta 201
Documento emitido
id string obligatorio
emisor_id string obligatorio
tipo integer obligatorio
folio integer obligatorio
fecha_emision string obligatorio
rut_receptor string obligatorio
razon_social_receptor string obligatorio
neto integer obligatorio
exento integer obligatorio
iva integer obligatorio
total integer obligatorio
moneda string obligatorio
estado enum obligatorio
emitidoenviadoaceptadoaceptado_con_reparosrechazadoanulado
envio_id string | null obligatorio
created_at string obligatorio
Errores
| Código | Cuándo |
|---|---|
400 | Documento inválido |
409 | Sin folios disponibles o conflicto de idempotencia |
El cuerpo de cualquier error sigue la misma forma y su code viene de un
catálogo cerrado. Ver errores.