Llama Gratis 01800 788 0195

Buscar

Petición al servicio

El servicio “buscar_cfdis” puede ser utilizado para buscar comprobantes que cumplan con los parametros que se indiquen y que le pertenezcan a la empresa, se retornará información principal de los comprobantes encontrados. Se necesita de un usuario y contraseña para utilizar el servicio.

Nombre Descripción Requerido
username Usuario del web service
password Contraseña del webservice
parametros Parametros de busqueda de cfdis

Parametros de entrada:

 

Parametro Descripción Formato Aceptado Requerido
rfc_emisor RFC del emisor del CFDI Regex de RFC No
rfc_receptor RFC del receptor del CFDI Regex de RFC No
fecha_emision_inicio Parámetro para buscar en un rango la fecha de emisión del comprobante. YYYY-MM-DD

Ej. 2017-12-31

Sólo si se incluye fecha_emision_fin
fecha_emision_fin Parámetro para buscar en un rango la fecha de emisión del comprobante. YYYY-MM-DD

Ej. 2017-12-31

Sólo si se incluye fecha_emision_inicio
fecha_timbrado_inicio Parámetro para buscar en un rango la fecha de timbrado del comprobante. YYYY-MM-DD

Ej. 2017-12-31

Sólo si se incluye fecha_timbrado_fin
fecha_timbrado_fin Parámetro para buscar en un rango la fecha de timbrado del comprobante. YYYY-MM-DD

Ej. 2017-12-31

Sólo si se incluye fecha_timbrado_inicio
cancelado Señalar si se buscarán comprobantes cancelados, no cancelados o todos. Si el valor es “true”, buscará cancelados, si es “false” buscará comprobantes vigentes, si no tiene valor buscará tanto cancelados como no cancelados. “true”, “false” o nulo. El valor es un string, no un booleano. No
external_id Parámetro para buscar un comprobante por id en la base de datos del usuario. Int No
uuid Parámetro para buscar por UUID. Regex de UUID No
folio Parámetro para buscar por folio. Libre No
serie Parámetro para buscar por serie. Libre No

Regex de RFC:

/[A-Z&Ñ]{3,4}[0-9]{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])[A-Z0-9]{2}[0-9A]/

Regex de UUIDs:

/^[a-f0-9A-F]{8}-[a-f0-9A-F]{4}-[a-f0-9A-F]{4}-[a-f0-9A-F]{4}-[a-f0-9A-F]{12}$/

Respuesta del servicio

Si hubo un error en la validación de los parámetros o en el servicio de búsqueda se le indicará por medio de un error, de lo contrario se regresará la estructura “buscar_cfdis_result” la cual tiene la siguiente estructura:

Nombre Descripción
Estatus Estatus de la petición, es 200 si fue exitosa.
Cantidad Cantidad de comprobantes que se encontraron con los parámetros especificados en la búsqueda.
Comprobantes Información de los comprobantes encontrados en formato XML.

La información que se regresa de los comprobantes es la siguiente:

Nombre Descripción
Folio Folio del comprobante
Serie Serie del comprobante.
external_id id de la base datos del usuario.
UUID Uuid del comprobante.
RFCEmisor RFC del emisor del comprobante.
NombreEmisor Nombre del emisor del comprobante.
RFCReceptor RFC del receptor del comprobante.
NombreReceptor Nombre del receptor del comprobante.
Total Cantidad del total del comprobante.
fechaEmision Fecha en la que se emitió el comprobante.
fechaTimbrado Fecha en la que se timbró el comprobante.
estatus Estatus del comprobante encontrado, puede ser Vigente o Cancelado.
fechaCancelacion Fecha en la que se canceló el comprobante, si el comprobante está vigente este campo no aparece.