Método: buscar
El método buscar del Web Service CFDI Recibe parámetros de búsqueda y regresa un compuesto RespuestaBusqueda que se describe en la siguiente tabla.
-
La obligatoriedad de los campos está representada de la siguiente manera en la columna “Requerido”:
- Sí: El valor de este campo debe enviarse siempre
- No: El valor de este campo puede enviarse o no.
- Condicional: El valor de este campo puede ser obligatorio o no, dependiendo de otros.
- Parametros:
-
Nombre Descripción Requerido usuario xs:string
Nombre de usuario registrado para el uso del WebService.
Sí password xs:string
Contraseña del usuario.
Sí parametrosBusqueda Compuesto con los parámetros de búsqueda. Se detalla en la tabla “Atributos de ParametrosBusqueda”.
Sí Nombre Descripción Requerido fechaInicio xs:dateTime
Determina la fecha límite inferior respecto a la creación de los CFDI con la que se hará la búsqueda.
No fechaFin xs:dateTime
Determina la fecha límite superior respecto a la creación de los CFDI con la que se hará la búsqueda.
No folio xs:long
Folio comercial del CFDI.
No serie xs:string
Serie comercial dle CFDI.
No uuid xs:string
Folio fiscal del CFDI.
No fechaPago xs:date
Fecha en la que se hizo el pago del CFDI.
No nombreCliente xs:string
Razón social del receptor del CFDI.
No rfcCliente xs:string
R. F. C. del receptor del CFDI.
No moneda xs:string
Nombre de la moneda utilizada en el CFDI.
No limit xs:int
Máximo de resultados que se regresarán.
No offset xs:int
Indica a partir de que registro se hará la búsqueda de comprobates.
No orderBy xs:string
Indica el atributo por el cual se deberán ordenar los CFDI.
No
Ejemplo de petición:
Descargar este ejemplo
Regresa:
- Este método retorna un tipo compuesto: RespuestaBusqueda los atributos se describen en la siguiente tabla.
-
Atributos de RespuestaBusquedaNombre Descripción Requerido status xs:int
El código estatus de la operación, el detalle de códigos de respuesta se detalla en el anexo
Sí mensaje xs:string
El mensaje de respuesta, detalla el estatus de la operación.
Sí leyenda xs:string
Mensaje que encabeza los resultados de la búsqueda.
Sí sumaImporte xs:decimal
Cantidad total de importe del CFDI.
Sí sumaSaldo xs:decimal
Saldo total del CFDI.
Sí max xs:int
Indica el máximo de CFDI que regreso la búsqueda.
Sí comprobantes Arreglo de ResumenCFDI
Arreglo del tipo complejo ResumenCFDI. Sus atributos se describen en la tabla “Atributos de ResumenCFDI”.
Sí Nombre Descripción Requerido folio xs:long
Folio comercial del CFDI.
No nombreSerie xs:string
Nombre de la serie comercial del CFDI.
Sí tipoFactura xs:int
Indica el tipo del CFDI.
Sí efectoComprobate xs:int
Indica el efecto fiscal que tiene el CFDI.
Sí nombreCliente xs:string
Razón social del receptor del CFDI.
Sí fechaEmision xs:dateTime
Fecha en la que se emitió el CFDI.
Sí fechaPago xs:dateTime
Fecha en la que se pagó el CFDI.
Sí autorizada xs:boolean
Indica si el CFDI esta autorizado.
Sí cancelada xs:boolean
Indica si el CFDI esta cancelado.
Sí monedaSimbolo xs:string
Símbolo de la moneda utilizada en el CFDI.
Sí monedaNombre xs:string
Nombre de la moneda utilizada en el CFDI.
Sí monedaTipoCambio xs:decimal
Tipo de cambio de la moneda utilizada en el CFDI.
Sí importeTotal xs:decimal
Cantidad total de importe del CFDI.
Sí subtotal xs:decimal
Cantidad subtotal de importe del CFDI
Sí uuid xs:string
Folio fiscal del CFDI.
Sí saldo xs:decimal
Saldo del CFDI.
Sí tieneAddenda xs:boolean
Indica si el CFDI tiene addenda.
Sí
Ejemplo de respuesta:
Descargar este ejemplo
-
Códigos de respuesta generales de encabezado
Los códigos de respuesta generales de encabezado pueden contener descripciones más específicas en el mensaje
- 200 — El proceso de creación se ha completado correctamente.
- 500 — Han ocurrido errores que no han permitido completar el proceso. Reintentar
- 501 — Error de conexión a la base de datos. Reintentar
- 502 — Han ocurrido errores al intentar recuperar datos o almacenarlos en la base de datos
- 503 — Se ha alcanzado el límite de licencias de acceso concurrente a base de datos
- 601 — Error de autenticación, verifique usuario y contraseña
- 602 — La cuenta de usuario se encuentra bloqueada
- 603 — La contraseña de la cuenta ha expirado
- 604 — Ha excedido el número máximo permitido de intentos de autenticación fallidos, la cuenta se bloqueará.
- 610 — La acción solicitada no está sooportada en la implementación porque no se ha configurado para tal fin o no es posible realizarla. En el método importar significa que la implementación no tiene un Conector de importación de comprobantes configurado
- 611 — No se han especificado todos los parámetros necesarios para realizar la operación. En el caso del método importar significa que el Conector de importación asignado a esta implementación no puede ser utilizado a través de este en este WebService debido a limitaciones propias del conector.
- 612 — Archivo malformado. El formato de archivo o secuencia binaria no corresponde a la esperada.
- 613 — La secuencia numérica ha llegado al final.
- 620 — No tiene permiso para realizar la acción.
- 621 — Argumento no válido
- 622 — Operación no soportada para la implementación
- 623 — Datos no encontrados
- 624 — Violación de restricción de unicidad
- 625 — La acción no se puede completar porque requiere que se ejecute una acción previa
- 626 — Error de configuración de la implementación
- 630 — El contrato de la implementación ha expirado
- 631 — La fecha de pago del contrato de la implementación ha expirado
- 632 — Se ha superado el límite de uso justo para la implementación
- 633 — La implementación se encuentra inactiva