Emisión de Documentos

Emitir un documento significa que enviaremos el archivo al SII para que sea revisado, firmado y aceptado.

En esta sección aprenderás cómo utilizar la API para insertar documentos, emitirlos y obtener su información

Insertando, emitiendo una boleta y obteniendo su información

Para insertar una boleta electrónica o una boleta electrónica exenta utilizaremos el verbo http POST.

exclamacion

API endpoint exclusivo para partners que trabajen con factura electronica.

URL del recurso

Información del recurso

Formato de respuesta JSON
¿Requiere autenticación? SI
¿Requiere token? SI
¿Requiere Partner key? NO

Parámetros

Nombre Descripción Tipo del parámetro Tipo del dato
rut Rut de la empresa Path String
numeroSerie Número de serie del sistema, este valor se obtiene desde el resultado de la autenticación API Path Integer
rutFuncionario
rut del funcionario Path String
opcionFoliosAutomaticos
0: folios informados
1: genera folios automáticos
Path Integer
codigoSIItipoDocumento

Código SII que identifica el tipo Documento, códigos aceptados: 

39 - Boleta Electrónica

41 - Boleta Electrónica Exenta

Path Integer
documento Detalle de las Boletas Body Json

JSON de Documento

En el parámetro documento debes incluir un JSON con la siguiente estructura.

Nombre Tipo Obligatorio Descripción
productos Array SI Array de Json de los productos incluidos en la boleta
documentoReferenciado Json NO Referencia de la boleta

JSON de Productos

En el parámetro producto debes incluir un JSON con la siguiente estructura

Nombre Tipo Obligatorio Descripción
fechaEmision string SI

Fecha de emisión de la boleta en formato yyyy-mm-dd

folio integer SI Número de Folio del documento
rutContraparte string SI Rut de la contraparte
razonSocialContraparte string NO Nombre de la contraparte
giroContraparte string NO Giro de la contraparte
comunaContraparte string SI

Comuna de la contraparte

direccionContraparte string NO

Dirección de la contraparte

emailContraparte string NO Email Contraparte
codigoSucursal string SI Código de la sucursal ingresada en el sistema
secuencia integer NO Número de secuencia, cambiara según la cantidad de productos que se ingresen
afecto string NO  Indicador para marcar si el producto es afecto. Valores posibles: SI, NO
producto string NO

Nombre del producto

descripcion string NO

Descripción corta del producto

cantidad number NO Cantidad del producto
precio integer NO Precio del producto
valor number NO

Valor del producto

codigoItem string NO Código del producto
unidadMedida string NO Unidad de Medida
fechaVencimiento string SI Fecha de vencimiento
codigoSIITipoDeServicio string SI Codigo SII de la Boleta
fechaPeriodoDesde string SI Fecha periodo desde
fechaPeriodoHasta string SI Fecha periodo hasta
observacion
string NO Parámetro opcional

JSON de documento referenciado

En el parámetro documento referenciado debes incluir un JSON con la siguiente estructura

Nombre Tipo Obligatorio Descripción
tipo integer NO

DTE Documento Enviados Referencia

folio  integer NO

Número de folio del documento

secuencia
integer NO

Número de secuencia (cambiara según la cantidad de productos que se ingresen)

tipoDocumentoReferenciado integer NO

 

folioDocumentoReferenciado integer NO

Número de Folio del documento referenciado

fechaDocumentoReferenciado
integer NO

Fecha de emisión del documento referenciado

motivoReferencia integer NO  
glosa string NO  

Consideraciones

exclamacion

En este apartado se entrega información importante que debes tener en consideración.

Solo puedes ingresar documentos del tipo

Tipo documento Código SII
BOLETA ELECTRONICA 39
BOLETA ELECTRONICA EXENTA 41

Ejemplos de Request

Ejemplos de Request

Ejemplo Response

Response Body

Response Header

Nombre Valor
cache-control no-cache
content-length 0
content-type application/json; charset=utf-8
date Thu, 16 Apr 2020 22:53:54 GMT
expires -1
pragma no-cache
server Microsoft-IIS/8.5
status 200
x-aspnet-version 4.0.30319
x-powered-by ASP.NET
x-stackifyid V2|040d058f-a30e-4035-bb03-757df53ff679|C77694|CD26

Pruebas

Probar en Swagger