---
title: "Servicios Web (API) Legacy (versión 1)"
description: ""
type: "docs"
category: "doc"
tags: []
authors: [Anonymous]
date: "2026-08-27"
last_update: "2026-08-21"
time_minutes: 1
draft: false
unlisted: false
attachments: [apigateway-v1-api-schema.yaml]
url: "https://www.stage.apigateway.cl/docs/api-v1"
---
## API Gateway Legacy (V1)
Proveemos en [legacy.apigateway.cl](https://legacy.apigateway.cl) una API para interacturar con diferentes funcionalidades del SII.
> ¡Tenemos una API que ni el propio SII tiene disponible!
**Importante**: esta API no está relacionada de ninguna forma con el SII, es sólo una pasarela para interactuar con funcionalidades del sitio web del SII. No somos parte del SII ni de otra institución pública.
Si requiere soporte con el uso de la API, por favor [abrir un ticket de soporte](https://www.apigateway.cl/help).
**IMPORTANTE** los ejemplos con código de esta documentación son generados automáticamente y no representan ejemplos reales ni funcionales. Cada usuario deberá construir los códigos necesarios según su lenguaje y sistema con la documentación existente. Donde los códigos sugeridos por Postman podrían servir de guía, pero nada más.
**POSTMAN WEB**: Al usar Postman en la web, compartes la IP con otros usuarios de Postman web. Por lo que tu cuenta se bloqueará. Usa la aplicación de escritorio de Postman. Así usarás tu propia IP en las consultas.
---
#### Academia de API Gateway
La Academia de API Gateway es un espacio diseñado para ayudar a los usuarios a entender y utilizar la API de API Gateway de manera eficiente.
En la [Academia de API Gateway](/academy/tags/api-gateway-legacy) encontrarás una serie de lecciones para aprender a usar la API.
#### Clientes de la API
| Lenguaje | Autor | Repositorio |
| --- | --- | --- |
| PHP | API Gateway | [github.com/apigatewaycl/apigateway-api-client-php](https://github.com/apigatewaycl/apigateway-api-client-php) |
| Python | API Gateway | [github.com/apigatewaycl/apigateway-api-client-python](https://github.com/apigatewaycl/apigateway-api-client-python) |
Servers: https://legacy.apigateway.cl
Index:
- API Contribuyentes - Consultas públicas
- Situación Tributaria de un Contribuyente
- Verificación de Cédula RUT
- Actividades Económicas
- API Contribuyentes - Consultas MiSii - Representantes (otros al contribuyente)
- Representantes del contribuyente
- API Contribuyentes - Consultas MiSii - Representados (contribuyente a otros)
- Listado contribuyentes representados
- Representar un contribuyente
- API Contribuyentes - Consultas MiSii - Datos del contribuyente
- Datos del contribuyente
- API SII
- Unidad de fomento (UF)
- Corrección monetaria
- Impuesto de segunda categoría
- API DTE - Código de Asignación de Folios (CAF)
- Solicitar CAF
- Descargar XML
- Consultar Estado de un Folio
- Anulación de Folios
- Listado de Folios Solicitados
- Listado de Folios por Estado
- API DTE - Contribuyentes
- Listado Contribuyentes Autorizados
- Estado Autorización de un Contribuyente
- Estado Autorización de un Contribuyente (incluye email)
- Datos Privados de un Contribuyente
- Asignar Datos Privados de un Contribuyente
- Usuarios Autorizados de un Contribuyente
- Asignar Usuarios Autorizados a un Contribuyente
- API DTE - Documentos Emitidos
- Estado de un envío de XML al SII
- Verificación Avanzada de un Documento en SII
- API DTE - Información Electrónica de Compras y Ventas
- Obtener Código de Reemplazo de Libro
- API RCV - Registro de Compras
- Resumen de Compras
- Detalle de Compras
- Asignación Tipo de Transacción de una Compra
- Async: Solicitar
- Async: Estado
- Async: Detalle
- API RCV - Registro de Ventas
- Resumen de Ventas
- Detalle de Ventas
- Asignación de Resumen de Ventas por Documento
- Async: Solicitar
- Async: Estado
- Async: Detalle
- API RTC
- Obtener Certificado de Cesión Electrónica
- Estado de Envío de Cesión Electrónica
- Estado de Cesión de un DTE
- Listado de Cesiones
- API BHE - Boletas de Honorarios Emitidas
- Listado de Boletas de Honorarios Emitidas
- Emitir Boleta de Honorarios
- Descargar PDF Boleta de Honorarios Emitida
- Enviar Email con la Boleta de Honorarios Emitida
- Anular Boleta de Honorarios Emitida
- API BHE - Boletas de Honorarios Recibidas
- Listado de Boletas de Honorarios Recibidas
- Descargar PDF Boleta de Honorarios Recibida
- Observar Boleta de Honorarios Recibida
- API BTE - Boletas de Terceros Emitidas
- Resumen Mensual y Anual de Boletas de Terceros Emitidas
- Listado de Boletas de Terceros Emitidas
- Emitir Boleta de Terceros
- Descargar HTML Boleta de Terceros
- Anular Boleta de Terceros Emitida
- Buscar datos Boleta de Terceros
- Obtener la tasa del receptor de una BTE
- API BTE - Boletas de Terceros Recibidas
- Listado de Boletas de Terceros Recibidas
- Descargar HTML Boleta de Terceros Recibida
- API Vehículos
- Buscar Tasación Vehicular
- Tipos de Vehículos según Categoría
- Marcas de Vehículos según Categoría
- Características de Vehículos según Categoría
- API Software MIPYME SII - Contribuyentes
- Información Pública de un Contribuyente
- API Software MIPYME SII - Documentos Borradores
- Listado de Documentos Borradores
- Emitir Documento Borrador
- Eliminar Documento Borrador
- Descargar PDF de un Documento Borrador
- API Software MIPYME SII - Documentos Emitidos
- Listado de Documentos Emitidos
- Descargar PDF de un DTE Emitido
- Descargar XML de un DTE emitido
- API Software MIPYME SII - Documentos Recibidos
- Listado de Documentos Recibidos
- Descargar PDF de un DTE Recibido
- Descargar XML de un DTE Recibido
- API Certificación DTE - Contribuyentes
- Datos del contribuyente
- API Certificación DTE - Certificación de Facturas y otros documentos
- Postulación a Software de Mercado
- Solicitar Set de Pruebas
- API Certificación DTE - Certificación de Boletas
- Solicitar Set de Pruebas de Boletas
- API Facturación - Documentos Tributarios
- Generar XML de un DTE
- Generar PDF a partir del XML del DTE
- Generar ESCPOS a partir del XML del DTE
- Normalizar DTE al formato estándar del SII
- Generar XML de RVD de Boletas (ex RCOF)
- Generar XML de Cesión de DTE (AEC)
- API Facturación - Envíos al SII
- Enviar XML al SII
- Consultar Envio de XML al SII
- API Facturación - Intercambios de DTE
- Registrar Respuesta de Intercambio de DTE en el SII
- Fecha de Recepción de un DTE en el SII
- Historial de Eventos de un DTE
- Información para Cesión de un DTE
- API Facturación - Utilidades
- Token autenticación
- Datos certificado digital
- Back Office
- Información del Usuario
- Notificar pago
- Tasks Beat
### API Contribuyentes - Consultas públicas
#### GET /api/v1/sii/contribuyentes/situacion_tributaria/tercero/{rut}
Situación Tributaria de un Contribuyente
**Permiso requerido**: `query contribuyentes`
Permite obtener la situación tributaria de un contribuyente.
Este método no necesita autenticación en el SII, esto permite que sea un método `GET`
La respuesta incluye:
- RUT.
- Razón social.
- Si tiene o no inicio de actividades.
- Fecha inicio de actividades.
- Si tiene autorización para declarar impuestos en moneda extranjera.
- Si es contribuyente PRO-PYME.
- El listado de actividades económicas vigentes.
- Los documentos que ha timbrado y el año del último timbraje.
- La fecha desde cuando está obligado a emitir sus documentos de manera electrónica.
- Si tiene períodos donde haya estado exento de emitir DTE y el motivo.
- Observaciones (como inconcurrencia a llamados del SII o posible suplantación de identidad).
Las observaciones específicas que se están considerando son:
- `inconcurrente` Contribuyente Inconcurrente
- `suplantado` Contribuyente en riesgo de ser suplantado
- `no_ubicado` Contribuyente no ubicado
- `termino_giro` Presentación en trámite término de giro
- `domicilio_inexistente` Domicilio Inexistente
- `actividad_esporadica` Contribuyente tasado para realizar actividad esporádica
- `no_habido_domicilio` Contribuyente no es habido en el domicilio declarado al SII
- `termino_giro_obligatorio` Contribuyente obligado a dar aviso de Término de Giro
Parameters:
- `formato` (query, string)
Responses:
- `200` — Situación Tributaria de un Contribuyente
#### GET /api/v1/sii/contribuyentes/rut/verificar/{rut}/{serie}
Verificación de Cédula RUT
**Permiso requerido**: `query contribuyentes`
Recurso para verificar la validez de la cédula RUT de empresas chilenas.
**Experimental**: este recurso podría no entregar una respuesta correcta el 100% de las veces. Si tienes problemas, avísanos y revisamos para mejorar.
Responses:
- `200` — Verificación de Cédula RUT
#### GET /api/v1/sii/contribuyentes/actividades_economicas
Actividades Económicas
**Permiso requerido**: `query contribuyentes`
Recurso para obtener el listado de actividades económicas de los contribuyentes.
Responses:
- `200`
### API Contribuyentes - Consultas MiSii - Representantes (otros al contribuyente)
#### POST /api/v1/sii/misii/representantes/listado
Representantes del contribuyente
**Permiso requerido**: `query contribuyentes`
Recurso para obtener el listado de representantes del contribuyente.
Además se obtiene el listado de posibles permisos que se pueden asignar.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Respuesta exitosa con datos del representado y sus permisos
### API Contribuyentes - Consultas MiSii - Representados (contribuyente a otros)
#### POST /api/v1/sii/misii/representados/listado
Listado contribuyentes representados
**Permiso requerido**: `query contribuyentes`
Recurso para obtener el listado de representandos autorizados a un contribuyente.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/misii/representados/representar/{rut}/{permisos}
Representar un contribuyente
**Permiso requerido**: `query contribuyentes`
Recurso para asignar un contribuyente que se desea representar en la siguientes llamadas a la API.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200`
### API Contribuyentes - Consultas MiSii - Datos del contribuyente
#### POST /api/v1/sii/misii/contribuyente/datos
Datos del contribuyente
**Permiso requerido**: `query contribuyentes`
Recurso para obtener los datos del contribuyente autenticado en la página MiSii.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Respuesta con los datos del contribuyente
### API SII
#### GET /api/v1/sii/indicadores/uf/anual/{anio}/{mes}/{dia}
Unidad de fomento (UF)
**Permiso requerido**: `query sii`
Este recurso permite entregar los datos de 3 formas:
- Anual
- Mensual
- Diaria
Los valores `:mes` u `:dia` son opcionales.
Responses:
- `200` — Valor de la UF de día específico
#### GET /api/v1/sii/indicadores/correccion_monetaria/anual/{anio}
Corrección monetaria
**Permiso requerido**: `query sii`
Este recurso entrega los datos de manera anual. Se debe considerar que en el resultado se obtendrá para cada año consultado una lista con los valores de la corrección monetaria. Dicha lista tendrá 12 elementos, donde:
- Elemento de índice `0`: es la corrección mensual del "capital inicial".
- Elementos de índices `1` al `11`: es la corrección mensual de los meses de enero a noviembre, siendo enero el índice `1` y noviembre el índice `11`.
En diciembre no existe corrección monetaria mensual (pues estamos en el mes final).
Cada elemento de la lista será un diccionario con índices del `1` al `12`, enero a diciembre respectivamente.
Responses:
- `200` — Valor de la UF de día específico
#### GET /api/v1/sii/indicadores/impuesto_segunda_categoria/anual/{anio}/{mes}
Impuesto de segunda categoría
**Permiso requerido**: `query sii`
Este recurso permite entregar los datos de 2 formas:
- Anual
- Mensual
El valor `:mes` es opcional.
Responses:
- `200`
### API DTE - Código de Asignación de Folios (CAF)
#### POST /api/v1/sii/dte/caf/solicitar/{emisor}/{dte}/{cantidad}
Solicitar CAF
**Permiso requerido**: `query dte`
Recurso que permite solicitar un nuevo XML de un CAF al SII.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/dte/caf/xml/{emisor}/{dte}/{folio_inicial}/{folio_final}/{fecha_autorizacion}
Descargar XML
**Permiso requerido**: `query dte`
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/dte/caf/estado/{emisor}/{dte}/{folio}
Consultar Estado de un Folio
**Permiso requerido**: `query dte`
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` `html`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Consultar Estado de un Folio
#### POST /api/v1/sii/dte/caf/anular/{emisor}/{dte}/{folio_inicial}/{folio_final}
Anulación de Folios
**Permiso requerido**: `query dte`
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` `html`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/dte/caf/solicitudes/{emisor}/{dte}
Listado de Folios Solicitados
**Permiso requerido**: `query dte`
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` `html`
- `pagina` (query, string) — `0` todas las solicitudes que existan
`>0` página específica de las solicitudes de CAF
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Listado de Folios Solicitados
#### POST /api/v1/sii/dte/caf/estados/{emisor}/{dte}/{folio_inicial}/{folio_final}/{estado}
Listado de Folios por Estado
**Permiso requerido**: `query dte`
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Listado de Folios por Estado
### API DTE - Contribuyentes
#### POST /api/v1/sii/dte/contribuyentes/autorizados
Listado Contribuyentes Autorizados
**Permiso requerido**: `query dte`
Permite descargar la base de datos de contribuyentes autorizados por el SII a operar con documentos tributarios electrónicos.
Se incluyen los siguientes datos:
- RUT.
- Razón social.
- Número de resolución que autoriza la emisión de DTE.
- Fecha de resolución que autoriza la emisión de DTE.
- Correo electrónico de intercambio.
- Página web declarada en SII del sofware que se usa.
**Tiempo de respuesta del servicio web**
Este servicio requiere bastante tiempo para entregar la respuesta, puesto que los registros entregados son cercanos al millón. Descargar los datos en formato `csv_sii`, en la mayoría de los casos, debiese ser más rápido que usar `json` o `csv`.
**Datos con problemas en formato** **`json`** **o** **`csv`**
Adicionalmente usar el formato `csv_sii` entregará los datos oficiales del SII sin ser manipulados para darles formato `json` o `csv`. API Gateway evita manipular los datos del SII, por eso de ser necesario, te recomendamos bajar el formato oficial del SII y procesar dicho archivo en tu sistema
Parameters:
- `dia` (query, string) — Día para el cual se desean obtener los contribuyentes
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` versión JSON de los datos que vienen en el archivo CSV descargado del SII
`csv` versión modificada del archivo CSV descargado del SII, codificado en UTF-8
`csv_sii` versión sin modificar del archivo CSV descargado del SII, codificado en ISO-8859-1`0`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200`
#### GET /api/v1/sii/dte/contribuyentes/autorizado/{rut}
Estado Autorización de un Contribuyente
**Permiso requerido**: `query dte`
Este servicio entrega el estado de autorización de un contribuyente para usar Documentos Tributarios Electrónicos (DTE). Se indicará si está o no autorizado, la fecha y número de resolución que lo autoriza, la dirección regional a la que pertenece el contribuyente y si usa el Software del SII Portal MIPYME o Software de Mercado para facturar.
Además, se entregará un listado de los documentos que el contribuyente tiene autorizados a llevar de manera electrónica y desde qué fecha cuenta con la autorización del SII para hacerlo.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` `html`
Responses:
- `200` — Estado Autorización de un Contribuyente
#### POST /api/v1/sii/dte/contribuyentes/autorizado/{rut}
Estado Autorización de un Contribuyente (incluye email)
**Permiso requerido**: `query dte`
Este servicio entrega el estado de autorización de un contribuyente para usar Documentos Tributarios Electrónicos (DTE). Se indicará si está o no autorizado, la fecha y número de resolución que lo autoriza, la dirección regional a la que pertenece el contribuyente y si usa el Software del SII Portal MIPYME o Software de Mercado para facturar.
Además, se entregará un listado de los documentos que el contribuyente tiene autorizados a llevar de manera electrónica y desde qué fecha cuenta con la autorización del SII para hacerlo.
Esta consulta, a diferencia de la que es por `GET`, requiere un certificado digital para poder obtener el correo electrónico de intercambio del contribuyente. Este dato extra es la única diferencia entre esta llamada y la que se hace vía `GET`.
La respuesta se entrega sólo en formato `json`.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json``html`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Estado Autorización de un Contribuyente (incluye email)
#### POST /api/v1/sii/dte/contribuyentes/datos/{contribuyente}
Datos Privados de un Contribuyente
**Permiso requerido**: `query dte`
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` `html`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Datos Personales de un Contribuyente
#### POST /api/v1/sii/dte/contribuyentes/set_datos/{contribuyente}
Asignar Datos Privados de un Contribuyente
**Permiso requerido**: `query dte`
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"datos": {
"emails": {
"administrador": "esteban@example.com",
"intercambio": "dte@example.com",
"sii": "sii@example.com"
},
"software": {
"nombre": "LibreDTE",
"url": "libredte.cl"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/dte/contribuyentes/usuarios/{rut}
Usuarios Autorizados de un Contribuyente
**Permiso requerido**: `query dte`
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` `html`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Usuarios Autorizados de un Contribuyente
#### POST /api/v1/sii/dte/contribuyentes/set_usuario/{contribuyente}
Asignar Usuarios Autorizados a un Contribuyente
**Permiso requerido**: `query dte`
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"usuario": {
"permisos": {
"administrador": false,
"anular_folios": true,
"consultar": true,
"enviar": true,
"firmar": true,
"solicitar_folios": true
},
"run": "66666666-6"
}
}
```
Responses:
- `200`
### API DTE - Documentos Emitidos
Recursos que permiten consultar por documentos emitidos por contribuyentes. Ya sean, emitidos por el propio usuario o por terceros.
Permiten, principalmente, validar documentos emitidos por empresas.
#### POST /api/v1/sii/dte/emitidos/estado_envio/{emisor}/{track_id}
Estado de un envío de XML al SII
**Permiso requerido**: `query dte`
Entrega el estado del envío de un XML de DTE al SII.
**Nota**: solo se pueden consultar por envíoa al SII de empresas que el usuario autenticado con certificado digital tenga acceso.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` `html`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Estado de un envío de XML al SII
#### POST /api/v1/sii/dte/emitidos/verificar
Verificación Avanzada de un Documento en SII
**Permiso requerido**: `query dte`
Este recurso permite hacer una verificación avanzada de un documento emitido enviado al SII.
Lo más importante, permite verificar que la firma electrónica del DTE consultado corresponda con la firma electrónica que el SII tiene registrada para el DTE enviado.
En la respuesta se encontrará la siguiente información:
- Estado del envío del XML al SII.
- Track ID del envío.
- Si la firma coincide o no con la registrada por SII.
- Eventos que el DTE tenga asociados al acuse de recibo.
- Si el documento es o no cedible.
- Fecha de recepción del DTE en el SII.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"dte": {
"dte": 33,
"emisor": "76192083-9",
"fecha": "2017-10-01",
"firma": "pnaJ2qw49PttDIfh5b+xkHW+pToZLzRF2yxVPmKADzjAHTa8RB5tYKjp2eHtQPByta0L7BQgL1KujJeqYk2qMakucRL0GckQgzqrMFL+NEWf+hSZXHnhOtti00i0ZvEb8kDdViTWSxUKQX08qHQSm/KMjNAeCXMlRIXv/rEx112yQsX3pbxKs9uGNER9MwWS7nTakM9WQFllSXmSdty51Y429XX2LA4hrSyv3EZfWvWItUiPBRzWnS2LbG2j10WYmbsN173WUxYpqIN6VzP5Z6iEWknYLDI8wErIwA9yNbAxqB9QTQ+W782V16dJD5scT/wnfH06UkCskiN9gxLfeg==",
"folio": 1000,
"receptor": "76524238-K",
"total": 31724
}
}
```
Responses:
- `200` — Verificación Avanzada de un Documento en SII
### API DTE - Información Electrónica de Compras y Ventas
#### POST /api/v1/sii/dte/iecv/codigo_reemplazo/{emisor}/{periodo}/{operacion}/{tipo}/{track_id}
Obtener Código de Reemplazo de Libro
**Permiso requerido**: `query dte`
Recurso que entrega el código de reemplazo de libro de compras o ventas para poder rectificar un libro.
Nota: sólo para períodos de 201707 hacia atrás.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200`
### API RCV - Registro de Compras
Los documentos en el registro de compras pueden estar en 4 posibles estados:
- `REGISTRO`: documentos que tienen acuse de recibo, fueron pagados al contado o bien pasaron los 8 días y se registraron de manera automática en el registro de compras.
- `PENDIENTE`: documentos sin acuse de recibo que están aún dentro de los 8 días. Pueden ser recibidos o reclamados por el receptor.
- `NO_INCLUIR`: documentos que fueron parte del registro, pero que por X motivo la empresan o desea incluir en su contabilidad.
- `RECLAMADO`: son los documentos que estaban pendientes y fueron reclamados antes de los 8 días.
**Si el contribuyente posee mas de 1000 registros en el mes, se debe utilizar la forma asíncrona.**
#### POST /api/v1/sii/rcv/compras/resumen/{receptor}/{periodo}/{estado}
Resumen de Compras
**Permiso requerido**: `query rcv`
Parameters:
- `formato` (query, string) — `json` `csv`
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato CSV
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Resumen de Compras
#### POST /api/v1/sii/rcv/compras/detalle/{receptor}/{periodo}/{dte}/{estado}
Detalle de Compras
**Permiso requerido**: `query rcv`
Recurso para obtener el detalle de las compras a partir de los datos del Registro de Compras.
El detalle es el listado de documentos de cierto tipo disponibles en el registro de compras. En ningún caso este recurso entregará el listado de items (productos o servicios) de cada documento. Esto no es posible porque ese dato no se encuentra en el listado de documentos del registro de compras.
**Archivo en CSV del RCV del SII**
Se pueden obtener los datos en distintos tipos. Sin embargo, el tipo `rcv_csv` tiene ciertas ventajas:
- No es necesario indicar el código de DTE, se recomienda usar 0 para el campo `dte` en la URL ya que no se usa. Siempre se obtienen todos los tipos de documentos del período.
- Permite obtener los datos de impuestos específicos.
- En general, debería ser el tipo con mejor tiempo de respuesta.
Considerar adicionalmente, que es más rápido usar el tipo `rcv_csv` con el formato `csv`.
**Importante**: el tipo `rcv_csv` y formato `json` sólo funciona con el estado `REGISTRO`. No es posible bajar otros estados con este tipo y formato de datos. Si desea utilizar el topo `rcv_csv` con otro estado deberá usar el formato `csv`.
**Respuesta**
La respuesta incluirá por defecto los datos obtenidos directamente desde el SII, donde los campos vienen desde el SII. Se recomienda revisar el registro de compras para ir comparando aquellos campos que no se entienda a partir de su nombre lo que significan. Adjuntamos una descripción general de los campos:
- `detTipoDoc`: código del tipo de DTE recibido.
- `detRutDoc`: RUT del proveedor, sin dígito verificador.
- `detDvDoc`: dígito verificador del RUT del proveedor.
- `detRznSoc`: razón social del proveedor.
- `detNroDoc`: folio del DTE recibido.
- `detFchDoc`: fecha de emisión del DTE recibido.
- `detFecAcuse`: fecha en que el receptor generó el acuse de recibido (si es que se generó).
- `detFecReclamado`: fecha en que el receptor generó el reclamo (si es que se generó).
- `detFecRecepcion`: fecha de recepción del XML del DTE por parte del SII.
- `detMntExe`: total monto exento.
- `detMntNeto`: total monto neto.
- `detMntIVA`: total monto IVA.
- `detMntTotal`: total del documento.
- `detTipoDocRef`: código del tipo de DTE de la referencia en el DTE recibido.
- `detFolioDocRef`: folio del DTE referenciado en el documento de compra.
- `detEventoReceptor`: código del evento que a realizado el receptor (si se ha realizado).
- `detEventoReceptorLeyenda`: glosa del evento que a realizado el receptor (si se ha realizado).
- `detPcarga`: período contable en el que corresponde registrar este documento de compra.
- `detMntActFijo`: Corresponde al monto del activo fijo del DTE (si fue clasificado como activo fijo).
- `detMntIVAActFijo`: Monto del IVA del activo fijo del DTE (si fue clasificado como activo fijo).
- `detMntIVANoRec`: Monto IVA no recuperable del DTE.
- `detMntCodNoRec`: corresponde el código del IVA no recuperable (si es que hay IVA no recuperable).
- `detAnulado`: cantidad de documentos anulados.
- `detMntSinCredito`: es el monto del IVA sin derecho a crédito fiscal.
- `detCdgSIISucur`: corresponde al código de la sucursal registrada en el SII.
- `detIndServicio`: código del indicador de servicio.
- `detTipoTransaccion`: tipo de transacción del documento.
- `detIndSinCosto`: indica si la compra es sin costo (solo en facturas).
- `detIVAFueraPlazo`: valor del total del IVA que está fuera de plazo, sólo aplica para notas de crédito.
- `detMntNoFact`: monto no facturable del DTE.
- `detIVATerceros`: monto del IVA terceros, sólo cuando hay venta o servicio por cuenta de terceros.
- `detMntPeriodo`: se refiere a la cantidad o monto de dinero declarado durante un período determinado. Este valor puede ser negativo.
- `detCredEc`: es el crédito especial del 65% para Empresas Constructoras.
- `detIVAPropio`: se refiere al monto del Impuesto al Valor Agregado (IVA) propio que ha sido declarado durante un período determinado. Aplica sólo cuando hay venta o servicio por cuenta de terceros.
- `detDepEnvase`: se refiera a la garantía de depósito por envase.
- `detLiqValComIVA`: se refiere al valor líquido de una compra o transacción que incluye el Impuesto al Valor Agregado (IVA).
- `detTasaImp`: se refiere a la tasa o porcentaje de impuesto aplicado a una transacción específica.
- `"detLiqValComExe`: se refiere al valor líquido de una compra o transacción exenta de impuestos.
- `detMntSinCredito`: corresponde al monto sin derecho a crédito.
- `detLiqValComNeto`: se refiere al valor líquido o neto de una compra o transacción.
- `detExpNumId`: se refiere al número de identificación del exportador.
- `detExpNacionalidad`: se refiere a la nacionalidad del exportador.
- `detLiqDvEmisor`: se refiere al dígito verificador del emisor en una transacción o documento tributario.
- `detCodigo`: puede referirse a diferentes códigos asociados a transacciones, productos o servicios en el contexto de los registros - tributarios\`.
- `detTabPuros`: corresponde al impuesto por tabacos manufacturados (cigarros puros)
- `detTabCigarrillos`: corresponde al impuesto por tabacos manufacturados (cigarrillos)
- `detTabElaborado`: corresponde al impuesto por tabacos manufacturados (tabaco elaborado)
- `detIVARetTotal`: se refiere al monto total de Impuesto al Valor Agregado (IVA) retenido en una transacción o período determinado.
- `detIVARetParcial`: Corresponde al monto parcial de Impuesto al Valor Agregado (IVA) retenido en una transacción o período determinado.
- `detIVANoRetenido`: es el monto de Impuesto al Valor Agregado (IVA) que no ha sido retenido en una transacción o período determinado.
- `detImpVehiculo`: corresponde al impuesto a los vehículos automóviles
- `detIVAUsoComun`: se refiere al Impuesto al Valor Agregado (IVA) aplicado a los bienes o servicios de uso común.
- `detTpoImp`: corresponde al código del tipo impuesto del DTE.
- `detLiqRutEmisor`: se refiere al RUT (Rol Único Tributario) del emisor en una transacción o documento tributario.
- `descTipoTransaccion`: descripción de cómo se clasifica el tipo de compra del DTE.
- `detEmisorNota`: se refiere al emisor de una nota de crédito o débito.
- `totalDinrMontoIVANoR`: se refiere al monto total en dinero del Impuesto al Valor Agregado (IVA) no retenido en una transacción o período determinado.
- `detPsjNac`: se refiere al número de pasajeros nacionales en una transacción o documento tributario.
- `detPsjInt`: se refiere al número de pasajeros internacionales en una transacción o documento tributario.
- `detNumInt`: corresponde al número o cantidad relacionada con operaciones o transacciones internacionales.
- `totalDtoiMontoImp`: se refiere al monto total del descuento sobre impuestos en una transacción o período determinado.
- `dcvCodigo`: corresponde al código que permite al SII tener información precisa sobre la actividad económica del contribuyente.
- `dcvEstadoContab`: se refiere al estado contable de una entidad o contribuyente.
- `detLey18211`: corresponde al impuesto del 4.4% por la importación de mercancías extranjeras, efectuada desde Zona Franca Primaria a Zona Franca de Extensión, el cual se calculará sobre el valor CIF de dichas mercancías.
Parameters:
- `formato` (query, string) — `json` `csv`
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `tipo` (query, string) — `rcv` `iecv` `rcv_csv`
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato `csv` con tipo `rcv` o `iecv`
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Detalle de Compras
#### POST /api/v1/sii/rcv/compras/set_tipo_transaccion/{receptor}/{periodo}
Asignación Tipo de Transacción de una Compra
**Permiso requerido**: `query rcv`
Tipos de transacciones que se pueden asignar usando `tipo_transaccion`:
- `1` Compras del giro
- `2` Compras en supermercados o comercios similares
- `3` Adquisición de bienes raíces
- `4` Compra de activo fijo
- `5` Compras con IVA uso común
- `6` Compras sin derecho a crédito
Para el campo `codigo_iva` los posible valores son:
- Caso normal se usa `1` donde la empresa es sólo afecta, no hay IVA de uso común y el IVA es recuperable.
- Caso IVA de uso común se asigna `2`.
- Caso IVA no recuperable, se usará uno de los códigos de IVA no recuperable, ya sean:
- `1` Compras destinadas a IVA a generar operaciones no gravadas o exentas
- `2` Facturas de proveedores registradas fuera de plazo.
- `3` Gastos rechazados.
- `4` Entregas gratuitas (premios, bonificaciones, etc) recibidas.
- `9` Otros.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
},
"documentos": [
{
"codigo_iva": 1,
"dte": 33,
"emisor": "77666555-4",
"folio": 1,
"tipo_transaccion": 1
}
]
}
```
Responses:
- `200`
#### POST /api/v1/sii/rcv/compras/async/solicitar/{receptor}/{periodo}/{dte}/{estado}
Async: Solicitar
Async: Solicitar
Parameters:
- `certificacion` (query, string)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/rcv/compras/async/estado/{receptor}/{periodo}/{id}/{dte}/{estado}
Async: Estado
Async: Estado
Parameters:
- `certificacion` (query, string)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/rcv/compras/async/detalle/{receptor}/{periodo}/{id}/{dte}/{estado}
Async: Detalle
Async: Detalle
Parameters:
- `formato` (query, string) — `json` `csv`
- `certificacion` (query, string)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200`
### API RCV - Registro de Ventas
#### POST /api/v1/sii/rcv/ventas/resumen/{emisor}/{periodo}
Resumen de Ventas
**Permiso requerido**: `query rcv`
Parameters:
- `formato` (query, string) — `json` `csv`
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato CSV
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Resumen de Ventas
#### POST /api/v1/sii/rcv/ventas/detalle/{emisor}/{periodo}/{dte}
Detalle de Ventas
**Permiso requerido**: `query rcv`
Recurso para obtener el detalle de las ventas a partir de los datos del Registro de Ventas.
El detalle es el listado de documentos de cierto tipo disponibles en el registro de ventas. En ningún caso este recurso entregará el listado de items (productos o servicios) de cada documento. Esto no es posible porque ese dato no se encuentra en el listado de documentos del registro de ventas.
**Archivo en CSV del RCV del SII**
Se pueden obtener los datos en distintos tipos. Sin embargo, el tipo `rcv_csv` tiene ciertas ventajas:
- No es necesario indicar el código de DTE, se recomienda usar 0 para el campo `dte` en la URL ya que no se usa. Siempre se obtienen todos los tipos de documentos del período.
- Permite obtener los datos de impuestos específicos.
- En general, debería ser el tipo con mejor tiempo de respuesta.
Considerar adicionalmente, que es más rápido usar el tipo `rcv_csv` con el formato `csv`.
**Respuesta**
La respuesta incluirá por defecto los datos obtenidos directamente desde el SII, donde los campos vienen desde el SII. Se recomienda revisar el registro de compras para ir comparando aquellos campos que no se entienda a partir de su nombre lo que significan. Los más importantes son:
- `detTipoDoc`: código del tipo de DTE emitido.
- `detRutDoc`: RUT del cliente, sin dígito verificador.
- `detDvDoc`: dígito verificador del RUT del cliente.
- `detRznSoc`: razón social del cliente.
- `detNroDoc`: folio del DTE emitido.
- `detFchDoc`: fecha de emisión del DTE emitido.
- `detFecAcuse`: fecha en que el receptor generó el acuse de recibido (si es que se generó).
- `detFecReclamado`: fecha en que el receptor generó el reclamo (si es que se generó).
- `detFecRecepcion`: fecha de recepción del XML del DTE por parte del SII.
- `detMntExe`: total monto exento.
- `detMntNeto`: total monto neto.
- `detMntIVA`: total monto IVA.
- `detMntTotal`: total del documento.
- `detTipoDocRef`: código del tipo de DTE de la referencia en el DTE emitido.
- `detFolioDocRef`: folio del DTE referenciado en el documento de venta.
- `detEventoReceptor`: código del evento que a realizado el receptor (si se ha realizado).
- `detEventoReceptorLeyenda`: glosa del evento que a realizado el receptor (si se ha realizado).
- `detPcarga`: período contable en el que corresponde registrar este documento de venta.
Parameters:
- `formato` (query, string) — `json` `csv`
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `tipo` (query, string) — `rcv` `iecv` `rcv_csv`
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato `csv` con tipo `rcv` o `iecv`
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Detalle de Ventas
#### POST /api/v1/sii/rcv/ventas/set_resumen/{emisor}/{periodo}
Asignación de Resumen de Ventas por Documento
**Permiso requerido**: `query rcv`
Permite asignar un resumen de documentos emitidos al registro de ventas.
Por ejemplo, agregar mensualmente el resumen de boletas emitidas.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
},
"documentos": [
{
"det_mnt_exe": 5000,
"det_mnt_iva": 1900,
"det_mnt_neto": 10000,
"det_mnt_total": 16900,
"det_nro_doc": 10,
"det_tipo_doc": 39
}
]
}
```
Responses:
- `200`
#### POST /api/v1/sii/rcv/ventas/async/solicitar/{receptor}/{periodo}/{dte}
Async: Solicitar
Async: Solicitar
Parameters:
- `certificacion` (query, string)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/rcv/ventas/async/estado/{receptor}/{periodo}/{id}/{dte}
Async: Estado
Async: Estado
Parameters:
- `certificacion` (query, string)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/rcv/ventas/async/detalle/{emisor}/{periodo}/{id}/{dte}
Async: Detalle
Async: Detalle
Parameters:
- `formato` (query, string) — `json` `csv`
- `certificacion` (query, string)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200`
### API RTC
Recursos para interactuar con el [Registro de Transferencia de Créditos](https://palena.sii.cl/rtc/RTC/RTCMenu.html) del SII. En otras palabras, lo asociado a la cesión de documentos tributarios.
**Importante**: en estos recursos, la autenticación del SII fue probada originalmente con certificado digital. Sin embargo, al menos un usuario ha reportado que sólo le funcionó con RUT y clave tributaria del contribuyente. Considerar esto en caso de algún problema al obtener los datos.
#### POST /api/v1/sii/rtc/cesiones/certificado/{emisor}/{dte}/{folio}/{fecha}
Obtener Certificado de Cesión Electrónica
**Permiso requerido**: `query rtc`
Entrega el certificado, en HTML, de la cesión del documento.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/rtc/cesiones/estado_envio/{track_id}
Estado de Envío de Cesión Electrónica
**Permiso requerido**: `query rtc`
Retorna el estado del envío de la cesión al SII.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` `html`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Estado de Envío de Cesión Electrónica
#### POST /api/v1/sii/rtc/cesiones/estado/{emisor}/{dte}/{folio}
Estado de Cesión de un DTE
**Permiso requerido**: `query rtc`
Para el caso con respuesta del SII "Tenedor Vigente" se entrega el estado de un DTE para conocer si está o no cedido junto con datos del estado actual de la cesión.
En el caso de que el SII sólo indique "Documento Cedido" se entrega sólo si está o no cedido.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Estado de Cesión de un DTE
#### POST /api/v1/sii/rtc/cesiones/documentos/{desde}/{hasta}/{consulta}
Listado de Cesiones
**Permiso requerido**: `query rtc`
Obtener las cesiones de un periodo.
Para acceder a la información entregada en esta opción, debe autenticarse:
- **Con RUT/Clave o Certificado Digital**: un contribuyente relacionado con la cesión (como deudor, cedente o cesionario).
- ~~**Con RUT/Clave o Certificado Digital**~~~~: una persona que haya sido autorizada para representar electrónicamente a algunos de los contribuyentes antes indicados.~~
El rango de tiempo de la búsqueda no puede ser superior a 1 mes.
**Importante**: si no obtiene datos al usar el certificado digital. Se recomienda probar con RUT y clave. Ya que en la mayoría de los casos es por permisos y es mejor usar directamente el RUT y clave del contribuyente.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` `xml` `csv` `txt`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Listado de Cesiones
### API BHE - Boletas de Honorarios Emitidas
#### POST /api/v1/sii/bhe/emitidas/documentos/{emisor}/{periodo}
Listado de Boletas de Honorarios Emitidas
**Permiso requerido**: `query bhe`
La consulta de BHE debe ser realizada con el RUT y clave tributaria del emisor de las boletas.
Parameters:
- `formato` (query, string) — `json` `csv`
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato CSV
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200` — Listado de Boletas de Honorarios Emitidas
#### POST /api/v1/sii/bhe/emitidas/emitir
Emitir Boleta de Honorarios
**Permiso requerido**: `query bhe`
El campo `TipoRetencion` puede tener los siguientes valores:
- `0` sin retención. Para sociedades de profesionales que tributan en 1era categoría.
- `1` la retención la hace el receptor de la boleta.
- `2` la retención la hace el contribuyente emisor de la boleta.
Adicionalmente, este recurso permite emitir BHE directamente con las credenciales del emisor o bien con las de un usuario autorizado. En este último caso el RUT del emisor será diferente al RUT usado para autenticar en el SII al usuario.
La API permite emitir una boleta sin datos del receptor. Para esto se debe omitir el campo `Receptor` en el JSON o bien enviar `RUTRecep` con valor `0-0`.
Si se indica `RUTRecep`, y el RUT indicado existe en el SII, la boleta será siempre generada con los datos que el SII tenga (datos oficiales). Y, en dicho caso, los datos enviados en el JSON serán omitidos.
**Datos del emisor**
Actualmente se obtiene la dirección automáticamente del SII, pero siempre la primera dirección (casa matriz).
Para asignar la dirección, y otros datos, en el TAG Emisor hay que enviar estos campos:
- `GiroEmis`
- `Telefono`
- `CodigoDirOrigen`
- `DirOrigen`
- `CmnaOrigen`
Los campos deben tener los valores que usa SII en la web.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
},
"boleta": {
"Detalle": [
{
"MontoItem": 50,
"NmbItem": "Prueba integracion LibreDTE 1"
},
{
"MontoItem": 100,
"NmbItem": "Prueba integracion LibreDTE 2"
}
],
"Encabezado": {
"Emisor": {
"RUTEmisor": "1111111-1"
},
"IdDoc": {
"FchEmis": "2020-09-16",
"TipoRetencion": 1
},
"Receptor": {
"CmnaRecep": "Santa Cruz",
"DirRecep": "Santa Cruz",
"RUTRecep": "66666666-6",
"RznSocRecep": "Receptor generico"
}
}
}
}
```
Responses:
- `200` — Emitir Boleta de Honorarios
#### POST /api/v1/sii/bhe/emitidas/pdf/{codigo}
Descargar PDF Boleta de Honorarios Emitida
**Permiso requerido**: `query bhe`
Este recurso permite obtener el PDF de una boleta de honorarios.
Se utiliza el código de la boleta asignado por SII para obtener el PDF.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/bhe/emitidas/email/{codigo}
Enviar Email con la Boleta de Honorarios Emitida
**Permiso requerido**: `query bhe`
Este recurso permite enviar por email la boleta de honorarios electrónica.
La principal ventaja que tiene enviar por esta vía en vez del software propio, es que se envía directo desde los sistemas del SII. Y ellos adjuntan el mensaje estándar, el PDF y el XML de la boleta.
Se utiliza el código de la boleta asignado por SII para obtener enviar el correo.
El correo del destinatario es opcional. Si se omite se usará el correo que el SIi tenga registrado por defecto para el contribuyente receptor de la boleta.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
},
"destinatario": {
"email": "correo@example.com"
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/bhe/emitidas/anular/{emisor}/{folio}
Anular Boleta de Honorarios Emitida
**Permiso requerido**: `query bhe`
Permite anular una boleta de honorarios electrónica previamente emitida.
La respuesta JSON incluye el índice `boleta_anulada` que puede tener 2 valores al llamar a este recurso:
- `S` indica que la boleta estaba vigente y fue anulada.
- `A` indica que la boleta ya se encontraba anulada previamente.
Parameters:
- `formato` (query, string) — `json` `html`
- `causa` (query, string) — `1` No se efectuó el pago de los servicios por parte del receptor
`2` No se efectuó la prestación de servicios
`3` Error en la digitación
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200` — Anular Boleta de Honorarios Emitida
### API BHE - Boletas de Honorarios Recibidas
#### POST /api/v1/sii/bhe/recibidas/documentos/{receptor}/{periodo}
Listado de Boletas de Honorarios Recibidas
**Permiso requerido**: `query bhe`
La consulta de BHE debe ser realizada con el RUT y clave tributaria del receptor de las boletas.
**¿Tienes muchas boletas recibidas?**
Si tienes más de 100 BHE recibidas en un período, deberás bajar los listados de boletas de manera paginada.
Para esto indica en tu primera llamada el parámetro `pagina=1` en la URL. Esta llamada te entregará:
- La cantidad de boletas disponibles en el período en `n_boletas`.
- Un código llamado `pagina_sig_codigo` que deberá ser pasado en la siguiente llamada.
- El listado de boletas en `boletas`.
Para obtener las siguientes páginas (desde la 2) deberás indicar el parámetro `pagina` y además el parámetro `pagina_sig_codigo` (también en la URL) con el código entregado previamente. Esto permitirá ir obteniendo de manera paginada las boletas.
Finalmente, cuando no queden páginas, el campo `pagina_sig_codigo` tendrá el valor `00000000000000` en la respuesta de la API.
**¿Se pueden consultar por día?**
Si, es posible consultar las boletas de manera diaria. Por ejemplo 20220316 consultará por el día 16 de marzo del año 2022.
**¿Por qué no veo la retención del emisor cuando consulto por mes?**
El SII no entrega la retención por día cuando es del emisor. Se podría asumir con el total de honorarios y el líquido.
**¿Por qué no veo el RUT del emisor cuando consulto por día?**
El SII no entrega el RUT del emisor de la BHE al consultar por día.
**¿Qué significa el valor del campo "estado"?**
- **N:** Vigente.
- **S**: Anulada.
- **V**: Vigente con solicitud de anulacion pendiente.
- **R**: Observada por el Receptor.
- **U**: Observada en la Unidad del SII.
Otros valores de estado no están definidos por SII.
Parameters:
- `formato` (query, string) — `json` `csv`
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato CSV
- `pagina` (query, string)
- `pagina_sig_codigo` (query, string)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Listado de Boletas de Honorarios Recibidas
#### POST /api/v1/sii/bhe/recibidas/pdf/{codigo}
Descargar PDF Boleta de Honorarios Recibida
**Permiso requerido**: `query bhe`
Este recurso permite obtener el PDF de una boleta de honorarios.
Se utiliza el código de la boleta asignado por SII para obtener el PDF.
Un listado de código se encuentra en el servicio que permite obtener el listado de boletas.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/bhe/recibidas/observar/{emisor}/{folio}
Observar Boleta de Honorarios Recibida
**Permiso requerido**: `query bhe`
Permite observar una boleta de honorarios electrónica previamente recibida.
Parameters:
- `formato` (query, string) — `json` `html`
- `causa` (query, string) — `1` No se reconoce la relación contractual o comercial con el emisor
`2` No se reconoce al emisor de la BHE
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Observar Boleta de Honorarios Recibida
### API BTE - Boletas de Terceros Emitidas
#### POST /api/v1/sii/bte/emitidas/resumen/{emisor}/{anio}
Resumen Mensual y Anual de Boletas de Terceros Emitidas
**Permiso requerido**: `query bte`
Obtiene el resumen anual de las boletas emitidas.
Parameters:
- `formato` (query, string) — `json` `csv` `html`
- `csv_delimiter` (query, string) — Delimitador del archivo CSV
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Resumen Mensual de Boletas de Terceros Emitidas
#### POST /api/v1/sii/bte/emitidas/documentos/{emisor}/{periodo}
Listado de Boletas de Terceros Emitidas
**Permiso requerido**: `query bte`
La consulta de BTE debe ser realizada con el RUT y clave tributaria del emisor de las boletas.
Parameters:
- `formato` (query, string) — `json` `csv`
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato CSV
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Listado de Boletas de Terceros Emitidas
#### POST /api/v1/sii/bte/emitidas/emitir
Emitir Boleta de Terceros
**Permiso requerido**: `query bte`
Este recurso permite emitir una BTE en el SII.
Se aplica una tasa de retención que varía según el período de emisión de la BTE:
| Período | Retención |
| --- | --- |
| 2020 | 10,75% |
| 2021 | 11,50% |
| 2022 | 12,25% |
| 2023 | 13,00% |
| 2024 | 13,75% |
| 2025 | 14,50% |
| 2026 | 15,25% |
| 2027 | 16,00% |
| 2028 | 17,00% |
Sin embargo, por el [préstamo solidario](https://www.sii.cl/destacados/prestamo_solidario/), algunos contribuyentes pueden tener una tasa de retención adicional del 3%. Es importante al emitir una BTE [corroborar la tasa de retención](https://documenter.getpostman.com/view/5911929/SWLiYkK9#4d6d7113-bf96-4580-a057-da150000e4cb).
Si el receptor de la BTE tiene retención adiciona del 3%. Envía la tasa real en los datos de la boleta, esto será meramente informativo y no afectará la creación de la boleta en el SII (ya que el SII hace los cálculos sin considerar lo que envíes). Sin embargo, servirá para que en nuestra respuesta se entregue la retención correcta.
Debes enviar la retención en el encabezado:
```
{
"Encabezado": {
"Totales": {
"TasaRetencion": 15.25
}
}
}
```
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
},
"boleta": {
"Detalle": [
{
"MontoItem": 50,
"NmbItem": "Prueba integracion API Gateway 1"
},
{
"MontoItem": 100,
"NmbItem": "Prueba integracion API Gateway 2"
}
],
"Encabezado": {
"Emisor": {
"RUTEmisor": "76192083-9"
},
"IdDoc": {
"FchEmis": "2024-10-10"
},
"Receptor": {
"CmnaRecep": "Santa Cruz",
"DirRecep": "Santa Cruz",
"RUTRecep": "66666666-6",
"RznSocRecep": "Receptor generico"
}
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/bte/emitidas/html/{codigo}
Descargar HTML Boleta de Terceros
**Permiso requerido**: `query bte`
Este recurso permite obtener el HTML de una boleta de terceros.
Se utiliza el código de la boleta asignado por SII para obtener el HTML.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/bte/emitidas/anular/{emisor}/{folio}
Anular Boleta de Terceros Emitida
**Permiso requerido**: `query bte`
Permite anular una Boleta de Terceros Electrónica.
Parameters:
- `formato` (query, string) — `json` `html`
- `causa` (query, string) — `2` No se efectuó la prestación de servicios
`3` Error en la digitación
- `periodo` (query, string) — Período de la boleta (usado para acelerar la consulta si el formato es `json`)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Anular Boleta de Terceros Emitida
#### POST /api/v1/sii/bte/emitidas/documento/{emisor}/{folio}
Buscar datos Boleta de Terceros
**Permiso requerido**: `query bte`
Permite obtener los datos de una Boleta de Terceros Electrónica.
Parameters:
- `periodo` (query, string) — Período de la boleta (acelera la búsqueda)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Buscar datos Boleta de Terceros
#### POST /api/v1/sii/bte/emitidas/receptor_tasa/{emisor}/{receptor}
Obtener la tasa del receptor de una BTE
**Permiso requerido**: `query bte`
Permite obtener la tasa real que se debe usar con el receptor de la Boleta de Terceros Electrónica.
Esto es necesario por la tasa adicional que puede existir en la retención. Ejemplo: 3% adicional por préstamo del SII.
Parameters:
- `periodo` (query, string) — Período de la tasa de retención buscada: AAAAMM
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "76192083-9"
}
}
}
```
Responses:
- `200` — Obtener la tasa del receptor de una BTE
### API BTE - Boletas de Terceros Recibidas
#### POST /api/v1/sii/bte/recibidas/documentos/{receptor}/{periodo}
Listado de Boletas de Terceros Recibidas
**Permiso requerido**: `query bte`
La consulta de BHE debe ser realizada con el RUT y clave tributaria del emisor de las boletas.
Parameters:
- `formato` (query, string) — `json` `csv`
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato CSV
- `error_detail` (query, string)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200` — Listado de Boletas de Honorarios Emitidas
#### POST /api/v1/sii/bte/recibidas/html/{codigo}
Descargar HTML Boleta de Terceros Recibida
**Permiso requerido**: `query bte`
Este recurso permite obtener el HTML de una boleta de terceros.
Se utiliza el código de la boleta asignado por SII para obtener el HTML.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200`
### API Vehículos
#### POST /api/v1/sii/vehiculos/tasacion/buscar
Buscar Tasación Vehicular
**Permiso requerido**: `query vehiculos`
Recurso de la API que permite buscar la tasación fiscal de un vehículo y el valor del permiso de circulación para cierto periodo.
Campos obligatorios:
- `anioTasa`: año fiscal de la búsqueda (por defecto el año actual).
- `categoria`: 1 es vehículo liviano.
- `tipo`: 6 es SUV.
Estos valores son opcionales, pero se recomienda al menos filtrar por `marca` y `anio` para que la búsqueda sea eficiente.
- `marca`: 229 es SUZUKI.
- `modelo`
- `version`
- `anio`
Buscar sin estos filtros, descargará todos los registros, que puede ser útil si se desea obtener todos los datos para almacenar localmente y consultar con posterioridad.
Request body example:
```
{
"anio": 2017,
"anioTasa": 2020,
"categoria": 1,
"marca": 229,
"modelo": "VITARA",
"tipo": 6,
"version": "GLX SPORT"
}
```
Responses:
- `200` — Buscar Tasación Vehicular
#### GET /api/v1/sii/vehiculos/categorias/tipos/{categoria}
Tipos de Vehículos según Categoría
**Permiso requerido**: `query vehiculos`
Responses:
- `200` — Tipos de Vehículos según Categoría
#### GET /api/v1/sii/vehiculos/categorias/marcas/{categoria}
Marcas de Vehículos según Categoría
**Permiso requerido**: `query vehiculos`
Responses:
- `200` — Marcas de Vehículos según Categoría
#### GET /api/v1/sii/vehiculos/categorias/caracteristicas/{categoria}
Características de Vehículos según Categoría
**Permiso requerido**: `query vehiculos`
Responses:
- `200` — Características de Vehículos según Categoría
### API Software MIPYME SII - Contribuyentes
#### POST /api/v1/sii/mipyme/contribuyentes/info/{contribuyente}/{emisor}/{dte}
Información Pública de un Contribuyente
**Permiso requerido**: `query mipyme`
El RUT y clave tributaria del cuerpo de la solicitud deben ser de un usuario (persona) que tenga acceso a la empresa "emisora" que está registrada en el Portal MIPYME del SII.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200` — Información Pública de un Contribuyente
### API Software MIPYME SII - Documentos Borradores
#### POST /api/v1/sii/mipyme/borradores/documentos/{emisor}
Listado de Documentos Borradores
**Permiso requerido**: `query mipyme`
Por defecto se buscan todos los borradores, se puede usar el atributo `filtros` para definir filtrar por cualquier campo del borrador.
Algunos filtros útiles son los siguientes:
- `ptdc_CODIGO` Código del tipo de DTE
- `efxp_RUT_RECEP` RUT sin DV del receptor
- `efxp_MNT_TOTAL` Monto total del DTE
Parameters:
- `formato` (query, string) — `json` `csv`
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato CSV
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
},
"filtros": []
}
```
Responses:
- `200`
#### POST /api/v1/sii/mipyme/borradores/emitir
Emitir Documento Borrador
**Permiso requerido**: `query mipyme`
Considerar los siguientes puntos al emitir un DTE:
- Los datos del emisor si se envían no se usan, se usa lo por defecto del emisor en el SII. Se puede emitir sólo enviando el RUT del emisor.
- Los datos del receptor deben ir por requerimiento de nuestra API, pero no se utilizan para generar el borrador. Se ocuparán los datos por defecto que tenga el receptor en el SII.
- El descuento de un item sólo puede ser en porcentaje.
- El descuento global puede ser en porcentaje o en monto, pero debe ser sólo 1 descuento (no se permiten recargos).
- Los items son máximo 10.
- Las referencias son máximo 3.
- La factura afecta debe llevar sólo items afectos. Si se desea facturar items exentos deberán ir en una factura exenta aparte.
- Para emitir una factura exenta se debe indicar en los items el campo `"IndExe": 1`. En el descuento global, en caso de existir, se debe indicar el campo `"IndExeDR": 1`
- La guía de despacho no puede ir con descuentos, ni por item, ni global.
- No se guarda la forma de pago en el borrador. Por lo que no se puede asignar algo diferente a crédito que es el valor por defecto.
- No se guardan los datos de transporte en el borrador.
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
},
"dte": {
"Detalle": [
{
"NmbItem": "Producto sin código, el más sencillo.",
"PrcItem": 1000,
"QtyItem": 1
},
{
"CdgItem": {
"TpoCodigo": "INT1",
"VlrCodigo": "cod1"
},
"NmbItem": "Producto con código.",
"PrcItem": 1000,
"QtyItem": 1
},
{
"DscItem": "Esta es la descripción del producto.",
"NmbItem": "Producto con descripción.",
"PrcItem": 1000,
"QtyItem": 1
},
{
"NmbItem": "Producto con más de 1 cantidad y con unidad.",
"PrcItem": 1000,
"QtyItem": 3.5,
"UnmdItem": "Un"
},
{
"DescuentoPct": 50,
"NmbItem": "Producto con descuento.",
"PrcItem": 1000,
"QtyItem": 1
}
],
"DscRcgGlobal": {
"TpoMov": "D",
"TpoValor": "%",
"ValorDR": "10"
},
"Encabezado": {
"Emisor": {
"RUTEmisor": "1111111-1"
},
"IdDoc": {
"TipoDTE": 33
},
"RUTSolicita": "1111111-1",
"Receptor": {
"CmnaRecep": "Santa Cruz",
"DirRecep": "Santa Cruz",
"GiroRecep": "Informática",
"RUTRecep": "76192083-9",
"RznSocRecep": "SASCO SpA"
}
},
"Referencia": [
{
"FchRef": "2022-09-03",
"FolioRef": 1,
"TpoDocRef": 52
},
{
"FchRef": "2022-09-01",
"FolioRef": 123,
"RazonRef": "Pedido por Esteban",
"TpoDocRef": 801
}
]
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/mipyme/borradores/eliminar/{emisor}/{codigo}
Eliminar Documento Borrador
**Permiso requerido**: `query mipyme`
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/mipyme/borradores/pdf/{emisor}/{codigo}
Descargar PDF de un Documento Borrador
**Permiso requerido**: `query mipyme`
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200`
### API Software MIPYME SII - Documentos Emitidos
#### POST /api/v1/sii/mipyme/emitidos/documentos/{emisor}
Listado de Documentos Emitidos
**Permiso requerido**: `query mipyme`
Al realizar la búsqueda se pueden utilizar los siguientes filtros:
- `FEC_DESDE` desde qué fecha buscar, formato AAAA-MM-DD.
- `FEC_HASTA` hasta qué fecha buscar, formato AAAA-MM-DD.
- `RUT_RECP` RUT del receptor del documento, sin puntos ni dígito verificador.
- `RZN_SOC` razón social del receptor del documento.
- `TPO_DOC` código de DTE que se está buscando.
- `FOLIO` folio del documento.
- `ESTADO` estado del DTE que se está buscando.
Los valores para `ESTADO` pueden ser:
- `EMI` Documento emitido
- `PRV` Borrador (pre-view) de documento
- `DCD` Certificado rechazado
- `DEI` RUT emisor inválido
- `DFI` Folio DTE inválido
- `DIN` Incompleto
- `DPF` Sin permiso de firma
- `DRF` DTE rechazado por firma
- `DRI` RUT receptor inválido
- `DRR` Rechazado por repetido
- `INI` DTE inicializado
- `RAC` DTE aceptado por receptor
- `RAD` DTE aceptado con discrepancias
- `RNR` DTE no recibido por receptor
- `RRC` DTE recibido por receptor
- `RRH` DTE rechazado por receptor
- `RSR` Recibido sin reparos
Parameters:
- `formato` (query, string) — `json` `csv`
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato CSV
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
},
"filtros": {
"FEC_DESDE": "2019-01-01",
"FEC_HASTA": "2019-12-31"
}
}
```
Responses:
- `200` — Listado de Documentos Emitidos
#### POST /api/v1/sii/mipyme/emitidos/pdf/{emisor}/{dte}/{folio}
Descargar PDF de un DTE Emitido
**Permiso requerido**: `query mipyme`
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/mipyme/emitidos/xml/{emisor}/{dte}/{folio}
Descargar XML de un DTE emitido
**Permiso requerido**: `query mipyme`
Parameters:
- `auth_cache` (query, string)
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200`
### API Software MIPYME SII - Documentos Recibidos
#### POST /api/v1/sii/mipyme/recibidos/documentos/{receptor}
Listado de Documentos Recibidos
**Permiso requerido**: `query mipyme`
Al realizar la búsqueda se pueden utilizar los siguientes filtros:
- `FEC_DESDE` desde qué fecha buscar, formato AAAA-MM-DD.
- `FEC_HASTA` hasta qué fecha buscar, formato AAAA-MM-DD.
- `RUT_EMI` RUT del emisor del documento, sin puntos ni dígito verificador.
- `RZN_SOC` razón social del emisor del documento.
- `TPO_DOC` código de DTE que se está buscando.
- `FOLIO` folio del documento.
- `ESTADO` estado del DTE que se está buscando.
Los valores para `ESTADO` pueden ser:
- `EMI` Documento emitido
- `PRV` Borrador (pre-view) de documento
- `DCD` Certificado rechazado
- `DEI` RUT emisor inválido
- `DFI` Folio DTE inválido
- `DIN` Incompleto
- `DPF` Sin permiso de firma
- `DRF` DTE rechazado por firma
- `DRI` RUT receptor inválido
- `DRR` Rechazado por repetido
- `INI` DTE inicializado
- `RAC` DTE aceptado por receptor
- `RAD` DTE aceptado con discrepancias
- `RNR` DTE no recibido por receptor
- `RRC` DTE recibido por receptor
- `RAL` DTE aceptado Ley 19.983
- `RRH` DTE rechazado por receptor
- `RSR` Recibido sin reparos
Parameters:
- `formato` (query, string) — `json` `csv`
- `csv_delimiter` (query, string) — Delimitador que se debe usar en el formato CSV
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
},
"filtros": {
"FEC_DESDE": "2019-01-01",
"FEC_HASTA": "2019-12-31"
}
}
```
Responses:
- `200` — Listado de Documentos Recibidos
#### POST /api/v1/sii/mipyme/recibidos/pdf/{receptor}/{emisor}/{dte}/{folio}
Descargar PDF de un DTE Recibido
**Permiso requerido**: `query mipyme`
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/mipyme/recibidos/xml/{receptor}/{emisor}/{dte}/{folio}
Descargar XML de un DTE Recibido
**Permiso requerido**: `query mipyme`
Request body example:
```
{
"auth": {
"pass": {
"clave": "",
"rut": "1111111-1"
}
}
}
```
Responses:
- `200`
### API Certificación DTE - Contribuyentes
#### POST /api/v1/sii/dte/certificacion/contribuyentes/datos/{contribuyente}
Datos del contribuyente
**Permiso requerido**: `query dte_cert`
Permite obtener los datos del contribuyente registrado en SII para la confección de los documentos PDF según el formato entregado por el SII.
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"datos": {
"administrador": "66666666-6",
"documentos": [
33
],
"emails": {
"administrador": "esteban@example.com",
"intercambio": "dte@example.com",
"sii": "sii@example.com"
},
"software": {
"nombre": "LibreDTE",
"url": "libredte.cl"
}
}
}
```
Responses:
- `200` — Datos del contribuyente
### API Certificación DTE - Certificación de Facturas y otros documentos
#### POST /api/v1/sii/dte/certificacion/facturas/postular/{contribuyente}
Postulación a Software de Mercado
**Permiso requerido**: `query dte_cert`
Parameters:
- `formato` (query, string) — `json` `html`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"datos": {
"administrador": "66666666-6",
"documentos": [
33
],
"emails": {
"administrador": "esteban@example.com",
"intercambio": "dte@example.com",
"sii": "sii@example.com"
},
"software": {
"nombre": "LibreDTE",
"url": "libredte.cl"
}
}
}
```
Responses:
- `200`
#### POST /api/v1/sii/dte/certificacion/facturas/solicitar_set/{contribuyente}
Solicitar Set de Pruebas
**Permiso requerido**: `query dte_cert`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"sets": [
33
]
}
```
Responses:
- `200`
### API Certificación DTE - Certificación de Boletas
#### POST /api/v1/sii/dte/certificacion/boletas/solicitar_set/{contribuyente}
Solicitar Set de Pruebas de Boletas
**Permiso requerido**: `query dte_cert`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"datos": {
"email": "libredte@sasco.cl"
}
}
```
Responses:
- `200`
### API Facturación - Documentos Tributarios
#### POST /api/v1/libredte/dte/documentos/generar
Generar XML de un DTE
**Permiso requerido**: `query libredte`
Parameters:
- `normalizar` (query, string) — `1` Se usa normalización: se calcularán ciertos valores
`0` No se usa normalización: se deben enviar todos los valores según esquema XML
- `formato` (query, string) — Formato de los datos que se están enviando para crear el DTE:
`json` formato por defecto en JSON
`xml` igual que `json` pero en formato XML
`yaml` igual que `json` pero en formato YAML
`JSONString` String JSON que contiene el JSON completo
`Acepta.Normal` todos los DTE menos boletas ni exportación
`Acepta.Boleta` para generar boletas
`FacturacionCL.XML`
- `gzip` (query, string) — `0` enviar sin comprimir
`1` enviar comprimido
- `retry` (query, string) — Cantidad de intentos de envío que se deben realizar
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"caf": "",
"dte": {
"Detalle": {
"NmbItem": "Venta",
"PrcItem": 10000,
"QtyItem": 1
},
"Encabezado": {
"Emisor": {
"Acteco": "620200",
"CmnaOrigen": "Santa Cruz",
"DirOrigen": "Santa Cruz",
"GiroEmis": "Servicios integrales de informática",
"RUTEmisor": "76192083-9",
"RznSoc": "SASCO SpA"
},
"IdDoc": {
"Folio": 782,
"TipoDTE": 33
},
"Receptor": {
"CmnaRecep": "Santiago",
"DirRecep": "Santiago",
"GiroRecep": "Gobierno",
"RUTRecep": "60803000-K",
"RznSocRecep": "Servicio de Impuestos Internos"
}
}
},
"resolucion": {
"fecha": "2019-12-23",
"numero": 0
}
}
```
Responses:
- `200` — Generar el XML de un DTE
#### POST /api/v1/libredte/dte/documentos/pdf
Generar PDF a partir del XML del DTE
**Permiso requerido**: `query libredte`
Recurso que permite obtener el PDF de un documento tributario electrónico que le ha sido enviado como XML.
Request body example:
```
{
"cedible": true,
"copias_cedibles": 1,
"copias_tributarias": 1,
"extra": {
"codigo_barras": {
"cotizacion": true,
"dte": true,
"incluirrut": false
},
"color": {
"razonsocial": [
14,
66,
170
]
},
"detalle": {
"ancho": {
"CdgItem": 30,
"DescuentoMonto": 22,
"MontoItem": 22,
"PrcItem": 22,
"QtyItem": 15,
"RecargoMonto": 22
},
"fuente": 9,
"posicion": 0
},
"emisor": {
"direccion": false,
"email": false,
"giro": false,
"razonsocial": false,
"telefono": false,
"web": false
},
"historial": {
"datos": {
"Abril": 12,
"Febrero": 12,
"Julio": 5,
"Junio": 4,
"Marzo": 11,
"Mayo": 10.5
},
"titulo": "Consumo de Agua Potable"
},
"img": {
"cotizacion": "",
"historial": "",
"logo": "",
"pie": ""
}
},
"footer": {
"left": "Boletas y Facturas con LibreDTE",
"right": "www.libredte.cl"
},
"formato": "general",
"webVerificacion": false,
"xml": ""
}
```
Responses:
- `200`
#### POST /api/v1/libredte/dte/documentos/escpos
Generar ESCPOS a partir del XML del DTE
**Permiso requerido**: `query libredte`
Recurso que permite obtener el código ESCPOS de un Documento Tributario Electrónico (DTE) a partir de su XML.
El código ESCPOS puede ser enviado directamente a una impresora térmica (papel contínuo).
Tiene como principal ventaja una mejor calidad de impresión versus imprimir en la impresora térmica el PDF del DTE.
El código binario ESCPOS generado ha sido probado correctamente con una impresora Epson TM-T20II Ethernet con el profile `default`.
Request body example:
```
{
"caratula": false,
"cedible": 0,
"copias_cedibles": 1,
"copias_tributarias": 1,
"cut": true,
"footer": true,
"logo": false,
"papelContinuo": 80,
"pdf417": "pdf417",
"profile": "default",
"specialchars": true,
"webVerificacion": false,
"xml": "WE1MIGVuIEJhc2U2NAo="
}
```
Responses:
- `200`
#### POST /api/v1/libredte/dte/formatos/json
Normalizar DTE al formato estándar del SII
**Permiso requerido**: `query libredte`
El campo `dte` del JSON debe ser un string codificado en base64 con los datos del formato desde el que se desea convertir.
Para ver los formatos soportados revisar el recurso "Generar el XML de un DTE".
Request body example:
```
{
"dte": "",
"formato": "Acepta.Boleta"
}
```
Responses:
- `200`
#### POST /api/v1/libredte/dte/rcof/generar
Generar XML de RVD de Boletas (ex RCOF)
**Permiso requerido**: `query libredte`
El Reporte de Ventas Diarias (RDV) o ex RCOF (Reporte de Consumo de Folios) es un archivo XML que se debe enviar de lunes a domingo al SII. Todos los días, existan o no movimientos.
Cada envío que se hace del RCOF, reemplazará al anterior. Siempre y cuando tenga una secuencia siguiente a la última enviada. Dicho de otra forma, el SII sólo considerará el último XML enviado.
El ambiente al que se envía el XML al SII estará determinado por número de resolución indicada en los datos de la solicitud.
Para forzar la generación del RCOF, aunque no existan documentos, siempre considerar el envío de la llave `dtes` en los datos:
{
"fecha": "2021-09-25",
"dtes": [39]
}
El ejemplo anterior (que sólo tiene los campos nuevos), siempre generará un XML con boletas afectas. Y de no existir documentos, el resumen estará en 0.
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"documentos": [
{
"FchDoc": "2020-07-05",
"MntExe": 0,
"MntIVA": 19,
"MntNeto": 100,
"MntTotal": 119,
"NroDoc": 1,
"TasaImp": 19,
"TpoDoc": 39
},
{
"FchDoc": "2020-07-05",
"MntExe": 50,
"MntIVA": 190,
"MntNeto": 1000,
"MntTotal": 1190,
"NroDoc": 2,
"TasaImp": 19,
"TpoDoc": 39
},
{
"FchDoc": "2020-07-05",
"MntExe": 100,
"MntIVA": 0,
"MntNeto": 0,
"MntTotal": 100,
"NroDoc": 2,
"TasaImp": 0,
"TpoDoc": 41
}
],
"emisor": "76192083-9",
"resolucion": {
"fecha": "2019-12-23",
"numero": 0
},
"secuencia": 1
}
```
Responses:
- `200` — Generar RCOF sin movimiento / Generar RCOF
#### POST /api/v1/libredte/dte/cesion/ceder
Generar XML de Cesión de DTE (AEC)
**Permiso requerido**: `query libredte`
Se debe enviar el XML de EnvioDTE codificado en base64 y la respuesta lo entregará de igual forma.
**Declaración jurada**
El campo `cedente.declaracion_jurada` es opcional, si no se especifica se usará una declaración jurada por defecto con el formato:
```
Yo, {usuario_nombre}, RUN {usuario_run}, representando a {cedente_razon_social}, RUT {cedente_rut}, declaro que he puesto a disposición del cesionario {cesionario_razon_social}, RUT {cesionario_rut}, el documento donde constan los recibos de la recepción de mercaderías entregadas o servicios prestados, entregados por parte del deudor de la factura {deudor_razon_social}, RUT {deudor_rut}, de acuerdo a lo establecido en la Ley N° 19.983
```
**Datos cedente**
Es posible indicar los siguientes campos en el índice `cedente` del cuerpo de la solicitud que se asignarán a los índices que se indica en el XML de la cesión en Cesion.DocumentoCesion.Cedente:
- `rut`: se asignará al campo `RUT` del `Cedente` (opcional). Por defecto se asignará el RUT del emisor del DTE cedido (`RUTEmisor`).
- `razon_social`: se asignará al campo `RazonSocial` del `Cedente` (opcional). Por defecto se asignará la razón social del emisor del DTE cedido (`RznSoc`).
- `direccion`: se asignará al campo `Direccion` del `Cedente` (opcional). Por defecto se asignará la dirección de origen unida a la comuna de origen del emisor del DTE cedido (`DirOrigen` y `CmnaOrigen`).
- `email`: se asignará al campo `eMail` del `Cedente` (obligatorio).
La `declaracion_jurada` se obtiene según lo indicado previamente para dicho campo. Respecto al campo `RUTAutorizado` se se obtiene tanto el `RUT` como el `Nombre` de la firma electrónica enviada al consumir el servicio web.
**Datos cesionario**
Es posible indicar los siguientes campos en el índice `cesionario` del cuerpo de la solicitud que se asignarán a los índices que se indican en el XML de la cesión en `Cesion.DocumentoCesion.Cesionario`:
- `rut`: se asignará al campo `RUT` del `Cesionario` (obligatorio).
- `razon_social`: se asignará al campo `RazonSocial` del `Cesionario` (obligatorio).
- `direccion`: se asignará al campo `Direccion` del `Cesionario` (obligatorio).
- `email`: se asignará al campo `eMail` del `Cesionario` (obligatorio).
**Cesión de un documento previmante cedido**
El servicio web no tiene probada la funcionalidad que permite ceder un documento previamente cedido (receder), por lo que no se debe considerar como una característica de la API esta opción.
Si la desea probar, considere que es una función experimental y no se garantiza el funcionamiento.
Para probar esta opción deberá indicar los datos completos del cedente.
Request body example:
```
{
"cedente": {
"email": ""
},
"cert": {
"cert-data": "",
"pkey-data": ""
},
"cesionario": {
"direccion": "",
"email": "",
"razon_social": "",
"rut": "1111111-1"
},
"xml": ""
}
```
Responses:
- `200` — Ceder un DTE
### API Facturación - Envíos al SII
#### POST /api/v1/libredte/dte/envios/enviar
Enviar XML al SII
**Permiso requerido**: `query libredte`
Recurso que permite realizar el envío de un XML AL SII.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `gzip` (query, string) — `0` enviar sin comprimir
`1` enviar comprimido
- `retry` (query, string) — Cantidad de intentos de envío que se deben realizar
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"emisor": "76192083-9",
"xml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iSVNPLTg4NTktMSI/Pgo8RW52aW9CT0xFVEEgeG1sbnM9Imh0dHA6Ly93d3cuc2lpLmNsL1NpaUR0ZSIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSIgeHNpOnNjaGVtYUxvY2F0aW9uPSJodHRwOi8vd3d3LnNpaS5jbC9TaWlEdGUgRW52aW9CT0xFVEFfdjExLnhzZCIgdmVyc2lvbj0iMS4wIj4KICA8U2V0RFRFIElEPSJMaWJyZURURV9TZXREb2MiPgogICAgPENhcmF0dWxhIHZlcnNpb249IjEuMCI+CiAgICAgIDxSdXRFbWlzb3I+NzYxOTIwODMtOTwvUnV0RW1pc29yPgogICAgICA8UnV0RW52aWE+MTYyNjEwNjMtNTwvUnV0RW52aWE+CiAgICAgIDxSdXRSZWNlcHRvcj4xNjI2MTA2My01PC9SdXRSZWNlcHRvcj4KICAgICAgPEZjaFJlc29sPjIwMTktMTItMjM8L0ZjaFJlc29sPgogICAgICA8TnJvUmVzb2w+MDwvTnJvUmVzb2w+CiAgICAgIDxUbXN0RmlybWFFbnY+MjAyMC0wNy0xN1QxMDowODo0OTwvVG1zdEZpcm1hRW52PgogICAgICA8U3ViVG90RFRFPgogICAgICAgIDxUcG9EVEU+Mzk8L1Rwb0RURT4KICAgICAgICA8TnJvRFRFPjE8L05yb0RURT4KICAgICAgPC9TdWJUb3REVEU+CiAgICA8L0NhcmF0dWxhPgogICAgPERURSB2ZXJzaW9uPSIxLjAiPgogIDxEb2N1bWVudG8gSUQ9IkxpYnJlRFRFX1QzOUY1NzciPgogICAgPEVuY2FiZXphZG8+CiAgICAgIDxJZERvYz4KICAgICAgICA8VGlwb0RURT4zOTwvVGlwb0RURT4KICAgICAgICA8Rm9saW8+NTc3PC9Gb2xpbz4KICAgICAgICA8RmNoRW1pcz4yMDIwLTA3LTE3PC9GY2hFbWlzPgogICAgICAgIDxJbmRTZXJ2aWNpbz4zPC9JbmRTZXJ2aWNpbz4KICAgICAgPC9JZERvYz4KICAgICAgPEVtaXNvcj4KICAgICAgICA8UlVURW1pc29yPjc2MTkyMDgzLTk8L1JVVEVtaXNvcj4KICAgICAgICA8UnpuU29jRW1pc29yPlNBU0NPIFNwQTwvUnpuU29jRW1pc29yPgogICAgICAgIDxHaXJvRW1pc29yPlNlcnZpY2lvcyBpbnRlZ3JhbGVzIGRlIGluZm9ybeF0aWNhPC9HaXJvRW1pc29yPgogICAgICAgIDxEaXJPcmlnZW4+RGFuaWVsIEJhcnJvcyBHcmV6IDE5MTwvRGlyT3JpZ2VuPgogICAgICAgIDxDbW5hT3JpZ2VuPlNhbnRhIENydXo8L0NtbmFPcmlnZW4+CiAgICAgIDwvRW1pc29yPgogICAgICA8UmVjZXB0b3I+CiAgICAgICAgPFJVVFJlY2VwPjE2MjYxMDYzLTU8L1JVVFJlY2VwPgogICAgICAgIDxSem5Tb2NSZWNlcD5Fc3RlYmFuIEVJUkw8L1J6blNvY1JlY2VwPgogICAgICAgIDxDb250YWN0bz4rNTYgOSA3NDIxOTUzMjwvQ29udGFjdG8+CiAgICAgICAgPERpclJlY2VwPlNhbnRpYWdvPC9EaXJSZWNlcD4KICAgICAgICA8Q21uYVJlY2VwPlNhbnRpYWdvPC9DbW5hUmVjZXA+CiAgICAgIDwvUmVjZXB0b3I+CiAgICAgIDxUb3RhbGVzPgogICAgICAgIDxNbnRUb3RhbD4yMDA8L01udFRvdGFsPgogICAgICA8L1RvdGFsZXM+CiAgICA8L0VuY2FiZXphZG8+CiAgICA8RGV0YWxsZT4KICAgICAgPE5yb0xpbkRldD4xPC9Ocm9MaW5EZXQ+CiAgICAgIDxObWJJdGVtPnAxPC9ObWJJdGVtPgogICAgICA8UXR5SXRlbT4xPC9RdHlJdGVtPgogICAgICA8UHJjSXRlbT4xOTkuOTI8L1ByY0l0ZW0+CiAgICAgIDxNb250b0l0ZW0+MjAwPC9Nb250b0l0ZW0+CiAgICA8L0RldGFsbGU+CiAgICA8UmVmZXJlbmNpYT4KICAgICAgPE5yb0xpblJlZj4xPC9Ocm9MaW5SZWY+CiAgICAgIDxSYXpvblJlZj5FbWFpbCByZWNlcHRvcjogZXN0ZWJhbkBkZWxhZi5jbDwvUmF6b25SZWY+CiAgICA8L1JlZmVyZW5jaWE+CiAgICA8VEVEIHZlcnNpb249IjEuMCI+CiAgPEREPgogICAgPFJFPjc2MTkyMDgzLTk8L1JFPgogICAgPFREPjM5PC9URD4KICAgIDxGPjU3NzwvRj4KICAgIDxGRT4yMDIwLTA3LTE3PC9GRT4KICAgIDxSUj4xNjI2MTA2My01PC9SUj4KICAgIDxSU1I+RXN0ZWJhbiBFSVJMPC9SU1I+CiAgICA8TU5UPjIwMDwvTU5UPgogICAgPElUMT5wMTwvSVQxPgogICAgPENBRiB2ZXJzaW9uPSIxLjAiPgo8REE+CjxSRT43NjE5MjA4My05PC9SRT4KPFJTPlNBU0NPIFNQQTwvUlM+CjxURD4zOTwvVEQ+CjxSTkc+PEQ+MTE8L0Q+PEg+MTAxMDwvSD48L1JORz4KPEZBPjIwMTYtMDItMTM8L0ZBPgo8UlNBUEs+PE0+MnZXTmg0dGlldldYVjF4UnRYMjlRYjB2NU9QYzV0eEFtdWk0SHFUNHlNOFZNMkwxNHAxeWNoa09aYXh3L3I1WkIxWVNYdmNFRnUrY2J3VHVHL0QxeFE9PTwvTT48RT5Bdz09PC9FPjwvUlNBUEs+CjxJREs+MTAwPC9JREs+CjwvREE+CjxGUk1BIGFsZ29yaXRtbz0iU0hBMXdpdGhSU0EiPldJVDRTTklaUTlGNmNPVHJ1WnVJVzhYYTdNN3BOZmVOTnhIQXpaMzg2c09CVE05T0YwcHFuVkM5anllU1ZkQmxwM1pMYmN5VWZrcGdyc0gzVVNmT1BBPT08L0ZSTUE+CjwvQ0FGPgogICAgPFRTVEVEPjIwMjAtMDctMTdUMTA6MDg6NDk8L1RTVEVEPgogIDwvREQ+CiAgPEZSTVQgYWxnb3JpdG1vPSJTSEExd2l0aFJTQSI+ZjVVQnpPb21MNDNNcUZoMTUyRnh1YzhQa1Q0RXI1K2pNcTZjN3VTYmYzcVdYVmt2eVRPV1VvcXRIOFo4TEprcUJyL1dVeER5UmJHMjJKMkFLR2ZsNVE9PTwvRlJNVD4KPC9URUQ+CiAgPFRtc3RGaXJtYT4yMDIwLTA3LTE3VDEwOjA4OjQ5PC9UbXN0RmlybWE+PC9Eb2N1bWVudG8+CjxTaWduYXR1cmUgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyMiPjxTaWduZWRJbmZvIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48Q2Fub25pY2FsaXphdGlvbk1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzIwMDEvUkVDLXhtbC1jMTRuLTIwMDEwMzE1Ii8+PFNpZ25hdHVyZU1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNyc2Etc2hhMSIvPjxSZWZlcmVuY2UgVVJJPSIjTGlicmVEVEVfVDM5RjU3NyI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNlbnZlbG9wZWQtc2lnbmF0dXJlIi8+PC9UcmFuc2Zvcm1zPjxEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjc2hhMSIvPjxEaWdlc3RWYWx1ZT5sMGd2UXVITklYcENCQU45bWRSYlhBaE1VczQ9PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPlZiZ1dTeUFkdHJKam1nWURDcUxVNElYSTVUV05tMkN1N0o2L3FnVThLWFFOWVNsZ3BVdjdKM0kybHpBUHpLemsKUUhLTlByTHc5SW5QSWxpSlNybTU3YjJzdXlkVndXMFZEOCs5Tkp3SkVkSFBmM1R4VXRraFNVWGF4SytCOGQ4RwpDWU1xQkx5cUVUOUxhNHFxbUVWUDVQd2VYY3FZeFF1TXczSnBMU0g4SG1UNXpLdmJ3c29HNERNSFdvUFZyeWxxCjV2Y0VaTytJOVpZb0NydzM0b1l3YnhqMHFob3VvcXNBbG9WZWdueFJQTXhzV0dJVXAwQnpya3dROERYek5YaHAKNlJKTWJzMnRpcHF3VDVhUEFQYWFVNS9jZ0ozaGlEaC8xU3JZR1RiLzY0YzZFaDI0VkNNMDZHU09MNGhBSkpYdgpraEgvVlhhM25mbTM1eFM5RURBbkVBPT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxLZXlWYWx1ZT48UlNBS2V5VmFsdWU+PE1vZHVsdXM+bEhJODN0YzI1YWZtdUQ1NFRLbFF2RWE4SnJseXEyeHJiU3Nld2pwTXlYa3hTWlZnazRqdys0d1N5VWtlakZoTQplbUlsUHRndlJFZHVhNHNUV3FxUldXckovWmFqbWIrcm5qdC9LSlF0Q0tSaStaelZKMXM0bVllZWhKRmxKdDlyCk0zN0JMSUk4bThMN1lqUGRuaDVIbzBJYTVtcmFZeGM2QStUQ1VEWHN4TWxaM1NYRkpoMzB1Z0hvNG1NdUZTbmkKdUdIemlYb3YwWXV3eVgzZm1LbXEzLyt4L20wVDA4MGlDc1NSUGZPTXBqajY2a1ltbndSQW5DYzdhbFYyTDQzTApTYkRDL0dqTERxZHIrSkNrdmhmbUdreEJ2ZnM4Z2JjZnROMDNmWVNuWGdSbXJCN3QvT3BHM0JrVGtJbjlBK0JnClNVcXdNQVRFNW9DazJRL3BFaEZzMXc9PTwvTW9kdWx1cz48RXhwb25lbnQ+QVFBQjwvRXhwb25lbnQ+PC9SU0FLZXlWYWx1ZT48L0tleVZhbHVlPjxYNTA5RGF0YT48WDUwOUNlcnRpZmljYXRlPk1JSUdiekNDQlZlZ0F3SUJBZ0lEQVdscE1BMEdDU3FHU0liM0RRRUJDd1VBTUlHbU1Rc3dDUVlEVlFRR0V3SkQKVERFWU1CWUdBMVVFQ2hNUFFXTmxjSFJoTG1OdmJTQlRMa0V1TVVnd1JnWURWUVFERXo5QlkyVndkR0V1WTI5dApJRUYxZEc5eWFXUmhaQ0JEWlhKMGFXWnBZMkZrYjNKaElFTnNZWE5sSURJZ1VHVnljMjl1WVNCT1lYUjFjbUZzCklDMGdSelF4SGpBY0Jna3Foa2lHOXcwQkNRRVdEMmx1Wm05QVlXTmxjSFJoTG1OdmJURVRNQkVHQTFVRUJSTUsKT1RZNU1Ua3dOVEF0T0RBZUZ3MHhOekV4TURZeE5ETTNOVEphRncweU1ERXhNRFl4TkRNM05USmFNSUdLTVFzdwpDUVlEVlFRR0V3SkRUREVZTUJZR0ExVUVEQk1QVUVWU1UwOU9RU0JPUVZSVlVrRk1NU3N3S1FZRFZRUURFeUpGClUxUkZRa0ZPSUVWRVZVRlNSRThnUkVVZ1RFRWdSbFZGVGxSRklGSlZRa2xQTVI4d0hRWUpLb1pJaHZjTkFRa0IKRmhCbGMzUmxZbUZ1UUdSbGJHRm1MbU5zTVJNd0VRWURWUVFGRXdveE5qSTJNVEEyTXkwMU1JSUJJakFOQmdrcQpoa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQWxISTgzdGMyNWFmbXVENTRUS2xRdkVhOEpybHlxMnhyCmJTc2V3anBNeVhreFNaVmdrNGp3KzR3U3lVa2VqRmhNZW1JbFB0Z3ZSRWR1YTRzVFdxcVJXV3JKL1pham1iK3IKbmp0L0tKUXRDS1JpK1p6VkoxczRtWWVlaEpGbEp0OXJNMzdCTElJOG04TDdZalBkbmg1SG8wSWE1bXJhWXhjNgpBK1RDVURYc3hNbFozU1hGSmgzMHVnSG80bU11RlNuaXVHSHppWG92MFl1d3lYM2ZtS21xMy8reC9tMFQwODBpCkNzU1JQZk9NcGpqNjZrWW1ud1JBbkNjN2FsVjJMNDNMU2JEQy9HakxEcWRyK0pDa3ZoZm1Ha3hCdmZzOGdiY2YKdE4wM2ZZU25YZ1JtckI3dC9PcEczQmtUa0luOUErQmdTVXF3TUFURTVvQ2syUS9wRWhGczF3SURBUUFCbzRJQwp2akNDQXJvd0h3WURWUjBqQkJnd0ZvQVVaYVdyUGovSXRsRnRFWDVmd3dvSDVrT2dDTFl3SFFZRFZSME9CQllFCkZQeFJhYVVWYm9IRGU5MUw3cXU4RGhVc0hwN2hNQXNHQTFVZER3UUVBd0lFOERBZEJnTlZIU1VFRmpBVUJnZ3IKQmdFRkJRY0RBZ1lJS3dZQkJRVUhBd1F3RVFZSllJWklBWWI0UWdFQkJBUURBZ1dnTUlIMUJnTlZIU0FFZ2UwdwpnZW93Z2VjR0NDc0dBUVFCdFdzQ01JSGFNREVHQ0NzR0FRVUZCd0lCRmlWb2RIUndjem92TDJGalp6UXVZV05sCmNIUmhMbU52YlM5RFVGTXRRV05sY0hSaFkyOXRNSUdrQmdnckJnRUZCUWNDQWpDQmx6QVdGZzlCWTJWd2RHRXUKWTI5dElGTXVRUzR3QXdJQkNScDlSV3dnZEdsMGRXeGhjaUJvWVNCemFXUnZJSFpoYkdsa1lXUnZJR1Z1SUdadgpjbTFoSUc5dWJHbHVaU3dnY1hWbFpHRnVaRzhnYUdGaWFXeHBkR0ZrYnlCbGJDQkRaWEowYVdacFkyRmtieUJ3CllYSmhJSFZ6YnlCMGNtbGlkWFJoY21sdkxDQndZV2R2Y3l3Z1kyOXRaWEpqYVc4Z2VTQnZkSEp2Y3k0d1dnWUQKVlIwU0JGTXdVYUFZQmdnckJnRUVBY0VCQXFBTUZnbzVOamt4T1RBMU1DMDRvQ1FHQ0NzR0FRVUZCd2dEb0JndwpGZ3dLT1RZNU1Ua3dOVEF0T0FZSUt3WUJCQUhCQVFLQkQybHVabTlBWVdObGNIUmhMbU52YlRCYkJnTlZIUkVFClZEQlNvQmdHQ0NzR0FRUUJ3UUVCb0F3V0NqRTJNall4TURZekxUV2dKQVlJS3dZQkJRVUhDQU9nR0RBV0RBb3gKTmpJMk1UQTJNeTAxQmdnckJnRUVBY0VCQW9FUVpYTjBaV0poYmtCa1pXeGhaaTVqYkRCSEJnZ3JCZ0VGQlFjQgpBUVE3TURrd053WUlLd1lCQlFVSE1BR0dLMmgwZEhCek9pOHZZV05uTkM1aFkyVndkR0V1WTI5dEwyRmpaelF2CmIyTnpjQzlEYkdGelpUSXRSelF3UHdZRFZSMGZCRGd3TmpBMG9ES2dNSVl1YUhSMGNITTZMeTloWTJjMExtRmoKWlhCMFlTNWpiMjB2WVdObk5DOWpjbXd2UTJ4aGMyVXlMVWMwTG1OeWJEQU5CZ2txaGtpRzl3MEJBUXNGQUFPQwpBUUVBT3BORjMranRqOENSbEhRRkduWGhmMHNBWGduV2s1R0xGbko5VTQyUDEyTC91b1VkV0F3WEVKNGc0Zmh1CjROdGhPdTBqL2o3OXlmYzJuL1dQUHJRUEl5VjFjaSs5UG9NcXUwU1VYVnBVdC93N0JIUFY2Wm00ZXRqQjhubVUKb1RHUlZLWnUxZktCOTE5TlRGTU1ELzFaNHZ3RWdlYVhSMjIzUURsVnZTQW1wenpvcGY0bzlRelptOHBpcTZDTQpnQ3p0UjkvOC9RSjRhWWs0cmdhYi9scnB1U1RMRURjT2hkZHJKd1l0Q3dpdE1lcjZoMVE0NWswa3BWMHphd0R0ClovaHFXakluSHZZelpUY1JNNjk5SThWbFl0MVQzb1cyWWJmSXZpMHlYV3FFK3FRVG1WcHFDdG5yaTBMTElJNjUKNWZyY3BGTElPN1p4TXBobzRmalNNa3FlMEE9PTwvWDUwOUNlcnRpZmljYXRlPjwvWDUwOURhdGE+PC9LZXlJbmZvPjwvU2lnbmF0dXJlPjwvRFRFPgogIDwvU2V0RFRFPgo8U2lnbmF0dXJlIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48U2lnbmVkSW5mbyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSI+PENhbm9uaWNhbGl6YXRpb25NZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIvPjxTaWduYXR1cmVNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjcnNhLXNoYTEiLz48UmVmZXJlbmNlIFVSST0iI0xpYnJlRFRFX1NldERvYyI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNlbnZlbG9wZWQtc2lnbmF0dXJlIi8+PC9UcmFuc2Zvcm1zPjxEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjc2hhMSIvPjxEaWdlc3RWYWx1ZT40ZlArbW9TTTJtYTFDMENUTmpONS9wNEEwTDg9PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPklzM3ZnaVBDbzhjMzZpRWg4U3lZeXc4aDl0VXUyeEczaEFZK0pzR2taeS9DVjh3UXZVTHFCY091WU1VSzVDOUIKUXJqbm9MeFZybFlXam9IeEl0czdCeHEwK1Y1RGxzVFlveFhFWDFRZWJneVZJOXd1cGlqYU9EOWNwbnE2WWFydwo2SjZEcmxmMDJxZWJ6VDZ5WjVFazZxZXVNTEFpZDE3NTRDQ0ZDeGZyeWo0RFBGT1hocGdXZHJkMzM1ejZVQXF0CjB4RWthR2RqTDRJVncvL21TbUQvbnl5YnQrM3kwaFJqTUVjMjhYSW9HcHcrWnM4K2dLNWJQTHZOWXNWM2dUb2cKSXg0N0ExNXRxSmZNYzVlU2pyamZydXFoV0xDeFltVE9EMTFIbWpZUFpLbFlUblJ2NlBTRnNncVc1d2pYZG56Ygo4ZVJ4bDdsSWxiNlFRZ3JVVTRzYUpnPT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxLZXlWYWx1ZT48UlNBS2V5VmFsdWU+PE1vZHVsdXM+bEhJODN0YzI1YWZtdUQ1NFRLbFF2RWE4SnJseXEyeHJiU3Nld2pwTXlYa3hTWlZnazRqdys0d1N5VWtlakZoTQplbUlsUHRndlJFZHVhNHNUV3FxUldXckovWmFqbWIrcm5qdC9LSlF0Q0tSaStaelZKMXM0bVllZWhKRmxKdDlyCk0zN0JMSUk4bThMN1lqUGRuaDVIbzBJYTVtcmFZeGM2QStUQ1VEWHN4TWxaM1NYRkpoMzB1Z0hvNG1NdUZTbmkKdUdIemlYb3YwWXV3eVgzZm1LbXEzLyt4L20wVDA4MGlDc1NSUGZPTXBqajY2a1ltbndSQW5DYzdhbFYyTDQzTApTYkRDL0dqTERxZHIrSkNrdmhmbUdreEJ2ZnM4Z2JjZnROMDNmWVNuWGdSbXJCN3QvT3BHM0JrVGtJbjlBK0JnClNVcXdNQVRFNW9DazJRL3BFaEZzMXc9PTwvTW9kdWx1cz48RXhwb25lbnQ+QVFBQjwvRXhwb25lbnQ+PC9SU0FLZXlWYWx1ZT48L0tleVZhbHVlPjxYNTA5RGF0YT48WDUwOUNlcnRpZmljYXRlPk1JSUdiekNDQlZlZ0F3SUJBZ0lEQVdscE1BMEdDU3FHU0liM0RRRUJDd1VBTUlHbU1Rc3dDUVlEVlFRR0V3SkQKVERFWU1CWUdBMVVFQ2hNUFFXTmxjSFJoTG1OdmJTQlRMa0V1TVVnd1JnWURWUVFERXo5QlkyVndkR0V1WTI5dApJRUYxZEc5eWFXUmhaQ0JEWlhKMGFXWnBZMkZrYjNKaElFTnNZWE5sSURJZ1VHVnljMjl1WVNCT1lYUjFjbUZzCklDMGdSelF4SGpBY0Jna3Foa2lHOXcwQkNRRVdEMmx1Wm05QVlXTmxjSFJoTG1OdmJURVRNQkVHQTFVRUJSTUsKT1RZNU1Ua3dOVEF0T0RBZUZ3MHhOekV4TURZeE5ETTNOVEphRncweU1ERXhNRFl4TkRNM05USmFNSUdLTVFzdwpDUVlEVlFRR0V3SkRUREVZTUJZR0ExVUVEQk1QVUVWU1UwOU9RU0JPUVZSVlVrRk1NU3N3S1FZRFZRUURFeUpGClUxUkZRa0ZPSUVWRVZVRlNSRThnUkVVZ1RFRWdSbFZGVGxSRklGSlZRa2xQTVI4d0hRWUpLb1pJaHZjTkFRa0IKRmhCbGMzUmxZbUZ1UUdSbGJHRm1MbU5zTVJNd0VRWURWUVFGRXdveE5qSTJNVEEyTXkwMU1JSUJJakFOQmdrcQpoa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQWxISTgzdGMyNWFmbXVENTRUS2xRdkVhOEpybHlxMnhyCmJTc2V3anBNeVhreFNaVmdrNGp3KzR3U3lVa2VqRmhNZW1JbFB0Z3ZSRWR1YTRzVFdxcVJXV3JKL1pham1iK3IKbmp0L0tKUXRDS1JpK1p6VkoxczRtWWVlaEpGbEp0OXJNMzdCTElJOG04TDdZalBkbmg1SG8wSWE1bXJhWXhjNgpBK1RDVURYc3hNbFozU1hGSmgzMHVnSG80bU11RlNuaXVHSHppWG92MFl1d3lYM2ZtS21xMy8reC9tMFQwODBpCkNzU1JQZk9NcGpqNjZrWW1ud1JBbkNjN2FsVjJMNDNMU2JEQy9HakxEcWRyK0pDa3ZoZm1Ha3hCdmZzOGdiY2YKdE4wM2ZZU25YZ1JtckI3dC9PcEczQmtUa0luOUErQmdTVXF3TUFURTVvQ2syUS9wRWhGczF3SURBUUFCbzRJQwp2akNDQXJvd0h3WURWUjBqQkJnd0ZvQVVaYVdyUGovSXRsRnRFWDVmd3dvSDVrT2dDTFl3SFFZRFZSME9CQllFCkZQeFJhYVVWYm9IRGU5MUw3cXU4RGhVc0hwN2hNQXNHQTFVZER3UUVBd0lFOERBZEJnTlZIU1VFRmpBVUJnZ3IKQmdFRkJRY0RBZ1lJS3dZQkJRVUhBd1F3RVFZSllJWklBWWI0UWdFQkJBUURBZ1dnTUlIMUJnTlZIU0FFZ2UwdwpnZW93Z2VjR0NDc0dBUVFCdFdzQ01JSGFNREVHQ0NzR0FRVUZCd0lCRmlWb2RIUndjem92TDJGalp6UXVZV05sCmNIUmhMbU52YlM5RFVGTXRRV05sY0hSaFkyOXRNSUdrQmdnckJnRUZCUWNDQWpDQmx6QVdGZzlCWTJWd2RHRXUKWTI5dElGTXVRUzR3QXdJQkNScDlSV3dnZEdsMGRXeGhjaUJvWVNCemFXUnZJSFpoYkdsa1lXUnZJR1Z1SUdadgpjbTFoSUc5dWJHbHVaU3dnY1hWbFpHRnVaRzhnYUdGaWFXeHBkR0ZrYnlCbGJDQkRaWEowYVdacFkyRmtieUJ3CllYSmhJSFZ6YnlCMGNtbGlkWFJoY21sdkxDQndZV2R2Y3l3Z1kyOXRaWEpqYVc4Z2VTQnZkSEp2Y3k0d1dnWUQKVlIwU0JGTXdVYUFZQmdnckJnRUVBY0VCQXFBTUZnbzVOamt4T1RBMU1DMDRvQ1FHQ0NzR0FRVUZCd2dEb0JndwpGZ3dLT1RZNU1Ua3dOVEF0T0FZSUt3WUJCQUhCQVFLQkQybHVabTlBWVdObGNIUmhMbU52YlRCYkJnTlZIUkVFClZEQlNvQmdHQ0NzR0FRUUJ3UUVCb0F3V0NqRTJNall4TURZekxUV2dKQVlJS3dZQkJRVUhDQU9nR0RBV0RBb3gKTmpJMk1UQTJNeTAxQmdnckJnRUVBY0VCQW9FUVpYTjBaV0poYmtCa1pXeGhaaTVqYkRCSEJnZ3JCZ0VGQlFjQgpBUVE3TURrd053WUlLd1lCQlFVSE1BR0dLMmgwZEhCek9pOHZZV05uTkM1aFkyVndkR0V1WTI5dEwyRmpaelF2CmIyTnpjQzlEYkdGelpUSXRSelF3UHdZRFZSMGZCRGd3TmpBMG9ES2dNSVl1YUhSMGNITTZMeTloWTJjMExtRmoKWlhCMFlTNWpiMjB2WVdObk5DOWpjbXd2UTJ4aGMyVXlMVWMwTG1OeWJEQU5CZ2txaGtpRzl3MEJBUXNGQUFPQwpBUUVBT3BORjMranRqOENSbEhRRkduWGhmMHNBWGduV2s1R0xGbko5VTQyUDEyTC91b1VkV0F3WEVKNGc0Zmh1CjROdGhPdTBqL2o3OXlmYzJuL1dQUHJRUEl5VjFjaSs5UG9NcXUwU1VYVnBVdC93N0JIUFY2Wm00ZXRqQjhubVUKb1RHUlZLWnUxZktCOTE5TlRGTU1ELzFaNHZ3RWdlYVhSMjIzUURsVnZTQW1wenpvcGY0bzlRelptOHBpcTZDTQpnQ3p0UjkvOC9RSjRhWWs0cmdhYi9scnB1U1RMRURjT2hkZHJKd1l0Q3dpdE1lcjZoMVE0NWswa3BWMHphd0R0ClovaHFXakluSHZZelpUY1JNNjk5SThWbFl0MVQzb1cyWWJmSXZpMHlYV3FFK3FRVG1WcHFDdG5yaTBMTElJNjUKNWZyY3BGTElPN1p4TXBobzRmalNNa3FlMEE9PTwvWDUwOUNlcnRpZmljYXRlPjwvWDUwOURhdGE+PC9LZXlJbmZvPjwvU2lnbmF0dXJlPjwvRW52aW9CT0xFVEE+Cg=="
}
```
Responses:
- `200` — Enviar DTE al SII
#### POST /api/v1/libredte/dte/envios/estado
Consultar Envio de XML al SII
**Permiso requerido**: `query libredte`
Recurso que permite consultar por el estado de un DTE enviado al SII.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"dte": 39,
"emisor": "76192083-9",
"folio": 0,
"track_id": 12094110
}
```
Responses:
- `200` — Consultar Estado de un Envío de DTE al SII (boleta con folio) / Consultar Estado de un Envío de DTE al SII (boleta sin folio)
### API Facturación - Intercambios de DTE
Recursos asociados al proceso de Intercambio de DTE entre contribuyentes. Proceso durante el cual un Proveedor envía uno o más DTE a un Cliente y este indica si acepta o reclama dichos documentos.
#### POST /api/v1/libredte/dte/intercambios/respuesta_sii
Registrar Respuesta de Intercambio de DTE en el SII
**Permiso requerido**: `query libredte`
Permite ingresar la respuesta al proceso de intercambio en el SII. En general se permite recibir o reclamar un documento.
Específicamente, las acciones que se pueden asignar a un documento, usando el campo `EstadoRecepDTE` son:
- `ERM` Otorga recibo de mercaderías o servicios.
- `ACD` Acepta contenido del documento.
- `RCD` Reclamo al contenido del documento.
- `RFP` Reclamo por falta parcial de mercaderías.
- `RFT` Reclamo por falta total de mercaderías.
Es importante indicar que el IVA crédito de un documento sólo puede ser usado en el período donde el DTE fue recibido. O sea, si un documento es Aceptado `ACD` en Enero, pero Recibido `ERM` en Febrero, el documento quedará en Febrero en el Registro de Compras. Y por lo tanto su IVA podrá ser usado sólo en Febrero.
Es importante siempre ingresar el estado `ERM` si lo que queremos es recibir el documento.
Por el contrario, si queremos reclamar algún documento. Informar alguno de los 3 posibles estados. Considerar, que luego de ser reclamado, un documento no podrá ser aceptado ni recibido. Lo mismo al revés.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"documentos": [
{
"EstadoRecepDTE": "ERM",
"FchEmis": "2020-10-26",
"Folio": 859423,
"MntTotal": 25938,
"RUTEmisor": "96919050-8",
"RUTRecep": "76192083-9",
"RecepDTEGlosa": "Ok",
"TipoDTE": 33
}
]
}
```
Responses:
- `200` — Registrar Respuesta de Intercambio al SII
#### POST /api/v1/libredte/dte/intercambios/recepcion_sii/{emisor}/{dte}/{folio}
Fecha de Recepción de un DTE en el SII
**Permiso requerido**: `query libredte`
Entrega la fecha en que el SII dió por recibido el DTE, desde esta fecha son los 8 días que tiene el receptor para reclamar el DTE.
Posterior a estos 8 días, el DTE se entiende por aceptado.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Fecha de Recepción de un DTE en el SII
#### POST /api/v1/libredte/dte/intercambios/eventos/{emisor}/{dte}/{folio}
Historial de Eventos de un DTE
**Permiso requerido**: `query libredte`
Entrega el historial de eventos asociados al documento en el SII. Son todos los eventos que el receptor del documento a asignado.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Historial de Eventos de un DTE
#### POST /api/v1/libredte/dte/intercambios/cesion/{emisor}/{dte}/{folio}
Información para Cesión de un DTE
**Permiso requerido**: `query libredte`
Indica si el DTE puede o no ser cedido.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Información para Cesión de un DTE
### API Facturación - Utilidades
#### POST /api/v1/libredte/auth/token
Token autenticación
Token autenticación
Parameters:
- `certificacion` (query, string)
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200`
#### POST /api/v1/libredte/certificate/info
Datos certificado digital
Datos certificado digital
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Auth Token
### Back Office
#### GET /api/v1/users/{id}
Información del Usuario
Recurso que permite conocer la información del usuario en la API.
Entrega, entre otros datos, os roles que tiene, los permisos para hacer consultas y los límites de consulta en un rango de tiempo.
Responses:
- `200`
#### POST /api/v1/admin/bills/biller/{biller}/notify
Notificar pago
Recurso que permite conocer la información del usuario en la API.
Entrega, entre otros datos, os roles que tiene, los permisos para hacer consultas y los límites de consulta en un rango de tiempo.
Request body example:
```
{
"codigo": "ZTs3NjE5MjA4MzszOTsxMDg0",
"emisor": 76192083
}
```
Responses:
- `200`
#### GET /api/v1/admin/tasks/beat
Tasks Beat
Recurso que permite conocer la información del usuario en la API.
Entrega, entre otros datos, os roles que tiene, los permisos para hacer consultas y los límites de consulta en un rango de tiempo.
Parameters:
- `run_async` (query, string)
- `tasks` (query, string)
Responses:
- `200`
---
Last updated on 21/08/2026