Test helpers

Endpoints que solo existen para llaves de prueba y mueven las piezas que normalmente mueve el mundo.

Base: https://api.facturia.cl/v1. Todos los endpoints de este capítulo se autentican con Authorization: Bearer salvo que se diga lo contrario, y el sobre de error es el de Errores.

Método	Ruta	Qué hace
`POST`	`/test_helpers/received_documents`	Inyecta un DTE de proveedor como si hubiera llegado a la casilla de recepción
`POST`	`/test_helpers/rcv/seed`	Siembra filas de RCV en un período para que la propuesta de F29 tenga datos
`POST`	`/test_helpers/clock`	Adelanta el reloj simulado de esta empresa
`POST`	`/test_helpers/empresas/{empresa_id}/onboarding`	Lleva la puesta en marcha de una empresa a cualquier estado

`POST /test_helpers/received_documents`

Inyecta un DTE de proveedor como si hubiera llegado a la casilla de recepción

curl -sS -X POST https://api.facturia.cl/v1/test_helpers/received_documents \
  -H "Authorization: Bearer $FACTURIA_KEY" \
  -H "Facturia-Empresa: $EMPRESA" \
  -H "Content-Type: application/json" \
  -d '{"tipo_dte":33,"emisor":{"rut":"96790240-3","legal_name":"Proveedor Austral SpA"}}'

Parámetros

Parámetro	En	Requerido	Tipo	Notas
`Facturia-Empresa`	header	—	string	La empresa destino: RUT canónico (`77928532-4`) o id de empresa (`emp_…`). Obligatorio en toda llamada con alcance de empresa, salvo que la llave sea un token de empresa. Este header es el ÚNICO mecanismo: no hay parámetro `?empresa=` ni campo `empresa` en el cuerpo. Omitido donde se requiere → `400 empresa_required`; fuera de la lista blanca → `403 empresa_not_allowed`.

Cuerpo

Campo	Tipo	Requerido	Notas
`tipo_dte`	`33` · `34` · `39` · `41` · `46` · `52` · `56` · `61`	sí	33 factura afecta · 34 factura exenta · 39 boleta afecta · 41 boleta exenta · 46 factura de compra · 52 guía de despacho · 56 nota de débito · 61 nota de crédito. Las boletas (39/41) viajan por otro transporte del SII; eso es invisible desde esta API.
`folio`	integer	—
`emisor`	Party	sí
`issue_date`	string	—
`totals`	Totals	—
`items`	DocumentItem[]	—
Respuestas

Código	Significado	Cuerpo
`201`	El documento recibido inyectado; se dispara `received_document.created`.	ReceivedDocument
`403`	Llave válida pero sin permiso: scope, lista blanca de empresas o modo.	ErrorResponse

`POST /test_helpers/rcv/seed`

Siembra filas de RCV en un período para que la propuesta de F29 tenga datos

curl -sS -X POST https://api.facturia.cl/v1/test_helpers/rcv/seed \
  -H "Authorization: Bearer $FACTURIA_KEY" \
  -H "Facturia-Empresa: $EMPRESA" \
  -H "Content-Type: application/json" \
  -d '{"period":"2026-07"}'

Parámetros

Parámetro	En	Requerido	Tipo	Notas
`Facturia-Empresa`	header	—	string	La empresa destino: RUT canónico (`77928532-4`) o id de empresa (`emp_…`). Obligatorio en toda llamada con alcance de empresa, salvo que la llave sea un token de empresa. Este header es el ÚNICO mecanismo: no hay parámetro `?empresa=` ni campo `empresa` en el cuerpo. Omitido donde se requiere → `400 empresa_required`; fuera de la lista blanca → `403 empresa_not_allowed`.

Cuerpo

Campo	Tipo	Requerido	Notas
`period`	Period	sí	Período tributario `YYYY-MM` (America/Santiago). Ej.: `"2026-07"`.
`purchases`	integer	—	Por defecto: `10`.
`sales`	integer	—	Por defecto: `10`.
Respuestas

Código	Significado	Cuerpo
`202`	Job de siembra aceptado.	Job

`POST /test_helpers/clock`

Adelanta el reloj simulado de esta empresa

Ejercita la ventana de acuse de 8 días, el vencimiento de folios y los plazos del F29 sin esperar.

curl -sS -X POST https://api.facturia.cl/v1/test_helpers/clock \
  -H "Authorization: Bearer $FACTURIA_KEY" \
  -H "Facturia-Empresa: $EMPRESA" \
  -H "Content-Type: application/json" \
  -d '{"advance_days":9,"set_to":"…"}'

Parámetros

Parámetro	En	Requerido	Tipo	Notas
`Facturia-Empresa`	header	—	string	La empresa destino: RUT canónico (`77928532-4`) o id de empresa (`emp_…`). Obligatorio en toda llamada con alcance de empresa, salvo que la llave sea un token de empresa. Este header es el ÚNICO mecanismo: no hay parámetro `?empresa=` ni campo `empresa` en el cuerpo. Omitido donde se requiere → `400 empresa_required`; fuera de la lista blanca → `403 empresa_not_allowed`.

Cuerpo

Campo	Tipo	Requerido
`advance_days`	integer	—
`set_to`	string	—
Respuestas

Código	Significado	Cuerpo
`200`	La nueva fecha simulada de la empresa.	object

`POST /test_helpers/empresas/{empresa_id}/onboarding`

Lleva la puesta en marcha de una empresa a cualquier estado

curl -sS -X POST https://api.facturia.cl/v1/test_helpers/empresas/emp_01K2R6ZC4P8QW1VN7T3MHDY9EK/onboarding \
  -H "Authorization: Bearer $FACTURIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"draft"}'

Parámetros

Parámetro	En	Requerido	Tipo	Notas
`empresa_id`	path	sí	string

Cuerpo

Campo	Tipo	Requerido
`status`	`draft` · `mandato_pending` · `mandato_signed` · `certificate_pending` · `certificate_verified` · `sii_postulacion_pending` · `certification_in_progress` · `cumplimiento_pending` · `resolucion_pending` · `folios_pending` · `emitting` · `action_required` · `blocked` · `suspended`	sí
`step`	string	—
Respuestas

Código	Significado	Cuerpo
`200`	El estado de puesta en marcha forzado.	Onboarding

POST /test_helpers/received_documents

POST /test_helpers/rcv/seed

POST /test_helpers/clock

POST /test_helpers/empresas/{empresa_id}/onboarding

En esta página

`POST /test_helpers/received_documents`

`POST /test_helpers/rcv/seed`

`POST /test_helpers/clock`

`POST /test_helpers/empresas/{empresa_id}/onboarding`