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
.jpg "Hubspot - nubox (32)")
Para insertar una boleta electrónica o una boleta electrónica exenta utilizaremos el verbo http POST.
API endpoint exclusivo para partners que trabajen con factura electronica.
| Formato de respuesta | JSON |
|---|---|
| ¿Requiere autenticación? | SI |
| ¿Requiere token? | SI |
| ¿Requiere Partner key? | NO |
| 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 |
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 |
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 |
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, si la configuración de la empresa es folio autogenerado deja este campo en 1 |
| 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 |
En este apartado se entrega información importante que debes tener en consideración.
Solo puedes ingresar documentos del tipo
| Tipo de documento | Código del SII |
|---|---|
| BOLETA ELECTRONICA | 39 |
| BOLETA ELECTRONICA EXENTA | 41 |
| 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 |
