¿Por qué devuelve Belvo facturas incompletas?
Nuestra capacidad para extraer datos de SAT a veces puede verse afectada por la confiabilidad y las limitaciones de su plataforma. Además, el SAT tiene algunos límites en cuanto a la cantidad de XML que puede descargar en un día determinado. Este límite se refresca a las 00:00 (CST). Es poco probable que se vea afectado por estos límites a menos de que esté accediendo a un gran volumen de facturas (más de 2.000 facturas).
Sin embargo, si lo hace, las facturas recuperadas después de haber alcanzado el límite establecido por el SAT pueden contener información parcial (algunos de los campos mostrarán null
). Esto se debe a que necesitamos el XML de una factura para completar algunos atributos específicos de la factura.
¿Qué datos de la factura siempre podré recuperar a través de Belvo?
En casos donde no podamos descargar el XML de una factura, siempre devolveremos los metadatos de la factura (independientemente del límite). Esto incluye:
type
invoice_type
invoice_identification
invoice_date
sender_id
sender_name
receiver_id
receiver_name
certification_date
certification_authority
currency
total_amount
status
cancelation_status
cancelation_update_date
Debido a que siempre devolvemos estos datos, tendrás constancia de dichas factura, que podrás corregir en futuras peticiones.
¿Cómo sé si una factura se ha visto afectada por el límite de descarga establecido por el SAT ?
Las facturas que se vean afectadas por el límite de descarga impuesto por el SAT se pueden identificar mediante un atributo warnings
que mostrara una alerta:
{
...
"warnings": {
"code": "sat_xml_limit_reached",
"message": "The daily limit for XML downloads set by SAT was reached so this invoice might be missing data. Please check <https://tinyurl.com/yydzhy5d> for more information on this error."
},
...
}
En la gran mayoría de casos, cuando no se hayan detectado errores, el atributo warnings
mostrará null
.
{
...
"warnings": null
...
}
¿Qué sucede si tengo una factura almacenada en Belvo y, en una nueva petición, se obtiene esta misma factura pero con errores?
Si la factura almacenada en Belvo contenía errores, la sobreescribiremos con la versión correcta tan pronto se haga una nueva petición en la que esta se incluya.
Si la factura almacenada en Belvo no contenía errores y recibimos una nueva versión de la misma factura que contenga errores, no guardaremos esta nueva versión. En su lugar, devolveremos la versión correcta que teníamos almacenada.
¿Cómo reparo una factura almacenada en Belvo que contenga errores?
Si usas recurrent links, intentaremos recuperar esta factura nuevamente al refrescar el link (por defecto cada 7 días).
Si usas single links, te sugerimos volver a hacer una nueva petición pasadas 24 horas para recuperar facturas incompletas.