DOCUMENTACION API COMERCIAL

Guías para facturar desde tu sistema o aplicación

DESCARGA TU COMPROBANTE

Enlace Fiscal almacena de manera ilimitada y permanente tus Comprobantes Fiscales Digitales (CFDI) para consulta y auditoría. Al consumir la API Comercial, tu empresa y los receptores de los CFDI que emites tienen acceso gratuito a un Portal de Descarga de los CFDI en formatos XML y PDF.

Contenido de esta página

En esta página encontrarás el siguiente contenido:

Requisitos

Este tutorial asume que ya tienes los siguientes elementos:

  • Una cuenta configurada con la modalidad de API activada. Si aún no tienes tu cuenta configurada, consulta la Guía de Inicio Rápido.
  • Tus credenciales para consumir la API. Para más información sobre cómo obtener y utilizar tus credenciales en el encabezado de tu petición, consulta la sección de Autenticación.

Descargar tus CFDI

Cuando emites un CFDI via la API Comercial, no necesitas realizar una petición adicional para descargarlo.

Las ligas para descargar tus CFDI en formatos PDF y XML se encuentran directamente en la respuesta de una petición de timbrado al endpoint POST https://api.enlacefiscal.com/v6/generarCfdi. Tu sistema puede descargar los CFDI generados tanto en el entorno de prueba como en el entorno de producción.

El siguiente diagrama representa el proceso de timbrado de nuestra API Comercial que incluye las ligas para descargar el CFDI en la respuesta a la petición.




Si quieres enviar las ligas de descarga del CFDI al receptor por correo electrónico desde la API Comercial, consulta el tutorial para enviar tu comprobante.

Petición

Para obtener más información sobre los parámetros de la petición de timbrado, consulta el tutorial para timbrar tu comprobante. No necesitas agregar ningún parámetro a la petición de timbrado.

Respuesta

El siguiente es un extracto de código dentro de la respuesta a la petición de timbrado. Los puntos suspensivos (...) representan objetos en formato JSON con datos generales y adicionales de la respuesta, como la fecha de generación y los sellos digitales del comprobante.


{
"AckEnlaceFiscal": {
    ...
    "descargaArchivoQR": "https://descarga.enlacefiscal.com/QR/?i=QUFBMDEwMTAxQUFBLS0yMDE3XzE4XzRldsTNmLTc0YjktNDAwNC1iN2I2LTA5YjMwNzgxYjRmNi0tMS0tMTg=&b=0",
    "descargaArchivoPDF": "https://descarga.enlacefiscal.com/PDF/?i=YjMwNzgxYjRmNi0tMS0tMTg=&b=0",
    "descargaXmlCFDi": "https://descarga.enlacefiscal.com/CFDI/?i=QUFBMDEwMTAxQUFBLS0yMDE3XzE4XzRlODAwNTNmLTc0dssjktNDAwNC1iN2I2LTA5YjMwNzgxYjRmNi0tMS0tMTg=&b=0"
    }
}

Dentro de la respuesta de la petición de timbrado encontrarás las siguientes URL para descargar los archivos XML, PDF y QR de tus comprobantes:

  • descargaArchivoQR: URL para descargar el archivo QR de tu comprobante.
    El archivo QR te proporciona todos las datos requeridos por el SAT en caso de que desees hacer tu propio diseño de comprobantes en formato PDF.
  • descargaArchivoPDF: URL para descargar tu comprobante en formato PDF.
    El PDF de un comprobante generado en el entorno de prueba contiene una marca de agua especificando que no tiene validez fiscal.
    El diseño del PDF puede ser personalizado en el portal de Enlace Fiscal con el logotipo y los colores de tu marca. Para personalizar tu PDF, consulta el artículo sobre la Edición de Diseño de PDF.
  • descargaXmlCFDi: URL para descargar tu comprobante en formato XML.

Configurar el portal de descarga

El Portal de Descarga permite a tus clientes consultar sus CFDI y descargarlos en formatos PDF y XML. Puedes personalizar las siguientes opciones de descarga:

  • La vigencia de las ligas enviadas al receptor del CFDI por correo electrónico
  • La configuración del portal de descarga:
    • La visibilidad del historial de CFDI
    • El estatus de pago de cada CFDI
    • La incorporación de un mensaje personalizado e información de contacto para aclaraciones

Para configurar las opciones de descarga de los CFDI, sigue los siguientes pasos:

  1. Inicia sesión en el portal de Enlace Fiscal con los siguientes datos:
    • RFC
    • Usuario de la cuenta
    • Contraseña
  2. En la barra de navegación superior del portal, selecciona CFDis Comerciales / Configuración.
    Se abre la pantalla de Configuración.
  3. En el menú de la pantalla de Configuración, selecciona Portal de Descargas.
    Se abre la configuración de la descarga de CFDI.
  4. Elige la vigencia de las ligas enviadas al receptor del CFDI. Puedes seleccionar una de las siguientes opciones:
    • 1 Semana
    • 1 Mes
    • 3 Meses
    • 1 Año
    • Permanente
  5. En la configuración del portal de descarga, puedes abilitar las siguientes opciones:
    • El receptor puede descargar todo su historial de CFDI.
    • El receptor puede ver el estatus de pago en el listado de CFDI.
    • Si deseas indicarle al receptor alguna información de contacto para aclaraciones, puedes personalizar un mensaje.
Puedes además incorporar el logo de tu marca en el portal de descarga. Para personalizar la imagen del portal de descarga, contacta a nuestro equipo.

Acceder al portal de descarga

El receptor de tus CFDI puede acceder al portal de descarga de dos maneras:

  • Desde el correo electrónico que recibe cuando timbras y envías un CFDI. Las ligas incluidas en el correo electrónico inician sesión de manera automática en el portal de descarga.
  • Desde su navegador ingresando la URL del portal de descarga. El receptor del CFDI debe ingresar su RFC y una contraseña asignada para acceder al portal.

Para asignar un usuario y una contraseña al receptor, sigue los siguientes pasos:

  1. Inicia sesión en el portal de Enlace Fiscal con los siguientes datos:
    • RFC
    • Usuario de la cuenta
    • Contraseña
  2. En la barra de navegación superior del portal, selecciona CFDis Comerciales / Configuración.
    Se abre la pantalla de Configuración.
  3. En el menú de la pantalla de Configuración, selecciona Accesos a Descargas.
    Se abre la configuración de Accesos a Descargas.
  4. En la parte derecha, haz clic en el botón de Crear Acceso para Clientes.
    Se abre una nueva ventana.
  5. En la ventana Crear Acceso para Clientes, ingresa el RFC del receptor y asigna su Contraseña.
    Puedes enviar la contraseña al receptor seleccionando la opción Enviar el acceso a su cliente via correo electrónico.
  6. Haz clic sobre Guardar.
    La ventana de Crear Acceso para Clientes se cierra. Si seleccionaste la opción de envío en el paso anterior, el receptor recibirá su contraseña por correo electrónico. En Accesos a Descarga, el RFC y la contraseña del receptor se agrega a la lista de accesos junto con la fecha de asignación y el nombre del usuario que ha asignado esos datos.

¿Tienes preguntas?

Consulta nuestros artículos con preguntas frecuentes sobre facturación electrónica o contáctanos por correo.