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.
Para insertar una venta utilizaremos el verbo http POST, puedes insertar documentos de ventas como facturas, facturas electrónicas, boletas, etc.
API endpoint exclusivo para partners, requieres de un partner key para utilizarlo
Formato de respuesta | JSON |
---|---|
¿Requiere autenticación? | SI |
¿Requiere token? | SI |
¿Requiere Partner key? | SI |
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 |
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. |
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 |
String | NO | Email de la contraparte o cliente |
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 |
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. |
Existen algunos tipos de documentos que no son soportados, son los siguientes:
N/A
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 |