Compras

Un documento de compra 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 compra

Hubspot - nubox (10)

Insertando una compra

Para insertar una compra utilizaremos el verbo http POST, puedes insertar documentos de compras 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
Compra Representa un documento de compra en formato JSON. Body Json
PartnerKey Llave que identifica al partner como único. Header String

JSON de Compras

En el parámetro Compras 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 genera la compra.
RazonSocialProveedor String SI Razón social del proveedor de la compra.
CodigoSIITipoDoc Integer SI Código SII que identifica el tipo Documento
Folio Integer SI Número de folio corresponde al número identificador de la compra.
Fecha String SI Fecha de emisión de la compra.
FechaVencimiento String SI Fecha de vencimiento de la compra.
RutEmisor String SI Rol único tributario o código de identificación tributaria del proveedor.
MontoExento Integer NO Monto exento del documento.
MontoNeto Integer NO Monto neto del documento.
MontoIva Integer NO Monto IVA del documento.
MontoTotal Integer SI Monto total del documento.
Glosa String NO Glosa del documento que corresponde a la sección en la que se especifican todos los detalles del documento.
MontoIvaNoRetenido Integer NO Monto IVA no retenido.
IVAUsoComun Integer NO IVA de uso común
Periodo Integer SI Mes del período del documento. El valor es entre 1 y 12
Anno Integer SI Año del período del documento en formato yyyy. No puede ser menor de 6 años al año actual.
TotalLey18211 Integer NO Valor total Ley 18211.
TipoTransaccionCompra String SI Tipo transacción compra.
NetoActivoFijo Integer NO Monto neto activo fijo, corresponde al precio de adquisición.
IvaActivoFijo Integer NO Monto IVA activo fijo
DocumentoReferencia Array NO Lista de los documentos que pudieron ser referenciados en la compra
OtrosImpuestos Array NO Lista de otros impuestos
IVANoRecuperable Array NO Lista de monto IVA no recuperable
ComisionesYOtrosCargos Array NO Lista de comisiones y Otros Cargos

JSON de Documento Referencia

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

Nombre Tipo Obligatorio Descripción
FolioReferencia String SI Folio del documento referenciado. El documento debe haber sido informado previamente
CodigoSIITipoDocReferencia Integer NO Código SII del documento referenciado
Fecha String NO  

JSON de Otros impuestos

En el parámetro otros impuestos debes incluir un JSON con la siguiente estructura.

Nombre Tipo Obligatorio Descripción
CodigoImpuesto Integer NO Código del Impuesto (ver tabla)
MontoImpuesto Integer NO

Monto del Impuesto. 

Al incluir algún otro impuesto debe contener al menos una línea afecta. Sólo los documentos Factura, Factura Electrónica y sus respectivas Notas de crédito y débito, pueden tener impuestos adicionales. El documento no puede tener el mismo tipo de impuesto más de una vez. 

JSON de IVA no recuperable

En el parámetro IVA no recuperable debes incluir un array JSON con la siguiente estructura

Nombre Tipo Obligatorio Descripción
Codigo Integer NO Código de tipo de iva no recuperable (ver tabla).
Monto Integer NO Monto de IVA no recuperable.

JSON de Comisiones y otros encargos

En el parámetro Comisiones y otros encargos debes incluir un array JSON con la siguiente estructura.

Nombre Tipo Obligatorio Descripción
Neto Integer NO Monto neto total
Exento Integer NO Monto exento total
IVA Integer NO Monto IVA total
Total Integer NO Total de la compra

Consideraciones

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

exclamacion

Revisa aquí las validaciones básicas que debes tener en consideración

Tipo de documento Código del SII
Liquidación factura 40
Factura de compra no electrónica 45
Nota de débito 55
Nota de crédito 60
Factura de exportación 101
Nota de débito exportación 104
Nota de crédito exportación 106

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