Compras en factura electrónica

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 compra en factura electrónica

Flujo de inserción de compra

Hubspot - nubox (18)

Insertando una compra

Para insertar una compra utilizaremos el verbo http POST, puedes insertar documentos de compras como facturas electrónicas, facturas electrónicas, nota de debito, nota de crédito, etc.

exclamacion

API endpoint exclusivo para partners de factura electrónica.

URL del recurso

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 empresa  Path String
numeroSerie Número de serie del sistema, este valor se obtiene desde la autenticación de la API Path Integer
rutFuncionario
Rut de funcionario Path String
documento
Detalle de la compra Body Json

JSON de Documento de Compra

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

Nombre Tipo Obligatorio Descripción
codigoSIITipoDoc Integer SI

Código SII Tipo Documento.

Valores posibles:

33 : FACTURA ELECTRONICA

34 : FACTURA EXENTA ELECTRONICA

46 : FACTURA DE COMPRA ELECTRONICA

56 : NOTA DE DEBITO ELECTRONICA

61 : NOTA DE CREDITO ELECTRONICA

30 : FACTURA

32 : FACTURA EXENTA

45 : FACTURA DE COMPRA

55 : NOTA DE DEBITO

60 : NOTA DE CREDITO

40 : LIQUIDACION FACTURA

914 : DECLARACION DE INGRESO

29 : FACTURA DE INICIO

108 : SOLICITUD REGISTRO FACTURA

43 : LIQUIDACION FACTURA ELECTRONICA

folio String NO Número de folio
fecha String NO Fecha de emisión
rutEmisor String NO Rut de la empresa
razonSocialEmisor String SI Razón social del emisor
estado String NO Estado del documento. Valores posibles : [BORRADOR, LIBRO]
montoExento Integer NO Monto exento
montoNeto Integer NO

Monto neto

montoIva Integer NO Monto iva
montoTotal Integer SI Monto total. Su valor mínimo es 1
glosa String NO

Glosa del documento

montoIvaNoRetenido Integer NO Monto iva no retenido
IVAUsoComun Integer NO Iva de uso común
periodo Integer SI Mes del periodo del documento
anno Integer SI Año del periodo del documento
totalLey18211 Integer SI Valor total Ley 18211
tipoTransaccionCompra String NO

Tipo transaccion compra.

Valores posibles:

GIRO, SUPERMERCADO, BIENES, ACTIVO, IVACOMUN, IVANORECUPERABLE

netoActivoFijo Integer NO Monto neto activo fijo
IVAActivoFijo Integer NO Monto IVA activo fijo
otrosImpuestos ARRAY JSON NO Lista de otros impuestos
IVANoRecuperable JSON NO Monto IVA no recuperable
comisionesYOtrosCargos JSON NO Comisiones y Otros Cargos

JSON de Otros Impuestos

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

Nombre Tipo Obligatorio Descripción
codigoImpuesto String NO Código del Impuesto
montoImpuesto
Integer NO Monto del Impuesto

JSON de IVA no recuperable

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

Nombre Tipo Obligatorio Descripción
codigo String NO

Tipo de Iva no recuperable.

Valores Posibles:

Compras destinadas a IVA a generar operaciones no gravados o exentas,

Entregas gratuitas (premios, bonificaciones, etc.) recibidas.

Facturas de proveedores registradas fuera de plazo, Gastos rechazados.

Otros

monto
Integer NO

Monto de Iva no recuperable

JSON de comisiones y otros cargos

En el parámetro Comisiones y otros cargos 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

En este apartado se entrega información importante que debes tener en consideración.

Ejemplos de Request

Ejemplo Response

Response Body

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
expires -1
pragma no-cache
server Microsoft-IIS/8.5
status 200
x-aspnet-version 4.0.30319
x-powered-by ASP.NET
x-stackifyid V2|040d058f-a30e-4035-bb03-757df53ff679|C77694|CD26

Pruebas

Probar en Swagger