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)

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

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

URL del recurso

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.

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

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.

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

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

Revisa aquí 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

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