BEbelvo
Invoices Chile

Retrieve invoices for a link

Retrieve invoice information from a specific Chilean fiscal link. You can ask for up to <b>one</b> year (365 days) of invoices per request. If you need invoices for more than one year, just make another request.

📘 Highly Recommended > > We strongly recommend that you use Belvo's X-Belvo-Request-Mode header parameter and implement an asynchronous workflow. This will ensure that you do not receive any timeout errors while retrieving invoice data.

post/api/cl/invoices/

Request

Query parameters

omitstring

Omit certain fields from being returned in the response. For more information, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> DevPortal article.

fieldsstring

Return only the specified fields in the response. For more information, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> DevPortal article.

Headers

X-Belvo-Request-Mode'async'
Example:async

Recommended header parameter to make your POST request asynchronous (thus preventing timeouts and improving your data flow).

When you make an asynchronous request, Belvo responds with a 202 - Accepted payload, including the request_id. Once we have retrieved the requested information, you will receive a webhook with the link and request IDs.

Request body

linkstring uuid required

The link.id you want to retrieve information for.

date_fromstring date required

The date from which you want to start getting data for, in YYYY-MM-DD format.

⚠️ The value of date_from cannot be greater than date_to.

date_tostring date required

The date you want to stop getting data for, in YYYY-MM-DD format.

⚠️ The value of date_to cannot be greater than today's date (in other words, no future dates).

type'OUTFLOW' | 'INFLOW' | 'null' nullable

The direction of the invoice (from the perspective of the Link owner).

  • OUTFLOW indicates a sent invoice.
  • INFLOW indicates a received invoice.
save_databoolean

Indicates whether or not to persist the data in Belvo. By default, this is set to true and we return a 201 Created response.

When set to false, the data won't be persisted and we return a 200 OK response.

Example request

{
  "link": "c81a1dea-6dd6-4999-8b9f-541ee8197058",
  "date_from": "2020-08-05",
  "date_to": "2020-10-05",
  "type": "INFLOW",
  "save_data": true
}

Response

Ok (when save_data=false)

idstring uuid

Belvo's unique identifier for the current item.

linkstring uuid nullable

The link.id the data belongs to.

created_atstring date-time

The ISO-8601 timestamp of when the data point was created in Belvo's database.

collected_atstring date-time

The ISO-8601 timestamp when the data point was collected.

total_amountnumber float

The total amount of the invoice, including VAT and other taxes or charges.

net_amountnumber float

The total invoice amount after VAT and other taxes.

vat_amountnumber float

The total VAT amount of the invoice.

currencystring

The three-letter currency code (ISO-4217) of the invoice.

issue_datestring date

The date that the invoice was issued, in YYYY-MM-DD format.

received_atstring date-time

The ISO-8601 timestamp of when the invoice was received.

acknowledged_atstring date-time

The ISO-8601 timestamp of when the invoice was acknowledged as received.

claim_datestring date nullable

The date when a claim or dispute was raised about the invoice, in YYYY-MM-DD format.

statusstring

The status of the invoice. Can be either:

  • REGISTERED
  • PENDING
  • REJECTED
  • CANCELLED
document_codeinteger

A code that indicates whether the document is a invoice, a credit or debit note, and so on.

categorystring

The category of the invoice, according to the institution.

foliostring

The institution's unique code for the invoice.

sender_idstring

The identification number of the sender. For SII Chile, this is the RUT.

sender_namestring

The registered name of the sender.

receiver_idstring

The identification number of the receiver. For SII Chile, this is the RUT.

receiver_namestring

The registered name of the receiver.

type'INFLOW' | 'OUTFLOW'

Indicates whether the invoice is an INFLOW or OUTFLOW.

Example response

[
  {
    "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d",
    "link": "30cb4806-6e00-48a4-91c9-ca55968576c8",
    "created_at": "2022-02-09T08:45:50.406032Z",
    "collected_at": "2022-02-09T08:45:50.406032Z",
    "total_amount": 3272500.02,
    "net_amount": 2750000.02,
    "vat_amount": 522500.02,
    "currency": "CLP",
    "issue_date": "2024-09-23",
    "received_at": "2024-09-02T15:23:47-03:00",
    "acknowledged_at": "2024-09-02T15:23:47-03:00",
    "status": "REGISTERED",
    "document_code": 33,
    "category": "Del Giro",
    "folio": "23559723",
    "sender_id": "59324768-2",
    "sender_name": "Cafe del Sur",
    "receiver_id": "82136549-6",
    "receiver_name": "Alejandra Gonzalez",
    "type": "INFLOW",
    "purchase_invoice_details": {
      "vat_refundable_amount": 300.02,
      "vat_non_refundable_amount": 20.02,
      "vat_non_refundable_code": 90,
      "net_amount_fixed_assets": 8000.02,
      "vat_fixed_assets": 80.02,
      "vat_common_use": 129.02,
      "tax_non_credit_amount": 5.02,
      "vat_non_withheld": 8.02,
      "tax_exempt_amount": 33.02,
      "tax_cigarettes_amount": 50.02,
      "tax_cigar_amount": 51.02,
      "tax_processed_tobacco_amount": 49.02,
      "additional_tax_amount": 1005.02,
      "additional_tax_rate": "2.1",
      "additional_tax_code": 50993
    },
    "sales_invoice_details": {
      "construction_sector_tax_credit": 50000.02,
      "tax_free_trade_zone_amount": 38490.02,
      "container_deposit_guarantee": 0.02,
      "non_billable_amount": 40.02,
      "domestic_transportation_amount": 67.02,
      "international_transportation_amount": 56.02,
      "branch_code": 76129014,
      "tax_exempt_amount": 4000.02,
      "additional_tax_code": 50993,
      "additional_tax_rate": "2.1",
      "additional_tax_amount": 1005.02,
      "vat_total_withheld": 33.02,
      "vat_partially_withheld": 30.02,
      "vat_non_withheld": 40.02,
      "vat_sales": 100.02,
      "vat_third_party": 1000.02,
      "vat_past_due": 31.02,
      "invoice_settlement_sender_id": "55524768-7",
      "invoice_settlement_net_commission": 54.02,
      "invoice_settlement_exempt_commission": 16.02,
      "invoice_settlement_vat_commission": 78.02,
      "foreign_recipient_id": "JANM-7820234",
      "foreign_recipient_nationality": "Peru"
    },
    "summary_invoice_details": {
      "month": "2024-08",
      "updated_at": "2024-09-02T15:23:47-03:00",
      "total_documents": 23,
      "tax_exempt_amount": 4000.02
    }
  }
]

Changes

No recorded changes to this operation across all 5 revisions of this API.