# Listar facturas

## ▶️ Uso

Con el método List Invoices, puedes:

1. Listar facturas relacionadas con un  específico (usando el parámetro de consulta ).
2. Obtener los detalles de un  específico (usando el parámetro de consulta ).
3.  Listar todas las facturas relacionadas con tu cuenta de Belvo (sin usar ningún parámetro de consulta).

## 📖 Paginación

Este método devuelve una respuesta paginada (por defecto: 100 elementos por página). Puedes usar el parámetro de consulta  para aumentar el número de elementos devueltos hasta un máximo de 1000 elementos. Puedes usar el parámetro de consulta  para navegar a través de los resultados. Para más detalles sobre cómo navegar por las respuestas paginadas de Belvo, consulta nuestro artículo Consejos de Paginación.

## 🔦 Filtrado de Respuestas

Consulta la lista de campos a continuación para ver los campos por los que puedes filtrar tus respuestas. Para más información sobre cómo usar filtros, consulta nuestro artículo Filtrado de respuestas.

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

## Query parameters:

  - `link` (string)
    El  por el que deseas filtrar.

ℹ️ Recomendamos encarecidamente añadir el filtro  para mejorar tu rendimiento.
    Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4"

  - `page_size` (integer)
    Indica cuántos resultados devolver por página. Por defecto, devolvemos 100 resultados por página.

ℹ️ El número mínimo de resultados devueltos por página es 1 y el máximo es 1000. Si introduces un valor mayor que 1000, nuestra API usará por defecto el valor máximo (1000).
    Example: 100

  - `page` (integer)
    Un número de página dentro del conjunto de resultados paginados.
    Example: 1

  - `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.

  - `link__in` (array)
    Devuelve resultados solo para estos s.
    Example: ["5722d0ba-69d7-42dc-8ff5-33767b83c5d6"]

  - `id` (string)
    Devuelve información solo para este recurso .
    Example: "24ccab1d-3a86-4136-a6eb-e04bf52b356f"

  - `id__in` (array)
    Devuelve información para estos s de recursos.
    Example: ["6b3dea0f-be29-49d1-aabe-1a6d588642e6"]

  - `created_at` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo en esta fecha (en formato ).
    Example: "2022-05-05"

  - `created_at__gt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después de esta fecha (en formato ).
    Example: "2022-05-05"

  - `created_at__gte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después o en esta fecha (en formato ).
    Example: "2022-05-04"

  - `created_at__lt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes de esta fecha (en formato ).
    Example: "2022-04-01"

  - `created_at__lte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes o en esta fecha (en formato ).
    Example: "2022-03-30"

  - `created_at__range` (array)
    Devolver cuentas que fueron actualizadas por última vez en la base de datos de Belvo entre dos fechas (en formato ).
    Example: ["2022-03-03"]

## Response 200 fields (application/json):

  - `count` (integer)
    El número total de resultados en tu cuenta de Belvo.
    Example: 130

  - `next` (string,null)
    La URL a la siguiente página de resultados. Cada página consta de hasta 100 elementos. Si no hay suficientes resultados para una página adicional, el valor es .

En nuestro ejemplo de documentación, usamos  como un valor de marcador de posición. En producción, este valor será reemplazado por el endpoint real que estás utilizando actualmente (por ejemplo,  o ).
    Example: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2"

  - `previous` (string,null)
    La URL a la página anterior de resultados. Si no hay una página anterior, el valor es .

  - `results` (array)
    Array de objetos de invoice.

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

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

  - `results.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"

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

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

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

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

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

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

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

  - `results.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"

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

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

  - 
  - 
  - 
  -
    Example: "REGISTERED"

  - `results.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

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

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

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

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

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

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

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

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

  - `results.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

  - `results.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

  - `results.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

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

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

  - `results.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

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

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

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

  - `results.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.

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

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

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

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

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

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

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

  - `results.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

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

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

  - `results.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).

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

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

  - `results.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.

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

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

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

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

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

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

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

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

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

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

  - `results.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"

  - `results.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

  - `results.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

  - `results.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

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

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

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

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

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

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

  - `results.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"

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

  - `results.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 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"