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
.jpg "Hubspot - nubox (18)")
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.
API endpoint exclusivo para partners de factura electrónica.
| Formato de respuesta | JSON |
|---|---|
| ¿Requiere autenticación? | SI |
| ¿Requiere token? | SI |
| ¿Requiere Partner key? | NO |
| 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 |
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 |
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 |
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 |
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 |
Existen algunos tipos de documentos que no son soportados, son los siguientes:
En este apartado se entrega información importante que debes tener en consideración.
| 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 |
