v1

latestOpenAPI 3.0.22026-08-061464031.4 MB
Invoices Chile

Get an invoice's details

Get the details of a specific invoice.

get/api/cl/invoices/{id}/

Path parameters

idstring uuid required

The invoice.id you want to get detailed information about.

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.

Response

Ok

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
  }
}