# Consultar CFDIs # Devuelve un array de objetos que contienen información de los cfdi alojados en la plataforma que corresponden a un emisor. Este servicio requiere autenticación por usuario o CTI, por lo que deberá presentar el par de credenciales (usuario/contraseña), un Id de sesión válido o un par id CTI/contraseña. En caso de la autenticación a través de CTI, ésta deberá estar asociada al RFC del emisor. End point: https://factudesk.api.induxsoft.net/consultas/cfdi/{emitidos|recibidos}/?filtro=valor[& ...] Parámetros de filtro: * status. Una de las siguientes palabras: 'vigente','vencido', 'cancelando', cancelado. Si se omite, se asume 'vigente'. (vencido corresponde cfdi ppd que hayan superado su fecha de vencimiento y aun tengan saldo por pagar) * rfc. El RFC del emisor si se han solicitado recibidos o del receptor si se han solicitado emitidos. * text. Una cadena por la que se realizará una comparación 'like' con el rfc y nombre del emisor o el receptor según corresponda a lo solicitado (emitidos o recibidos) * finicial. Una cadena de fecha yyyy-mm-dd que indica el inicio de un rango de fechas * ffinal. Una cadena de fecha yyyy-mm-dd que indica el fin de un rango de fechas * periodo. Una cadena en la forma yyyy-mm que indica un mes en particular, es mutuamente excluyente con finicial y ffinal * mpago. La clave del método de pago según el catálogo del SAT, si se omite se devuelve cualquier método de pago. * fpago. La clave de la forma de pago según el catálogo del SAT, si se omite se devuelve cualquier forma de pago. * tipo. Una letra (I, E, P, N, T) que corresponde al tipo de CFDI, si se omite se devuele cualquier tipo. * color. Una cadena que indica el color asociado al CFDI (blanco, azul, rojo, amarillo, verde), si se omite se devuelven de cualquier color. * limit. Un entero que indica la cantidad máxima de elementos a devolver, si se omite, se asumen 500, si se establece en -1 se devuelven todos los que cumplan con el criterio de filtro, si no hay más parámetros de filtro se ignora cuando es -1. * moneda. La clave de una divisa, si se omite se devuelven elementos de cualquier moneda * saldos. Un valor true/false (booleano) que indica si la respuesta incluirá los saldos por pagar en el caso de los ppds, valor predeterminado es false Si se omiten parámetros de filtro, se devuelven los últimos 200 elementos vigentes. Solicitud POST con usuario y contraseña ``` Method: POST Content-Type: application/json;charset=utf-8 { "uid":"Id de usuario (correo o teléfono móvil)", "pwd":"Contraseña del usuario", "rfc":"RFC del propietario del certificado" } ``` Solicitud POST con Id de sesión ``` Method: POST Content-Type: application/json;charset=utf-8 { "ids":"Id de sesión válido", "rfc":"RFC del propietario del certificado" } ``` Solicitud POST con Id CTI y contraseña ``` Method: POST Content-Type: application/json;charset=utf-8 { "cti":"Id de usuario (correo o teléfono móvil)", "pwd":"Contraseña del usuario", } ``` ### Respuesta exitosa ### Para las opciones de resultado xmljsn y xmlb64: ``` Content-Type: application/json;charset=utf-8 { "success":true, "data": [ { "uuid":"", "iddoc":"", "version":"3.3/4.0", "emision":"", "cerficacion":"yyyy-mm-ddThh:mm:ss", "cancelacion":"fecha y hora del acuse de cancelación, si no está cancelado no debe existir este campo", "cancelado":false, "status":"vigente, vencido, cancelando, cancelado", "forma_pago":"", "metodo_pago":"", "moneda":"MXN", "rfc_emisor":"", "rfc_receptor":"", "emisor":"", "receptor":"", "subtotal":0, "descuento":0, "traslados":0, "retenciones":0, "total":0, "color":"blanco", "vencimiento":"Fecha de vencimiento si es PPD y está establecida, en caso contrario el campo no debe existir", "saldo":0 (saldo por pagar si es ppd y el dato está disponible) }, {...},... ] } ```