--- title: ¿Es posible rescatar la información del módulo de compras (Factura de compra) mediante API? description: "API relBase: cómo consultar facturas de compra, campos disponibles y ejemplos de endpoints. Referencia interna para soporte" --- [Ir directamente al contenido](https://ayuda.relbase.cl/es-posible-rescatar-la-información-del-módulo-de-compras-factura-de-compra-mediante-api#main-content) Español Traducciones de Mostrar submenú de ![logo-relbase-normal@2x-3cb41ff14952911c096f1fce4346e95337a2289d0c98414c667897f37b9f11dd.png\]](https://ayuda.relbase.cl/hs-fs/hubfs/logo-relbase-normal@2x-3cb41ff14952911c096f1fce4346e95337a2289d0c98414c667897f37b9f11dd.png?height=31&name=logo-relbase-normal@2x-3cb41ff14952911c096f1fce4346e95337a2289d0c98414c667897f37b9f11dd.png) Abrir navegación principal Cerrar navegación principal - Español Traducciones de Mostrar submenú de - Ir a relbase.cl Ir a relbase.cl Hola. ¿Te ayudamos a encontrar lo que necesitas? - No hay sugerencias porque el campo de búsqueda está vacío. 1. [Centro de ayuda Chile](https://ayuda.relbase.cl/?hsLang=es) 2. [Integraciones](https://ayuda.relbase.cl/integraciones?hsLang=es) 3. [API](https://ayuda.relbase.cl/integraciones?hsLang=es#api) # ¿Es posible rescatar la información del módulo de compras (Factura de compra) mediante API? ## Sí. La API de relBase expone los datos de compras a través de dos endpoints: **Requisitos** - Disponible solo para empresas de Chile. - Integración conectada a la API v2 mediante OAuth 2.0, con el scope `documents:read`. - Si la funcionalidad no está habilitada para tu empresa, la API responde 403 con `feature_not_available_in_country`. **1\. Listado de todas las compras** El endpoint `GET https://api.relbase.cl/api/v2/compras` devuelve el listado paginado de compras de la empresa, incluyendo los documentos recibidos de proveedores (facturas afectas y exentas, notas de crédito y débito, facturas de compra, entre otros), con los campos principales del encabezado (tipo de documento, montos, proveedor, estado, etc.). Es la misma información visible en app.relbase.cl. **Filtros disponibles** - `type_document`: filtra por tipo de documento. Acepta `33` (factura afecta), `34` (factura exenta), `61` (nota de crédito), `56` (nota de débito), `43` (liquidación factura), `46` (factura de compra), `30` (factura no electrónica) y `914` (declaración de ingreso). - `status_rcv`: filtra por estado en el Registro de Compras y Ventas: `0` Recibido, `5` Aceptado, `8` Aceptado Ley 19.983, `7` Rechazado. - `start_date` y `end_date`: rango de fechas en formato `dd-mm-yyyy`. ⚠️ **Importante:** si no envías `start_date` y `end_date`, el listado devuelve solo las compras del **mes en curso**. Para consultar otros períodos, indica siempre el rango de fechas. **Ejemplo de respuesta del listado de compras API v2** ![Captura de pantalla 2026-10-15 a la(s) 10.53.55 p.m.](https://ayuda.relbase.cl/hs-fs/hubfs/Captura%20de%20pantalla%202026-10-15%20a%20la(s)%2010.53.55%20p.m..png?width=653&height=449&name=Captura%20de%20pantalla%202026-10-15%20a%20la(s)%2010.53.55%20p.m..png) **El bloque `meta` indica la página actual (`current_page`), la siguiente (`next_page`, que vale `-1` cuando no hay más páginas) y el total de registros (`total_count`).** Los campos que entrega este endpoint: - - `id` — ID de la compra en relBase. Es el que se usa para consultar el detalle. - `provider_name` — Nombre del proveedor. - `folio` — Número de folio. - `type_document` — Código del tipo de documento (ej: 33, 46). - `type_document_name` — Nombre del tipo de documento (ej: Factura de compra electrónica). - `amount_neto` — Monto neto. - `amount_iva` — IVA. - `amount_total` — Monto total. - `status` — Estado del documento (ej: vigente). **2. Detalle de una compra específica** Para consultar una compra en particular, usa el endpoint: ***GET*** [***https://api.relbase.cl/api/v2/compras/{purchase\_id}***](https://api.relbase.cl/api/v2/compras/%7Bpurchase_id%7D) El purchase\_id corresponde al campo id que devuelve el listado. Este endpoint entrega los datos del encabezado de la compra y el detalle de productos/ítems de la factura, incluyendo la descripción por línea.   Ejemplo de respuesta con detalle de productos: ![Captura de pantalla 2026-10-15 a la(s) 10.58.41 p.m.](https://ayuda.relbase.cl/hs-fs/hubfs/Captura%20de%20pantalla%202026-10-15%20a%20la(s)%2010.58.41%20p.m..png?width=619&height=411&name=Captura%20de%20pantalla%202026-10-15%20a%20la(s)%2010.58.41%20p.m..png) Campos adicionales en el detalle: - `provider_id` — ID del proveedor en relBase. - `products[]` — Detalle de ítems de la factura: - `product_id` — ID del producto. - `description` — Descripción del ítem o servicio. - `quantity` — Cantidad. - `price` — Precio unitario. ***⚠️  Se puede obtener más detalle de productos y referencias, siempre y cuando se haya recibido mediante intercambio. Las facturas recibidas mediante RCV no incluyen detalle de ítems. El campo products\[\] vendrá vacío.*** | | | --- | - [Primeros pasos](https://ayuda.relbase.cl/primeros-pasos?hsLang=es#main-content) - [Paso 1: Nuevos productos](https://ayuda.relbase.cl/primeros-pasos?hsLang=es#paso-1-nuevos-productos) - [Paso 2: Carga de stock](https://ayuda.relbase.cl/primeros-pasos?hsLang=es#paso-2-carga-de-stock) - [Paso 3: Crear clientes](https://ayuda.relbase.cl/primeros-pasos?hsLang=es#paso-3-crear-clientes) - [Paso 4: Realizar ventas](https://ayuda.relbase.cl/primeros-pasos?hsLang=es#paso-4-realizar-ventas) - [Personaliza tu cuenta](https://ayuda.relbase.cl/primeros-pasos?hsLang=es#personaliza-tu-cuenta) - [Referidos](https://ayuda.relbase.cl/referidos?hsLang=es) - [APP móvil](https://ayuda.relbase.cl/app-m%C3%B3vil?hsLang=es#main-content) - [Primeros Pasos](https://ayuda.relbase.cl/app-m%C3%B3vil?hsLang=es#primeros-pasos) - [🆕 Entregas](https://ayuda.relbase.cl/entregas?hsLang=es) - [Clientes](https://ayuda.relbase.cl/clientes?hsLang=es#main-content) - [Creación y edición](https://ayuda.relbase.cl/clientes?hsLang=es#creaci%C3%B3n-y-edici%C3%B3n) - [Acciones sobre mis clientes](https://ayuda.relbase.cl/clientes?hsLang=es#acciones-sobre-mis-clientes) - [Ventas](https://ayuda.relbase.cl/ventas?hsLang=es#main-content) - [Cotización](https://ayuda.relbase.cl/ventas?hsLang=es#cotizaci%C3%B3n) - [Órdenes de trabajo](https://ayuda.relbase.cl/ventas?hsLang=es#%C3%B3rdenes-de-trabajo) - [Notas de venta](https://ayuda.relbase.cl/ventas?hsLang=es#notas-de-venta) - [Guías de despacho](https://ayuda.relbase.cl/ventas?hsLang=es#gu%C3%ADas-de-despacho) - [Facturas](https://ayuda.relbase.cl/ventas?hsLang=es#facturas) - [Boletas](https://ayuda.relbase.cl/ventas?hsLang=es#boletas) - [Notas de crédito](https://ayuda.relbase.cl/ventas?hsLang=es#notas-de-cr%C3%A9dito) - [Notas de débito](https://ayuda.relbase.cl/ventas?hsLang=es#notas-de-d%C3%A9bito) - [Cesiones (factoring)](https://ayuda.relbase.cl/ventas?hsLang=es#cesiones-factoring) - [General](https://ayuda.relbase.cl/ventas?hsLang=es#general) - [Impresión masiva](https://ayuda.relbase.cl/ventas?hsLang=es#impresi%C3%B3n-masiva) - [Pedidos web](https://ayuda.relbase.cl/ventas?hsLang=es#pedidos-web) - [Punto de venta](https://ayuda.relbase.cl/punto-de-venta?hsLang=es#main-content) - [Transbank - POS integrado](https://ayuda.relbase.cl/punto-de-venta?hsLang=es#transbank-pos-integrado) - [Proceso de venta](https://ayuda.relbase.cl/punto-de-venta?hsLang=es#proceso-de-venta) - [Cierre de caja](https://ayuda.relbase.cl/punto-de-venta?hsLang=es#cierre-de-caja) - [Configuración](https://ayuda.relbase.cl/punto-de-venta?hsLang=es#configuraci%C3%B3n) - [General](https://ayuda.relbase.cl/punto-de-venta?hsLang=es#general) - [Exportación](https://ayuda.relbase.cl/exportaci%C3%B3n?hsLang=es#main-content) - [Proceso de venta](https://ayuda.relbase.cl/exportaci%C3%B3n?hsLang=es#proceso-de-venta) - [Compras](https://ayuda.relbase.cl/compras?hsLang=es#main-content) - [Facturas de compra](https://ayuda.relbase.cl/compras?hsLang=es#facturas-de-compra) - [Doc. Recibidos](https://ayuda.relbase.cl/compras?hsLang=es#doc-recibidos) - [Pago proveedores](https://ayuda.relbase.cl/compras?hsLang=es#pago-proveedores) - [Órdenes de compra](https://ayuda.relbase.cl/compras?hsLang=es#%C3%B3rdenes-de-compra) - [Impresión masiva](https://ayuda.relbase.cl/compras?hsLang=es#impresi%C3%B3n-masiva) - [Gastos y Rendiciones](https://ayuda.relbase.cl/compras?hsLang=es#gastos-y-rendiciones) - [Recaudación](https://ayuda.relbase.cl/recaudaci%C3%B3n?hsLang=es#main-content) - [Funcionalidades](https://ayuda.relbase.cl/recaudaci%C3%B3n?hsLang=es#funcionalidades) - [Configuración](https://ayuda.relbase.cl/recaudaci%C3%B3n?hsLang=es#configuraci%C3%B3n) - [Eventos](https://ayuda.relbase.cl/eventos?hsLang=es) - [Inventario](https://ayuda.relbase.cl/inventario?hsLang=es#main-content) - [Movimientos de inventario](https://ayuda.relbase.cl/inventario?hsLang=es#movimientos-de-inventario) - [Movimientos de bodega](https://ayuda.relbase.cl/inventario?hsLang=es#movimientos-de-bodega) - [Configuración](https://ayuda.relbase.cl/inventario?hsLang=es#configuraci%C3%B3n) - [Reportes](https://ayuda.relbase.cl/reportes?hsLang=es#main-content) - [Reportes de venta](https://ayuda.relbase.cl/reportes?hsLang=es#reportes-de-venta) - [Reportes de compra](https://ayuda.relbase.cl/reportes?hsLang=es#reportes-de-compra) - [Reporte de despachos](https://ayuda.relbase.cl/reportes?hsLang=es#reporte-de-despachos) - [General](https://ayuda.relbase.cl/reportes?hsLang=es#general) - [Configuración](https://ayuda.relbase.cl/configuraci%C3%B3n?hsLang=es#main-content) - [Proveedores](https://ayuda.relbase.cl/configuraci%C3%B3n?hsLang=es#proveedores) - [Categorias](https://ayuda.relbase.cl/configuraci%C3%B3n?hsLang=es#categorias) - [Productos](https://ayuda.relbase.cl/configuraci%C3%B3n?hsLang=es#productos) - [Packs](https://ayuda.relbase.cl/configuraci%C3%B3n?hsLang=es#packs) - [Usuarios](https://ayuda.relbase.cl/configuraci%C3%B3n?hsLang=es#usuarios) - [Canales de venta](https://ayuda.relbase.cl/configuraci%C3%B3n?hsLang=es#canales-de-venta) - [Formas de pago](https://ayuda.relbase.cl/configuraci%C3%B3n?hsLang=es#formas-de-pago) - [Descuentos y listas de precio](https://ayuda.relbase.cl/configuraci%C3%B3n?hsLang=es#descuentos-y-listas-de-precio) - [General](https://ayuda.relbase.cl/configuraci%C3%B3n?hsLang=es#general) - [Integraciones](https://ayuda.relbase.cl/integraciones?hsLang=es#main-content) - [NUEVO 🚀 TiendaNube](https://ayuda.relbase.cl/integraciones?hsLang=es#nuevo-tiendanube) - [Paris](https://ayuda.relbase.cl/integraciones?hsLang=es#paris) - [Mercado libre](https://ayuda.relbase.cl/integraciones?hsLang=es#mercado-libre) - [Falabella](https://ayuda.relbase.cl/integraciones?hsLang=es#falabella) - [Ripley](https://ayuda.relbase.cl/integraciones?hsLang=es#ripley) - [Walmart](https://ayuda.relbase.cl/integraciones?hsLang=es#walmart) - [Woocommerce](https://ayuda.relbase.cl/integraciones?hsLang=es#woocommerce) - [Jumpseller](https://ayuda.relbase.cl/integraciones?hsLang=es#jumpseller) - [Prestashop](https://ayuda.relbase.cl/integraciones?hsLang=es#prestashop) - [Shopify](https://ayuda.relbase.cl/integraciones?hsLang=es#shopify) - [Anymarket](https://ayuda.relbase.cl/integraciones?hsLang=es#anymarket) - [Multivende](https://ayuda.relbase.cl/integraciones?hsLang=es#multivende) - [Pedidos web](https://ayuda.relbase.cl/integraciones?hsLang=es#pedidos-web) - [General](https://ayuda.relbase.cl/integraciones?hsLang=es#general) - [API](https://ayuda.relbase.cl/integraciones?hsLang=es#api) - [Videos tutoriales](https://ayuda.relbase.cl/videos-tutoriales?hsLang=es#main-content) - [General](https://ayuda.relbase.cl/videos-tutoriales?hsLang=es#general) - [APP móvil](https://ayuda.relbase.cl/videos-tutoriales?hsLang=es#app-m%C3%B3vil) - [Ventas](https://ayuda.relbase.cl/videos-tutoriales?hsLang=es#ventas) - [Preguntas frecuentes](https://ayuda.relbase.cl/preguntas-frecuentes?hsLang=es) - [Novedades](https://ayuda.relbase.cl/novedades?hsLang=es#main-content) - [Actualizaciones del sistema](https://ayuda.relbase.cl/novedades?hsLang=es#actualizaciones-del-sistema) - [Ofertas y descuentos](https://ayuda.relbase.cl/novedades?hsLang=es#ofertas-y-descuentos) - [Interrupción programada](https://ayuda.relbase.cl/novedades?hsLang=es#interrupci%C3%B3n-programada) - [SII](https://ayuda.relbase.cl/sii?hsLang=es#main-content) - [Mantenciones](https://ayuda.relbase.cl/sii?hsLang=es#mantenciones) - [SII](https://ayuda.relbase.cl/sii?hsLang=es#sii) [![relBase](https://ayuda.relbase.cl/hs-fs/hubfs/logo-relbase-normal@2x-3cb41ff14952911c096f1fce4346e95337a2289d0c98414c667897f37b9f11dd-1.png?width=303&height=68&name=logo-relbase-normal@2x-3cb41ff14952911c096f1fce4346e95337a2289d0c98414c667897f37b9f11dd-1.png "relBase")](http://www.relbase.cl) Centro de ayuda relke.cl Copyright © 2026, relBase