Changelog

/v1 evoluciona de forma aditiva: endpoints nuevos, campos opcionales nuevos, campos de respuesta nuevos, valores de enum nuevos, tipos de evento nuevos. Tu cliente debe ignorar lo que no reconoce. Un retiro o un cambio de comportamiento lleva 12 meses de aviso, un header Sunset en los endpoints afectados y una entrada acá (§5.8).

Hay un feed RSS en https://docs.facturia.cl/feed.xml. Suscribirse es parte de una buena integración.

2026-08-14 — v1 — la superficie publicada

Emisión. Ocho tipos de DTE (33, 34, 39, 41, 46, 52, 56, 61) con folio asignado de forma sincrónica y el viaje al SII como máquina de estados observable. POST /v1/documents/previews cotiza y valida sin emitir; preview_id emite lo aprobado y emitir dos veces la misma previsualización devuelve el documento original, no un segundo folio.

Artefactos. PDF y XML firmado por llave, o por enlace público firmado con expiración en días o en segundos. El XML se sirve en ISO-8859-1, byte a byte igual a lo que recibió el SII, por la ruta autenticada y por el enlace público.

Copia cedible para facturas 33 y 34. La Ley 19.983 entrega la tercera copia a la factura, sin distinguir afecta de exenta, y el Manual de Muestras Impresas del SII la exige para ambas. copy=cedible en cualquier otro tipo responde 422 cedible_not_available.

Recepción. Los DTE de tus proveedores, la respuesta comercial (ACD, RCD, RFP, RFT, ERM) y la ventana de 8 días corridos anclada en la marca de recepción del SII, en calendario de Santiago. Sin ancla no hay plazo: 422 commercial_response_anchor_pending en vez de una fecha inventada.

Impuestos. RCV de compras y ventas, caracterización individual y masiva, propuesta de F29 con explicación y trazabilidad por código, archivo de carga del SII y declaración como job con estados honestos. El código 048 se declara como insumo externo y se avisa cada vez que falta.

Webhooks. Firma HMAC sobre los bytes crudos, entrega al-menos-una-vez, reintentos publicados y un libro de eventos consultable y reproducible durante 12 meses.

Sandbox. Gratis para siempre y sin un solo socket hacia el SII: folios virtuales, resultados forzables y los mismos límites de tasa que producción, para que una prueba de carga signifique algo.