Listar DTEs

GET

/api/v1/billing/dte

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/dte?tipo_dte=33&estado=borrador&rut_receptor=76543210-K&limit=20"),
    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/dte?tipo_dte=33&estado=borrador&rut_receptor=76543210-K&limit=20"))
    .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/dte?tipo_dte=33&estado=borrador&rut_receptor=76543210-K&limit=20';
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/dte?tipo_dte=33&estado=borrador&rut_receptor=76543210-K&limit=20' \
  --header 'X-Api-Key: <X-Api-Key>'

Listado con paginación basada en cursor. Soporta filtros por tipo de documento, estado, rango de fechas de emisión y RUT del receptor.

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

estado

Estado del DTE en su ciclo de vida.

Importante:

la API serializa estos valores exactamente como aparecen aquí
use estos mismos literales para renderizar UI, hacer exhaustiveness checks y filtrar por estado en GET /api/v1/billing/dte

Valores:

borrador: Creado pero aún no firmado
generado: Documento construido, previo a firma
firmado: Firmado digitalmente, pendiente de envío
enviando: Sobre aceptado por la plataforma, esperando procesamiento SII
procesando: SII recibió el envío y se está consultando estado final del DTE
aceptado: Aceptado por el SII
rechazado: Rechazado por el SII
con_reparos: Aceptado por el SII con observaciones

string

Valores permitidos: borrador generado firmado enviando procesando aceptado rechazado con_reparos

Filtrar por estado del ciclo de vida

fecha_desde

string format: date

Fecha de emisión mínima (inclusive)

fecha_hasta

string format: date

Fecha de emisión máxima (inclusive)

rut_receptor

string

Example

76543210-K

RUT del receptor con dígito verificador

cursor

string

Cursor de paginación retornado en next_cursor de la página anterior

limit

integer

default: 20 >= 1 <= 100

Cantidad máxima de resultados por página

Respuestas

200

Lista de DTEs

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

requerido

integer

estado

requerido

Estado del DTE en su ciclo de vida.

Importante:

la API serializa estos valores exactamente como aparecen aquí
use estos mismos literales para renderizar UI, hacer exhaustiveness checks y filtrar por estado en GET /api/v1/billing/dte

Valores:

borrador: Creado pero aún no firmado
generado: Documento construido, previo a firma
firmado: Firmado digitalmente, pendiente de envío
enviando: Sobre aceptado por la plataforma, esperando procesamiento SII
procesando: SII recibió el envío y se está consultando estado final del DTE
aceptado: Aceptado por el SII
rechazado: Rechazado por el SII
con_reparos: Aceptado por el SII con observaciones

string

Valores permitidos: borrador generado firmado enviando procesando aceptado rechazado con_reparos

rut_receptor

requerido

string

razon_social_receptor

requerido

string

fecha_emision

requerido

string format: date

monto_neto

integer

nullable

monto_exento

integer

nullable

tasa_iva

number

iva

integer

nullable

monto_total

requerido

integer

detalle

requerido

Array<object>

object

tipo_doc_liq

Tipo de documento liquidado. Requerido en Liquidación Factura (tipo 43).

string

<= 3 characters

ind_exe

Marca una línea como exenta cuando el tipo de DTE lo requiere.

integer

Valores permitidos: 1

cod_imp_adic

Código de impuesto adicional por línea. Para factura de compra con retención total de IVA se usa 15.

integer

nombre

requerido

Nombre del item o servicio

string

<= 200 characters

dsc_item

Descripción adicional de la línea. En notas con codigo_ref=2 y monto cero se serializa como DscItem y se omiten QtyItem/PrcItem.

string

<= 1000 characters

cantidad

Cantidad (soporta decimales para unidades fraccionarias). Puede omitirse solo en correcciones de texto codigo_ref=2 sin monto.

number

>= 0.000001

unidad

Unidad de medida opcional del item, por ejemplo UN, Kg o Lt

string

<= 4 characters

precio

Precio unitario en pesos chilenos. Puede omitirse solo en correcciones de texto codigo_ref=2 sin monto.

integer

monto_item

Monto total de la línea. Uso acotado (por ejemplo liquidaciones) cuando el valor de línea no debe recalcularse como cantidad por precio.

integer

descuento_pct

Descuento porcentual sobre la línea (0-100)

number

<= 100

recargo_pct

Recargo porcentual sobre la línea (0-100)

number

<= 100

referencias

Array<object>

object

tipo_doc_ref

requerido

One of:

integer
string

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

Código libre para referencias de exportación, por ejemplo MIC, DUS, AWB o SNA.

string

>= 1 characters <= 3 characters

folio_ref

requerido

Folio del documento referenciado

integer

fecha_ref

requerido

Fecha del documento referenciado

string format: date

codigo_ref

Código de referencia SII:

1: Anula documento referenciado
2: Corrige texto del documento referenciado
3: Corrige montos del documento referenciado

integer

Valores permitidos: 1 2 3

razon_ref

requerido

Razón de la referencia

string

<= 200 characters

tracking

Información de tracking del envío al SII

object

envio_id

string format: uuid

nullable

track_id

Track ID asignado por el SII

string

nullable

estado_envio

string

nullable

codigo_sii

Código de respuesta del SII

string

nullable

glosa_sii

Glosa descriptiva de la respuesta SII

string

nullable

informados

Cantidad total de documentos informados por el SII

integer

aceptados

Cantidad de documentos aceptados

integer

rechazados

Cantidad de documentos rechazados

integer

reparos

Cantidad de documentos con reparos

integer

intentos

integer

sii_status

Último detalle fino por documento consultado al SII.

object

source

Fuente del dato consultado en SII

string

track_id

string

nullable

estado_sii

Estado crudo del documento devuelto por SII

string

nullable

glosa

Glosa consolidada

string

nullable

glosa_estado

Glosa principal asociada al estado

string

nullable

err_code

string

nullable

glosa_err

string

nullable

num_atencion

string

nullable

checked_at

string format: date-time

nullable

raw_xml

Respuesta XML cruda relevante, cuando está disponible.

string

nullable

xml_documento

XML firmado (solo si se solicita con include_xml=true)

string

nullable

metadata

object

key

additional properties

any

created_at

requerido

string format: date-time

updated_at

requerido

string format: date-time

next_cursor

Cursor para la siguiente página. Null si no hay más resultados.

string

nullable

total_count

requerido

Total de registros que coinciden con los filtros

integer

Example

{
  "items": [
    {
      "tipo_dte": 33,
      "estado": "borrador",
      "rut_receptor": "76543210-K",
      "razon_social_receptor": "Empresa Ejemplo SpA",
      "tasa_iva": 19,
      "detalle": [
        {
          "tipo_doc_liq": "33",
          "ind_exe": 1,
          "cod_imp_adic": 15,
          "nombre": "Servicio de consultoria TI",
          "dsc_item": "Detalle adicional del servicio",
          "cantidad": 10,
          "unidad": "UN",
          "precio": 50000,
          "monto_item": 329448,
          "descuento_pct": 10,
          "recargo_pct": 0
        }
      ],
      "referencias": [
        {
          "tipo_doc_ref": 33,
          "folio_ref": 123,
          "codigo_ref": 1,
          "razon_ref": "Anula factura por devolucion"
        }
      ]
    }
  ]
}

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"
}