Descarga tradicional
Para conocer la diferencia entre la descarga tradicional y el web service del SAT, te invitamos a leer este artículo donde hablamos detalle de este tema.
Funcionalidad
- Podrás descargar los comprobantes (XML) emitidos y/o recibidos del servidor del SAT.
- Descargar los archivos adicionales disponibles en el servidor del SAT.
- Generación de la representación impresa (PDF) de los comprobantes descargados.
- Exportar la información de los comprobantes consultados a diferentes formatos.
¿Cuántos XML puedes descargar?
- Podrás descargar hasta 33,000 XMLs por RFC al día.
- No existe límite alguno en la descarga de la metadata.
Autenticación
Podrás acceder al servidor del SAT de dos formas:
- Clave CIEC indicando:
- RFC del contribuyente.
- Contraseña del contribuyente.
- Firma electrónica indicando:
- Certificado: Se deberá de indicar el archivo correspondiente al certificado (.cer, .pem, .pfx) de la e.firma.
- Llave privada: Se deberá de indicar el archivo correspondiente a la llave privada (.key) de la e.firma.
- Contraseña: Este parámetro corresponde a la contraseña de la llave privada.
- RFC: Este parámetro deberá de corresponder al RFC del certificado.
- Si se indicaron ambos accesos (CIEC y e.firma) la prioridad de acceso será por medio de e.firma, si por algún motivo falla el acceso por e.firma, la librería en automático pasará a realizar el acceso por CIEC.
Filtros
Capacidad de consultar y descargar los comprobantes por diferentes aspectos:
- Emitidos y/o recibidos: podrás definir si la descarga es por el tipo de consulta.
- UUID: la descarga podrá ser por uno o más folios fiscales.
- Rango de fechas: podrás filtrar la descarga usando un rango de fechas que coincida con la fecha de emisión del o los comprobantes; incluyendo hora, minuto y segundo.
- Emisor y Receptor: realiza la descarga exacta de un comprobante usando el RFC, ya sea del emisor o del receptor.
- Complemento: condiciona la descarga de comprobantes de aquellos que contengan un tipo de complemento en específico.
- Estado del CFDI: descarga los comprobantes que estén vigentes y/o cancelados.
- Motivo de cancelación: se podrá filtrar la descarga por alguno de los motivos de cancelación.
- Total: descargar los comprobantes que estén dentro de un importe mínimo y máximo.
- PAC: filtrar la descarga por el Proveedor Autorizado de Certificación que certificó el comprobante.
Otros métodos de descarga
Además de la descarga por rango de fechas, la librería ofrece otros métodos para consultar o descargar los XML:
- Folio fiscal (UUID): podrás realizar la consulta y/o descarga de comprobantes fiscales del servidor del SAT usando solamente el o los folios fiscales (UUID).
- Cancelados en un periodo: podrás obtener los comprobantes cancelados en un periodo, sin importar cuando fueron emitidos.
- Nómina: podrás consultar y/o descargar los archivos de los recibos de nómina emitidos; esta opción es de gran utilidad cuando se emiten más de 500 comprobantes con la misma fecha, hora, minuto y segundo.
Archivos adicionales
La librería ofrece la posibilidad de descargar los archivos relacionados al CFDI y que están disponibles en el servidor del SAT:
- Acuse de solicitud de cancelación: documento que contiene los datos de solicitud de cancelación de un CFDI.
- Acuse de cancelación: documento que confirma la cancelación de un CFDI.
- PDF del SAT: PDF del CFDI en formato del SAT.
- Detalle: documento que muestra los detalles del CFDI.
- Documento relacionado: documento que muestra los UUIDs que están relacionados con un comprobante.
Este último es de gran importancia, porque permite saber por que un UUID no puede ser cancelado.
Resultado obtenido
Además de los archivos XML y PDF, también se obtiene una relación detallada de la descarga de comprobantes realizada, con datos como:
- Tipo (Emitido / Recibido)
- Versión del CFDI
- Folio fiscal (UUID)
- RFC emisor
- Razón social del emisor
- RFC receptor
- Razón social del receptor
- Serie
- Folio
- Fecha de emisión
- Fecha de certificación
- Efecto del comprobante (Ingreso / Egreso / Nómina / Pago / Traslado)
- Estado del comprobante (Cancelado / Vigente)
- Estado de la cancelación
- Estado del proceso de cancelación
- Fecha de cancelación
- Forma de pago
- Método de pago
- Moneda
- Tipo de cambio
- Sub total
- Descuento
- Total de impuestos trasladados
- Total de impuestos retenidos
- Total del comprobante
- RFC del PAC
- Nombre comercial del PAC
- Razón social del PAC
- Folio de sustitución
Representación impresa
- La librería puede generar automáticamente la representación impresa (PDF) de los XML descargados.
- Versiones soportadas:
- CFDI 3.2, 3.3 y 4.0
- CFDI 3.2 con nómina 1.1
- CFDI 3.2 con nómina 1.2
- CFDI 3.3 con nómina 1.2
- CFDI 4.0 con nómina 1.2
La generación de la representación impresa se basa en formatos (plantillas) los cuales puedes personalizar (logotipo, colores, etiquetas, datos, etc.) de acuerdo a los requerimientos de tu compañía.
Descarga de archivos
- Resultado
- Disco: podrás guardar físicamente en tu disco duro los archivos descargados.
- Memoria: podrás mantener en memoria los archivos descargados para su manipulación; en este caso no se crean archivos en el disco.
- Guardar en disco: podrás definir el nombre del directorio donde serán descargados los XML y el nombre que estos llevarán, esto mediante el uso y combinación de los siguientes parámetros:
- Tipo de consulta (emitidos / recibidos)
- Datos del emisor (RFC / razón social)
- Datos del receptor (RFC / razón social)
- Fecha de emisión (año / mes / día)
- Fecha de certificación (año / mes / día)
- PAC que certifico
- Folio fiscal (UUID)
- Efecto del comprobante (Ingreso, etc.)
- Estado del comprobante (vigente / cancelado)
Exportar la información de los comprobantes
La información de cada comprobante consultado está disponible para poder crear reportes y ser exportada a:
- CSV
- Texto
- JSON (JavaScript Object Notation)
- XML (Extensible Markup Languajes)
Requerimientos técnicos
Para el correcto funcionamiento de la librería se requiere:
- Windows 10 o superior.
- Windows server 2019 o superior.
- Conexión a internet.
Contacto
Para más información puedes contactarnos a traves del chat que se encuentra en nuestro sitio web.