Cargar un CAF de folios

post /v1/facturacion/emisores/{emisor_id}/folios

Carga un CAF: el rango de folios timbrado que el SII entrega por tipo de documento. Sin folios no se puede emitir.

Un CAF que arranca por debajo de un folio ya emitido se rechaza: sólo repartiría folios repetidos que el SII no acepta.

Autenticación

Requiere API key (sk_live_… · sk_test_…) en la cabecera authorization: Bearer …. Ver autenticación.

Parámetros

Nombre	En	Tipo	Descripción
`emisor_id`obligatorio	path	`string`	—

Cuerpo de la petición

caf_xml string obligatorio

Respuesta 201

Folios cargados

id string obligatorio

tipo_dte integer obligatorio

desde integer obligatorio

hasta integer obligatorio

disponibles integer obligatorio

Errores

Código	Cuándo
`400`	CAF inválido o que pisa folios ya emitidos

El cuerpo de cualquier error sigue la misma forma y su code viene de un catálogo cerrado. Ver errores.

curl -X POST https://api.klevy.cl/v1/facturacion/emisores/emisor_id/folios \ -H 'authorization: Bearer sk_live_tu_api_key' \ -H 'content-type: application/json' \ -d '{ "caf_xml": "<AUTORIZACION>…</AUTORIZACION>" }'

const respuesta = await fetch( 'https://api.klevy.cl/v1/facturacion/emisores/emisor_id/folios', { method: 'POST', headers: { authorization: 'Bearer sk_live_tu_api_key', 'content-type': 'application/json', }, body: JSON.stringify({ "caf_xml": "<AUTORIZACION>…</AUTORIZACION>" }), }, ); const datos = await respuesta.json();

import requests respuesta = requests.post( "https://api.klevy.cl/v1/facturacion/emisores/emisor_id/folios", headers={ "authorization": "Bearer sk_live_tu_api_key", }, json={ "caf_xml": "<AUTORIZACION>…</AUTORIZACION>" }, ) datos = respuesta.json()