Guardado y 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 y emitirlos.

Flujo de emisión de ventas

Hubspot - nubox (34)

Insertando y emitiendo una venta

Para insertar una venta utilizaremos el verbo http POST, puedes insertar y emitir documentos de ventas como facturas, facturas electrónicas, etc.

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
emitir

true : emite los documentos

false : documentos con estado borrador

Path Boolean
documento Detalle de la venta 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 venta
documentoReferenciado Json NO Referencia de la venta

JSON de Productos

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

Nombre Tipo Obligatorio Descripción
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
tipo integer SI Codigo SII del tipo de documento. Valores posibles: 33: Factura electrónica, 34:Factura exenta electrónica, 56: Nota débito electrónica, 61:Nota de crédito electrónica, 39: Boleta electrónica; 41: Boleta exenta electrónica ,
folio integer SI Número de Folio del documento
secuencia integer NO Número de secuencia, cambiara según la cantidad de productos que se ingresen
fecha string SI

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

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

ponderacionDescuento integer NO Porcentaje de Descuento
tipoDeServicio string NO Codigo SII del Servicio de la Boleta (solo necesario para Boletas Electrónicas y Boletas Electróniocas Exentas, de no serlo puede quedar vacio) Valores Posibles: 1 : Boleta de servicios periodicos domiciliarios, 2 : Boleta de otros servicios periodicos, 3 : Boleta de servicios
fechaPeriodoDesde string SI Fecha periodo desde
fechaPeriodoHasta string SI Fecha periodo hasta
fechaVencimiento string NO Fecha de vencimiento
codigoSucursal string SI Código de la sucursal ingresada en el sistema
vendedor string NO Nombre del vendedor
codigoItem string NO Código del producto (valor con el que se registro en el sistema)
unidadMedida string NO Unidad de Medida. Valores posibles: BDJA : Bandeja, BIN : BIN, BTLL : Botella, CA : Cajas Walmart, CAJA : Caja, CART : Cartón, CJ : Cajas Walmart, CM : Centímetros, CM3 : Centímetros Cúbicos, DIA : Día, DISP : Display, DNA : Docena, EA : Artículos Walmart, G : Gramos, GLB : Global, HA : Hectárea, HR : Hora, KG : Kilógramo, LT : Litro, M : Metros, M2 : Metro cuadrado, M3 : Metro Cúbico, MES : Mes, ML : Metro Lineal, MR : Metro Ruma, P2 : Pies Cuadrado, PAR : PAR, PIE : Pie, PLGO : Pliego, PM : Pulgada Maderera, PP : Pulgada Pinera, PQ : Paquete, PULG : Pulgada, QTAL : Quintal(100 Kg.), RLLO : Rollo, SACO : Saco, TBDM : Tonelada BDMT, TBDU : Tonelada BDU, TIRA : Tira, TON : Tonelada, UF : U.F., UNID : Unidad, USD : Dolar, VIAJ : Viaje
codigoIMP string NO Código de impuesto o retención adicional
montoIMP integer NO Monto de impuesto o retención adicional
indicadorDeTraslado string NO Indicador De Traslado. Valores posibles: 1:Operacion constituye venta, 2:Ventas por efectuar, 3:Consignaciones, 4:Entrega gratuita, 5:Traslados internos, 6:Otros traslados no venta, 7:Guia de devolucion
formaDePago string NO Forma De Pago. Valores posibles: 1:Contado, 2:Credito, 3:Sin costo
medioDePago string NO Medio De Pago. Valores posibles: CH:Cheque, CF:Cheque a fecha, LT:letra, EF:Efectivo, PE:Pago a cta.cte, TC:Tarjeta Credito,OT:Otro
terminosDePagoDias string NO Terminos De Pago Dias
terminosDePagoCodigo string NO Términos De Pago Código
comunaDestino string NO Comuna Destino
rutSolicitanteFactura string NO Rut de la empresa
productoCambioSujeto string NO Producto Cambio Sujeto
cantidadMontoCambioSujeto integer NO Cantidad Monto Cambio Sujeto
tipoGlobalAfecto string NO Tipo Global Afecto. Valores posibles: 1:DSCTO%, 2:DSCTO$, 3:RCGO%, 4:RCGO$
valorGlobalAfecto string NO Valor Global Afecto
tipoGlobalExento string NO Tipo Global Exento
valorGlobalExento string NO Valor Global Exento
precioCambioSujeto string NO Precio Cambio Sujeto
descuentoMonto string NO Descuento Monto
rutTransportista string NO Rut del transportista
rutChofer string NO Rut del chofer
patente string NO patente
nombreChofer string NO Nombre Chofer
direccionDestino string NO Dirección Destino
ciudadDestino string NO Ciudad Destino
tipoDeDespacho string NO Tipo De Despacho. Valores posibles: 1:A instalaciones del cliente por cuenta del receptor, 2:A instalaciones del cliente por cuenta del emisor, 3:A otras instalaciones por cuenta del emisor
nombreDeContacto string NO Nombre De Contacto
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.

Ejemplos de Request

Ejemplos de Request

Ejemplo Response

Response Body

Response Header

Nombre Valor
date Mon, 22 Jun 2020 20:30:21 GMT
cache-control no-cache
content-length 1174
content-type text/plain; charset=utf-8

Pruebas

Probar en Swagger