# Recuperar faturas para um link

Recuperar informações de faturas de um link fiscal específico do Chile.
Você pode solicitar até um ano (365 dias) de faturas por solicitação. Se precisar de faturas por mais de um ano, basta fazer outra solicitação.
> 📘 Altamente Recomendado > > Recomendamos fortemente que você use o parâmetro de cabeçalho X-Belvo-Request-Mode da Belvo e implemente um fluxo de trabalho assíncrono. Isso garantirá que você não receba erros de timeout ao recuperar dados de faturas.

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

## Header parameters:

  - `X-Belvo-Request-Mode` (string)
    Parâmetro de cabeçalho recomendado para tornar sua solicitação POST assíncrona (evitando timeouts e melhorando o fluxo de dados).

Quando você faz uma solicitação assíncrona, a Belvo responde com um payload 202 - Accepted, incluindo o request_id. Assim que tivermos recuperado as informações solicitadas, você receberá um webhook com o link e os IDs de solicitação.
    Enum: "async"

## Query parameters:

  - `omit` (string)
    Omitir certos campos de serem retornados na resposta. Para mais informações, consulte nosso artigo Filtrando respostas no DevPortal.

  - `fields` (string)
    Retorne apenas os campos especificados na resposta. Para mais informações, consulte nosso artigo no DevPortal Filtrando respostas.

## Request fields (application/json):

  - `link` (string, required)
    O link.id para o qual você deseja recuperar informações.
    Example: "c81a1dea-6dd6-4999-8b9f-541ee8197058"

  - `date_from` (string, required)
    A data a partir da qual você deseja começar a obter dados, no formato YYYY-MM-DD.

⚠️ O valor de date_from não pode ser maior que date_to.
    Example: "2020-08-05"

  - `date_to` (string, required)
    A data em que você deseja parar de receber dados, no formato YYYY-MM-DD.

⚠️ O valor de date_to não pode ser maior que a data de hoje (ou seja, não são permitidas datas futuras).
    Example: "2020-10-05"

  - `type` (string,null)
    A direção da fatura (do ponto de vista do proprietário do Link).
- OUTFLOW indica uma fatura enviada.
- INFLOW indica uma fatura recebida.
    Enum: "OUTFLOW", "INFLOW", null

  - `save_data` (boolean)
    Indica se os dados devem ou não ser persistidos no Belvo. Por padrão, isso é definido como true e retornamos uma resposta 201 Created.

Quando definido como false, os dados não serão persistidos e retornamos uma resposta 200 OK.
    Example: true

## Response 200 fields (application/json):

  - `id` (string)
    Identificador único da Belvo para o item atual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `link` (string,null)
    O link.id ao qual os dados pertencem.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `created_at` (string)
    O carimbo de data e hora ISO-8601 de quando o ponto de dados foi criado no banco de dados da Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `collected_at` (string)
    O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.
    Example: "2022-02-09T08:45:50.406032Z"

  - `total_amount` (number)
    O valor total da fatura, incluindo IVA e outros impostos ou encargos.
    Example: 3272500.02

  - `net_amount` (number)
    O valor total da fatura após o IVA e outros impostos.
    Example: 2750000.02

  - `vat_amount` (number)
    O valor total do IVA da fatura.
    Example: 522500.02

  - `currency` (string)
    O código de moeda de três letras (ISO-4217) da fatura.
    Example: "CLP"

  - `issue_date` (string)
    A data em que a fatura foi emitida, no formato YYYY-MM-DD.
    Example: "2024-09-23"

  - `received_at` (string)
    O carimbo de data/hora ISO-8601 de quando a fatura foi recebida.
    Example: "2024-09-02T15:23:47-03:00"

  - `acknowledged_at` (string)
    O carimbo de data e hora ISO-8601 de quando a fatura foi reconhecida como recebida.
    Example: "2024-09-02T15:23:47-03:00"

  - `claim_date` (string,null)
    A data em que uma reclamação ou disputa foi levantada sobre a fatura, no formato YYYY-MM-DD.

  - `status` (string)
    O status da fatura. Pode ser:

  - REGISTERED
  - PENDING
  - REJECTED
  - CANCELLED
    Example: "REGISTERED"

  - `document_code` (integer)
    Um código que indica se o documento é uma fatura, uma nota de crédito ou débito, e assim por diante.
    Example: 33

  - `category` (string)
    A categoria da fatura, de acordo com a instituição.
    Example: "Del Giro"

  - `folio` (string)
    O código único da instituição para a fatura.
    Example: "23559723"

  - `sender_id` (string)
    O número de identificação do remetente. Para o SII Chile, este é o RUT.
    Example: "59324768-2"

  - `sender_name` (string)
    O nome registrado do remetente.
    Example: "Cafe del Sur"

  - `receiver_id` (string)
    O número de identificação do receptor. Para o SII Chile, este é o RUT.
    Example: "82136549-6"

  - `receiver_name` (string)
    O nome registrado do receptor.
    Example: "Alejandra Gonzalez"

  - `type` (string)
    Indica se a fatura é um INFLOW ou OUTFLOW.
    Enum: "INFLOW", "OUTFLOW"

  - `purchase_invoice_details` (object,null)
    Detalhes sobre a nota fiscal de compra. Se a nota fiscal for uma nota de venda (type = OUTFLOW), este campo retornará null.

  - `purchase_invoice_details.vat_refundable_amount` (number,null)
    O valor do IVA pago que é elegível para ser reivindicado como crédito fiscal.
    Example: 300.02

  - `purchase_invoice_details.vat_non_refundable_amount` (number,null)
    O valor do IVA pago que não pode ser recuperado como crédito fiscal.
    Example: 20.02

  - `purchase_invoice_details.vat_non_refundable_code` (integer,null)
    Um código que identifica o motivo pelo qual o VAT não é recuperável.
    Example: 90

  - `purchase_invoice_details.net_amount_fixed_assets` (number,null)
    O valor líquido dos ativos fixos adquiridos.
    Example: 8000.02

  - `purchase_invoice_details.vat_fixed_assets` (number,null)
    O valor do IVA na compra de ativos fixos.
    Example: 80.02

  - `purchase_invoice_details.vat_common_use` (number,null)
    O IVA que se aplica a compras usadas para fins tanto tributáveis quanto não tributáveis.
    Example: 129.02

  - `purchase_invoice_details.tax_non_credit_amount` (number,null)
    O valor do imposto que não pode ser reivindicado como crédito.
    Example: 5.02

  - `purchase_invoice_details.vat_non_withheld` (number,null)
    O valor do IVA que não foi retido pelo comprador.
    Example: 8.02

  - `purchase_invoice_details.tax_exempt_amount` (number,null)
    A parte da compra que é isenta de IVA.
    Example: 33.02

  - `purchase_invoice_details.credit_or_debit_note_on_purchase` (boolean,null)
    Indica se a fatura está vinculada a uma nota de crédito ou débito.

  - `purchase_invoice_details.tax_cigarettes_amount` (number,null)
    O valor total do imposto aplicado sobre cigarros.
    Example: 50.02

  - `purchase_invoice_details.tax_cigar_amount` (number,null)
    O valor total do imposto aplicado sobre charutos.
    Example: 51.02

  - `purchase_invoice_details.tax_processed_tobacco_amount` (number,null)
    O valor total do imposto aplicado sobre o tabaco processado.
    Example: 49.02

  - `purchase_invoice_details.additional_tax_amount` (number,null)
    O valor total do imposto do imposto adicional.
    Example: 1005.02

  - `purchase_invoice_details.additional_tax_rate` (string,null)
    A alíquota do imposto adicional.
    Example: "2.1"

  - `purchase_invoice_details.additional_tax_code` (integer,null)
    O código tributário para o imposto adicional.
    Example: 50993

  - `sales_invoice_details` (object,null)
    Detalhes sobre a nota fiscal de vendas. Se a nota fiscal for uma nota de compra (type = INFLOW), este campo retornará null.

  - `sales_invoice_details.construction_sector_tax_credit` (number,null)
    O valor do crédito fiscal aplicável para empresas de construção.
    Example: 50000.02

  - `sales_invoice_details.tax_free_trade_zone_amount` (number,null)
    Imposto aplicável para transações em zonas de livre comércio.
    Example: 38490.02

  - `sales_invoice_details.container_deposit_guarantee` (number,null)
    Refere-se a depósitos ou garantias em recipientes, se aplicável.
    Example: 0.02

  - `sales_invoice_details.is_free_of_charge` (boolean,null)
    Indique se esta venda foi feita sem custo (por exemplo, a fatura é para material promocional, reabastecimentos periódicos gratuitos e similares).

  - `sales_invoice_details.periodic_billing_type` (boolean,null)
    Marca se a fatura é para serviços periódicos.

  - `sales_invoice_details.non_billable_amount` (number,null)
    A parte da transação que não é faturável.
    Example: 40.02

  - `sales_invoice_details.total_amount_for_period` (number,null)
    O valor total para um período específico, frequentemente usado para faturamento periódico.

  - `sales_invoice_details.domestic_transportation_amount` (number,null)
    O valor total gasto em transporte doméstico.
    Example: 67.02

  - `sales_invoice_details.international_transportation_amount` (number,null)
    O valor total gasto em transporte internacional.
    Example: 56.02

  - `sales_invoice_details.branch_code` (integer,null)
    O código da filial fiscal onde a nota fiscal de vendas foi emitida.
    Example: 76129014

  - `sales_invoice_details.tax_exempt_amount` (number,null)
    A parte da venda que é isenta de IVA.
    Example: 4000.02

  - `sales_invoice_details.credit_or_debit_note_on_purchase` (boolean,null)
    Indica se a fatura está vinculada a uma nota de crédito ou débito.

  - `sales_invoice_details.additional_tax_code` (integer,null)
    O código tributário para o imposto adicional.
    Example: 50993

  - `sales_invoice_details.additional_tax_rate` (string,null)
    A alíquota do imposto adicional.
    Example: "2.1"

  - `sales_invoice_details.additional_tax_amount` (number,null)
    O valor total do imposto do imposto adicional.
    Example: 1005.02

  - `sales_invoice_details.vat_total_withheld` (number,null)
    O total do IVA retido.
    Example: 33.02

  - `sales_invoice_details.vat_partially_withheld` (number,null)
    O valor do IVA parcialmente retido.
    Example: 30.02

  - `sales_invoice_details.vat_non_withheld` (number,null)
    O valor do IVA que não foi retido.
    Example: 40.02

  - `sales_invoice_details.vat_sales` (number,null)
    O valor do IVA correspondente às próprias vendas do vendedor.
    Example: 100.02

  - `sales_invoice_details.vat_third_party` (number,null)
    Valor do IVA relacionado a vendas de terceiros ao atuar como intermediário.
    Example: 1000.02

  - `sales_invoice_details.vat_past_due` (number,null)
    IVA que é contabilizado ou pago após a data de vencimento.
    Example: 31.02

  - `sales_invoice_details.invoice_settlement_sender_id` (string,null)
    O RUT da entidade que emitiu a liquidação para a fatura.
    Example: "55524768-7"

  - `sales_invoice_details.invoice_settlement_net_commission` (number,null)
    O valor líquido da comissão na liquidação da fatura.
    Example: 54.02

  - `sales_invoice_details.invoice_settlement_exempt_commission` (number,null)
    A parte da comissão na liquidação da fatura que está isenta de impostos.
    Example: 16.02

  - `sales_invoice_details.invoice_settlement_vat_commission` (number,null)
    IVA cobrado sobre o valor da comissão na liquidação da fatura.
    Example: 78.02

  - `sales_invoice_details.reference_document_type` (string,null)
    Indica o tipo de documento ao qual esta fatura se refere ou está vinculada.

  - `sales_invoice_details.reference_document_folio` (string,null)
    O número do fólio do documento referido.

  - `sales_invoice_details.foreign_recipient_id` (string,null)
    O número de identificação de um indivíduo estrangeiro.
    Example: "JANM-7820234"

  - `sales_invoice_details.foreign_recipient_nationality` (string,null)
    A nacionalidade do indivíduo estrangeiro.
    Example: "Peru"

  - `summary_invoice_details` (object)
    Detalhes sobre o resumo das faturas BOLETA_ELECTRONICA ou COMPROBANTE_PAGO.

  - `summary_invoice_details.month` (string)
    O ano e o mês das faturas, no formato YYYY-MM.
    Example: "2024-08"

  - `summary_invoice_details.updated_at` (string)
    O carimbo de data e hora ISO-8601 de quando a lista de faturas foi atualizada pela última vez.
    Example: "2024-09-02T15:23:47-03:00"

  - `summary_invoice_details.total_documents` (integer)
    O número total de faturas no resumo.
    Example: 23

  - `summary_invoice_details.tax_exempt_amount` (number)
    O valor total da fatura (de todas as faturas no resumo) que está isento de IVA.
    Example: 4000.02

## Response 202 fields (application/json):

  - `request_id` (string)
    O ID único para esta solicitação. Recomendamos que você armazene este valor para identificar posteriormente qual evento de webhook está relacionado a uma solicitação assíncrona.
    Example: "b5d0106ac9cc43d5b36199fe831f6bbe"

## Response 403 fields (application/json):

  - `code` (string)
    Um código de erro único (access_to_resource_denied) que permite classificar e tratar o erro programaticamente.

ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Uma breve descrição do erro.

Para erros access_to_resource_denied, a descrição é:

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

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    Um código de erro único (not_found) que permite classificar e lidar com o erro programaticamente.
    Example: "not_found"

  - `message` (string)
    Uma breve descrição do erro.

Para erros not_found, a descrição é:

  - Not found
    Example: "Not found"

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Um código de erro único (request_timeout) que permite classificar e lidar com o erro programaticamente.

ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com erros 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Uma breve descrição do erro.

Para erros de request_timeout, a descrição é:

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

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 500 fields (application/json):

  - `code` (string)
    Um código de erro único (unexpected_error) que permite classificar e tratar o erro de forma programática.

ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com erros 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Uma breve descrição do erro.

Para erros unexpected_error, a descrição é:

  - Belvo não consegue processar a solicitação devido a um problema interno do sistema ou a uma resposta não suportada de uma instituição.
    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)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"