# Recuperar facturas para un enlace

Recuperar información de la factura desde un enlace fiscal específico.

> 📘 Información
>
> Puedes solicitar hasta  año (365 días) de facturas por solicitud. Si necesitas facturas por más de un año, simplemente realiza otra solicitud.

> 🚧 Advertencia
>
> Este recurso puede devolver campos obsoletos. Por favor, consulta la documentación de la respuesta para más información.

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

## Header parameters:

  - `X-Belvo-Request-Mode` (string)
    Parámetro de encabezado recomendado para hacer que tu solicitud POST sea asincrónica (evitando así tiempos de espera y mejorando el flujo de datos).

Cuando realizas una solicitud asincrónica, Belvo responde con un payload , que incluye el . Una vez que hayamos recuperado la información solicitada, recibirás un webhook con el enlace y los IDs de solicitud.
    Enum: "async"

## Query parameters:

  - `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.

## Request fields (application/json):

  - `link` (string, required)
    El  para el que deseas recuperar información.
    Example: "c81a1dea-6dd6-4999-8b9f-541ee8197058"

  - `date_from` (string, required)
    La fecha desde la cual deseas comenzar a obtener datos, en formato .

⚠️ El valor de  no puede ser mayor que .
    Example: "2020-08-05"

  - `date_to` (string, required)
    La fecha en la que deseas dejar de recibir datos, en formato .

⚠️ El valor de  no puede ser mayor que la fecha de hoy (en otras palabras, no se permiten fechas futuras).
    Example: "2020-10-05"

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

  - `attach_xml` (boolean)
    Cuando se establece en , recibirás la factura XML en la respuesta.

  - `save_data` (boolean)
    Indica si se debe o no persistir los datos en Belvo. Por defecto, esto está configurado en  y devolvemos una respuesta 201 Created.

Cuando se establece en , los datos no se persistirán y devolvemos una respuesta 200 OK.
    Example: true

## Response 200 fields (application/json):

  - `id` (string)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `link` (string,null)
    El  al que pertenecen los datos.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `collected_at` (string, required)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `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"

  - `invoice_identification` (string,null, required)
    El ID único de la institución fiscal para la factura.
    Example: "A1A1A1A1-2B2B-3C33-D44D-555555E55EE"

  - `invoice_date` (string,null, required)
    La fecha de la factura, en formato .
    Example: "2019-12-01"

  - `status` (string,null, required)
    El estado de la factura. Puede ser  (válido) o  (cancelado).
    Example: "Vigente"

  - `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"

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

  - `tax_details` (object)
    Información general sobre los impuestos de la factura.

  - `tax_details.total_tax_retained` (number)
    Monto total de impuestos retenidos.
    Example: 194.27

  - `tax_details.total_tax_transferred` (number)
    Monto total de impuestos transferidos.
    Example: 150.4

  - `tax_details.retained_taxes` (array)
    Lista de impuestos retenidos.

  - `tax_details.retained_taxes.tax` (string)
    El tipo de impuesto retenido (por ejemplo, ISR, IVA o IEPS).
    Example: "ISR"

  - `tax_details.retained_taxes.tax_percentage` (number,null)
    El porcentaje de impuesto retenido.

  - `tax_details.retained_taxes.pre_tax_amount` (number,null)
    El monto antes de impuestos.

  - `tax_details.retained_taxes.tax_amount` (number)
    El monto del impuesto retenido.
    Example: 94

  - `tax_details.transferred_taxes` (array)
    Lista de impuestos transferidos.

  - `tax_details.transferred_taxes.tax` (string)
    El tipo de impuesto transferido (por ejemplo, ISR, IVA o IEPS).
    Example: "IVA"

  - `tax_details.transferred_taxes.tax_percentage` (number)
    El porcentaje de impuesto transferido.
    Example: 16

  - `tax_details.transferred_taxes.tax_amount` (number)
    El monto del impuesto transferido.
    Example: 150.4

  - `sender_id` (string,null, required)
    El ID fiscal del remitente de la factura
    Example: "AAA111111AA11"

  - `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"

  - `sender_name` (string,null, required)
    El nombre del remitente de la factura.
    Example: "ACME CORP"

  - `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"

  - `receiver_id` (string,null, required)
    El ID fiscal del receptor de la factura.
    Example: "BBB222222BB22"

  - `receiver_postal_code` (string)
    El código postal del receptor.
    Example: "11560"

  - `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"

  - `receiver_name` (string,null, required)
    El nombre del receptor de la factura.
    Example: "BELVO CORP"

  - `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"

  - `cancelation_status` (string,null, required)
    Si la factura es cancelada, este campo indica el estado de la cancelación.

  - `cancelation_update_date` (string,null, required)
    La fecha de la cancelación de la factura, en formato .
    Example: "2019-12-02"

  - `certification_date` (string,null, required)
    La fecha de la certificación fiscal, en formato .
    Example: "2019-12-01"

  - `certification_authority` (string,null, required)
    El ID fiscal del proveedor de certificación.
    Example: "CCC333333CC33"

  - `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"

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

  - `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"

  - `version` (string,null)
    La versión CFDI de la factura.
    Example: "3.3"

  - `place_of_issue` (string,null)
    El código postal de donde se emitió la factura.
    Example: "01165"

  - `invoice_details` (array, required)
    Una lista de descripciones para cada artículo (producto comprado o servicio prestado) en la factura.

  - `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"

  - `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"

  - `invoice_details.quantity` (number,null, required)
    La cantidad de este artículo de factura.
    Example: 10

  - `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"

  - `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"

  - `invoice_details.unit_amount` (number,null, required)
    El precio de un artículo singular.
    Example: 200

  - `invoice_details.tax_type` (string,null)
    El tipo de impuesto del artículo.

  - `invoice_details.pre_tax_amount` (number,null, required)
    El precio total de este artículo antes de aplicar impuestos es ( x ).
    Example: 400

  - `invoice_details.tax_percentage` (number,null, required)
    El porcentaje de impuesto a aplicar.
    Example: 16

  - `invoice_details.tax_amount` (number,null, required)
    El monto del impuesto para este artículo de factura ( x ).
    Example: 64

  - `invoice_details.total_amount` (number,null, required)
    El precio total para este artículo de factura ( + ).
    Example: 464

  - `invoice_details.retained_taxes` (array)
    El impuesto retenido en el artículo de la factura.

  - `invoice_details.retained_taxes.retained_tax_amount` (number,null, required)
    El monto del impuesto retenido.
    Example: 209.79

  - `invoice_details.transferred_taxes` (array)
    Los impuestos transferidos relacionados con la factura.

  - `invoice_details.transferred_taxes.transferred_tax_amount` (number,null, required)
    El monto del impuesto transferido.
    Example: 209.79

  - `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"

  - `subtotal_amount` (number,null, required)
    El monto antes de impuestos de esta factura (suma del  de cada artículo).
    Example: 400

  - `exchange_rate` (number,null, required)
    El tipo de cambio utilizado en esta factura para la moneda.
    Example: 0.052

  - `tax_amount` (number,null, required)
    El monto del impuesto para esta factura (suma del  de cada artículo).
    Example: 64

  - `discount_amount` (number,null, required)
    El monto total descontado en esta factura.
    Example: 10

  - `total_amount` (number,null, required)
    El monto total de la factura ( +  - )
    Example: 454

  - `related_invoices` (array)
    Una lista de facturas relacionadas.

  - `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"

  - `related_invoices.related_invoice_identification` (string,null)
    El SAT ID de la factura relacionada.
    Example: "INV-123456"

  - `payments` (array, required)
    Una lista que detalla todos los pagos de facturas.

  - `payments.date` (string,null, required)
    Marca de tiempo ISO-8601 cuando se realizó el pago.
    Example: "2020-03-17T12:00:00.000Z"

  - `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"

  - `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"

  - `payments.exchange_rate` (string,null, required)
    La tasa de cambio de  a MXN cuando se realizó el pago.
    Example: "3.75"

  - `payments.amount` (number,null, required)
    El monto de la factura, en la moneda de la factura original.
    Example: 8000.5

  - `payments.operation_number` (string,null, required)
    El identificador interno de la institución fiscal para la operación.
    Example: "831840"

  - `payments.beneficiary_rfc` (string,null)
    El ID fiscal del beneficiario del pago.
    Example: "BNM840515VB1"

  - `payments.beneficiary_account_number` (string,null, required)
    El número de cuenta bancaria del beneficiario del pago.
    Example: "12343453245633"

  - `payments.payer_rfc` (string,null, required)
    El ID fiscal del emisor del pago.
    Example: "BKJM840515VB1"

  - `payments.payer_account_number` (string,null, required)
    El número de cuenta bancaria del emisor del pago.
    Example: "13343663245699"

  - `payments.payer_bank_name` (string,null, required)
    La institución bancaria que fue utilizada por el emisor del pago.
    Example: "CITI BANAMEX"

  - `payments.related_documents` (array, required)
    Una lista de todas las facturas diferidas relacionadas afectadas por el pago.

  - `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"

  - `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"

  - `payments.related_documents.payment_method` (string,null, required)
    El método de pago de la factura relacionada.
    Example: "PPD"

  - `payments.related_documents.partiality_number` (integer)
    El número de cuota de pago.
    Example: 1

  - `payments.related_documents.previous_balance` (number,null, required)
    El monto de la factura antes del pago.
    Example: 18877.84

  - `payments.related_documents.amount_paid` (number,null, required)
    El monto pagado en esta cuota.
    Example: 8000

  - `payments.related_documents.outstanding_balance` (number,null, required)
    El monto restante por pagar.
    Example: 10877.84

  - `payroll` (object,null, required)
    Detalles sobre el pago de nómina. Solo aplicable para facturas de nómina.

  - `payroll.days` (integer,null, required)
    El número de días cubiertos por el pago.
    Example: 30

  - `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"

  - `payroll.amount` (number, required)
    El monto total del pago de nómina.
    Example: 20400.1

  - `payroll.version` (string, required)
    La versión del objeto de nómina.
    Example: "1.2"

  - `payroll.date_from` (string,null, required)
    La fecha de inicio del período de pago, en formato .
    Example: "2018-07-01"

  - `payroll.date_to` (string,null, required)
    La fecha de finalización del período de pago, en formato .
    Example: "2018-07-31"

  - `payroll.payment_date` (string, required)
    La fecha de pago, en formato .
    Example: "2018-07-16"

  - `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"

  - `payroll.earnings_breakdown` (array,null)
    Un desglose de las ganancias para el pago de nómina.

  - `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"

  - `payroll.earnings_breakdown.taxable_amount` (number)
    La cantidad de ingresos que es imponible.
    Example: 1505

  - `payroll.earnings_breakdown.vat_free_amount` (number)
    El monto del ingreso que no está sujeto a IVA.

  - `payroll.tax_deductions` (array,null)
    Un desglose de las deducciones fiscales en el pago de nómina.

  - `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"

  - `payroll.tax_deductions.amount` (number)
    El monto de la deducción fiscal.
    Example: 1505

  - `payroll.other_payments` (array,null)
    Un desglose de otros pagos para la nómina.

  - `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"

  - `payroll.other_payments.amount` (number)
    El monto del otro pago.
    Example: 1505

  - `folio` (string,null)
    El número de control interno que el contribuyente asigna a la factura.
    Example: "26"

  - `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"

  - `xml` (string,null)
    XML del documento de factura.

  - `warnings` (object,null)
    Objeto que contiene información sobre cualquier advertencia relacionada con esta factura.

  - `warnings.code` (string,null, required)
    El código de advertencia. Puede ser uno de:

  - 
  - 
  -
    Example: "sat_xml_limit_reached"

  - `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"

  - `payment_type_description` (string,null, required)

  - `payment_method_description` (string,null)
    

  - `sender_blacklist_status` (string,null)
    Por favor, use  en su lugar.

  - `receiver_blacklist_status` (string,null)
    Por favor, use  en su lugar.

## Response 201 fields (application/json):

  - `id` (string)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `link` (string,null)
    El  al que pertenecen los datos.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `collected_at` (string, required)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `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"

  - `invoice_identification` (string,null, required)
    El ID único de la institución fiscal para la factura.
    Example: "A1A1A1A1-2B2B-3C33-D44D-555555E55EE"

  - `invoice_date` (string,null, required)
    La fecha de la factura, en formato .
    Example: "2019-12-01"

  - `status` (string,null, required)
    El estado de la factura. Puede ser  (válido) o  (cancelado).
    Example: "Vigente"

  - `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"

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

  - `tax_details` (object)
    Información general sobre los impuestos de la factura.

  - `tax_details.total_tax_retained` (number)
    Monto total de impuestos retenidos.
    Example: 194.27

  - `tax_details.total_tax_transferred` (number)
    Monto total de impuestos transferidos.
    Example: 150.4

  - `tax_details.retained_taxes` (array)
    Lista de impuestos retenidos.

  - `tax_details.retained_taxes.tax` (string)
    El tipo de impuesto retenido (por ejemplo, ISR, IVA o IEPS).
    Example: "ISR"

  - `tax_details.retained_taxes.tax_percentage` (number,null)
    El porcentaje de impuesto retenido.

  - `tax_details.retained_taxes.pre_tax_amount` (number,null)
    El monto antes de impuestos.

  - `tax_details.retained_taxes.tax_amount` (number)
    El monto del impuesto retenido.
    Example: 94

  - `tax_details.transferred_taxes` (array)
    Lista de impuestos transferidos.

  - `tax_details.transferred_taxes.tax` (string)
    El tipo de impuesto transferido (por ejemplo, ISR, IVA o IEPS).
    Example: "IVA"

  - `tax_details.transferred_taxes.tax_percentage` (number)
    El porcentaje de impuesto transferido.
    Example: 16

  - `tax_details.transferred_taxes.tax_amount` (number)
    El monto del impuesto transferido.
    Example: 150.4

  - `sender_id` (string,null, required)
    El ID fiscal del remitente de la factura
    Example: "AAA111111AA11"

  - `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"

  - `sender_name` (string,null, required)
    El nombre del remitente de la factura.
    Example: "ACME CORP"

  - `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"

  - `receiver_id` (string,null, required)
    El ID fiscal del receptor de la factura.
    Example: "BBB222222BB22"

  - `receiver_postal_code` (string)
    El código postal del receptor.
    Example: "11560"

  - `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"

  - `receiver_name` (string,null, required)
    El nombre del receptor de la factura.
    Example: "BELVO CORP"

  - `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"

  - `cancelation_status` (string,null, required)
    Si la factura es cancelada, este campo indica el estado de la cancelación.

  - `cancelation_update_date` (string,null, required)
    La fecha de la cancelación de la factura, en formato .
    Example: "2019-12-02"

  - `certification_date` (string,null, required)
    La fecha de la certificación fiscal, en formato .
    Example: "2019-12-01"

  - `certification_authority` (string,null, required)
    El ID fiscal del proveedor de certificación.
    Example: "CCC333333CC33"

  - `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"

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

  - `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"

  - `version` (string,null)
    La versión CFDI de la factura.
    Example: "3.3"

  - `place_of_issue` (string,null)
    El código postal de donde se emitió la factura.
    Example: "01165"

  - `invoice_details` (array, required)
    Una lista de descripciones para cada artículo (producto comprado o servicio prestado) en la factura.

  - `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"

  - `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"

  - `invoice_details.quantity` (number,null, required)
    La cantidad de este artículo de factura.
    Example: 10

  - `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"

  - `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"

  - `invoice_details.unit_amount` (number,null, required)
    El precio de un artículo singular.
    Example: 200

  - `invoice_details.tax_type` (string,null)
    El tipo de impuesto del artículo.

  - `invoice_details.pre_tax_amount` (number,null, required)
    El precio total de este artículo antes de aplicar impuestos es ( x ).
    Example: 400

  - `invoice_details.tax_percentage` (number,null, required)
    El porcentaje de impuesto a aplicar.
    Example: 16

  - `invoice_details.tax_amount` (number,null, required)
    El monto del impuesto para este artículo de factura ( x ).
    Example: 64

  - `invoice_details.total_amount` (number,null, required)
    El precio total para este artículo de factura ( + ).
    Example: 464

  - `invoice_details.retained_taxes` (array)
    El impuesto retenido en el artículo de la factura.

  - `invoice_details.retained_taxes.retained_tax_amount` (number,null, required)
    El monto del impuesto retenido.
    Example: 209.79

  - `invoice_details.transferred_taxes` (array)
    Los impuestos transferidos relacionados con la factura.

  - `invoice_details.transferred_taxes.transferred_tax_amount` (number,null, required)
    El monto del impuesto transferido.
    Example: 209.79

  - `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"

  - `subtotal_amount` (number,null, required)
    El monto antes de impuestos de esta factura (suma del  de cada artículo).
    Example: 400

  - `exchange_rate` (number,null, required)
    El tipo de cambio utilizado en esta factura para la moneda.
    Example: 0.052

  - `tax_amount` (number,null, required)
    El monto del impuesto para esta factura (suma del  de cada artículo).
    Example: 64

  - `discount_amount` (number,null, required)
    El monto total descontado en esta factura.
    Example: 10

  - `total_amount` (number,null, required)
    El monto total de la factura ( +  - )
    Example: 454

  - `related_invoices` (array)
    Una lista de facturas relacionadas.

  - `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"

  - `related_invoices.related_invoice_identification` (string,null)
    El SAT ID de la factura relacionada.
    Example: "INV-123456"

  - `payments` (array, required)
    Una lista que detalla todos los pagos de facturas.

  - `payments.date` (string,null, required)
    Marca de tiempo ISO-8601 cuando se realizó el pago.
    Example: "2020-03-17T12:00:00.000Z"

  - `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"

  - `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"

  - `payments.exchange_rate` (string,null, required)
    La tasa de cambio de  a MXN cuando se realizó el pago.
    Example: "3.75"

  - `payments.amount` (number,null, required)
    El monto de la factura, en la moneda de la factura original.
    Example: 8000.5

  - `payments.operation_number` (string,null, required)
    El identificador interno de la institución fiscal para la operación.
    Example: "831840"

  - `payments.beneficiary_rfc` (string,null)
    El ID fiscal del beneficiario del pago.
    Example: "BNM840515VB1"

  - `payments.beneficiary_account_number` (string,null, required)
    El número de cuenta bancaria del beneficiario del pago.
    Example: "12343453245633"

  - `payments.payer_rfc` (string,null, required)
    El ID fiscal del emisor del pago.
    Example: "BKJM840515VB1"

  - `payments.payer_account_number` (string,null, required)
    El número de cuenta bancaria del emisor del pago.
    Example: "13343663245699"

  - `payments.payer_bank_name` (string,null, required)
    La institución bancaria que fue utilizada por el emisor del pago.
    Example: "CITI BANAMEX"

  - `payments.related_documents` (array, required)
    Una lista de todas las facturas diferidas relacionadas afectadas por el pago.

  - `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"

  - `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"

  - `payments.related_documents.payment_method` (string,null, required)
    El método de pago de la factura relacionada.
    Example: "PPD"

  - `payments.related_documents.partiality_number` (integer)
    El número de cuota de pago.
    Example: 1

  - `payments.related_documents.previous_balance` (number,null, required)
    El monto de la factura antes del pago.
    Example: 18877.84

  - `payments.related_documents.amount_paid` (number,null, required)
    El monto pagado en esta cuota.
    Example: 8000

  - `payments.related_documents.outstanding_balance` (number,null, required)
    El monto restante por pagar.
    Example: 10877.84

  - `payroll` (object,null, required)
    Detalles sobre el pago de nómina. Solo aplicable para facturas de nómina.

  - `payroll.days` (integer,null, required)
    El número de días cubiertos por el pago.
    Example: 30

  - `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"

  - `payroll.amount` (number, required)
    El monto total del pago de nómina.
    Example: 20400.1

  - `payroll.version` (string, required)
    La versión del objeto de nómina.
    Example: "1.2"

  - `payroll.date_from` (string,null, required)
    La fecha de inicio del período de pago, en formato .
    Example: "2018-07-01"

  - `payroll.date_to` (string,null, required)
    La fecha de finalización del período de pago, en formato .
    Example: "2018-07-31"

  - `payroll.payment_date` (string, required)
    La fecha de pago, en formato .
    Example: "2018-07-16"

  - `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"

  - `payroll.earnings_breakdown` (array,null)
    Un desglose de las ganancias para el pago de nómina.

  - `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"

  - `payroll.earnings_breakdown.taxable_amount` (number)
    La cantidad de ingresos que es imponible.
    Example: 1505

  - `payroll.earnings_breakdown.vat_free_amount` (number)
    El monto del ingreso que no está sujeto a IVA.

  - `payroll.tax_deductions` (array,null)
    Un desglose de las deducciones fiscales en el pago de nómina.

  - `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"

  - `payroll.tax_deductions.amount` (number)
    El monto de la deducción fiscal.
    Example: 1505

  - `payroll.other_payments` (array,null)
    Un desglose de otros pagos para la nómina.

  - `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"

  - `payroll.other_payments.amount` (number)
    El monto del otro pago.
    Example: 1505

  - `folio` (string,null)
    El número de control interno que el contribuyente asigna a la factura.
    Example: "26"

  - `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"

  - `xml` (string,null)
    XML del documento de factura.

  - `warnings` (object,null)
    Objeto que contiene información sobre cualquier advertencia relacionada con esta factura.

  - `warnings.code` (string,null, required)
    El código de advertencia. Puede ser uno de:

  - 
  - 
  -
    Example: "sat_xml_limit_reached"

  - `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"

  - `payment_type_description` (string,null, required)

  - `payment_method_description` (string,null)
    

  - `sender_blacklist_status` (string,null)
    Por favor, use  en su lugar.

  - `receiver_blacklist_status` (string,null)
    Por favor, use  en su lugar.

## Response 202 fields (application/json):

  - `request_id` (string)
    El ID único para esta solicitud. Recomendamos que almacene este valor para identificar más tarde qué evento de webhook se relaciona con una solicitud asincrónica.
    Example: "b5d0106ac9cc43d5b36199fe831f6bbe"

## 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"