---
title: Ventas
---

[![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/)

# **Ventas**

Un documento de venta acredita una transacción de forma legal entre dos partes.

En esta sección aprenderás cómo utilizar la API para insertar documentos de venta en contabilidad.

## Flujo de inserción de una venta

![Hubspot - nubox (11)](https://developers.nubox.com/hubfs/Hubspot%20-%20nubox%20(11).jpg "Hubspot - nubox (11)")

## Insertando una venta

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

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

API endpoint exclusivo para partners, requieres de un partner key para utilizarlo

## URL del recurso

[https://api.nubox.com/nubox.api/venta](https://api.nubox.com/nubox.api/venta)

## Información del recurso

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

## Parámetros

| Nombre | Descripción | Tipo del parámetro | Tipo del dato |
| --- | --- | --- | --- |
| Venta | Representa un documento de venta en formato JSON. | Body | Json |
| PartnerKey | Llave que identifica al partner como único. | Header | String |

## JSON de Ventas

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

Descripción

Json

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| NumeroSerie | Integer | SI | Número de serie del sistema, este valor se obtiene desde el resultado de la autenticación API |
| Rut | String | SI | Rut de la empresa que realiza la venta. |
| Folio | Integer | SI | Número de folio corresponde al número identificador de la venta, |
| CodigoTipoDocumento | Integer | SI | Código SII que identifica el tipo Documento |
| FechaEmision | String | SI | Fecha de emisión del documento |
| MontoNeto | Integer | SI | Monto neto del documento. |
| MontoExento | Integer | SI | Monto exento del documento. |
| MontoIva | Integer | SI | Monto IVA del documento. |
| MontoTotal | Integer | SI | Monto total del documento. |
| Contraparte | JSON | SI | Contraparte de venta |
| Referencia | JSON | NO | Referencia de venta |
| ImpuestosAdicionales | Array | NO | Otros impuestos aplicados a la venta. |

## JSON de Contraparte de venta

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

Descripción

Json

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| Rut | String | SI | Rol único tributario o código de identificación tributaria del cliente. |
| RazonSocial | String | SI | Corresponde a la Razón social del cliente. |
| Giro | String | NO | Corresponde al Giro del cliente. |
| ComunaId | Integer | SI | Comuna de residencia del cliente, valores posibles se obtienen del método ObtenerComunas de la API. |
| Direccion | String | NO | Dirección de la contraparte o cliente |
| Email | String | NO | Email de la contraparte o cliente |

## JSON de Referencia de venta

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

Descripción

Json

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| Folio | Integer | NO | Número de folio corresponde al número identificador de la referencia. |
| CodigoTipoDocumento | Integer | NO | Código SII que identifica el tipo Documento de la referencia de la venta |

## JSON de Impuestos adicionales

En el parámetro **impuestos adicionales** debes incluir un array JSON con la siguiente estructura

Descripción

Json

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| CodigoTipoDeImpuesto | Integer | NO | Código que identifica un impuesto o retención adicional. |
| Monto | Integer | NO | Monto de impuesto o retención adicional. |

## **Consideraciones**

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

Revisa [aquí](https://developers.nubox.com/ventas-validaciones) las validaciones básicas que debes tener en consideración

Existen algunos tipos de documentos que no son soportados, son los siguientes:

## Ejemplos de Request

cURL

Js - Jquery

Js - Fetch

Js - XHR

Node.js

C#

PHP

Ruby

GO

Java

## Ejemplo Response

## Response Body

N/A

## 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 |

## Pruebas

[![Probar en Swagger](https://no-cache.hubspot.com/cta/default/2081075/11328fa8-aa7d-4c61-b965-9e43228315bf.png)](https://cta-redirect.hubspot.com/cta/redirect/2081075/11328fa8-aa7d-4c61-b965-9e43228315bf)

 

[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?"
  } ]
}
```