Listar DTEs

Información	Detalle
Permiso requerido	DTE02
ID operación	cl.documentos.dtes.listar.v2

Retorna un listado ordenado de documentos eléctronicos (DTE).
Estos documentos pueden ser filtrados por tipos (Emitidos, Recibidos, Rechazados, Pagados, Pendientes...).

Para listar estos documentos, deberás tener en cuenta lo que coloques en los filtros.

Si quisieras listar los DTE emitidos, el filtro mas escencial seria estadoSii:0,1,2,3,4,5,6,7,8,9, también ten
presente filtrar por rutEmisor donde el valor de este filtro sera el rut de la empresa.

Si quisieras listar los DTE recibidos, el filtro mas escencial sería estadoSii:4,5, en este caso también se agregaría
el filtro rutReceptor donde el valor de este filtro sera el rut de la empresa a la que perteneces.

Al enviar los filtros, el rut de la empresa debe ingresarse en uno de los filtros enviados rutEmisor o rutReceptor o rutCesionario.

Definición de campos DTE segun el SII

Sintaxis de Filtros

El parámetro filtros utiliza una sintaxis especial para construir condiciones de búsqueda:

filtros=campo1:valor1|campo2:valor2|campo3$valorParcial

Los filtros se separan con el caracter pipe | (codificado como %7C en URL).

Operadores disponibles

Operador	Sintaxis	Comportamiento	Ejemplo
`:` (igualdad)	`campo:valor`	Igualdad exacta	`rutEmisor:76179952-5`
`:` (múltiples valores)	`campo:val1,val2,val3`	SQL `IN (val1, val2, val3)`	`tipoDocumento:33,34,61`
`:` (rango)	`campo:desde--hasta`	`>= desde AND <= hasta`	`fechaCreacion:2024-01-01--2024-03-31`
`:` (nulo)	`campo:NULL`	SQL `IS NULL`	`fechaDePago:NULL`
`$` (búsqueda parcial)	`campo$texto`	SQL `LIKE '%texto%'`	`razonSocialEmisor$FEBOS`

Filtros Disponibles

Identificación del documento

Nombre del filtro	Tipo	Descripción	Ejemplo
`febosId`	String	ID único Febos del documento	`febosId:d0e8b8bf11e55145ed195d511c9ebaf0c33c`
`tipoDocumento`	Integer	Código de tipo DTE (ver tabla más abajo)	`tipoDocumento:33,34,61`
`folio`	Long	Número de folio del documento	`folio:1337392`
`externalId`	String	ID externo del sistema integrado. Requiere además filtro `tipoDocumento` (un solo valor) y `rutEmisor` (un solo valor)	`externalId:ABC123`
`trackId`	Long	ID de seguimiento del SII	`trackId:123456`
`idDocumento`	String	ID interno del documento	`idDocumento:xxx`

Fechas (formato rango: `YYYY-MM-DD--YYYY-MM-DD`)

Nombre del filtro	Descripción	Ejemplo
`fechaCreacion`	Fecha de creación en el sistema. Obligatorio si no se filtra por `febosId`, `folio` o `externalId`	`fechaCreacion:2024-01-01--2024-03-31`
`fechaEmision`	Fecha de emisión del DTE	`fechaEmision:2024-01-01--2024-01-31`
`fechaVencimiento`	Fecha de vencimiento	`fechaVencimiento:2024-01-01--2024-06-30`
`fechaRecepcion`	Fecha de recepción	`fechaRecepcion:2024-01-01--2024-01-31`
`fechaRecepcionSii`	Fecha de recepción en el SII	`fechaRecepcionSii:2024-01-01--2024-01-31`
`fechaAcuseRecibo`	Fecha de acuse de recibo	`fechaAcuseRecibo:2024-01-01--2024-01-31`
`fechaDePago`	Fecha de pago	`fechaDePago:2024-01-01--2024-03-31`
`fechaCesion`	Fecha de cesión (factoring)	`fechaCesion:2024-01-01--2024-03-31`
`fechaDeCancelacion`	Fecha de cancelación	`fechaDeCancelacion:2024-01-01--2024-01-31`
`fechaReciboComercialAceptado`	Fecha RCA	`fechaReciboComercialAceptado:2024-01-01--2024-01-31`
`fechaReciboComercialRechazado`	Fecha recibo comercial rechazado	`fechaReciboComercialRechazado:2024-01-01--2024-01-31`
`fechaReciboMercaderia`	Fecha recibo de mercaderías	`fechaReciboMercaderia:2024-01-01--2024-01-31`

Restricción de rango de fechas: Máximo 12 meses entre fecha desde y hasta (3 meses si el usuario tiene el permiso restrictivo RST001). Si se busca por febosId, folio o externalId no se requiere filtro de fecha.

Emisor

Nombre del filtro	Tipo	Descripción
`rutEmisor`	String	RUT del emisor. Usar `*` para wildcard (solo superadmin)
`razonSocialEmisor`	String	Razón social del emisor
`giroEmisor`	String	Giro del emisor
`codigoActividadEconomica`	String	Código ACTECO
`sucursal`	String	Sucursal emisora
`codigoSiiSucursal`	Integer	Código SII de la sucursal
`correoEmisor`	String	Correo electrónico del emisor
`codigoVendedor`	String	Código del vendedor

Receptor

Nombre del filtro	Tipo	Descripción
`rutReceptor`	String	RUT del receptor. Usar `*` para wildcard (solo superadmin)
`razonSocialReceptor`	String	Razón social del receptor
`giroReceptor`	String	Giro del receptor
`correoReceptor`	String	Correo electrónico del receptor
`contacto`	String	Contacto del receptor

Estados

Nombre del filtro	Tipo	Valores posibles
`estadoSii`	Integer	1=Pendiente envío, 2=Enviado, 3=Error envío, 4=Aceptado, 5=Aceptado c/reparos, 6=Rechazado, 7=Pendiente consulta, 8=Error consulta, 9=Ensobrado, 10=Anulado
`estadoComercial`	Integer	0=Sin acción, 1=Aceptado, 2=Aceptado SII, 3=Pre-rechazado, 4=Rechazado SII, 5=Reclamo parcial, 6=Reclamo total, 7=Recibo mercaderías, 8=Aceptado por defecto
`estadoDePago`	Integer	Estado de pago del documento
`estadoEnvioReceptor`	Integer	Estado de envío al receptor
`recibido`	Boolean	Si el documento fue recibido
`incompleto`	String	Si el documento está incompleto

Cesión (Factoring)

Nombre del filtro	Tipo	Descripción
`rutCesionario`	String	RUT del cesionario
`razonSocialCesionario`	String	Razón social del cesionario

Montos (soportan operador de rango `--`)

Nombre del filtro	Tipo	Descripción
`montoTotal`	Decimal	Monto total del documento
`montoNeto`	Decimal	Monto neto
`montoExento`	Decimal	Monto exento
`iva`	Decimal	Monto IVA
`monto`	Long	Monto general

Otros filtros

Nombre del filtro	Tipo	Descripción
`formaDePago`	Integer	1=Contado, 2=Crédito, 3=Sin Valor
`tipoDespacho`	Integer	Tipo de despacho
`indicadorDeTraslado`	Integer	Indicador de traslado
`grupoReceptor`	String	ID del grupo receptor
`usuarioId`	String	ID del usuario que creó el documento
`tieneNc`	String	Tiene nota de crédito (`si`/`no`)
`tieneNd`	String	Tiene nota de débito (`si`/`no`)
`tieneRph`	String	Tiene recibo por honorarios (`si`/`no`)
`tieneAptobacionActiva`	String	Tiene aprobación activa (`si`/`no`)
`rutMandante`	String	RUT del mandante
`codigoSii`	String	Código SII
`folioReferencia`	String	Folio del documento de referencia
`ordenDeCompra`	String	Número de orden de compra

Reglas de negocio

Filtro de identidad obligatorio: La consulta debe incluir al menos uno de: rutEmisor, rutReceptor, rutCesionario o febosId. El RUT enviado debe corresponder al de la empresa autenticada.

Rango de fechas limitado: Máximo 12 meses (3 meses con permiso RST001).

Filtro externalId: Requiere además tipoDocumento con un solo valor y rutEmisor con un solo valor.

Filtro folio: Si se filtra por folio, los filtros de fecha se eliminan automáticamente.

Filtro febosId: Si se filtra por febosId, los filtros de fecha se eliminan automáticamente.

Wildcard * en rut: Solo disponible para usuarios superadmin.

Ejemplos de filtros

Caso de uso	Filtros
Facturas emitidas del mes	`rutEmisor:76179952-5\|tipoDocumento:33\|fechaCreacion:2024-03-01--2024-03-31`
DTEs recibidos	`rutReceptor:76179952-5\|estadoSii:4,5\|fechaCreacion:2024-03-01--2024-03-31`
Buscar por folio específico	`rutEmisor:76179952-5\|folio:12345`
Documentos cedidos (factoring)	`rutCesionario:76179952-5\|fechaCesion:2024-01-01--2024-03-31`
Buscar por razón social (parcial)	`rutEmisor:76179952-5\|razonSocialReceptor$ACME\|fechaCreacion:2024-01-01--2024-03-31`
Documentos con nota de crédito	`rutEmisor:76179952-5\|tieneNc:si\|fechaCreacion:2024-01-01--2024-03-31`
Monto total mayor a 1M	`rutEmisor:76179952-5\|montoTotal:1000000--999999999\|fechaCreacion:2024-01-01--2024-03-31`
Buscar por ID externo	`rutEmisor:76179952-5\|tipoDocumento:33\|externalId:ABC-123`

Tipos de Documentos

Ver tabla de tipos de documento

Código	Tipo Documento
30	Factura
32	Factura de ventas y servicios no afectos o exentos de IVA
33	Factura electrónica
34	Factura no afecta o exenta electrónica
35	Boleta
38	Boleta exenta
39	Boleta electrónica
40	Liquidación factura
41	Boleta exenta electrónica
43	Liquidación factura electrónica
45	Factura de compra
46	Factura de compra electrónica
48	Pago electrónico
50	Guía de despacho
52	Guía de despacho electrónica
55	Nota de débito
56	Nota de débito electrónica
60	Nota de crédito
61	Nota de crédito electrónica
66	Boleta de Honorarios
103	Liquidación
110	Factura de exportación electrónica
111	Nota de débito de exportación electrónica
112	Nota de crédito de exportación electrónica

Estados Comerciales

Código	Estado Comercial
0	Sin acción
1	Aceptado
2	Aceptado en el SII
3	Pre-rechazado
4	Rechazado en el SII
5	Reclamo parcial en el SII
6	Reclamo total en el SII
7	Recibo de mercaderías en el SII
8	Aceptado por defecto en el SII

Estados del SII

Código	Estados SII
1	Pendiente de envío al SII
2	Enviado al SII
3	Error al enviar
4	Aceptado por el SII
5	Aceptado con reparos por el SII
6	Rechazado por el SII
7	Pendiente de consulta en el SII
8	Error al consultar en el SII
9	Ensobrado
10	Anulado

Ver forma de pago y sus códigos

Tipo	Descripción
1	Contado
2	Crédito
3	Sin Valor

Ver estado pagado y sus códigos

Tipo	Descripción
M	Moroso
A	Atrasado
V	Vigente

Listar DTEs

Sintaxis de Filtros

Operadores disponibles

Filtros Disponibles

Identificación del documento

Fechas (formato rango: `YYYY-MM-DD--YYYY-MM-DD`)

Emisor

Receptor

Estados

Cesión (Factoring)

Montos (soportan operador de rango `--`)

Otros filtros

Reglas de negocio

Ejemplos de filtros

Solicitud

Respuestas

Listar DTEs

Sintaxis de Filtros#

Operadores disponibles#

Filtros Disponibles#

Identificación del documento#

Fechas (formato rango: YYYY-MM-DD--YYYY-MM-DD)#

Emisor#

Receptor#

Estados#

Cesión (Factoring)#

Montos (soportan operador de rango --)#

Otros filtros#

Reglas de negocio#

Ejemplos de filtros#

Solicitud

Respuestas

Sintaxis de Filtros

Operadores disponibles

Filtros Disponibles

Identificación del documento

Fechas (formato rango: `YYYY-MM-DD--YYYY-MM-DD`)

Emisor

Receptor

Estados

Cesión (Factoring)

Montos (soportan operador de rango `--`)

Otros filtros

Reglas de negocio

Ejemplos de filtros