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.
.jpg "Hubspot - nubox (10)")
Para insertar una compra utilizaremos el verbo http POST, puedes insertar documentos de compras 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 |
|---|---|---|---|
| Compra | Representa un documento de compra en formato JSON. | Body | Json |
| PartnerKey | Llave que identifica al partner como único. | Header | String |
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 |
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 |
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. |
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. |
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 |
Existen algunos tipos de documentos que no son soportados, son los siguientes:
| 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 |
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 |
