# Recuperar facturas para un enlace

Recuperar información de facturas desde un enlace fiscal específico de Chile.
Puedes solicitar hasta un año (365 días) de facturas por solicitud. Si necesitas facturas por más de un año, simplemente realiza otra solicitud.
> 📘 Altamente Recomendado > > Recomendamos encarecidamente que utilices el parámetro de encabezado  de Belvo e implementes un flujo de trabajo asincrónico. Esto garantizará que no recibas errores de tiempo de espera al recuperar datos de facturas.

Endpoint: POST /api/cl/invoices/
Version: 1.223.0
Security: basicAuth

## Header parameters:

  - `X-Belvo-Request-Mode` (string)
    Parámetro de encabezado recomendado para hacer que tu solicitud POST sea asincrónica (evitando así tiempos de espera y mejorando el flujo de datos).

Cuando realizas una solicitud asincrónica, Belvo responde con un payload , que incluye el . Una vez que hayamos recuperado la información solicitada, recibirás un webhook con el enlace y los IDs de solicitud.
    Enum: "async"

## Query parameters:

  - `omit` (string)
    Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

  - `fields` (string)
    Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

## Request fields (application/json):

  - `link` (string, required)
    El  para el que deseas recuperar información.
    Example: "c81a1dea-6dd6-4999-8b9f-541ee8197058"

  - `date_from` (string, required)
    La fecha desde la cual deseas comenzar a obtener datos, en formato .

⚠️ El valor de  no puede ser mayor que .
    Example: "2020-08-05"

  - `date_to` (string, required)
    La fecha en la que deseas dejar de recibir datos, en formato .

⚠️ El valor de  no puede ser mayor que la fecha de hoy (en otras palabras, no se permiten fechas futuras).
    Example: "2020-10-05"

  - `type` (string,null)
    La dirección de la factura (desde la perspectiva del propietario del Link).
-  indica una factura enviada.
-  indica una factura recibida.
    Enum: "OUTFLOW", "INFLOW", null

  - `save_data` (boolean)
    Indica si se debe o no persistir los datos en Belvo. Por defecto, esto está configurado en  y devolvemos una respuesta 201 Created.

Cuando se establece en , los datos no se persistirán y devolvemos una respuesta 200 OK.
    Example: true

## Response 200 fields (application/json):

  - `id` (string)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `link` (string,null)
    El  al que pertenecen los datos.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `created_at` (string)
    La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `collected_at` (string)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `total_amount` (number)
    El importe total de la factura, incluidos el IVA y otros impuestos o cargos.
    Example: 3272500.02

  - `net_amount` (number)
    El monto total de la factura después del IVA y otros impuestos.
    Example: 2750000.02

  - `vat_amount` (number)
    El importe total del IVA de la factura.
    Example: 522500.02

  - `currency` (string)
    El código de moneda de tres letras (ISO-4217) de la factura.
    Example: "CLP"

  - `issue_date` (string)
    La fecha en que se emitió la factura, en formato .
    Example: "2024-09-23"

  - `received_at` (string)
    La marca de tiempo ISO-8601 de cuando se recibió la factura.
    Example: "2024-09-02T15:23:47-03:00"

  - `acknowledged_at` (string)
    La marca de tiempo ISO-8601 de cuando se reconoció la recepción de la factura.
    Example: "2024-09-02T15:23:47-03:00"

  - `claim_date` (string,null)
    La fecha en que se presentó una reclamación o disputa sobre la factura, en formato .

  - `status` (string)
    El estado de la factura. Puede ser:

  - 
  - 
  - 
  -
    Example: "REGISTERED"

  - `document_code` (integer)
    Un código que indica si el documento es una factura, una nota de crédito o débito, etc.
    Example: 33

  - `category` (string)
    La categoría de la factura, según la institución.
    Example: "Del Giro"

  - `folio` (string)
    El código único de la institución para la factura.
    Example: "23559723"

  - `sender_id` (string)
    El número de identificación del remitente. Para SII Chile, este es el RUT.
    Example: "59324768-2"

  - `sender_name` (string)
    El nombre registrado del remitente.
    Example: "Cafe del Sur"

  - `receiver_id` (string)
    El número de identificación del receptor. Para SII Chile, este es el RUT.
    Example: "82136549-6"

  - `receiver_name` (string)
    El nombre registrado del receptor.
    Example: "Alejandra Gonzalez"

  - `type` (string)
    Indica si la factura es un INFLOW o OUTFLOW.
    Enum: "INFLOW", "OUTFLOW"

  - `purchase_invoice_details` (object,null)
    Detalles sobre la factura de compra. Si la factura es una factura de venta ( = ), este campo devolverá .

  - `purchase_invoice_details.vat_refundable_amount` (number,null)
    El monto del IVA pagado que es elegible para ser reclamado como un crédito fiscal.
    Example: 300.02

  - `purchase_invoice_details.vat_non_refundable_amount` (number,null)
    El monto del IVA pagado que no se puede reclamar como crédito fiscal.
    Example: 20.02

  - `purchase_invoice_details.vat_non_refundable_code` (integer,null)
    Un código que identifica la razón por la cual el IVA no es recuperable.
    Example: 90

  - `purchase_invoice_details.net_amount_fixed_assets` (number,null)
    El valor neto de los activos fijos adquiridos.
    Example: 8000.02

  - `purchase_invoice_details.vat_fixed_assets` (number,null)
    El valor del IVA en la compra de activos fijos.
    Example: 80.02

  - `purchase_invoice_details.vat_common_use` (number,null)
    El IVA que se aplica a las compras utilizadas tanto para fines gravables como no gravables.
    Example: 129.02

  - `purchase_invoice_details.tax_non_credit_amount` (number,null)
    El monto del impuesto que no se puede reclamar como crédito.
    Example: 5.02

  - `purchase_invoice_details.vat_non_withheld` (number,null)
    El monto del IVA que no fue retenido por el comprador.
    Example: 8.02

  - `purchase_invoice_details.tax_exempt_amount` (number,null)
    La parte de la compra que está exenta de IVA.
    Example: 33.02

  - `purchase_invoice_details.credit_or_debit_note_on_purchase` (boolean,null)
    Indica si la factura está vinculada con una nota de crédito o débito.

  - `purchase_invoice_details.tax_cigarettes_amount` (number,null)
    El monto total de impuestos aplicado a los cigarrillos.
    Example: 50.02

  - `purchase_invoice_details.tax_cigar_amount` (number,null)
    El monto total de impuestos aplicado a los cigarros.
    Example: 51.02

  - `purchase_invoice_details.tax_processed_tobacco_amount` (number,null)
    El monto total de impuestos aplicado al tabaco procesado.
    Example: 49.02

  - `purchase_invoice_details.additional_tax_amount` (number,null)
    El monto total del impuesto del impuesto adicional.
    Example: 1005.02

  - `purchase_invoice_details.additional_tax_rate` (string,null)
    La tasa impositiva del impuesto adicional.
    Example: "2.1"

  - `purchase_invoice_details.additional_tax_code` (integer,null)
    El código fiscal para el impuesto adicional.
    Example: 50993

  - `sales_invoice_details` (object,null)
    Detalles sobre la factura de ventas. Si la factura es una factura de compra ( = ), este campo devolverá .

  - `sales_invoice_details.construction_sector_tax_credit` (number,null)
    El monto del crédito fiscal aplicable para las empresas de construcción.
    Example: 50000.02

  - `sales_invoice_details.tax_free_trade_zone_amount` (number,null)
    Impuesto aplicable a las transacciones en zonas de libre comercio.
    Example: 38490.02

  - `sales_invoice_details.container_deposit_guarantee` (number,null)
    Se refiere a depósitos o garantías sobre contenedores, si corresponde.
    Example: 0.02

  - `sales_invoice_details.is_free_of_charge` (boolean,null)
    Indique si esta venta se realizó sin costo (por ejemplo, la factura es para material promocional, reabastecimientos periódicos gratuitos y similares).

  - `sales_invoice_details.periodic_billing_type` (boolean,null)
    Marca si la factura es para servicios periódicos.

  - `sales_invoice_details.non_billable_amount` (number,null)
    La parte de la transacción que no es facturable.
    Example: 40.02

  - `sales_invoice_details.total_amount_for_period` (number,null)
    El monto total para un período específico, a menudo utilizado para la facturación periódica.

  - `sales_invoice_details.domestic_transportation_amount` (number,null)
    El monto total gastado en transporte doméstico.
    Example: 67.02

  - `sales_invoice_details.international_transportation_amount` (number,null)
    El monto total gastado en transporte internacional.
    Example: 56.02

  - `sales_invoice_details.branch_code` (integer,null)
    El código de la sucursal fiscal donde se emitió la factura de venta.
    Example: 76129014

  - `sales_invoice_details.tax_exempt_amount` (number,null)
    La parte de la venta que está exenta de IVA.
    Example: 4000.02

  - `sales_invoice_details.vat_total_withheld` (number,null)
    El total del IVA retenido.
    Example: 33.02

  - `sales_invoice_details.vat_partially_withheld` (number,null)
    El monto del IVA parcialmente retenido.
    Example: 30.02

  - `sales_invoice_details.vat_non_withheld` (number,null)
    El monto del IVA que no fue retenido.
    Example: 40.02

  - `sales_invoice_details.vat_sales` (number,null)
    El importe del IVA correspondiente a las ventas propias del vendedor.
    Example: 100.02

  - `sales_invoice_details.vat_third_party` (number,null)
    Importe del IVA relacionado con ventas de terceros si actúa como intermediario.
    Example: 1000.02

  - `sales_invoice_details.vat_past_due` (number,null)
    IVA que se contabiliza o paga después de la fecha de vencimiento.
    Example: 31.02

  - `sales_invoice_details.invoice_settlement_sender_id` (string,null)
    El RUT de la entidad que emitió la liquidación para la factura.
    Example: "55524768-7"

  - `sales_invoice_details.invoice_settlement_net_commission` (number,null)
    El importe neto de la comisión en la liquidación de la factura.
    Example: 54.02

  - `sales_invoice_details.invoice_settlement_exempt_commission` (number,null)
    La parte de la comisión en la liquidación de la factura que está exenta de impuestos.
    Example: 16.02

  - `sales_invoice_details.invoice_settlement_vat_commission` (number,null)
    IVA cobrado sobre el monto de la comisión en la liquidación de la factura.
    Example: 78.02

  - `sales_invoice_details.reference_document_type` (string,null)
    Indica el tipo de documento al que se refiere o está vinculado esta factura.

  - `sales_invoice_details.reference_document_folio` (string,null)
    El número de folio del documento referido.

  - `sales_invoice_details.foreign_recipient_id` (string,null)
    El número de identificación de un individuo extranjero.
    Example: "JANM-7820234"

  - `sales_invoice_details.foreign_recipient_nationality` (string,null)
    La nacionalidad del individuo extranjero.
    Example: "Peru"

  - `summary_invoice_details` (object)
    Detalles sobre el resumen de las facturas  o .

  - `summary_invoice_details.month` (string)
    El año y mes de las facturas, en formato .
    Example: "2024-08"

  - `summary_invoice_details.updated_at` (string)
    La marca de tiempo ISO-8601 de cuándo se actualizó por última vez la lista de facturas.
    Example: "2024-09-02T15:23:47-03:00"

  - `summary_invoice_details.total_documents` (integer)
    El número total de facturas en el resumen.
    Example: 23

  - `summary_invoice_details.tax_exempt_amount` (number)
    El valor total de la factura (de todas las facturas en el resumen) que está exento de IVA.
    Example: 4000.02

## Response 201 fields (application/json):

  - `id` (string)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `link` (string,null)
    El  al que pertenecen los datos.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `created_at` (string)
    La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `collected_at` (string)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `total_amount` (number)
    El importe total de la factura, incluidos el IVA y otros impuestos o cargos.
    Example: 3272500.02

  - `net_amount` (number)
    El monto total de la factura después del IVA y otros impuestos.
    Example: 2750000.02

  - `vat_amount` (number)
    El importe total del IVA de la factura.
    Example: 522500.02

  - `currency` (string)
    El código de moneda de tres letras (ISO-4217) de la factura.
    Example: "CLP"

  - `issue_date` (string)
    La fecha en que se emitió la factura, en formato .
    Example: "2024-09-23"

  - `received_at` (string)
    La marca de tiempo ISO-8601 de cuando se recibió la factura.
    Example: "2024-09-02T15:23:47-03:00"

  - `acknowledged_at` (string)
    La marca de tiempo ISO-8601 de cuando se reconoció la recepción de la factura.
    Example: "2024-09-02T15:23:47-03:00"

  - `claim_date` (string,null)
    La fecha en que se presentó una reclamación o disputa sobre la factura, en formato .

  - `status` (string)
    El estado de la factura. Puede ser:

  - 
  - 
  - 
  -
    Example: "REGISTERED"

  - `document_code` (integer)
    Un código que indica si el documento es una factura, una nota de crédito o débito, etc.
    Example: 33

  - `category` (string)
    La categoría de la factura, según la institución.
    Example: "Del Giro"

  - `folio` (string)
    El código único de la institución para la factura.
    Example: "23559723"

  - `sender_id` (string)
    El número de identificación del remitente. Para SII Chile, este es el RUT.
    Example: "59324768-2"

  - `sender_name` (string)
    El nombre registrado del remitente.
    Example: "Cafe del Sur"

  - `receiver_id` (string)
    El número de identificación del receptor. Para SII Chile, este es el RUT.
    Example: "82136549-6"

  - `receiver_name` (string)
    El nombre registrado del receptor.
    Example: "Alejandra Gonzalez"

  - `type` (string)
    Indica si la factura es un INFLOW o OUTFLOW.
    Enum: "INFLOW", "OUTFLOW"

  - `purchase_invoice_details` (object,null)
    Detalles sobre la factura de compra. Si la factura es una factura de venta ( = ), este campo devolverá .

  - `purchase_invoice_details.vat_refundable_amount` (number,null)
    El monto del IVA pagado que es elegible para ser reclamado como un crédito fiscal.
    Example: 300.02

  - `purchase_invoice_details.vat_non_refundable_amount` (number,null)
    El monto del IVA pagado que no se puede reclamar como crédito fiscal.
    Example: 20.02

  - `purchase_invoice_details.vat_non_refundable_code` (integer,null)
    Un código que identifica la razón por la cual el IVA no es recuperable.
    Example: 90

  - `purchase_invoice_details.net_amount_fixed_assets` (number,null)
    El valor neto de los activos fijos adquiridos.
    Example: 8000.02

  - `purchase_invoice_details.vat_fixed_assets` (number,null)
    El valor del IVA en la compra de activos fijos.
    Example: 80.02

  - `purchase_invoice_details.vat_common_use` (number,null)
    El IVA que se aplica a las compras utilizadas tanto para fines gravables como no gravables.
    Example: 129.02

  - `purchase_invoice_details.tax_non_credit_amount` (number,null)
    El monto del impuesto que no se puede reclamar como crédito.
    Example: 5.02

  - `purchase_invoice_details.vat_non_withheld` (number,null)
    El monto del IVA que no fue retenido por el comprador.
    Example: 8.02

  - `purchase_invoice_details.tax_exempt_amount` (number,null)
    La parte de la compra que está exenta de IVA.
    Example: 33.02

  - `purchase_invoice_details.credit_or_debit_note_on_purchase` (boolean,null)
    Indica si la factura está vinculada con una nota de crédito o débito.

  - `purchase_invoice_details.tax_cigarettes_amount` (number,null)
    El monto total de impuestos aplicado a los cigarrillos.
    Example: 50.02

  - `purchase_invoice_details.tax_cigar_amount` (number,null)
    El monto total de impuestos aplicado a los cigarros.
    Example: 51.02

  - `purchase_invoice_details.tax_processed_tobacco_amount` (number,null)
    El monto total de impuestos aplicado al tabaco procesado.
    Example: 49.02

  - `purchase_invoice_details.additional_tax_amount` (number,null)
    El monto total del impuesto del impuesto adicional.
    Example: 1005.02

  - `purchase_invoice_details.additional_tax_rate` (string,null)
    La tasa impositiva del impuesto adicional.
    Example: "2.1"

  - `purchase_invoice_details.additional_tax_code` (integer,null)
    El código fiscal para el impuesto adicional.
    Example: 50993

  - `sales_invoice_details` (object,null)
    Detalles sobre la factura de ventas. Si la factura es una factura de compra ( = ), este campo devolverá .

  - `sales_invoice_details.construction_sector_tax_credit` (number,null)
    El monto del crédito fiscal aplicable para las empresas de construcción.
    Example: 50000.02

  - `sales_invoice_details.tax_free_trade_zone_amount` (number,null)
    Impuesto aplicable a las transacciones en zonas de libre comercio.
    Example: 38490.02

  - `sales_invoice_details.container_deposit_guarantee` (number,null)
    Se refiere a depósitos o garantías sobre contenedores, si corresponde.
    Example: 0.02

  - `sales_invoice_details.is_free_of_charge` (boolean,null)
    Indique si esta venta se realizó sin costo (por ejemplo, la factura es para material promocional, reabastecimientos periódicos gratuitos y similares).

  - `sales_invoice_details.periodic_billing_type` (boolean,null)
    Marca si la factura es para servicios periódicos.

  - `sales_invoice_details.non_billable_amount` (number,null)
    La parte de la transacción que no es facturable.
    Example: 40.02

  - `sales_invoice_details.total_amount_for_period` (number,null)
    El monto total para un período específico, a menudo utilizado para la facturación periódica.

  - `sales_invoice_details.domestic_transportation_amount` (number,null)
    El monto total gastado en transporte doméstico.
    Example: 67.02

  - `sales_invoice_details.international_transportation_amount` (number,null)
    El monto total gastado en transporte internacional.
    Example: 56.02

  - `sales_invoice_details.branch_code` (integer,null)
    El código de la sucursal fiscal donde se emitió la factura de venta.
    Example: 76129014

  - `sales_invoice_details.tax_exempt_amount` (number,null)
    La parte de la venta que está exenta de IVA.
    Example: 4000.02

  - `sales_invoice_details.vat_total_withheld` (number,null)
    El total del IVA retenido.
    Example: 33.02

  - `sales_invoice_details.vat_partially_withheld` (number,null)
    El monto del IVA parcialmente retenido.
    Example: 30.02

  - `sales_invoice_details.vat_non_withheld` (number,null)
    El monto del IVA que no fue retenido.
    Example: 40.02

  - `sales_invoice_details.vat_sales` (number,null)
    El importe del IVA correspondiente a las ventas propias del vendedor.
    Example: 100.02

  - `sales_invoice_details.vat_third_party` (number,null)
    Importe del IVA relacionado con ventas de terceros si actúa como intermediario.
    Example: 1000.02

  - `sales_invoice_details.vat_past_due` (number,null)
    IVA que se contabiliza o paga después de la fecha de vencimiento.
    Example: 31.02

  - `sales_invoice_details.invoice_settlement_sender_id` (string,null)
    El RUT de la entidad que emitió la liquidación para la factura.
    Example: "55524768-7"

  - `sales_invoice_details.invoice_settlement_net_commission` (number,null)
    El importe neto de la comisión en la liquidación de la factura.
    Example: 54.02

  - `sales_invoice_details.invoice_settlement_exempt_commission` (number,null)
    La parte de la comisión en la liquidación de la factura que está exenta de impuestos.
    Example: 16.02

  - `sales_invoice_details.invoice_settlement_vat_commission` (number,null)
    IVA cobrado sobre el monto de la comisión en la liquidación de la factura.
    Example: 78.02

  - `sales_invoice_details.reference_document_type` (string,null)
    Indica el tipo de documento al que se refiere o está vinculado esta factura.

  - `sales_invoice_details.reference_document_folio` (string,null)
    El número de folio del documento referido.

  - `sales_invoice_details.foreign_recipient_id` (string,null)
    El número de identificación de un individuo extranjero.
    Example: "JANM-7820234"

  - `sales_invoice_details.foreign_recipient_nationality` (string,null)
    La nacionalidad del individuo extranjero.
    Example: "Peru"

  - `summary_invoice_details` (object)
    Detalles sobre el resumen de las facturas  o .

  - `summary_invoice_details.month` (string)
    El año y mes de las facturas, en formato .
    Example: "2024-08"

  - `summary_invoice_details.updated_at` (string)
    La marca de tiempo ISO-8601 de cuándo se actualizó por última vez la lista de facturas.
    Example: "2024-09-02T15:23:47-03:00"

  - `summary_invoice_details.total_documents` (integer)
    El número total de facturas en el resumen.
    Example: 23

  - `summary_invoice_details.tax_exempt_amount` (number)
    El valor total de la factura (de todas las facturas en el resumen) que está exento de IVA.
    Example: 4000.02

## Response 202 fields (application/json):

  - `request_id` (string)
    El ID único para esta solicitud. Recomendamos que almacene este valor para identificar más tarde qué evento de webhook se relaciona con una solicitud asincrónica.
    Example: "b5d0106ac9cc43d5b36199fe831f6bbe"

## Response 403 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Una breve descripción del error.

Para los errores , la descripción es:

  - .
    Example: "You don't have access to this resource."

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.
    Example: "not_found"

  - `message` (string)
    Una breve descripción del error.

Para errores , la descripción es:

  -
    Example: "Not found"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Una breve descripción del error.

Para los errores de , la descripción es:

  - .
    Example: "The request timed out, you can retry asking for less data by changing your query parameters"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 500 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Una breve descripción del error.

Para los errores , la descripción es:

- .
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"