Listar CAFs

GET

/api/v1/billing/caf

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://api.simplo.cl/api/v1/billing/caf?tipo_dte=33"),
    Headers =
    {
        { "X-Api-Key", "<X-Api-Key>" },
    },
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.simplo.cl/api/v1/billing/caf?tipo_dte=33"))
    .header("X-Api-Key", "<X-Api-Key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

const url = 'https://api.simplo.cl/api/v1/billing/caf?tipo_dte=33';
const options = {method: 'GET', headers: {'X-Api-Key': '<X-Api-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.simplo.cl/api/v1/billing/caf?tipo_dte=33' \
  --header 'X-Api-Key: <X-Api-Key>'

Lista los CAFs (Códigos de Autorización de Folios) de la empresa con la cantidad de folios disponibles por cada uno.

Autenticación

ApiKeyAuth
BearerAuth

Parámetros

Parámetros de consulta

tipo_dte

Código SII del tipo de Documento Tributario Electrónico (33 factura, 39 boleta, 52 guía de despacho, 56/61 notas, 110-112 exportación). Detalle de cada tipo en la guía Tipos de DTE.

integer

Valores permitidos: 33 34 39 41 43 46 52 56 61 110 111 112

Filtrar por tipo de DTE

is_active

boolean

Filtrar por CAFs activos/inactivos

Respuestas

200

Lista de CAFs

application/json

object

items

requerido

Array<object>

object

requerido

string format: uuid

tipo_dte

requerido

Código SII del tipo de Documento Tributario Electrónico (33 factura, 39 boleta, 52 guía de despacho, 56/61 notas, 110-112 exportación). Detalle de cada tipo en la guía Tipos de DTE.

integer

Valores permitidos: 33 34 39 41 43 46 52 56 61 110 111 112

folio_desde

requerido

integer

folio_hasta

requerido

integer

folios_disponibles

requerido

Cantidad de folios aún no asignados

integer

ambiente

requerido

string

Valores permitidos: certificacion produccion

fecha_autorizacion

requerido

string format: date

is_active

requerido

boolean

created_at

requerido

string format: date-time

Example

{
  "items": [
    {
      "tipo_dte": 33,
      "folio_desde": 1,
      "folio_hasta": 200,
      "folios_disponibles": 158,
      "ambiente": "certificacion"
    }
  ]
}

401

Token o API key inválido o ausente

application/json

object

code

requerido

Código de error máquina-legible

string

message

requerido

Mensaje descriptivo del error. Este es el campo canónico para clientes nuevos.

string

error

Alias de compatibilidad de message mantenido hacia atrás.

string

details

Array<object>

object

field

requerido

Campo con error (dot notation para nested)

string

code

requerido

Código de validación

string

message

requerido

Mensaje descriptivo

string

action

Acción recomendada para el cliente

string

severity

Severidad opcional del error

string

Valores permitidos: critical error warning info

context

Contexto estructurado opcional para debugging

object

key

additional properties

any

Example

{
  "code": "VALIDATION_ERROR",
  "message": "Error de validacion en los campos enviados",
  "details": [
    {
      "field": "receptor.rut",
      "code": "INVALID_RUT",
      "message": "RUT invalido: digito verificador no coincide"
    }
  ],
  "severity": "critical"
}