# Listar facturas ## ▶️ Uso Con el método Listar Facturas, 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 una lista de 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. ## 🚨 Campos Obsoletos Este recurso puede devolver campos obsoletos. En la documentación de la respuesta, puedes ver que un campo ha sido marcado como . Esto significa que este campo ya no es mantenido por el equipo de Belvo. Aún puedes recibir datos para este campo dependiendo de la institución, sin embargo, no deberías depender de este campo. Endpoint: GET /api/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` (integer) Un número de página dentro del conjunto de resultados paginados. Example: 1 - `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 - `link__in` (array) Devuelve resultados solo para estos s. Example: ["5722d0ba-69d7-42dc-8ff5-33767b83c5d6"] - `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. - `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"] - `invoice_date` (string) Devolver facturas emitidas exactamente en esta fecha (). Example: "2022-05-05" - `invoice_date__lt` (string) Devuelve los saldos emitidos antes de esta fecha (). Example: "2022-03-02" - `invoice_date__lte` (string) Devuelve los saldos emitidos en esta fecha o antes (). Example: "2022-03-01" - `invoice_date__gt` (string) Devolver facturas emitidas después de esta fecha (). Example: "2022-05-06" - `invoice_date__gte` (string) Devolver facturas emitidas en esta fecha o posterior () Example: "2022-05-04" - `invoice_date__range` (array) Devolver facturas emitidas dentro de este rango de fechas (). Example: ["2022-05-06"] - `invoice_identification` (string) Devuelve una factura con este ID (según lo proporcionado por la institución). Example: "862B9918-3K6H-4E0B-NAI9-2BE2D833B840" - `invoice_identification__in` (array) Devuelve las facturas con estos IDs (según lo proporcionado por la institución). Example: ["992B9918-3G6H-4E0B-DAI9-2BE2D833B833"] - `status` (string) Devuelve las facturas con este estado. Puede ser (válido) o (cancelado). Example: "Vigente" - `status__in` (array) Devolver facturas con estos estados. Pueden ser (válido) o (cancelado). Example: ["Cancelado"] - `type` (string) Devolver facturas de este tipo. Puede ser o . Enum: "OUTFLOW", "INFLOW" - `type__in` (array) Devolver facturas de estos tipos. Puede ser o . Enum: "OUTFLOW", "INFLOW" - `total_amount` (number) Devolver facturas que coincidan exactamente con este valor. Example: 1000.02 - `total_amount__lt` (number) Devolver facturas menores que este valor. Example: 540.02 - `total_amount__lte` (number) Devolver facturas menores o iguales a este valor. Example: 541.02 - `total_amount__gt` (number) Devolver facturas mayores que este valor. Example: 520.02 - `total_amount__gte` (number) Devolver facturas mayores o iguales a este valor. Example: 519.02 - `total_amount__range` (array) Devolver facturas entre estos dos valores. Example: [541.02] ## 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.collected_at` (string, required) La marca de tiempo ISO-8601 cuando se recopiló el punto de datos. Example: "2022-02-09T08:45:50.406032Z" - `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.invoice_identification` (string,null, required) El ID único de la institución fiscal para la factura. Example: "A1A1A1A1-2B2B-3C33-D44D-555555E55EE" - `results.invoice_date` (string,null, required) La fecha de la factura, en formato . Example: "2019-12-01" - `results.status` (string,null, required) El estado de la factura. Puede ser (válido) o (cancelado). Example: "Vigente" - `results.invoice_type` (string,null, required) La clasificación de la factura por parte de la institución fiscal. Para el SAT de México, devolvemos uno de los siguientes valores: - - - - - Enum: "Egreso", "Ingreso", "Nómina", "Pago", "Traslado" - `results.type` (string,null, required) La dirección de la factura (desde la perspectiva del propietario del Link). - indica una factura enviada. - indica una factura recibida. Enum: "OUTFLOW", "INFLOW", null - `results.tax_details` (object) Información general sobre los impuestos de la factura. - `results.tax_details.total_tax_retained` (number) Monto total de impuestos retenidos. Example: 194.27 - `results.tax_details.total_tax_transferred` (number) Monto total de impuestos transferidos. Example: 150.4 - `results.tax_details.retained_taxes` (array) Lista de impuestos retenidos. - `results.tax_details.retained_taxes.tax` (string) El tipo de impuesto retenido (por ejemplo, ISR, IVA o IEPS). Example: "ISR" - `results.tax_details.retained_taxes.tax_percentage` (number,null) El porcentaje de impuesto retenido. - `results.tax_details.retained_taxes.pre_tax_amount` (number,null) El monto antes de impuestos. - `results.tax_details.retained_taxes.tax_amount` (number) El monto del impuesto retenido. Example: 94 - `results.tax_details.transferred_taxes` (array) Lista de impuestos transferidos. - `results.tax_details.transferred_taxes.tax` (string) El tipo de impuesto transferido (por ejemplo, ISR, IVA o IEPS). Example: "IVA" - `results.tax_details.transferred_taxes.tax_percentage` (number) El porcentaje de impuesto transferido. Example: 16 - `results.tax_details.transferred_taxes.tax_amount` (number) El monto del impuesto transferido. Example: 150.4 - `results.sender_id` (string,null, required) El ID fiscal del remitente de la factura Example: "AAA111111AA11" - `results.sender_fiscal_regime` (string,null) El régimen fiscal del remitente, según lo definido por la entidad legal en el país. Example: "601" - `results.sender_name` (string,null, required) El nombre del remitente de la factura. Example: "ACME CORP" - `results.sender_tax_fraud_status` (string,null) Indica si el remitente está o no en la lista de fraude fiscal del SAT por haber presentado datos incorrectos, tener pagos pendientes o haber realizado negocios que violan las regulaciones de la institución fiscal. El SAT actualiza la lista de fraude fiscal cada tres meses. Para más información sobre las razones por las cuales un contribuyente puede ser incluido en la lista de fraude fiscal, consulte el Artículo 69 y el Artículo 69-B del Código Fiscal de la Federación de México. Los estados posibles son: - La institución fiscal ha identificado irregularidades y ha abierto una investigación sobre el contribuyente. - La institución fiscal ha investigado al contribuyente y lo ha declarado inocente. - La institución fiscal ha confirmado que el contribuyente es culpable. - La institución fiscal ha reevaluado a un contribuyente previamente confirmado y, basándose en nueva evidencia, lo ha retirado de la lista de fraude fiscal. - El receptor o remitente no se encuentra en la lista (en otras palabras, están cumpliendo con las regulaciones de la institución fiscal). Example: "NO_TAX_FRAUD_STATUS" - `results.receiver_id` (string,null, required) El ID fiscal del receptor de la factura. Example: "BBB222222BB22" - `results.receiver_postal_code` (string) El código postal del receptor. Example: "11560" - `results.receiver_fiscal_regime` (string,null) El régimen fiscal del receptor, según lo definido por la entidad legal en el país. Example: "601" - `results.receiver_name` (string,null, required) El nombre del receptor de la factura. Example: "BELVO CORP" - `results.receiver_tax_fraud_status` (string,null) Indica si el receptor está o no en la lista de fraude fiscal del SAT por haber presentado datos incorrectos, tener pagos pendientes o haber realizado negocios que violan las regulaciones de la institución fiscal. El SAT actualiza la lista de fraude fiscal cada tres meses. Para obtener más información sobre las razones por las cuales un contribuyente puede ser incluido en la lista de fraude fiscal, consulte el Artículo 69 y el Artículo 69-B del Código Fiscal de la Federación de México. Los estados posibles son: - La institución fiscal ha identificado irregularidades y ha abierto una investigación sobre el contribuyente. - La institución fiscal ha investigado al contribuyente y lo ha declarado inocente. - La institución fiscal ha confirmado que el contribuyente es culpable. - La institución fiscal ha reevaluado a un contribuyente previamente confirmado y, basándose en nueva evidencia, lo ha retirado de la lista de fraude fiscal. - El receptor o emisor no se encuentra en la lista (en otras palabras, está cumpliendo con las regulaciones de la institución fiscal). Example: "NO_TAX_FRAUD_STATUS" - `results.cancelation_status` (string,null, required) Si la factura es cancelada, este campo indica el estado de la cancelación. - `results.cancelation_update_date` (string,null, required) La fecha de la cancelación de la factura, en formato . Example: "2019-12-02" - `results.certification_date` (string,null, required) La fecha de la certificación fiscal, en formato . Example: "2019-12-01" - `results.certification_authority` (string,null, required) El ID fiscal del proveedor de certificación. Example: "CCC333333CC33" - `results.payment_type` (string,null, required) El código de tipo de pago utilizado para esta factura, según lo definido por la entidad legal del país. - 🇲🇽 México Artículo de referencia del catálogo SAT Example: "99" - `results.payment_method` (string,null) El código del método de pago utilizado para esta factura, según lo definido por la entidad legal del país. - 🇲🇽 México artículo de referencia del catálogo SAT. Para México, devolvemos , o . Enum: "PUE", "PPD", null - `results.usage` (string,null) El código de uso de la factura, tal como lo define la entidad legal del país. - 🇲🇽 México Artículo de referencia del catálogo del SAT Example: "P01" - `results.version` (string,null) La versión CFDI de la factura. Example: "3.3" - `results.place_of_issue` (string,null) El código postal de donde se emitió la factura. Example: "01165" - `results.invoice_details` (array, required) Una lista de descripciones para cada artículo (producto comprado o servicio prestado) en la factura. - `results.invoice_details.description` (string,null, required) La descripción del artículo de la factura (una factura puede tener uno o más artículos). Example: "December 2019 accounting fees" - `results.invoice_details.product_identification` (string,null, required) El código de identificación del producto o del servicio, tal como lo define la entidad legal en el país.\n- \U0001F1F2\U0001F1FD México. Example: "84101600" - `results.invoice_details.quantity` (number,null, required) La cantidad de este artículo de factura. Example: 10 - `results.invoice_details.unit_code` (string,null, required) La unidad de medida, según lo definido por la entidad legal en el país. \n- \U0001F1F2\U0001F1FD México Referencia del catálogo SAT. Example: "E48" - `results.invoice_details.unit_description` (string,null, required) La descripción del artículo, según lo definido por la entidad legal en el país.\n- \U0001F1F2\U0001F1FD México Referencia del catálogo SAT. Example: "Unidad de servicio" - `results.invoice_details.unit_amount` (number,null, required) El precio de un artículo singular. Example: 200 - `results.invoice_details.tax_type` (string,null) El tipo de impuesto del artículo. - `results.invoice_details.pre_tax_amount` (number,null, required) El precio total de este artículo antes de aplicar impuestos es ( x ). Example: 400 - `results.invoice_details.tax_percentage` (number,null, required) El porcentaje de impuesto a aplicar. Example: 16 - `results.invoice_details.tax_amount` (number,null, required) El monto del impuesto para este artículo de factura ( x ). Example: 64 - `results.invoice_details.total_amount` (number,null, required) El precio total para este artículo de factura ( + ). Example: 464 - `results.invoice_details.retained_taxes` (array) El impuesto retenido en el artículo de la factura. - `results.invoice_details.retained_taxes.retained_tax_amount` (number,null, required) El monto del impuesto retenido. Example: 209.79 - `results.invoice_details.transferred_taxes` (array) Los impuestos transferidos relacionados con la factura. - `results.invoice_details.transferred_taxes.transferred_tax_amount` (number,null, required) El monto del impuesto transferido. Example: 209.79 - `results.currency` (string,null, required) La moneda de la factura. Por ejemplo: - 🇧🇷 BRL (Real Brasileño) - 🇨🇴 COP (Peso Colombiano) - 🇲🇽 MXN (Peso Mexicano) - 🇺🇸 USD (Dólar Estadounidense) Example: "MXN" - `results.subtotal_amount` (number,null, required) El monto antes de impuestos de esta factura (suma del de cada artículo). Example: 400 - `results.exchange_rate` (number,null, required) El tipo de cambio utilizado en esta factura para la moneda. Example: 0.052 - `results.tax_amount` (number,null, required) El monto del impuesto para esta factura (suma del de cada artículo). Example: 64 - `results.discount_amount` (number,null, required) El monto total descontado en esta factura. Example: 10 - `results.total_amount` (number,null, required) El monto total de la factura ( + - ) Example: 454 - `results.related_invoices` (array) Una lista de facturas relacionadas. - `results.related_invoices.relationship_type` (string,null) El tipo de relación entre esta factura y la factura relacionada, según lo definido por la entidad legal en el país. Para obtener más información, consulta nuestro artículo de referencia del catálogo SAT. Example: "01" - `results.related_invoices.related_invoice_identification` (string,null) El SAT ID de la factura relacionada. Example: "INV-123456" - `results.payments` (array, required) Una lista que detalla todos los pagos de facturas. - `results.payments.date` (string,null, required) Marca de tiempo ISO-8601 cuando se realizó el pago. Example: "2020-03-17T12:00:00.000Z" - `results.payments.payment_type` (string,null, required) Código de tipo de pago utilizado para esta factura, según lo definido por la entidad legal del país. - 🇲🇽 México Artículo de referencia del catálogo SAT Example: "03" - `results.payments.currency` (string,null, required) La moneda del pago. Por ejemplo: - 🇧🇷 BRL (Real Brasileño) - 🇨🇴 COP (Peso Colombiano) - 🇲🇽 MXN (Peso Mexicano) Tenga en cuenta que pueden devolverse otras monedas además de las enumeradas anteriormente. Example: "BRL" - `results.payments.exchange_rate` (string,null, required) La tasa de cambio de a MXN cuando se realizó el pago. Example: "3.75" - `results.payments.amount` (number,null, required) El monto de la factura, en la moneda de la factura original. Example: 8000.5 - `results.payments.operation_number` (string,null, required) El identificador interno de la institución fiscal para la operación. Example: "831840" - `results.payments.beneficiary_rfc` (string,null) El ID fiscal del beneficiario del pago. Example: "BNM840515VB1" - `results.payments.beneficiary_account_number` (string,null, required) El número de cuenta bancaria del beneficiario del pago. Example: "12343453245633" - `results.payments.payer_rfc` (string,null, required) El ID fiscal del emisor del pago. Example: "BKJM840515VB1" - `results.payments.payer_account_number` (string,null, required) El número de cuenta bancaria del emisor del pago. Example: "13343663245699" - `results.payments.payer_bank_name` (string,null, required) La institución bancaria que fue utilizada por el emisor del pago. Example: "CITI BANAMEX" - `results.payments.related_documents` (array, required) Una lista de todas las facturas diferidas relacionadas afectadas por el pago. - `results.payments.related_documents.invoice_identification` (string,null, required) El ID único de la institución fiscal para la factura diferida relacionada. Example: "7EE015F3-6311-11EA-B02A-00155D014007" - `results.payments.related_documents.currency` (string,null, required) La moneda de la factura relacionada. Por ejemplo: - 🇧🇷 BRL (Real Brasileño) - 🇨🇴 COP (Peso Colombiano) - 🇲🇽 MXN (Peso Mexicano) Tenga en cuenta que pueden devolverse otras monedas además de las enumeradas anteriormente. Example: "MXN" - `results.payments.related_documents.payment_method` (string,null, required) El método de pago de la factura relacionada. Example: "PPD" - `results.payments.related_documents.partiality_number` (integer) El número de cuota de pago. Example: 1 - `results.payments.related_documents.previous_balance` (number,null, required) El monto de la factura antes del pago. Example: 18877.84 - `results.payments.related_documents.amount_paid` (number,null, required) El monto pagado en esta cuota. Example: 8000 - `results.payments.related_documents.outstanding_balance` (number,null, required) El monto restante por pagar. Example: 10877.84 - `results.payroll` (object,null, required) Detalles sobre el pago de nómina. Solo aplicable para facturas de nómina. - `results.payroll.days` (integer,null, required) El número de días cubiertos por el pago. Example: 30 - `results.payroll.type` (string,null, required) El tipo de nómina, según lo definido por la entidad legal del país. - 🇲🇽 México Artículo de referencia del catálogo SAT Example: "O" - `results.payroll.amount` (number, required) El monto total del pago de nómina. Example: 20400.1 - `results.payroll.version` (string, required) La versión del objeto de nómina. Example: "1.2" - `results.payroll.date_from` (string,null, required) La fecha de inicio del período de pago, en formato . Example: "2018-07-01" - `results.payroll.date_to` (string,null, required) La fecha de finalización del período de pago, en formato . Example: "2018-07-31" - `results.payroll.payment_date` (string, required) La fecha de pago, en formato . Example: "2018-07-16" - `results.payroll.periodicity` (string,null) Con qué frecuencia se realiza el pago de nómina. Para el SAT de México, devolvemos uno de los siguientes valores: - - - - - - - - - - - Enum: "DAILY", "WEEKLY", "TENTH_DAY", "FOURTEENTH_DAY", "FIFTEENTH_DAY", "MONTHLY", "BIMONTHLY", "PER_TASK", "COMMISSION", "ONE_OFF", "OTHER_PERIODICITY", "null" - `results.payroll.earnings_breakdown` (array,null) Un desglose de las ganancias para el pago de nómina. - `results.payroll.earnings_breakdown.type` (string,null) El tipo de ingreso. Para ver una lista completa de los valores posibles, por favor consulta la tabla de tipos de desglose de ingresos de nómina. Example: "CHRISTMAS_BONUS" - `results.payroll.earnings_breakdown.taxable_amount` (number) La cantidad de ingresos que es imponible. Example: 1505 - `results.payroll.earnings_breakdown.vat_free_amount` (number) El monto del ingreso que no está sujeto a IVA. - `results.payroll.tax_deductions` (array,null) Un desglose de las deducciones fiscales en el pago de nómina. - `results.payroll.tax_deductions.type` (string,null) El tipo de deducción fiscal. Para ver una lista completa de los valores posibles, por favor consulta la tabla de tipos de deducciones fiscales de nómina. Example: "UNION_FEES" - `results.payroll.tax_deductions.amount` (number) El monto de la deducción fiscal. Example: 1505 - `results.payroll.other_payments` (array,null) Un desglose de otros pagos para la nómina. - `results.payroll.other_payments.type` (string,null) El tipo de otro pago. Para ver una lista completa de los valores posibles, consulte la tabla de tipos de otros pagos de nómina. Example: "EMPLOYMENT_SUBSIDY" - `results.payroll.other_payments.amount` (number) El monto del otro pago. Example: 1505 - `results.folio` (string,null) El número de control interno que el contribuyente asigna a la factura. Example: "26" - `results.export_type` (string,null) El tipo de exportación de la factura, según lo definido por la entidad legal en el país. Para más información, consulta nuestro artículo de referencia del catálogo SAT. Example: "01" - `results.xml` (string,null) XML del documento de factura. - `results.warnings` (object,null) Objeto que contiene información sobre cualquier advertencia relacionada con esta factura. - `results.warnings.code` (string,null, required) El código de advertencia. Puede ser uno de: - - - Example: "sat_xml_limit_reached" - `results.warnings.message` (string,null, required) La descripción de la advertencia. El mensaje dependerá del código de advertencia: Se alcanzó el límite diario de descargas XML establecido por el SAT, por lo que esta factura podría tener datos faltantes. Por favor, consulte https://tinyurl.com/yydzhy5d para más información sobre este error. No está disponible la descarga de detalles de facturas. El portal del SAT generó un error 503. Example: "The daily limit for XML downloads set by SAT was reached so this invoice\nmight be missing data. Please check https://tinyurl.com/yydzhy5d for more\ninformation on this error.\n" - `results.payment_type_description` (string,null, required) - `results.payment_method_description` (string,null) - `results.sender_blacklist_status` (string,null) Por favor, use en su lugar. - `results.receiver_blacklist_status` (string,null) Por favor, use en su lugar. ## 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"