Descarga masiva de CFDI – XML con e.firma (FIEL)

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:

  1. La librería intenta ingresar al servidor del SAT usando la e.firma
  2. En caso de que no se pueda ingresar por algún problema en el servidor del SAT, se usa la CIEC
  3. 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.

Facturando: Complemento Comercio Exterior 2.0

Como ya sabrás, la autoridad (SAT) ha sacado una nueva versión del complemento comercio exterior, pasando de la versión 1.1 a la versión 2.0

El SAT no ha realizado grandes cambios en esta nueva versión, realmente han sido cambios menores y ha eliminado algunos campos, si quieres conocer todos los cambios realizados, te invitamos a leer este artículo, donde detallamos cada uno de cambios que se hicieron.

Facturando

Como suele suceder en estos casos, una vez que el SAT libera cualquier cambio relacionado con la factura electrónica (generación, timbrado, validación, etc.); nosotros procedemos a analizar el mismo, ver sus implicaciones y actualizamos cada uno de los productos que se ve afectado por dicho cambio.

A continuación, enumeramos los productos que se ven afectados y mostramos el orden en que cada uno de ellos será liberado:

Generación y timbrado

Representación impresa (PDF)

Programas

Validación de XML

Otros

Fechas de liberación

Como ya sabrás, este complemento entra en vigor el día 18 de enero, por lo que nuestro objetivo es liberar cada uno de estos productos antes de esta fecha.

Las liberaciones serán realizadas de forma escalonada, esto es, una vez tengamos un producto listo, lo estaremos liberando, esto con el objetivo que los clientes tengan acceso a cada producto lo antes posible.

El primer producto en ser liberado será Electronic Document Library (EDL) y lo estaremos liberando a más tardar el día viernes 12 de enero.

Proceso de timbrado

Hemos estado en constante comunicación con nuestros PACs asociados y ellos son conscientes de las fechas dadas por el SAT, por lo que se encuentran trabajando a marchas forzadas para dar soporte a esta nueva versión del complemento Comercio Exterior.

Se tiene planeado dar soporte a este complemento, en el ambiente de pruebas esta misma semana y la próxima semana en el ambiente de producción.

Comentarios finales

Somos conscientes de que es muy corto el tiempo y que esto puede afectar de alguna manera a nuestros clientes y usuarios, pero lastimosamente el SAT no ha dado mucho tiempo para analizar e implementar este cambio; el tiempo dado por la autoridad para todo esto fue menos de un mes, además de que la información técnica fue liberada en una fecha donde todos estábamos por salir de vacaciones.

Esperamos que el SAT reconsidere la fecha límite y ofrezca una prórroga.

Esperamos que este artículo te haya sido de utilidad y haya resuelto todas tus dudas, 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.

PDF para la Constancias de retenciones y pagos 2.0

Como recordarás, este año 2022 el SAT liberó una nueva versión de la constancia de retenciones y pagos, esta nueva versión es la 2.0; y nos hemos dado a la tarea de modificar cada una de nuestras soluciones para dar soporte a este cambio.

Generación del PDF
En este caso hemos modificado el funcionamiento de la librería Electronic Document Printer con la finalidad de que pueda leer y procesar la constancia 2.0.

Formato – Plantilla
Además de lo comentado anteriormente, hemos desarrollado un nuevo formato o plantilla (Constancia20.repx) la cual debe ser cargada a la librería para que se pueda generar el PDF.

Esta plantilla muestra todos los datos de la constancia 2.0 y además da soporte a los siguientes complementos:

  • Arrendamiento
  • Dividendos
  • Intereses
  • Pago a extranjeros
  • Plataformas tecnológicas

Ejemplo
Adicionalmente, hemos actualizado el ejemplo que trae la librería para mostrar como trabajar con este nuevo formato y como generar el PDF de la constancia 2.0

Como siempre, invitmaos a todos los usuarios a descargar y actualizarse a esta nueva versión y con esto sacar provecho de las mejoras realizadas

DESCARGAR DLL

Hasta la próxima

DLL para la Constancias de retenciones y pagos 2.0

Hoy, hemos liberado una nueva versión (2022.05.09) de nuestra librería para la generación y el timbrado del CFDI y la constancia de retención: Electronic Document Library

En esta versión hemos agregado solamente una nueva característica que a continuación pasaremos a describir:

Constancias de retenciones 2.0
En este caso, hemos agregado soporte al nuevo estándar de la constancia de retenciones que el SAT liberado este año; con esta nueva versión podrás:

  • Generar la constancia
  • Timbrar la constancia
  • Leer y extraer los datos de la constancia

Ejemplos
También hemos actualizados 3 ejemplos para dar a conocer el funcionamiento de la nueva constancia, los ejemplos son:

  • PAC ECODEX, donde se muestra como generar y timbrar la constancia 2.0
  • Constancia de retenciones, donde podrás conocer como generar una constancia con cada uno de sus complementos.
  • Validación, este ejemplo muestra como validar y extraer la información de la constancia.

Como siempre, hemos actualizado los ejemplos tanto de C# como de VB.Net

Como podrás ver los cambios realizados no fueron muchos, pero si son muy importantes, porque dan soporte a los cambios realizados por el Servicio de Administración Tributaria (SAT).

Para finalizar, queremos invitarte a descargar y actualizarte a esta nueva versión.

DESCARGAR DLL

Hasta la próxima.

DLL para validar un recibo de pago 2.0

Hoy, hemos liberado una nueva versión de nuestra librería para la validación de comprobantes fiscales digitales: Electronic Document Validator

En esta ocasión hemos agregado soporte a los cambios realizados por el SAT, a continuación, describiremos de forma detallada los 2 cambios más importantes.

Recibo de pago 2.0
En este caso, hemos modificado la DLL para dar soporte a la nueva versión de este documento, por lo que, a partir de esta versión podrás validar todos los recibos de pagos emitidos o recibidos.

Las validaciones que hemos incluido en esta versión son:

Estructura
Se verifica cada uno de los atributos y nodos contenidos en la versión 2.0.

Sello
Permite conocer si el recibo fue modificado después de que éste fue generado.

Timbre
Se verifica que el XML haya sido timbrado y cumpla con lo requerido por la autoridad.

Certificado
Permite conocer si el comprobante con el que fue firmado el XML fue generado por el SAT.

Schema
En esta parte se valida el XML con los schemas proporcionados por el SAT.

SAT
Verifica que el comprobante se encuentre registrado en el SAT y si se encuentra vigente o cancelado; además se verifica si el emisor de este no está en las listas negras del SAT (Art. 69 y 69B).

Carta Porte 2.0
Aunque la carta porte 2.0 lleva algún tiempo con nosotros, es hasta esta versión de la librería en donde hemos agregado soporte a este complemento.

Las validaciones que se han agregado son las misma que las del complemento recibo de pago 2.0

Es importante mencionar que, en esta versión, no hemos implementado las validaciones mencionadas en la matriz de errores ni para el recibo de pago 2.0 ni para la carta porte 2.0; se esta considerando agregarlas en una futura versión.

Puedes descargar esta nueva versión de aquí

DESCARGAR DLL

DLL para cancelar un CFDI – XML con motivo

Hoy traemos una nueva versión de nuestra solución para generar y cancelar facturas electrónicas: Electronic Document Library.

En esta ocasión hemos agregado dos características importantes que describiremos a continuación:

Cancelación con motivo
Como recordarás, a partir del 1 de enero del 2022, el SAT liberó una nueva forma de cancelar los CFDIS, en éste, es necesario indicar el motivo de la cancelación:

  • 01 – Comprobante emitido con errores con relación
  • 02 – Comprobante emitido con errores sin relación
  • 03 – No se llevó a cabo la operación
  • 04 – Operación nominativa relacionada en la factura global

En esta nueva versión podrías indicar:

  • El motivo de la cancelación
  • Folio de sustitución, esto en el caso de que el motivo sea 01

Adicional a esto, la DLL:

  • Valida los datos indicados
  • Valida que el certificado este vigente y pertenezca al emisor del UUID

Es importante comentar que:

  • Para llevar a cabo este nuevo proceso de cancelación, es necesario indicar el certificado de sello del emisor.
  • El Id de la transacción cambio de un entero a GUID
  • La respuesta del PAC y los códigos de error han cambiado.

Para finalizar nos gustaría comentar que hemos modificado el demo PAC ECODEX, para mostrar como se lleva a cabo este nuevo proceso de cancelación.

Acuse de cancelación
De acuerdo con el nuevo método de cancelación, hemos implementado un nuevo método para obtener el acuse de cancelación, para esto hemos agregado nuevas clases y hemos modificado el ejemplo ECODEX para mostrar su funcionamiento.

Es importante comentar que este nuevo método muestra más información y maneja otro tipo de errores, por lo que te recomendamos revisar a detalle el demo.

Nuevas URLs de conexión
Debido a los dos cambios comentados anteriormente, la librería se conecta a nuevas URLs, por lo que recomendamos agregarlas como excepciones a tu firewall:

  • https://wsdevapicancelaciones.ecodex.com.mx/
  • https://wsdexapicancelaciones.ecodex.com.mx/

Como siempre, te invitamos a leer el historial de cambios, que es donde se registran todos los cambios realizados en cada liberación.

Finalmente queremos invitar a todos los usuarios a actualizarse a esta nueva versión y hacer uso de los métodos aquí agregados:

DESCARGAR

DLL para validar el XML de un CFDI 4.0

En esta ocasión, traemos una nueva versión de la librería que permite validar un comprobante fiscal digital: Electronic Document Validator.

En esta ocasión hemos realizado un solo cambio que a continuación describiremos:

CFDI 4.0
El cambio realizado en esta ocasión es dar soporte a los XML del CFDI 4.0; por lo que, a partir de esta versión podrás validar todos los XML emitidos o recibidos con la nueva versión del CFDI.

Para esta versión, las validaciones que hemos incluido son:

Estructura
Donde se verifica cada uno de los atributos y nodos contenidos en esta nueva versión.

Sello
Sirve para conocer si el comprobante fue modificado después de que fue generado.

Timbre
Se verifica que el comprobante haya sido timbrado y cumpla con lo requerido por la autoridad.

Certificado
Permite conocer si el comprobante con el que fue firmado el XML fue generado por el SAT.

Totales
Se verifica que los importes contenidos en el comprobante sean correctos.

Schema
En esta parte se valida el XML con los schemas proporcionados por el SAT.

SAT
Verifica que el comprobante se encuentre registrado en el SAT y si se encuentra vigente o cancelado; además se verifica si el emisor de este no esta en las listas negras del SAT (Art. 69 y 69B).

Como podrás observar, ha sido un solo cambio, pero un cambio muy importante y hemos implementado las características mas importantes del proceso de validación

Es importante mencionar que, en esta versión, no hemos implementado las validaciones mencionadas en la matriz de errores para el CFDI 4.0; éstas será implementadas en una próxima versión.

Puedes descargar la nueva versión de aquí

DESCARGAR

Librería para la generación y timbrado del CFDI 4.0

Hoy, hemos liberado la nueva versión de nuestra DLL (Electronic Document Library) para la generación y el timbrado del CFDI 4.0 y el recibo de pago 2.0.

A continuación, encontrarás los cambios más importantes que hemos hecho en esta nueva versión.

Timbrado del CFDI 4.0 y Recibo de pago 2.0
Como ya es de tu conocimiento, nuestra DLL ya ofrecía soporte a la generación del XML cumpliendo con el estándar requerido por el SAT para el CFDI en 2022; lo que no hacía era timbrarlo y eso es lo que hemos realizado en esta nueva versión.

Hemos modificado la integración con el PAC, esto con la finalidad de que los usuarios puedan llevar a cabo el timbrado a través de la librería.

Este cambio no conlleva cambios al proceso de timbrado actual, ya que hemos logrado que sea transparente.

Posiblemente tendrás muchas dudas con respecto a este cambio y trataremos de responderlas a continuación:

¿Esta versión soporta el CFDI 3.3?
Si, con esta nueva versión vas a poder continuar generando todo tipo de documentos como lo venias haciendo, además del CFDI 4.0

¿Esta versión soporta el Recibo de pago 1.0?
Así es.

¿Que cambios debo hacer para poder timbrar el CFDI 4.0 y el recibo de pago 2.0?
No debes hacer ningún cambio, todos los procesos que dependen del PAC continúan igual.

¿Existe algún cambio en las URLs de conexión?
Si, para esto, hemos actualizado el archivo PUERTOS.PDF, en el cual se especifican las nuevas URLs de conexión; esta información te será muy útil si manejas algún tipo de permiso o firewall para conectarte a internet.

¿Qué archivos (DLLs) cambiaron y debo actualizar?
En este caso debe seguir la regla que siempre recomendamos, debes actualizar todos los archivos que uses. Por cierto, no hemos agregado nuevas DLLs.

¿Qué ejemplos debo revisar para aprender a generar y timbrar los nuevos documentos?
Para el caso del CFDI 4.0 existen dos ejemplos:

  • CFDI 4.0: Este ejemplo tiene como objetivo enseñarte como usar todos los campos.
  • PAC ECODEX: Con este, aprenderás como timbrar un CFDI 4.0

Para el caso del recibo de pago 2.0; igualmente existen 2 ejemplos:

  • Recibo de pago 2.0: Este ejemplo tiene como objetivo enseñarte como usar todos los campos.
  • PAC ECODEX: Con este, aprenderás como timbrar un Recibo de pago 2.0

Para el caso del recibo de nómina 1.2 que hace uso del CFDI 4.0

  • Recibo de nomina 1.2: Hemos actualizado este ejemplo para mostrar como generar y timbrar un recibo de nómina usando el CFDI 4.0

¿Existe cambios en la generación del código de barras?
No, la DLL continúa funcionando como ya lo hacía antes.

¿Con esta librería puedo generar el PDF del CFDI 4.0?
Si deseas generar el PDF, te recomendamos usar este otro producto: Electronic Document Printer.

¿Existe cambios en los ejemplos que trae la librería?
Si, hemos actualizado todos los ejemplos incluidos, para que trabajen con el CFDI 4.0; por lo que te recomendamos revisarlos a detalle y ver cómo funciona cada uno.

¿Puedo leer y validar un CFDI 4.0?
Así es, hemos modificado la librería para que puedas leer y validar un:

  • CFDI 4.0
  • Recibo de pago 2.0
  • Recibo de nómina 1.2 con CFDI 4.0

¿Qué validaciones hace la librería al momento de leer el CFDI 4.0?
Te invitamos a revisar el demo llamado VALIDACION, en éste se explica todo acerca de este tema, que se valida, como se desactivan algunas opciones, etc.

¿Existen ejemplos para Visual Basic?
Así es, todos los ejemplos se encuentran disponibles para C# y Visual Basic .Net

Esperamos que con esto todas tus dudas hayan sido resueltas y en caso de que no, envíanos un correo a soporte y con gusto te estaremos respondiendo.

Finalmente queremos invitarte a descargar y actualizarte a esta versión dando clic aquí

DESCARGAR

CFDI 4.0: DLL para generar el PDF del XML

Hoy, hemos liberado una nueva versión de nuestra librería para la generación de la representación impresa del CFDI (PDF): Electronic Document Printer.

A continuación, describiremos, solamente, los cambios más importantes realizados en esta nueva versión (2022.02.02).

PDF del CFDI 4.0
A partir de esta liberación, podrás generar el de un CFDI 4.0; pero no solo esto, también se agregó soporte a:

  • Recibo de pago 2.0
  • Recibo de nómina con un CFDI 4.0

Para esto, hemos agregado dos nuevas plantillas (formatos):

  • Cfdi40.repx: Como su nombre lo indica, se usa para la generación del PDF del CFDI 4.0
  • Nomina12_Cfdi40.repx: Este es usando para el caso del recibo de nómina con el CFDI 4.0

Requerimientos técnicos
Debido a los cambios y mejoras realizadas al producto, nos hemos visto obligado a actualizar la versión del framework requerida, por lo que, a partir de esta versión, es necesario hacer uso de la versión 4.5.2 del Net Framework para que se pueda hacer uso de la librería.

Como siempre, te invitamos a leer el historial de cambios dando clic aquí, este documento contiene todos los cambios realizados.

Si deseas actualizarte a esta nueva versión, puedes descargarla de aquí

DESCARGAR

Si tienes alguna duda con respecto a esta publicación, te invitamos a que nos contactes por medio del chat que aparece en nuestra página www.facturando.mx donde con gusto un asesor te atenderá.

Hasta la próxima.