En esta ocasión, queremos compartir contigo la nueva funcionalidad integrada a la librería Electronic Document Download (EDD) para llevar a cabo la descarga masiva de archivos XML del servidor del SAT, por medio de la e.firma más conocida como la Firma Electrónica (FIEL).
Contexto
Electronic Document Download es una librería (DLL) que lleva más de 9 años en el mercado, su primera versión fue liberada en 2015 y desde entonces siempre ha usado la contraseña CIEC para ingresar al servidor del SAT.
En los últimos meses, algunos clientes nos han comentado que les gustaría poder usar la firma electrónica (e.firma) como método de autenticación ante el servidor del SAT, ya que no cuentan con la CIEC.
Ingreso al servidor del SAT con e.firma
A partir de ahora, la librería permitirá usar la e.firma para ingresar al servidor del SAT, donde solo deberás indicar:
Certificado
- Debe ser el certificado de la e.firma.
- Se agregó soporte a varios tipos de certificados: CER, PEM y PFX
- Este dato es obligatorio.
Llave privada
- Deberás indicar la llave privada (Key) de la e.firma.
- Este dato es opcional si el certificado es de tipo PFX
Contraseña
- Indica la contraseña de la llave privada o del certificado en formato PFX.
RFC
- Capturar el RFC correspondiente al contribuyente a quien pertenece la firma electrónica.
Soporte a diferentes tipos de certificados
Como abras notado, la librería no solo va a soportar los típicos archivos del SAT (.CER y .KEY) sino que también quisimos permitir el uso de otros formatos como son el PEM y PFX.
Lo anterior lo hicimos porque sabemos que algunos usuarios manejan el certificado en formato PFX.
Validaciones agregadas
Como ya es costumbre en todos nuestros productos, una vez que agregamos una característica, siempre nos aseguramos de que se usen los datos correctos, por lo que hemos implementado las siguientes validaciones antes de realizar la conexión al SAT:
- No se permite el uso de otro tipo de certificado, por ejemplo, el de sello.
- Se verifica que el certificado se encuentre vigente.
- Se analiza si el certificado y su llave privada corresponda el uno con el otro.
- Se valida que el certificado haya sido emitido por el SAT.
- Se verifica que el certificado pertenezca al contribuyente que desea hacer la consulta o descarga de los XML.
Como podrás imaginar, hemos implementado nuevos códigos de error para reportar cada una de estas situaciones; estos ya fueron agregados a la documentación de la librería.
Clave CIEC
Es importante aclarar que nuestra intención fue agregar funcionalidad y no quitar la que ya existe, por lo que se continúa dando soporte a la clave CIEC.
Lo anterior trae muchas dudas, por eso quisimos dar respuesta en este artículo.
¿Es posible que te preguntes si es posible indicar las dos: CIEC y e.firma?
La respuesta es sí, puedes indicar las dos, en ese caso:
- La librería intenta ingresar al servidor del SAT usando la e.firma
- En caso de que no se pueda ingresar por algún problema en el servidor del SAT, se usa la CIEC
- En caso de que tampoco se pueda ingresar con la CIEC se genera un mensaje de error.
¿Por qué darle prioridad a la e.firma?
Le hemos dado prioridad a la e.firma para ingresar al SAT por dos motivos:
- Consideramos que este método es un poco más estable que el de la CIEC.
- En nuestras pruebas, el ingreso al SAT usando la e.firma tomo menos tiempo.
¿Es obligatorio el uso de la e.firma?
No, es algo totalmente opcional y, como lo comentamos líneas arriba, se agregó el uso de la e.firma con el fin de darle solución a algunos usuarios.
¿Qué sucede si solo indicó la CIEC?
Nada, la librería va a continuar trabajando como ya lo venía haciendo.
Proceso de descarga
En este punto, tal vez te preguntes si el proceso de consulta o descarga sufrió algún cambio y la realidad es que no; lo que hicimos fue agregar otra forma de autenticarse ante el servidor del SAT.
Actualización de la librería
Para conocer cómo usar esta nueva característica, te invitamos a descargar la nueva versión y revisar los ejemplos, ya que estos han sido actualizados para que se pueda usar la CIEC y/o e.firma.
DLL para la descarga masiva de XML
Esperamos que este artículo te haya sido de utilidad y te invitamos a estar atento a este blog y a seguirnos en nuestras redes sociales (Twitter, Facebook, YouTube) donde estaremos publicando más contenido de este estilo.
Hasta la próxima.