1. 8.1. Documentos
  • Uso de API
    • 1. Introducción
    • 2. Ambientes Disponibles
    • 3. Seguridad
    • 4. Respuestas
    • 5. Tipos de Parámetros
    • 6. Errores
    • 7. Por dónde comenzar
    • 8. Webhooks
    • 9.-Adjuntos
  • Apis
    • 8.1. Documentos
      • Nuevo Documento
        POST
      • Listar DTEs
        GET
      • Listar DTEs V.2
        GET
      • Obtener Documento
        GET
      • Listar Documentos Adjuntos
        GET
      • Adjuntar archivo o documentos a un DTE
        POST
      • Dejar un comentario en la bitacora de un documento
        PUT
      • Listar los registros de bitácora de un DTE
        GET
      • Asociar contacto a un DTE
        POST
      • Enviar DTE por correo electrónico
        POST
      • Generar una acción comercial sobre un DTE
        PUT
      • Actualizar información de pago de un documento
        POST
      • Obtener información de pago de un documento
        GET
      • Cargar Borrador DTE
        POST
      • Nuevo Documento Portafolio Contrato
        POST
      • Carga Masiva Documentos Contrato
        POST
      • Listar tipos de Documentos de Escritorio Digital
        GET
      • Enviar a flujo expedientes
        POST
      • Listar opciones v2
        GET
      • Listar flujos para aprobaciones
        GET
    • 8.1.2 No Tributario
      • Nuevo Documento No Tributario
      • Listar DNTs
      • Actualizar Documento No Tributario
      • Obtener información de un documento
      • Actualiza Estado de Documento No Tributario
      • Buscar DTE referenciados a un DNT
    • 8.1.3 Documentos Personalizados
      • Convertir documento personalizado a expedientes para Escritorio Digital
      • Obtener listado de documentos personalizados
      • Crear un documento
    • 8.2. Folios
      • Cargar un CAF
      • Anular un CAF
      • Listar CAFs cargados
      • Listar CAFs
      • Solicitar un rango de folios para sucursal
      • Listar rangos de folios entregados a sucursales
      • Listar distribución de folios consumidos y por usar
      • Obtener Folios de un CAF
    • 8.3. Empresas
      • Articulos
        • Categorias
          • Listar categorias
          • Crear Categoria
          • Actualizar
          • Eliminar
        • Descuentos
          • Listar Descuentos
          • Crear Descuento
        • Listar artículo de venta
        • Buscar artículos
        • Crear artículo de venta
        • Eliminar artículo de venta
        • Actualizar artículo de venta
      • Listas Personalizadas
        • Crear Lista Personalizada
        • Listar Lista Personalizada
        • Eliminar lista personalizada
        • Modificar lista personalizada
        • Listar elementos de lista personalizada
      • Listar mis empresas
      • Crear una empresa
      • Buscar Sucursales de una empresa
      • Crear sucursal
      • Actualizar Sucursal
      • Eliminar Sucursal
      • Obtener sucursal
      • Crear Choferes de una empresa
      • Buscar choferes de una empresa
      • Obtener Chofer
      • Actualizar Choferes de una empresa
      • Modificar Choferes de una empresa
      • Eliminar chofer
      • Crear transportistas de una empresa
      • Buscar transportistas de una empresa
      • Obtener un transportista
      • Actualizar un transportista
      • Modificar un transportista
      • Marcar eliminado un transportista
      • Crear vehiculos de una empresa
      • Buscar vehiculos de una empresa
      • Obtener vehiculo
      • Modificar lista personalizada
      • Actualizar vehiculo
      • Modificar vehiculo
      • Eliminar Vehiculo
      • Cargar Certificado Digital para la Empresa
      • Obtener el certificado digital cargado en el sistema
      • Listar correos de la empresa enviados o recibidos por medio de Febos
      • Modificar grupo de unidad organizativa
      • Actualizar usuarios de grupo de unidad organizativa
      • Eliminar grupos de unidad organizativa
      • Invitar Proveedor
      • Buscar Proveedores
      • Listar árbol de usuarios dentro de grupos
      • Listar Unidades y oficinas de Escritorio Digital
      • Consultar información de una empresa
      • Lista Suplencias de Empresa
    • 8.4. Seguridad
      • Listar roles
      • Listar permisos de rol
      • Ingreso programático
      • Crear Token permanente
      • Listar Token
    • 8.5. Utilidades
      • Pre firmar URL para upload
      • Subir archivo para proceso
      • Realizar acción masiva
      • Encolar tarea en background
      • Consulta estado de tarea en background
      • Historial de Eventos
      • Crear ticket de soporte
    • 8.6. SII
      • Generar AEC.
    • 8.7. Firma Electrónica
      • Firmar un documento
      • Recuperar Firmas Disponibles
    • 8.8. Usuarios
      • Listar Usuarios
      • Listar Roles de Usuario
      • Obtener Usuario
      • Latido de usuario
      • Listar Grupos Usuario
    • 8.9. Impuestos
      • Listar Impuestos
    • 8.10. Aprobaciones
      • Cambiar correo de un paso
      • Previsualización documentos de aprobación
      • Listar Ejecuciones en Aprobaciones
      • Enviar archivo a flujo de firma
      • Obtener estado de ejecucion
      • Cambiar privacidad de una ejecución
    • 10. Configuraciones
      • Obtener objeto con configuraciones
  • Schemas
    • Schemas
      • Aprobaciones
        • AprobacionCrearResponse
        • Aprobacion-Paso
      • Articulos
        • Categoria
      • Estructura básica de un adjunto
    • BaseResponse
    • BaseListResponse
  1. 8.1. Documentos

Listar DTEs V.2

GET
/v2/documentos
InformaciónDetalle
Permiso requeridoDTE02
ID operacióncl.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#

OperadorSintaxisComportamientoEjemplo
: (igualdad)campo:valorIgualdad exactarutEmisor:76179952-5
: (múltiples valores)campo:val1,val2,val3SQL IN (val1, val2, val3)tipoDocumento:33,34,61
: (rango)campo:desde--hasta>= desde AND <= hastafechaCreacion:2024-01-01--2024-03-31
: (nulo)campo:NULLSQL IS NULLfechaDePago:NULL
$ (búsqueda parcial)campo$textoSQL LIKE '%texto%'razonSocialEmisor$FEBOS

Filtros Disponibles#

Identificación del documento#

Nombre del filtroTipoDescripciónEjemplo
febosIdStringID único Febos del documentofebosId:d0e8b8bf11e55145ed195d511c9ebaf0c33c
tipoDocumentoIntegerCódigo de tipo DTE (ver tabla más abajo)tipoDocumento:33,34,61
folioLongNúmero de folio del documentofolio:1337392
externalIdStringID externo del sistema integrado (campo internalId en emision). Requiere además filtro tipoDocumento (un solo valor) y rutEmisor (un solo valor)externalId:ABC123
trackIdLongID de seguimiento del SIItrackId:123456
idDocumentoStringID interno del documentoidDocumento:xxx

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

Nombre del filtroDescripciónEjemplo
fechaCreacionFecha de creación en el sistema. Obligatorio si no se filtra por febosId, folio o externalIdfechaCreacion:2024-01-01--2024-03-31
fechaEmisionFecha de emisión del DTEfechaEmision:2024-01-01--2024-01-31
fechaVencimientoFecha de vencimientofechaVencimiento:2024-01-01--2024-06-30
fechaRecepcionFecha de recepciónfechaRecepcion:2024-01-01--2024-01-31
fechaRecepcionSiiFecha de recepción en el SIIfechaRecepcionSii:2024-01-01--2024-01-31
fechaAcuseReciboFecha de acuse de recibofechaAcuseRecibo:2024-01-01--2024-01-31
fechaDePagoFecha de pagofechaDePago:2024-01-01--2024-03-31
fechaCesionFecha de cesión (factoring)fechaCesion:2024-01-01--2024-03-31
fechaDeCancelacionFecha de cancelaciónfechaDeCancelacion:2024-01-01--2024-01-31
fechaReciboComercialAceptadoFecha RCAfechaReciboComercialAceptado:2024-01-01--2024-01-31
fechaReciboComercialRechazadoFecha recibo comercial rechazadofechaReciboComercialRechazado:2024-01-01--2024-01-31
fechaReciboMercaderiaFecha recibo de mercaderíasfechaReciboMercaderia: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 filtroTipoDescripción
rutEmisorStringRUT del emisor. Usar * para wildcard (solo superadmin)
razonSocialEmisorStringRazón social del emisor
giroEmisorStringGiro del emisor
codigoActividadEconomicaStringCódigo ACTECO
sucursalStringSucursal emisora
codigoSiiSucursalIntegerCódigo SII de la sucursal
correoEmisorStringCorreo electrónico del emisor
codigoVendedorStringCódigo del vendedor

Receptor#

Nombre del filtroTipoDescripción
rutReceptorStringRUT del receptor. Usar * para wildcard (solo superadmin)
razonSocialReceptorStringRazón social del receptor
giroReceptorStringGiro del receptor
correoReceptorStringCorreo electrónico del receptor
contactoStringContacto del receptor

Estados#

Nombre del filtroTipoValores posibles
estadoSiiInteger1=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
estadoComercialInteger0=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
estadoDePagoIntegerEstado de pago del documento
estadoEnvioReceptorIntegerEstado de envío al receptor
recibidoBooleanSi el documento fue recibido
incompletoStringSi el documento está incompleto

Cesión (Factoring)#

Nombre del filtroTipoDescripción
rutCesionarioStringRUT del cesionario
razonSocialCesionarioStringRazón social del cesionario

Montos (soportan operador de rango --)#

Nombre del filtroTipoDescripción
montoTotalDecimalMonto total del documento
montoNetoDecimalMonto neto
montoExentoDecimalMonto exento
ivaDecimalMonto IVA
montoLongMonto general

Otros filtros#

Nombre del filtroTipoDescripción
formaDePagoInteger1=Contado, 2=Crédito, 3=Sin Valor
tipoDespachoIntegerTipo de despacho
indicadorDeTrasladoIntegerIndicador de traslado
grupoReceptorStringID del grupo receptor
usuarioIdStringID del usuario que creó el documento
tieneNcStringTiene nota de crédito (si/no)
tieneNdStringTiene nota de débito (si/no)
tieneRphStringTiene recibo por honorarios (si/no)
tieneAptobacionActivaStringTiene aprobación activa (si/no)
rutMandanteStringRUT del mandante
codigoSiiStringCódigo SII
folioReferenciaStringFolio del documento de referencia
ordenDeCompraStringNúmero de orden de compra

Reglas de negocio#

1.
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.
2.
Rango de fechas limitado: Máximo 12 meses (3 meses con permiso RST001).
3.
Filtro externalId: Requiere además tipoDocumento con un solo valor y rutEmisor con un solo valor.
4.
Filtro folio: Si se filtra por folio, los filtros de fecha se eliminan automáticamente.
5.
Filtro febosId: Si se filtra por febosId, los filtros de fecha se eliminan automáticamente.
6.
Wildcard * en rut: Solo disponible para usuarios superadmin.

Ejemplos de filtros#

Caso de usoFiltros
Facturas emitidas del mesrutEmisor:76179952-5|tipoDocumento:33|fechaCreacion:2024-03-01--2024-03-31
DTEs recibidosrutReceptor:76179952-5|estadoSii:4,5|fechaCreacion:2024-03-01--2024-03-31
Buscar por folio específicorutEmisor: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éditorutEmisor:76179952-5|tieneNc:si|fechaCreacion:2024-01-01--2024-03-31
Monto total mayor a 1MrutEmisor:76179952-5|montoTotal:1000000--999999999|fechaCreacion:2024-01-01--2024-03-31
Buscar por ID externorutEmisor:76179952-5|tipoDocumento:33|externalId:ABC-123
Tipos de Documentos
Ver tabla de tipos de documento
CódigoTipo Documento
30Factura
32Factura de ventas y servicios no afectos o exentos de IVA
33Factura electrónica
34Factura no afecta o exenta electrónica
35Boleta
38Boleta exenta
39Boleta electrónica
40Liquidación factura
41Boleta exenta electrónica
43Liquidación factura electrónica
45Factura de compra
46Factura de compra electrónica
48Pago electrónico
50Guía de despacho
52Guía de despacho electrónica
55Nota de débito
56Nota de débito electrónica
60Nota de crédito
61Nota de crédito electrónica
66Boleta de Honorarios
103Liquidación
110Factura de exportación electrónica
111Nota de débito de exportación electrónica
112Nota de crédito de exportación electrónica
Estados Comerciales
CódigoEstado Comercial
0Sin acción
1Aceptado
2Aceptado en el SII
3Pre-rechazado
4Rechazado en el SII
5Reclamo parcial en el SII
6Reclamo total en el SII
7Recibo de mercaderías en el SII
8Aceptado por defecto en el SII
Estados del SII
CódigoEstados SII
1Pendiente de envío al SII
2Enviado al SII
3Error al enviar
4Aceptado por el SII
5Aceptado con reparos por el SII
6Rechazado por el SII
7Pendiente de consulta en el SII
8Error al consultar en el SII
9Ensobrado
10Anulado
Ver forma de pago y sus códigos
TipoDescripción
1Contado
2Crédito
3Sin Valor
Ver estado pagado y sus códigos
TipoDescripción
MMoroso
AAtrasado
VVigente

Solicitud

Parámetros de consulta

Parámetros de Header

Respuestas

🟢200Correcto
application/json
Respuesta a todo evento
Bodyapplication/json

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/v2/documentos?consulta=trackId%2CtipoDocumento%2Cfolio%2CrutEmisor%2CrazonSocialEmisor&filtros=tipoDocumento%3A33%2C34%2C43%2C46%2C56&orden=-fechaCreacion&itemsPorPagina=20&pagina=1&aplicacion=FEB' \
--header 'token: xx' \
--header 'empresa: 1111111-1'
Respuesta Ejemplo de Respuesta
Token Inválido
{
    "codigo": 3,
    "duracion": 207,
    "hora": "2019-03-05T15:03:42.245Z",
    "errores": [],
    "mensaje": "Acceso denegado",
    "seguimientoId": "eaa362909975204aa43bd28-ba9e4503db58"
}
Modificado en 2026-08-20 19:34:25
Anterior
Listar DTEs
Siguiente
Obtener Documento
Built with