VXML_GetValue

VXml

Obtiene información resultado del procesamiento del documento CFDI (firmado, sellado y timbrado digital), esta información incluye, entre otras cosas, la información necesaria para el documento impreso en PDF.

Se debe utilizar DEPUES de llamar a las funciones VXML_ProcesaDocumento() ó VXML_ProcesaDocumentoSSL().

Esta función tiene un comportamiento dual, si el documento es procesado correctamente, podrá obtener todos los valores que se necesitan para la representación impresa del XML del CFDI en formato PDF, por otro lado, si el procesamiento del documento genera algún error, le permite recuperar una descripción amplia del error y en algunos casos esta descripción ampliada puede a incluir la solución al error.

Versión de VXml que soporta esta función: 2.0.0.9 Junio 2026
Aplicación: CFDI ver. 4.0

Sintáxis:

public static int VXML_GetValue (
	  			int hXml,
				int ValoraRecuperar
				)

Parámetros:

hXml: Tipo: Int32
Identificador en memoria del documento, devuelto por las funciones VXML_New() óVXML_NewWithLog().

ValoraRecuperar: Tipo: Int32
Valor numérico que indica el valor que deseamos recuperar, estos son 21 valores necesarios tanto para reportar el estado del procesamiento del XML así como para obtener los datos necesarios para la representación impresa en el PDF.

Estos valores son:

Valor	Constante predefinida	Descripción	Ejemplo
1	VXML_GET_DESCERROR	Código de Error en modo constante predefinida ( Ver códigos de error para obtener los valores de las constantes )	VXML_OK VXML_ERROR_SERVER VXML_ERROR_KEYPWD
2	VXML_GET_ERROR	Descripción extendida del error	CFDI40171 - El nodo concepto, no contiene el nodo hijo Impuestos. El password del fichero key es incorrecto
3	VXML_GET_CSDNUMBER	Número de certificado de sello digital con el que fue firmado el comprobante ( CSD del Emisor )	30001000000500003416
4	VXML_GET_SELLO	Sello digital del comprobante ( Emisor )	S2CoxBjSG6rEA2QWwTdFZb7xouTslv7fyf+8o6eeeferzVWLiybppngCeN9Md4O8d8Eb ZBEu28g6ltNmpmXIP8D/Qtm2Y9BFYLFX0bkNsdK+bKKz+8F8IXMp9sN2F+hQBTKxH9QZ 350zZUmA7AUNNpvejBsNbFighgtiudjWjdBfB46AYueAhcMySVZlbbMX16xWBhhWMJCq 8OO1+GpOUnDTBPSgTzqC5tx35F6HBYIIEskaj6l9tQgpj/r4NBgUKHexag5PC6yK1xG+ GwBoNPmAVJgSlFpanihwpVT7hh88piI+9fGI60+LfAWc9DGMPgqHOfZattG85lVak7IMUg==
5	VXML_GET_CADENA	Cadena original con la cual fue calculada el sello digital del CFDI	\|\|4.0\|CJZ\|7303\|2026-08-05T19:59:12\|99\|30001000000500003416\|CREDITO\|6034.48\| 0.00\|MXN\|1\|7000.00\|I\|01\|PPD\|07270\|01\|01000000-0000-0000-0000-000000000001\| 01000000-0000-0000-0000-000000000002\|01000000-0000-0000-0000-000000000003\| 01000000-0000-0000-0000-111111111111\|02\|02000000-0000-0000-0000-0000000000 01\|02000000-0000-0000-0000-222222222222\|EKU9003173C9\|ESCUELA KEMPER URGATE\| 601\|CTE940531F58\|CIBERNETICA Y TECNOLOGIA\|53050\|601\|G03\|43211500\|EQU-0025\| 1.000\|H87\|Computadora\|COMPUTADORA HP PORTATIL\|6034.48\|6034.48\|0.00\|02\| 6034.48\|002\|Tasa\|0.160000\|965.52\|6034.48\|002\|Tasa\|0.160000\|965.52\|965.52\|\|
6	VXML_GET_SATCSDNUMBER	Número de Certificado de sello digital con el cual fue timbrado el comprobante ( CSD del SAT )	30001000000500003456
7	VXML_GET_SATSELLO	Sello digital del timbre fiscal ( CSD del SAT )	NVwMSs63/uAZHYoMRK/40BLhDGnpThr0wd6ai+LLacJTaartt5lGj/IbMJtVx2E5Hqv dWdST9zCQuX1VCvy6u/B33md23g6Rv08E2zsTkFR7PynLFURUyx+uulqdJeiWa7uBOq x21+EuM1x/QQnOpTW0BN6B0cpJgVftTMoGLzmh/+v8jOBiT20gaZOvRkI7Ql3uPom7D GpWa9+fPCPPjBLyq301o1JKodcTN/sNM1lEZ64VGC7PkhSkxcSUk96NNjkrMq232YwF oppzMu2WrzziW4wT4MwRxZQxmqzRuM3AGYOFFussDvcbL5hOJQnoUc8G86tpGhxZ4m+ BzHRWFg==
8	VXML_GET_SATCADENA	Cadena orginal del timbre fiscal ( SAT )	\|\|1.1\|ce309179-4d8e-4995-8469-0f5f52514398\|2026-08-05T19:59:13\|SPR190613I52 \|S2CoxBjSG6rEA2QWwTdFZb7xouTslv7fyf+8o6eeeferzVWLiybppngCeN9Md4O 8d8EbZBEu28g6ltNmpmXIP8D/Qtm2Y9BFYLFX0bkNsdK+bKKz+8F8IXMp9sN2F+h QBTKxH9QZ350zZUmA7AUNNpvejBsNbFighgtiudjWjdBfB46AYueAhcMySVZlbbM X16xWBhhWMJCq8OO1+GpOUnDTBPSgTzqC5tx35F6HBYIIEskaj6l9tQgpj/r4NBg UKHexag5PC6yK1xG+GwBoNPmAVJgSlFpanihwpVT7hh88piI+9fGI60+LfAWc9DG MPgqHOfZattG85lVak7IMUg==\|30001000000500003456\|\|
9	VXML_GET_SATUUID	UUID o Folio Fiscal asignado por el SAT	ce309179-4d8e-4995-8469-0f5f52514398
10	VXML_GET_SATFECHA	Fecha de generación del Timbre ( SAT )	2026-08-05T19:59:13
11	VXML_GET_CSDINI	Fecha de inicio de vigencia del certtificado de sello digital (Emisor) en formato AAMMDDhhmmssZ	230518114351Z
12	VXML_GET_CSDFIN	Fecha de vencimiento del certificado de sello digital (Emisor) en formato AAMMDDhhmmssZ	270518114351Z
13	VXML_GET_VPID	VXml ID ó Folio interno utilizado por VXml en su base de datos	2399939
14	VXML_GET_DISP	Cantidad de timbres disponibles	268121
15	VXML_GET_DLLVERSION	Version de la librería	vxml260612v2.0.0.9
16	VXML_GET_FECHAXML	Fecha de emisión del xml	2026-08-05T19:59:12
17	VXML_GET_WARN	Mensaje de advertencia por parte de VXml	No implementado aún
18	VXML_GET_PAC	Nombre del PAC con el que se timbro el comprobante (SWE - SmarterWeb / INO - Invoice ONE / DIF - Digital Factura)	SWE
19	VXML_GET_REVISION	Plataforma de la librería (x86 - 32 bits, x64 - 64 bits)	x86
20	VXML_GET_SATRFCPROVCERTIF	RFC del proveedor autorizado de certificación (PAC)	SPR190613I52
21	VXML_GET_SATLEYENDA	Leyenda devuelta por el PAC	No implementado aun

Valor retornado:

Tipo: Int32

Retorna una cadena de caracteres valor numérico, si es 0 indica que el documento se procesó adecuadamente, si devuelve un valor negativo, esto indica que hubo errores en la generación del CFDI, estos errores se verán reflejados en el archivo de bitácora del proceso.

Valor retornado	Constante predefinida	Descripción
0	VXML_OK	XML procesado con éxito

Valor retornado	Constante predefinida	Descripción
-1	VXML_ERROR_UNKVER	Error de versión del XML, VXml solo soporta CFDI Ver. 4.0 y superiores
-2	VXML_ERROR_VALIDA	Descripción detallada del error (en caso de haberlo)
-3	VXML_ERROR_CSDOPEN	Error de apertura del archivo del certificado digital (archivo .CER)
-4	VXML_ERROR_CSDRFC	El RFC del XML no corresponde con el RFC del Certificado de Sello Digital (CSD)
-5	VXML_ERROR_CSDFECHA	La fecha del XML está fuera de la vigencia del certificado
-6	VXML_ERROR_KEYOPEN	Error de apertura del archivo de llave privada ( archivo.KEY)
-7	VXML_ERROR_KEYPWD	La contraseña del archivo .KEY es incorrecta
-8	VXML_ERROR_CSDKEYMACTH	Los archivos .CER y .KEY no corresponden al mismo par compatible
-9	VXML_ERROR_CADENAPIPA	Existe un valor incorrecto en la cadena original
-10	VXML_ERROR_WS	El WebService reporta un error en el procesamiento del XML
-11	VXML_ERROR_NET	Error general de comunicaciones, el equipo no está conectado a internet, no hay conexión o un firewall esta bloqueando la salida a internet
-12	VXML_ERROR_SERVER	Se pudo realizar la conexión al WebService pero no hay respuesta del servidor
-13	VXML_ERROR_LICINV	Error en las credenciales de seguridad para conectarse al WebService
-14	VXML_ERROR_MSXML	No se encuentra instalado el componente MSXML 6.0 necesario para realizar los procesos de sellado y timbrado.
-15	VXML_ERROR_GENSOAP	Error en la generación del SOAP para conectar con los Webserices de VXML.
-16	VXML_ERROR_SETPAC	Error en los datos de conexión al PAC

Ejemplo:

private void GeneraCFDI()
	{
         IntPtr hXml;
         IntPtr nResultado;

         /* indicamos la nueva version 4.0 */
         hXml = VXML_NewWithLog("4.0","bitacora.log");

         /* credenciales de timbrado */
         VXML_SetUserInfo(hXml, "demo_cibertec", "demo");

         /* Datos generales del comprobante*/
         VXML_SetComprobanteInfo_cfdi40(hXml, "CJZ", "7303", "%cb_date", "99", "CREDITO", "6034.48", "0.00", "MXN", "1", "7000.00", "I", "PPD", "07270", "", "01");
         /* datos del emisor */
         VXML_SetEmisorInfo_cfdi40(hXml, "EKU9003173C9", "ESCUELA KEMPER URGATE", "601", "");
         /* datos del receptor */
         VXML_SetReceptorInfo_cfdi40(hXml, "CTE940531F58", "CIBERNETICA Y TECNOLOGIA", "", "", "G03", "53050", "601");

         /* agregamos conceptos */
         VXML_AddConcepto_cfdi40(hXml, "43211500", "EQU-0025", "1.000", "H87", "Computadora", "COMPUTADORA HP PORTATIL", "6034.48", "6034.48", "0.00", "02");
         VXML_AddConceptoTraslado_cfdi40(hXml, "6034.48", "002", "Tasa", "0.160000", "965.52");  // impuestos del concepto

         /* resumen de impuestos */
         VXML_SetImpuestosInfo_cfdi40(hXml, "965.52", "");
         VXML_AddTraslado_cfdi40(hXml, "002", "Tasa", "0.160000", "965.52", "6034.48");

         // generamos el CFDI
         nResultado = VXML_ProcesaDocumentoSSL(hXml, "CSD_EKU9003173C9.cer", "CSD_EKU9003173C9.key", "12345678a", "demoIngresoCFDI40.xml");

         if (nResultado == 0) // no hubo errores, desplegamos los resultados
         {
           for (int i = 1; i <= 21; i++)
             {
              string getValue = VXML_GetValue(hXml, i);
              MessageBox.Show(getValue, $"GetValue [{i}]", MessageBoxButtons.OK, MessageBoxIcon.Information);
             }
         }
          else // hubo errores, desplegamos los errores desde la función VXML_GetValue
            {
                string errorCode = VXML_GetValue(hXml, 1);
                string error = VXML_GetValue(hXml, 2);
                MessageBox.Show($"Error en el CFDI: {error}", errorCode, MessageBoxButtons.OK, MessageBoxIcon.Error);
            }

            VXML_Free(hXml);
        }