Archivos de la etiqueta: desarrollo software

Guía Técnica CFDI: Implementación del Complemento Hidrocarburos y petrolíferos

Publicado el por

Para los desarrolladores de sistemas de facturación y ERP, la implementación del nuevo complemento de hidrocarburos y petroliferos requiere una precisión absoluta en la estructura del XML. A diferencia de otros complementos globales, este se integra a nivel de concepto, lo que exige una lógica de generación dinámica por cada producto facturado.

Publicación y vigencia

El estándar técnico de este complemento fue publicado oficialmente por el SAT el 27 de marzo de 2026. Su vigencia y obligatoriedad para todos los contribuyentes que enajenen gasolina regular, prémium o diésel inicia a partir del 24 de abril del 2026; como se puede observar, el periodo de convivencia es poco y posiblemente es debido a la urgencia de fiscalización en el sector.

Ubicación y recursos técnicos

La documentación oficial se encuentra dentro del portal del SAT, en la sección de «Factura electrónica», dentro del apartado de «Complementos de concepto».

Para facilitar tu desarrollo, hemos preparado un paquete con toda la información (XSD, Matriz de Errores y Catálogos), el cual puedes descargar aquí:

Descargar documentación técnica

Estructura y ubicación en el CFDI

Es un error común intentar colocar este nodo a nivel global del comprobante. Al ser un Complemento de Concepto, su ubicación correcta en el XML es dentro del nodo: cfdi:Concepto > cfdi:ComplementoConcepto > hidroypetro:HidroYPetro.

Regla de multiplicidad: Se debe incluir un complemento por cada concepto (producto) listado. Si una factura incluye gasolina regular, prémium y diésel, el XML deberá contener tres nodos de complemento independientes, cada uno asociado a su respectivo concepto.

Atributos del complemento

El nodo maestro se identifica como HidroYPetro y cuenta con 5 atributos técnicos definidos en el estándar:

  1. Versión: Debe fijarse en «1.0».
  2. TipoOperacion: Indica si es una comercialización o transporte.
  3. NumeroPermiso: El identificador otorgado por la Comisión Nacional de Energía (CNE).
  4. ClaveProducto: Vinculada al catálogo específico de hidrocarburos.
  5. Volumen: Cantidad precisa del hidrocarburo enajenado, validada contra la unidad de medida.

Especificaciones técnicas del SAT

El SAT ha liberado cuatro pilares fundamentales para la integración:

  • Schema (XSD): Define la estructura jerárquica, los espacios de nombres (namespaces) y los tipos de datos (longitudes, patrones regex y obligatoriedad).
  • Matriz de errores: Documento que contiene las validaciones lógicas que el PAC realizará antes del timbrado.
  • Catálogos: Listados específicos de claves de productos y unidades de medida aplicables exclusivamente a este sector.
  • Secuencia para la cadena original: El orden exacto de los atributos para la formación de la cadena que se someterá al algoritmo de firma electrónica.

Reglas de validación y matriz de errores

Según la última actualización de la Matriz de Errores, se han agregado 12 reglas de validación específicas para este complemento. Estas reglas aseguran la integridad de los datos antes de otorgar el sello digital. Algunos ejemplos críticos incluyen:

  • Regla HP001: Valida que el NumeroPermiso cumpla con el patrón definido en el XSD.
  • Regla HP005: Asegura que si existe el nodo de HidroYPetro, el concepto asociado pertenezca al catálogo de hidrocarburos autorizado.
  • Validación de permisos: Aunque la lista L_CNE no es pública para consulta general, los PAC (Proveedores Autorizados de Certificación) cuentan con el acceso para validar que el permiso reportado esté vigente en sus listas de control al momento del timbrado.

Formación de la cadena original

Para este complemento, la secuencia de la cadena original se construye siguiendo el orden de los atributos definidos en el estándar. El motor de sellado debe concatenar los valores de:

  • Versión
  • TipoOperacion
  • NumeroPermiso
  • ClaveProducto
  • Volumen

Cualquier alteración en este orden o la omisión de un pipe (|) resultará en un error de sello inválido.

¿Tu sistema está listo para el cambio? Integra nuestro SDK con soporte nativo para Hidrocarburos y petrolíferos y asegura el timbrado de tus clientes sin errores de validación.

Continúa leyendo sobre el nuevo complemento de gasolina:

Esperamos que esta serie de artículos 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.