# 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 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 , incluindo o . 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 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 . ⚠️ O valor de não pode ser maior que . Example: "2020-08-05" - `date_to` (string, required) A data em que você deseja parar de receber dados, no formato . ⚠️ O valor de 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). - indica uma fatura enviada. - 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 e retornamos uma resposta 201 Created. Quando definido como , 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 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 . 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 . - `status` (string) O status da fatura. Pode ser: - - - - 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 ( = ), este campo retornará . - `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 ( = ), este campo retornará . - `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.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 ou . - `summary_invoice_details.month` (string) O ano e o mês das faturas, no formato . 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 201 fields (application/json): - `id` (string) Identificador único da Belvo para o item atual. Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d" - `link` (string,null) O 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 . 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 . - `status` (string) O status da fatura. Pode ser: - - - - 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 ( = ), este campo retornará . - `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 ( = ), este campo retornará . - `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.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 ou . - `summary_invoice_details.month` (string) O ano e o mês das faturas, no formato . 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 () 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 , a descrição é: - . 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: ). 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 () que permite classificar e lidar com o erro programaticamente. Example: "not_found" - `message` (string) Uma breve descrição do erro. Para erros , a descrição é: - Example: "Not found" - `request_id` (string) Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: ). 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 () 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 , a descrição é: - . 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: ). 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 () 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 , a descriçã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: ). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações. Example: "9e7b283c6efa449c9c028a16b5c249fb"