---
title: emision-venta
---

[![logo-nubox-devs](https://developers.nubox.com/hs-fs/hubfs/logo-nubox-devs.png?width=500&name=logo-nubox-devs.png "logo-nubox-devs")](https://developers.nubox.com/)

# **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)](https://developers.nubox.com/hubfs/Hubspot%20-%20nubox%20(34).jpg "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](https://developers.nubox.com/hs-fs/hubfs/exclamacion.png?width=60&height=60&name=exclamacion.png "exclamacion")

API endpoint exclusivo para partners que trabajen con factura electronica.

## URL del recurso

[https://api.nubox.com/Nubox.API.cert/factura/documento/{rut}/{numeroSerie}/rutFuncionario/{opcionFoliosAutomaticos}/emitir/ventaExtendido?rutFuncionario={rutFuncionario}&emitir={emitir}](https://api.nubox.com/Nubox.API.cert/factura/documento/{rut}/{numeroSerie}/rutFuncionario/{opcionFoliosAutomaticos}/emitir/ventaExtendido?rutFuncionario={rutFuncionario}&emitir={emitir})

 

 

## 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 | SI | Referencia de la venta, debe ser declarado aunque este vacío |

## JSON de Productos

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

Descripción

Json

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| rutContraparte | string | SI | Rut de la contraparte |
| razonSocialContraparte | string | SI | Nombre de la contraparte |
| giroContraparte | string | SI | 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 | Código 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 | SI | Es el número de la secuencia de los productos |
| 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 | deprecado |
| valor | number | NO | Valor del producto o precio del producto, el total lo calcula la API |
| tipoDeServicio | string | NO | Código SII del Servicio de la Boleta (solo necesario para Boletas Electrónicas y Boletas Electrónicas Exentas, de no serlo puede quedar vacío) Valores Posibles: - 1 : Boleta de servicios periódicos domiciliarios. - 2 : Boleta de otros servicios periódicos - 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, si no hay sucursales ingresadas ingresa un 1 |
| vendedor | string | NO | Nombre del vendedor |
| codigoItem | string | NO | Código del producto (valor con el que se registró 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. - Hora : Hora. - KG : Kilogramo. - 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 declarados por el SII, puedes revisar la lista de impuestos [aquí](http://www.sii.cl/declaraciones_juradas/ddjj_3327_3328/cod_otros_imp_retenc.pdf)  |
| montoIMP | integer | NO | Monto de impuesto o retención adicional |
| indicadorDeTraslado | string | NO | Indicador De Traslado. Valores posibles: - 1:Operación constituye venta. - 2:Ventas por efectuar. - 3:Consignaciones. - 4:Entrega gratuita. - 5:Traslados internos. - 6:Otros traslados no venta. - 7:Guia de devolución. |
| formaDePago | string | NO | Forma De Pago. Valores posibles: - 1: Contado. - 2: Crédito. - 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 | Términos De Pago Dias |
| terminosDePagoCodigo | string | NO | Términos De Pago Código |
| comunaDestino | string | NO | Comuna Destino |
| rutSolicitanteFactura | string | NO | RUT del cliente que solicita la factura |
| productoCambioSujeto | string | NO | Producto Cambio Sujeto |
| cantidadMontoCambioSujeto | integer | NO | Cantidad Monto Cambio Sujeto |
| tipoGlobalAfecto | string | NO | Tipo Global Afecto. se puede incluir si el producto es declarado como afecto. Valores posibles: 1:DSCTO%, 2:DSCTO$, 3:RCGO%, 4:RCGO$ |
| valorGlobalAfecto | string | NO | Valor Global Afecto, se debe incluir si se declara el campo "tipoGlobalAfecto" |
| tipoGlobalExento | string | NO | Tipo Global Exento. se puede incluir si el producto es declarado como exento. Valores posibles: 1:DSCTO%, 2:DSCTO$, 3:RCGO%, 4:RCGO$ |
| valorGlobalExento | string | NO | Valor Global Exento, se debe incluir si se declara el campo "tipoGlobalExento" |
| precioCambioSujeto | string | NO | Precio Cambio Sujeto |
| ponderacionDescuento | integer | NO | Si deseas realizar un descuento por porcentaje ocupa este campo dejando el campo descuentoMonto en 0 |
| descuentoMonto | string | NO | Si deseas realizar un descuento por monto ocupa este campo dejando el campo ponderacionDescuento en 0 |
| 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

Descripción

Json

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| tipo | integer | NO | Es el mismo tipo del documento ya declarado en el nodo de producto Código 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 | NO | Es el mismo folio del documento ya declarado en el nodo de producto Número de folio del documento |
| secuencia | integer | NO | Número de secuencia (cambiará según la cantidad de productos que se ingresen) |
| tipoDocumentoReferenciado | integer | NO | Código SII del tipo de documento. Valores posibles: - 30: Factura. - 33: Factura electrónica. - 34:Factura electrónica exenta. - 39: Boleta Electrónica. - 41: Boleta Electrónica Exent. - 45: Factura de Compra. - 46: Factura de Compra Electrónica. - 50: Guía de Despacho. - 52: Guía de despacho electrónica. - 56: Nota débito electrónica. - 61:Nota de crédito electrónica. - 103:Liquidación. - 801: Orden de Compra. - 802: Nota de Pedido. |
| folioDocumentoReferenciado | integer | NO | Número de Folio del documento referenciado |
| fechaDocumentoReferenciado | integer | NO | Fecha de emisión del documento referenciado |
| motivoReferencia | integer | NO | Valores posibles: 1: Anula documento. 2: Corrige texto. 3: Corrige monto |
| glosa | string | NO | Glosa libre del porque estas cambiando un documento |

## **Consideraciones**

![exclamacion](https://developers.nubox.com/hs-fs/hubfs/exclamacion.png?width=60&height=60&name=exclamacion.png "exclamacion")

- El IVA es calculado automáticamente solo debes setear el campo **afecto** en **SI.**
- Cuando emites un documento de manera correcta, queda en una cola a la espera de ser emitido por el SII, en este caso el estado del documento es **borrador **te recomendamos utilizar el recurso de [consulta de estado](https://developers.nubox.com/estado-venta) para saber en que estado esta el documento.

## Ejemplos de Request

cURL

Js - Jquery

Js - Fetch

Js - XHR

Node.js

C#

PHP

Ruby

GO

Java

## 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](https://no-cache.hubspot.com/cta/default/2081075/fce1e973-e856-4474-a90a-d7436cb32a9e.png)](https://cta-redirect.hubspot.com/cta/redirect/2081075/fce1e973-e856-4474-a90a-d7436cb32a9e)

 

[nubox.com.co ](https://www.nubox.com.co) | [nubox.com ](https://www.nubox.com?hsLang=es-cl)

Orinoco 90, piso 9 - Las Condes, Santiago de Chile | Teléfono (56 2) 2478 5000   
© Nubox 2020

[![footer-logo](https://developers.nubox.com/hs-fs/hubfs/Assets%202018/footer-logo@2x-8.png?width=193&height=80&name=footer-logo@2x-8.png "footer-logo")](https://www.nubox.com/)

```json
{
  "@context" : "https://schema.org",
  "@type" : "Corporation",
  "contactPoint" : {
    "@type" : "ContactPoint",
    "areaServed" : "CL",
    "availableLanguage" : "es",
    "contactType" : "customer service",
    "telephone" : "+56975162493"
  },
  "logo" : "https://www.nubox.com/hs-fs/hubfs/logo-nubox-x2.webp?width=336&height=72&name=logo-nubox-x2.webp",
  "name" : "Nubox",
  "sameAs" : [ "https://www.facebook.com/Nubox.Chile/", "https://www.instagram.com/Nubox.Chile/", "https://x.com/NuboxChile", "https://www.linkedin.com/company/nuboxchile/", "https://www.youtube.com/channel/UCZMQznNQuL0KiHlAK--xP2A" ],
  "url" : "https://www.nubox.com/"
}
```

```json
{
  "@context" : "https://schema.org",
  "@type" : "FAQPage",
  "mainEntity" : [ {
    "@type" : "Question",
    "acceptedAnswer" : {
      "@type" : "Answer",
      "text" : "Nubox es un software contable para pymes y contadores enfocado en facturación electrónica, gestión contable y remuneraciones. Sus productos están diseñados para simplificar y automatizar procesos administrativos y financieros, facilitando el cumplimiento de obligaciones tributarias y mejorando la eficiencia operativa."
    },
    "name" : "¿Qué es Nubox?"
  }, {
    "@type" : "Question",
    "acceptedAnswer" : {
      "@type" : "Answer",
      "text" : "Nubox ofrece herramientas diseñadas para facilitar la gestión administrativa y financiera de las empresas. Con su plataforma, es posible emitir facturas electrónicas, lo que permite generar y enviar Documentos Tributarios Electrónicos (DTE) cumpliendo con la normativa vigente. Además, Nubox ayuda a llevar la contabilidad al registrar y organizar movimientos financieros, generar balances y estados de resultados, y preparar declaraciones juradas. Por último, también permite gestionar remuneraciones, ofreciendo funcionalidades para calcular y procesar liquidaciones de sueldo, administrar cotizaciones previsionales y generar informes relacionados con el pago de empleados."
    },
    "name" : "¿Para qué sirve Nubox?"
  } ]
}
```