virtualxml-cfdi v1.4.0
virtualxml-cfdi
Librería para firmar, sellar y timbrar CFDI v4.0
- Introducción
- Características
- Instalación
- Requisitos
- Información DEMO
- Contacto
- Métodos
- Métodos Administrativos
- Proceso de Timbrado
- Sitio Demo
- Funciones Referenciadas CFDI40 para Timbrado
- Básicas CFDI v40
- Conceptos CFDI v40
- Complemento Concepto Instituciones Educativas v1.0
- Complemento Concepto Venta Vehiculos v1.1
- Complementos
- Carta Porte v3.0
- Nómina v1.2
- Comercio Exterior v2.0
- Pagos v2.0
- Impuestos Locales v1.0
- Donatarias v1.1
- INE v1.1
- Divisas v1.0
- Aerolíneas v1.0
- Notarios Públicos v1.0
- Renovacion y Sustitución Vehicular v1.0
- Leyendas Fiscales v1.0
- Vehículo Usado v1.0
- Servicios Parciales de Construción v1.0
- Spei de Tercero a Tercero v1.0
- Estado de cuenta de combustibles de monederos electrónicos v1.2
- Consumo de Combustibles v1.1
- Pago en Especie v1.0
- Persona Fisica Integrante Coordinado v1.0
- Turista Pasajero Extranjero v1.0
- Vales de Despensa v1.0
- Detallista v1.0
- Especiales
- Ejemplos
- Changelog
Introducción
Librería para la generación y cancelación de CFDI 4.0 y CFDI 3.3, incluidos todos los complementos vigentes. Incluye el proceso de firmado, Sellado y tambien el Timbrado por medio del servicio de VirtualPAC, de acuerdo a la especificación del SAT.
Características
- Generación de CFDI 4.0
- Generación de CFDI 3.3
- Generación de todos los complementos vigentes:
- Generación de representacion impresa simple (PDF)
- Generación de Codigo de Barras Bidimensional en formatos: png, jpg y bmp
- Sellado local (tu llave privada y clave son usadas localmente)
- Soporta la solicitud de Cancelación de CFDI con el formato vigente a 2022 (tu llave privada y clave son usadas localmente)
Instalación
NPM:
$ npm install --save virtualxml-cfdi
Requisitos
- Contar con un CSD vigente (Certificado de Sello Digital).
- Contar con los archivos .cer, .key
- Contar con la clave del archivo .key
- En caso de desear timbrar con credenciales diferentes al demo; haber contratado un plan de timbres con VirtualPAC
NOTA: Los archivos .cer/.key de la FIEL no funcionan para el proceso de timbrado, deberan usarse los del CSD
Información DEMO
Estas credenciales pueden usarse sin necesidad de ningun tipo de registro
- usuario: demo_nodejs
- rfcemisor: EKU9003173C9
- Certificado Emisor: CSD_EKU9003173C9.cer (archivo ubicado dentro de la carpeta "test" del paquete)
- Llave Privada Emisor: CSD_EKU9003173C9.key (archivo ubicado dentro de la carpeta "test" del paquete)
- Clave Llave Privada: 12345678a
Contacto
- Correo electronico: soporte@ciber-tec.com
Métodos
cancelaCFDI2022
Procesa la solicitud de cancelación y devuelve el Acuse de solicitud/estatus Cancelación en caso de ser exitoso.
Esta funcion implementa los nuevos requisitos de cancelacion aplicables a partir de 2022.
Parametros Nombre | Tipo | Requerido | Ejemplo ------------------- | ------------------- | -------- | -------- usuario | Cadena | Sí | demo_nodejs rfcemisor | Cadena | Sí | EKU9003173C9 uuid | Cadena | Sí | FFFFFFFF-FFFF-FFFF-FFFF-FFFFFFFFFFFF motivo | Cadena | Sí | 02 foliosust | Cadena | Sí | Texto en blanco si no se usa certificado | Cadena | Sí | ./MisCertificados/EKU9003173C9.cer o Base64 (MIIF+TCCA+GgAwIBAgI...) llaveprivada | Cadena | Sí | ./MisCertificados/EKU9003173C9.key o Base64 (MIIFDjBABgkqhkiG9w0...) clave | Cadena | Sí | 12345678a outbasepath | Cadena | No | ../../salida/ outprefix | Cadena | No | prefijo outsuffix | Cadena | No | sufijo
Retorno Regresa una promesa. Una solicitud exitosa resolvera la promesa (resolve/then) y la respuesta contendra un exitcode = 201 o exitcode = 202, un uuid y un acuse. Cualquier otro valor sera un error en el proceso y debera referirse al mensaje message = ... normalmente en el rechazo (reject/catch) de la promesa
- Resolve (Then)
{ "exitcode": 201, "message": "201 - Solicitud de cancelación recibida." "uuid": "025357315-4D60-4E56-A056-7AA0B1D8D95F", "acuse": "XML del acuse en base64" }
Resolve (Then)
{ "exitcode": 202, "message": "202 - UUID Previamente cancelado." "uuid": "025357315-4D60-4E56-A056-7AA0B1D8D95F", "acuse": "XML del acuse en base64" }
Reject (Catch)
{ "exitcode": 205, "message": "CA205 - El UUID no existe => Error al cancelar el UUID de la factura" }
- Resolve (Then)
addFunctionCall
Agrega al Stack FIFO una llamada referenciada a la funcion funcName con los parámetros especificados.
- Parametros Nombre | Tipo | Requerido | Ejemplo ------------------- | ------------------- | -------- | -------- funcName | Cadena | Sí | VirtualXML_SetEmisorInfo_cfdi40 ...args | Multi parámetros | Sí | 'EKU9003173C9', 'NombreDelEmisorRazónSocial', '601'
NOTA: Dependiendo de la funcion referenciada (funcName), el numero de parámetros varía. Ver las funciones disponibles y numero de argumentos en la sección funciones referenciadas para timbrado
- Retorno La instancia de la clase, para usarse con llamadas secuenciales en 1 sola linea si se desea.
emiteCFDI40
Procesa Stack de funciones e intenta timbrar el documento generado.
Parametros Nombre | Tipo | Requerido | Ejemplo ------------------- | ------------------- | -------- | -------- usuario | Cadena | Sí | demo_nodejs rfcemisor | Cadena | Sí | EKU9003173C9 certificado | Cadena | Sí | ./MisCertificados/EKU9003173C9.cer o Base64 (MIIF+TCCA+GgAwIBAgI...) llaveprivada | Cadena | Sí | ./MisCertificados/EKU9003173C9.key o Base64 (MIIFDjBABgkqhkiG9w0...) clave | Cadena | Sí | 12345678a outbasepath | Cadena | No | ../../salida/ outprefix | Cadena | No | prefijo outsuffix | Cadena | No | sufijo qrpng | Bool | No | true qrbmp | Bool | No | false qrjpg | Bool | No | false pdf | Bool | No | true
Retorno Regresa una promesa. Un timbrado exitoso resolvera la promesa (resolve/then) y la respuesta contendra un exitcode = 0, un uuid y un xmltimbrado. Cualquier otro valor sera un error en el proceso y debera referirse al mensaje message = ... normalmente en el rechazo (reject/catch) de la promesa
Resolve (Then)
{ "exitcode": 0, "message": "" "uuid": "025357315-4D60-4E56-A056-7AA0B1D8D95F", "xmltimbrado": "XML en base64", "cadenasat": "Cadena Original del complemento de certificación digital del SAT", "qrpng": "QR.png en base64", "qrjpg": "QR.jpg en base64", "qrbmp": "QR.bmp en base64", "pdf": "Representacion impresa PDF en base64", }
Reject (Catch)
{ "exitcode": -5, "message": "Algunas funciones no son validas: VirtualXML_NoExiste" }
Métodos Administrativos
Métodos útiles para la gestion y mantenimiento de RFC emisores, usuarios (distribuidores) y la asignación de timbres manual o automática; posibilitando una administracion por medio del este paquete sin necesidad de hacer uso del portal administrativo. Para el uso de todos estos métodos, es requerida una APIKEY
adminEmisorAdd
Alta de un nuevo RFC emisor.
Parametros Nombre | Tipo | Requerido | Ejemplo ------------------- | ------------------- | -------- | -------- apikey | Cadena | Sí | 1pIp-j-ZVVff2H2-Y54yTtYpW-Uhdffw8Pb3pJGRt7o usuario | Cadena | Sí | demo_nodejs rfcemisor | Cadena | Sí | EKU9003173C9 pwdconsulta | Cadena | Sí | SomeSecret. Usar texto en blanco para no establecer el valor razonsocial | Cadena | Sí | Some Company AC. email | Cadena | Sí | email@soporte.com. Texto en blanco si no se usa contacto | Cadena | Sí | IT guy. Texto en blanco si no se usa asignacion | Int | Sí | 100 suspendido | Bool | Sí | false notificacion | Bool | Sí | true reserved | Cadena | No |
Retorno Regresa una promesa. Una solicitud exitosa resolvera la promesa (resolve/then) y la respuesta contendra un campo exitcode y message. Cualquier valor de exitcode diferente a 0 sera un error en el proceso y debera referirse al mensaje message = ... normalmente en el rechazo (reject/catch) de la promesa
Resolve (Then)
{ "exitcode": 0, "message": "" }
Reject (Catch)
{ "exitcode": -2, "message": "RFC previamente agregado" }
adminEmisorUpd
Actualizacion de la informacion general de un RFC emisor asociado a la cuenta del usuario.
Parametros Nombre | Tipo | Requerido | Ejemplo ------------------- | ------------------- | -------- | -------- apikey | Cadena | Sí | 1pIp-j-ZVVff2H2-Y54yTtYpW-Uhdffw8Pb3pJGRt7o usuario | Cadena | Sí | demo_nodejs rfcemisor | Cadena | Sí | EKU9003173C9 pwdconsulta | Cadena | Sí | SomeSecret. Usar texto en blanco para no establecer o alterar el valor actual razonsocial | Cadena | Sí | Some Company AC. email | Cadena | Sí | email@soporte.com. Texto en blanco si no se usa contacto | Cadena | Sí | IT guy. Texto en blanco si no se usa suspendido | Bool | Sí | false notificacion | Bool | Sí | true reserved | Cadena | No |
Retorno Regresa una promesa. Una solicitud exitosa resolvera la promesa (resolve/then) y la respuesta contendra un campo exitcode y message. Cualquier valor de exitcode diferente a 0 sera un error en el proceso y debera referirse al mensaje message = ... normalmente en el rechazo (reject/catch) de la promesa
Resolve (Then)
{ "exitcode": 0, "message": "" }
Reject (Catch)
{ "exitcode": -3, "message": "Usuario/APIKEY invalida" }
adminEmisorAsigna
Realiza una asignacion de timbres al RFC emisor.
Parametros Nombre | Tipo | Requerido | Ejemplo ------------------- | ------------------- | -------- | -------- apikey | Cadena | Sí | 1pIp-j-ZVVff2H2-Y54yTtYpW-Uhdffw8Pb3pJGRt7o usuario | Cadena | Sí | demo_nodejs rfcemisor | Cadena | Sí | EKU9003173C9 asignacion | Int | Sí | 100 reserved | Cadena | No |
Retorno Regresa una promesa. Una solicitud exitosa resolvera la promesa (resolve/then) y la respuesta contendra un campo exitcode y message. Cualquier valor de exitcode diferente a 0 sera un error en el proceso y debera referirse al mensaje message = ... normalmente en el rechazo (reject/catch) de la promesa
Resolve (Then)
{ "exitcode": 0, "message": "" }
Reject (Catch)
{ "exitcode": -2, "message": "No se permiten asignaciones en 0 o negativas" }
adminEmisorAutoasignacion
Crea o modifica la regla de autoasignación de timbres al RFC emisor. Cuando el total de timbres disponibles del emisor alcance el valor threshold, se asignaran el numero de timbres asignacion siempre que la regla se encuentre activa y el número de timbres totales asignados historicamente al emisor no supere el valor limite.
Parametros Nombre | Tipo | Requerido | Ejemplo ------------------- | ------------------- | -------- | -------- apikey | Cadena | Sí | 1pIp-j-ZVVff2H2-Y54yTtYpW-Uhdffw8Pb3pJGRt7o usuario | Cadena | Sí | demo_nodejs rfcemisor | Cadena | Sí | EKU9003173C9 asignacion | Int | Sí | 100 threshold | Int | Sí | 20 limit | Int | Sí | 5000 active | Bool | Sí | false reserved | Cadena | No |
Retorno Regresa una promesa. Una solicitud exitosa resolvera la promesa (resolve/then) y la respuesta contendra un campo exitcode y message. Cualquier valor de exitcode diferente a 0 sera un error en el proceso y debera referirse al mensaje message = ... normalmente en el rechazo (reject/catch) de la promesa
Resolve (Then)
{ "exitcode": 0, "message": "" }
Reject (Catch)
{ "exitcode": -2, "message": "Los timbres para asignar no debe ser mayor al total de tus timbres disponibles" }
adminUsuarioAdd
Alta de un usuario-hijo (distribuidor) relacionado al usuario actual. Este usuario podrá gestionar sus propios emisores y timbres de forma independiente pero podra recibir asignacion de timbres directamente del usuario padre.
Parametros Nombre | Tipo | Requerido | Ejemplo ------------------- | ------------------- | -------- | -------- apikey | Cadena | Sí | 1pIp-j-ZVVff2H2-Y54yTtYpW-Uhdffw8Pb3pJGRt7o usuario | Cadena | Sí | demo_nodejs distribuidor | Cadena | Sí | childUserName pwd | Cadena | Sí | SomeSecret. Usar texto en blanco para no establecer el valor razonsocial | Cadena | Sí | Some Company AC. email | Cadena | Sí | email@soporte.com. Texto en blanco si no se usa contacto | Cadena | Sí | IT guy. Texto en blanco si no se usa asignacion | Int | Sí | 100 reserved | Cadena | No |
Retorno Regresa una promesa. Una solicitud exitosa resolvera la promesa (resolve/then) y la respuesta contendra un campo exitcode y message. Cualquier valor de exitcode diferente a 0 sera un error en el proceso y debera referirse al mensaje message = ... normalmente en el rechazo (reject/catch) de la promesa
Resolve (Then)
{ "exitcode": 0, "message": "" }
Reject (Catch)
{ "exitcode": -2, "message": "Ya existe un usuario con este nombre" }
adminUsuarioUpd
Actualizacion de la informacion general de un usuario-hijo (distribuidor) RFC emisor asociado a la cuenta del usuario actual.
Parametros Nombre | Tipo | Requerido | Ejemplo ------------------- | ------------------- | -------- | -------- apikey | Cadena | Sí | 1pIp-j-ZVVff2H2-Y54yTtYpW-Uhdffw8Pb3pJGRt7o usuario | Cadena | Sí | demo_nodejs distribuidor | Cadena | Sí | childUserName pwd | Cadena | Sí | SomeSecret. Usar texto en blanco para no establecer o alterar el valor actual razonsocial | Cadena | Sí | Some Company AC. email | Cadena | Sí | email@soporte.com. Texto en blanco si no se usa contacto | Cadena | Sí | IT guy. Texto en blanco si no se usa reserved | Cadena | No |
Retorno Regresa una promesa. Una solicitud exitosa resolvera la promesa (resolve/then) y la respuesta contendra un campo exitcode y message. Cualquier valor de exitcode diferente a 0 sera un error en el proceso y debera referirse al mensaje message = ... normalmente en el rechazo (reject/catch) de la promesa
Resolve (Then)
{ "exitcode": 0, "message": "" }
Reject (Catch)
{ "exitcode": -2, "message": "Nombre de usuario en blanco" }
adminUsuarioAsigna
Realiza una asignacion de timbres al usuario-hijo (distribuidor) tomando los timbres disponibles del usuario actual.
Parametros Nombre | Tipo | Requerido | Ejemplo ------------------- | ------------------- | -------- | -------- apikey | Cadena | Sí | 1pIp-j-ZVVff2H2-Y54yTtYpW-Uhdffw8Pb3pJGRt7o usuario | Cadena | Sí | demo_nodejs distribuidor | Cadena | Sí | childUserName asignacion | Int | Sí | 100 reserved | Cadena | No |
Retorno Regresa una promesa. Una solicitud exitosa resolvera la promesa (resolve/then) y la respuesta contendra un campo exitcode y message. Cualquier valor de exitcode diferente a 0 sera un error en el proceso y debera referirse al mensaje message = ... normalmente en el rechazo (reject/catch) de la promesa
Resolve (Then)
{ "exitcode": 0, "message": "" }
Reject (Catch)
{ "exitcode": -2, "message": "Nombre de usuario en blanco" }
Proceso de Timbrado
El siguiente diagrama muestra el proceso de timbrado completo:
Demo
En el siguiente enlace se podra descargar un demo que incluye:
- Cliente Web: Contiene un formulario simple que sirve de interface para llenar la informacion del CFDI asi como observar la respuesta obtenida por el uso de virtualxml-cfdi por parte del servidor.
- Servidor: Sirve como capa de negocio exponiendo un servicio REST que procesa las solicitudes del cliente y hace uso de este paquete (virtualxml-cfdi) para la firma, sellado y timbrado del CFDI.
NOTA: El paquete virtualxml-cfdi puede ejecutarse en cualquier version Node 4+. Este demo utiliza la version minima de Node 12+
Descarga aqui - version minima NodeJS v12+
UsoDemo
Abrir linea de comandos en folder server y ejecutar:
$ npm install
$ npm start
Abrir linea de comandos en folder client
$ npm install
$ npm start
Abrir browser en direccion http://localhost:3000 y probar el demo.
Funciones Referenciadas para Timbrado
Estas funciones son añadidas a una pila FIFO (FirstIn-FirstOut) para ser enviadas y ejecutadas remotamente. Constan de un nombre funcName y de 1 o mas parámetros. Las funciones se agregan a la pila mediante el metodo addFunctionCall una vez que la clase VirtualXML ha sido instanciada. El siguiente ejemplo ilustra el modo de uso:
Los parámetros de funcName deberan ser de tipo cadena independientemente del tipo de dato que representen, y deberan tener el formato que corresponda de acuerdo a los lineamientos del SAT.
Los parámetros de funcName deberan ser una cadena vacia si no contiene informacion, y debera respetarse la posicion de los mismos.
const VirtualXML = require('virtualxml-cfdi');
const vxml = new VirtualXML(); // Nueva Instancia
vxml.addFunctionCall( 'VirtualXML_SetComprobanteInfo_cfdi40', // **funcName**
'NOM', // param01 = Serie
'1', // param02 = Folio
'2018-01-30T05:24:30', // param03 = Fecha
'01', // param04 = FormaPago
'CondiciónDePago', // param05 = CondicionesDePago
'5000.00', // param06 = SubTotal
'', // param07 = Descuento
'MXN', // param08 = Moneda
'', // param09 = TipoCambio
'5000.00', // param10 = Total
'I', // param11 = TipoDeComprobante
'PUE', // param12 = MetodoPago
'68025', // param13 = LugarExpedicion
'', // param14 = Confirmacion
'01'); // param15 = Exportacion
Se pueden agregar tantas llamadas como se necesiten para el correcto llenado del CFDI, teniendo en cuenta que algunos elementos que pueden aparecer varias veces (ej. cfdi.Conceptos), a su vez podran contener un detalle y las funciones del detalle afectaran al ultimo elemento padre al que pertenece. Por ejemplo:
const VirtualXML = require('virtualxml-cfdi');
const vxml = new VirtualXML(); // Nueva Instancia
vxml.addFunctionCall('VirtualXML_SetComprobanteInfo_cfdi40', 'A', '1', FechaCFDI, '99', 'Contado Comercial', '1000.00', '50.00', 'MXN', '', '1102.00', 'I', 'PPD', '53050', '', '01');
vxml.addFunctionCall('VirtualXML_SetReceptorInfo_cfdi40', 'MAG041126GT8', 'NombreDelReceptorRazónSocial', '', '', 'G01', '53050', '601');
vxml.addFunctionCall('VirtualXML_AddConcepto_cfdi40', '84111506', 'SEFXXX', '1', 'H87', 'Unidad', 'Paquete X - ObjetoImp1', '500.00', '500.00', '', '02');
vmlx.addFunctionCall('VirtualXML_AddConceptoCuentaPredial_cfdi40','5678901');
vxml.addFunctionCall('VirtualXML_AddConcepto_cfdi40', '84111506', 'SEFXXX', '2', 'H87', 'Unidad', 'Paquete X - ObjetoImp2', '250.00', '500.00', '50.00', '02');
vxml.addFunctionCall('VirtualXML_AddConcepto_cfdi40', '84111506', 'SEFXXX', '2', 'H87', 'Unidad', 'Paquete X - ObjetoImp3', '250.00', '500.00', '50.00', '02');
vxml.addFunctionCall('VirtualXML_AddConceptoTraslado_cfdi40', '450.00', '002', 'Tasa', '0.160000', '72.00');
// Para funciones que afectan informacion unica, NO importa el momento en que se llamen
vxml.addFunctionCall('VirtualXML_SetEmisorInfo_cfdi40', 'EKU9003173C9', 'NombreDelEmisorRazónSocial', '601','');
// Esta funcion afectara al ultimo CONCEPTO agregado
vmlx.addFunctionCall('VirtualXML_AddConceptoRetencion_cfdi40','3000.00','003','Tasa','0.300000','900.00');
El resultado seria un CFDI con la siguiente estructura:
CFDI
|--Emisor
|--Receptor
|--Conceptos
|--Concepto01
|--CuentaPredial
|--Concepto02
|--Concepto03
|--Impuestos
|--Traslado
|--Retencion
CFDI40.Básicas
VirtualXML_SetComprobanteInfo_cfdi40
VirtualXML_SetInformacionGlobal_cfdi40
VirtualXML_AddCfdiRelacionados_cfdi40
VirtualXML_AddCfdiRelacionado_cfdi40 (Usar antes AddCfdiRelacionados_cfdi40)
- 01 UUID
VirtualXML_SetEmisorInfo_cfdi40
VirtualXML_SetReceptorInfo_cfdi40
VirtualXML_SetImpuestosInfo_cfdi40
VirtualXML_AddTraslado_cfdi40 (Usar antes SetImpuestosInfo_cfdi40)
VirtualXML_AddRetencion_cfdi40 (Usar antes SetImpuestosInfo_cfdi40)
VirtualXML_SetAddenda
- 01 FragmentoXML (Debe ser válido e incluir los namespaces que no sean parte de un CFDI)
VirtualXML_SetAddendaText
- 01 TextoAddenda
CFDI40.Conceptos
VirtualXML_AddConcepto_cfdi40
VirtualXML_AddConceptoTraslado_cfdi40 (Usar antes AddConcepto_cfdi40)
VirtualXML_AddConceptoRetencion_cfdi40 (Usar antes AddConcepto_cfdi40)
VirtualXML_AddConceptoInformacionAduanera_cfdi40 (Usar antes AddConcepto_cfdi40)
- 01 NumeroPedimento
VirtualXML_AddConceptoCuentaPredial_cfdi40 (Usar antes AddConcepto_cfdi40)
- 01 Numero
VirtualXML_AddConceptoParte_cfdi40 (Usar antes AddConcepto_cfdi40)
VirtualXML_SetConceptoACuentaTerceros_cfdi40 (Usar antes AddConcepto_cfdi40)
CFDI.Conceptos.ComplementoConcepto.iedu10
- VirtualXML_AddConceptoComplementoIedu10 (Usar antes AddConcepto)
CFDI.Conceptos.ComplementoConcepto.ventavehiculos11
- VirtualXML_AddConceptoComplementoVentaVehiculos11_cfdi40 (Usar antes AddConcepto)
CFDI.Complemento.CartaPorte30
La respuesta de este complemento incluye la URL usada para el QR especifico CCP30, y de solicitarse las imagenes de QR, tambien el QRCCP30
VirtualXML_SetCartaPorte30
VirtualXML_CartaPorte30AddUbicacion (Usar antes SetCartaPorte30)
- 01 TipoUbicacion
- 02 IDUbicacion
- 03 RFCRemitenteDestinatario
- 04 NombreRemitenteDestinatario
- 05 NumRegIdTrib
- 06 ResidenciaFiscal
- 07 NumEstacion
- 08 NombreEstacion
- 09 NavegacionTrafico
- 10 FechaHoraSalidaLlegada
- 11 TipoEstacion
- 12 DistanciaRecorrida
- 13 Calle
- 14 NumeroExterior
- 15 NumeroInterior
- 16 Colonia
- 17 Localidad
- 18 Referencia
- 19 Municipio
- 20 Estado
- 21 Pais
- 22 CodigoPostal
VirtualXML_CartaPorte30SetMercancias
VirtualXML_CartaPorte30AddMercancia (Usar antes CartaPorte30SetMercancias)
- 01 BienesTransp
- 02 ClaveSTCC
- 03 Descripcion
- 04 Cantidad
- 05 ClaveUnidad
- 06 Unidad
- 07 Dimensiones
- 08 MaterialPeligroso
- 09 CveMaterialPeligroso
- 10 Embalaje
- 11 DescripEmbalaje
- 12 SectorCOFEPRIS
- 13 NombreIngredienteActivo
- 14 NomQuimico
- 15 DenominacionGenericaProd
- 16 DenominacionDistintivaProd
- 17 Fabricante
- 18 FechaCaducidad
- 19 LoteMedicamento
- 20 FormaFarmaceutica
- 21 CondicionesEspTransp
- 22 RegistroSanitarioFolioAutorizacion
- 23 PermisoImportacion
- 24 FolioImpoVUCEM
- 25 NumCAS
- 26 RazonSocialEmpImp
- 27 NumRegSanPlagCOFEPRIS
- 28 DatosFabricante
- 29 DatosFormulador
- 30 DatosMaquilador
- 31 UsoAutorizado
- 32 PesoEnKg
- 33 ValorMercancia
- 34 Moneda
- 35 FraccionArancelaria
- 36 UUIDComercioExt
- 37 TipoMateria
- 38 DescripcionMateria
VirtualXML_CartaPorte30SetDetalleMercancia (Usar antes CartaPorte30AddMercancia)
VirtualXML_CartaPorte30AddMercanciaDocumentacionAduanera (Usar antes CartaPorte30AddMercancia)
VirtualXML_CartaPorte30AddMercanciaGuiasIdentificacion (Usar antes CartaPorte30AddMercancia)
VirtualXML_CartaPorte30AddMercanciaCantidadTransporta (Usar antes CartaPorte30AddMercancia)
VirtualXML_CartaPorte30SetMercanciasAutotransporte (Usar antes CartaPorte30AddMercancia)
VirtualXML_CartaPorte30SetMercanciasTransporteMaritimo (Usar antes CartaPorte30AddMercancia)
- 01 PermSCT
- 02 NumPermisoSCT
- 03 NombreAseg
- 04 NumPolizaSeguro
- 05 TipoEmbarcacion
- 06 Matricula
- 07 NumeroOMI
- 08 AnioEmbarcacion
- 09 NombreEmbarc
- 10 NacionalidadEmbarc
- 11 UnidadesDeArqBruto
- 12 TipoCarga
- 13 Eslora
- 14 Manga
- 15 Calado
- 16 Puntal
- 17 LineaNaviera
- 18 NombreAgenteNaviero
- 19 NumAutorizacionNaviero
- 20 NumViaje
- 21 NumConocEmbarc
- 22 PermisoTempNavegacion
VirtualXML_CartaPorte30SetMercanciasTransporteMaritimoRemolquesCCP (Usar antes CartaPorte30SetMercanciasTransporteMaritimo)
VirtualXML_CartaPorte30AddMercanciasTransporteMaritimoContenedor (Usar antes CartaPorte30SetMercanciasTransporteMaritimo)
VirtualXML_CartaPorte30SetMercanciasTransporteAereo (Usar antes CartaPorte30AddMercancia)
VirtualXML_CartaPorte30SetMercanciasTransporteFerroviario (Usar antes CartaPorte30AddMercancia)
VirtualXML_CartaPorte30AddMercanciasTransporteFerroviarioDerechosDePaso (Usar antes CartaPorte30SetMercanciasTransporteFerroviario)
VirtualXML_CartaPorte30AddMercanciasTransporteFerroviarioCarro (Usar antes CartaPorte30SetMercanciasTransporteFerroviario)
VirtualXML_CartaPorte30AddMercanciasTransporteFerroviarioCarroContenedor (Usar antes CartaPorte30SetMercanciasTransporteFerroviario)
VirtualXML_CartaPorte30AddFiguraTransporteTiposFigura
VirtualXML_CartaPorte30AddFiguraTransporteTiposFiguraPartesTransporte (Usar antes CartaPorte30AddFiguraTransporteTiposFigura)
- 01 ParteTransporte
CFDI.Complemento.Nomina12
VirtualXML_SetNomina12
VirtualXML_Nomina12SetEmisor (Usar antes SetNomina12)
VirtualXML_Nomina12SetReceptor (Usar antes SetNomina12)
VirtualXML_Nomina12AddSubContratacion (Usar antes Nomina12SetReceptor)
VirtualXML_Nomina12SetPercepciones (Usar antes SetNomina12)
VirtualXML_Nomina12AddPercepcion (Usar antes Nomina12SetPercepciones)
VirtualXML_Nomina12SetJubilacionPensionRetiro (Usar antes Nomina12SetPercepciones)
VirtualXML_Nomina12SetSeparacionIndemnizacion (Usar antes Nomina12SetPercepciones)
VirtualXML_Nomina12SetDeducciones (Usar antes SetNomina12)
VirtualXML_Nomina12AddDeduccion (Usar antes Nomina12SetDeducciones)
VirtualXML_Nomina12AddOtroPago (Usar antes SetNomina12)
VirtualXML_Nomina12AddIncapacidad (Usar antes SetNomina12)
CFDI.Complemento.cce20
VirtualXML_SetComercioExterior20
VirtualXML_CCE20SetEmisor (Usar antes SetComercioExterior20)
VirtualXML_CCE20SetReceptor (Usar antes SetComercioExterior20)
VirtualXML_CCE20AddDestinatario (Usar antes SetComercioExterior20)
VirtualXML_CCE20AddDestinatarioDomicilio (Usar antes CCE20AddDestinatario)
VirtualXML_CCE20AddPropietario (Usar antes SetComercioExterior20)
VirtualXML_CCE20AddMercancia (Usar antes SetComercioExterior20)
VirtualXML_CCE20AddMercanciaDescripcionesEspecificas (Usar antes CCE20AddMercancia)
CFDI.Complemento.pagos20
VirtualXML_SetPagos20
VirtualXML_Pagos20AddPago (Usar antes SetPagos20)
VirtualXML_Pagos20AddPagoDoctoRelacionado (Usar antes Pagos20AddPago)
VirtualXML_Pagos20AddPagoDoctoRelacionadoRetencionDR (Usar antes Pagos20AddPagoDoctoRelacionado)
VirtualXML_Pagos20AddPagoDoctoRelacionadoTrasladoDR (Usar antes Pagos20AddPagoDoctoRelacionado)
VirtualXML_Pagos20AddPagoImpuestosPRetencionP (Usar antes Pagos20AddPago)
VirtualXML_Pagos20AddPagoImpuestosPTrasladoP (Usar antes Pagos20AddPago)
CFDI.Complemento.ImpuestosLocales10
VirtualXML_SetImpuestosLocales10
VirtualXML_ImpLocal10AddRetencionesLocales (Usar antes SetImpuestosLocales10)
VirtualXML_ImpLocal10AddTrasladosLocales (Usar antes SetImpuestosLocales10)
CFDI.Complemento.Donatarias11
CFDI.Complemento.INE11
VirtualXML_SetINE11
VirtualXML_INE11AddEntidad (Usar antes SetINE11)
VirtualXML_INE11AddEntidadContabilidad (Usar antes INE11AddEntidad)
- 01 IdContabilidad
CFDI.Complemento.Divisas10
- VirtualXML_SetDivisas10
- 01 tipoOperacion
CFDI.Complemento.Aerolineas10
VirtualXML_SetAerolineas10
VirtualXML_Aerolineas10AddCargo (Usar antes SetAerolineas10)
CFDI.Complemento.NotariosPublicos10
VirtualXML_SetNotariosPublicos10
- 01 TipoInmueble
- 02 Calle
- 03 NoExterior
- 04 NoInterior
- 05 Colonia
- 06 Localidad
- 07 Referencia
- 08 Municipio
- 09 Estado
- 10 Pais
- 11 CodigoPostal
- 12 NumInstrumentoNotarial
- 13 FechaInstNotarial
- 14 MontoOperacion
- 15 Subtotal
- 16 IVA
- 17 CURP
- 18 NumNotaria
- 19 EntidadFederativa
- 20 Adscripcion
- 21 CoproSocConyugalEEnajenante
- 22 CoproSocConyugalEAdquiriente
VirtualXML_NotariosPublicos10AddDescInmueble (Usar antes SetNotariosPublicos10)
VirtualXML_NotariosPublicos10AddDatosUnEnajenante (Usar antes SetNotariosPublicos10)
VirtualXML_NotariosPublicos10AddDatosEnajenanteCopSC (Usar antes SetNotariosPublicos10)
VirtualXML_NotariosPublicos10AddDatosUnAdquiriente (Usar antes SetNotariosPublicos10)
VirtualXML_NotariosPublicos10AddDatosAdquirienteCopSC (Usar antes SetNotariosPublicos10)
CFDI.Complemento.VehiculoRenovacionSustitucionVehiculo10
VirtualXML_SetRenovSustitVehiculos10
- 01 TipoDeDecreto
VirtualXML_RenovSustitVehiculos10AddRenovVehicular (Usar antes SetRenovSustitVehiculos10)
- 01 VehEnaj
- 02 UsadoPrecioVehUsado
- 03 UsadoTipoVeh
- 04 UsadoMarca
- 05 UsadoTipooClase
- 06 UsadoAño
- 07 UsadoModelo
- 08 UsadoNIV
- 09 UsadoNumSerie
- 10 UsadoNumPlacas
- 11 UsadoNumMotor
- 12 UsadoNumFolTarjCir
- 13 UsadoNumPedIm
- 14 UsadoAduana
- 15 UsadoFechaRegulVeh
- 16 UsadoFoliofiscal
- 17 NuevoAño
- 18 NuevoModelo
- 19 NuevoNumPlacas
- 20 NuevoRFC
VirtualXML_RenovSustitVehiculos10AddRenovVehicularVehiculoUsado (Usar antes RenovSustitVehiculos10AddRenovVehicular)
VirtualXML_RenovSustitVehiculos10AddSustitVehicular (Usar antes SetRenovSustitVehiculos10)
- 01 VehEnaj
- 02 UsadoPrecioVehUsado
- 03 UsadoTipoVeh
- 04 UsadoMarca
- 05 UsadoTipooClase
- 06 UsadoAño
- 07 UsadoModelo
- 08 UsadoNIV
- 09 UsadoNumSerie
- 10 UsadoNumPlacas
- 11 UsadoNumMotor
- 12 UsadoNumFolTarjCir
- 13 UsadoNumFolAvisoint
- 14 UsadoNumPedIm
- 15 UsadoAduana
- 16 UsadoFechaRegulVeh
- 17 UsadoFoliofiscal
- 18 NuevoAño
- 19 NuevoModelo
- 20 NuevoNumPlacas
- 21 NuevoRFC
CFDI.Complemento.LeyendasFiscales10
- VirtualXML_SetLeyendasFiscales10Full
- 01 A_disposicionFiscal01
- 02 A_norma01
- 03 A_textoLeyenda01
- 04 A_disposicionFiscal02
- 05 A_norma02
- 06 A_textoLeyenda02
- 07 A_disposicionFiscal03
- 08 A_norma03
- 09 A_textoLeyenda03
- 10 A_disposicionFiscal04
- 11 A_norma04
- 12 A_textoLeyenda04
- 13 A_disposicionFiscal05
- 14 A_norma05
- 15 A_textoLeyenda05
- 16 A_disposicionFiscal06
- 17 A_norma06
- 18 A_textoLeyenda06
- 19 A_disposicionFiscal07
- 20 A_norma07
- 21 A_textoLeyenda07
- 22 A_disposicionFiscal08
- 23 A_norma08
- 24 A_textoLeyenda08
- 25 A_disposicionFiscal09
- 26 A_norma09
- 27 A_textoLeyenda09
- 28 A_disposicionFiscal10
- 29 A_norma10
- 30 A_textoLeyenda10
CFDI.Complemento.VehiculoUsado10
VirtualXML_SetVehiculoUsado10
VirtualXML_VehiculoUsado10AddInformacionAduanera (Usar antes SetVehiculoUsado10)
CFDI.Complemento.ServicioParcial10
- VirtualXML_SetServicioParcial10
CFDI.Complemento.SPEI10
- VirtualXML_Spei10AddSpeiTercero
CFDI.Complemento.EstadoCuentaCombustible12
VirtualXML_SetEstadoDeCuentaCombustible12
VirtualXML_EstadoDeCuentaCombustible12AddConcepto (Usar antes SetEstadoDeCuentaCombustible12)
VirtualXML_EstadoDeCuentaCombustible12AddConceptoTraslado (Usar antes EstadoDeCuentaCombustible12AddConcepto)
CFDI.Complemento.ConsumoDeCombustibles11
VirtualXML_SetConsumoDeCombustibles11
VirtualXML_ConsumoDeCombustibles11AddConcepto (Usar antes SetConsumoDeCombustibles11)
VirtualXML_ConsumoDeCombustibles11AddConceptoDeterminado (Usar antes ConsumoDeCombustibles11AddConcepto)
CFDI.Complemento.PagoEnEspecie10
- VirtualXML_SetPagoEnEspecie10
CFDI.Complemento.PFIntegranteCoordinado10
CFDI.Complemento.TuristaPasajeroExtranjero10
- VirtualXML_SetTuristaPasajeroExtranjero10
CFDI.Complemento.ValesDeDespensa10
VirtualXML_SetValesDeDespensa10
VirtualXML_ValesDeDespensa10AddConcepto (Usar antes SetValesDeDespensa10)
CFDI.Complemento.Detallista10
VirtualXML_SetDetallista10
- 01 A_documentStatus
- 02 E_requestForPaymentIdentification_entityType
- 03 E_orderIdentification_referenceIdentification
- 04 E_orderIdentification_ReferenceDate
- 05 A_AdditionalInformationReferenceIdentification_type
- 06 E_AdditionalInformationReferenceIdentification_referenceIdentification
- 07 E_buyer_gln
- 08 E_buyerContactInformationPersonOrDepartmentName_text
- 09 E_seller_gln
- 10 A_seller_alternatePartyIdentificationType
- 11 E_seller_alternatePartyIdentification
- 12 E_shipTo_gln
- 13 E_shipTo_nameAndAddressName
- 14 E_shipTo_nameAndAddressStreetAddressOne
- 15 E_shipTo_nameAndAddressCity
- 16 E_shipTo_nameAndAddressPostalCode
- 17 E_InvoiceCreator_gln
- 18 A_InvoiceCreator_alternatePartyIdentificationType
- 19 E_InvoiceCreator_alternatePartyIdentification
- 20 E_InvoiceCreator_nameAndAddressName
- 21 E_InvoiceCreator_nameAndAddressStreetAddressOne
- 22 E_InvoiceCreator_nameAndAddressCity
- 23 E_InvoiceCreator_nameAndAddressPostalCode
- 24 A_paymentTerms_paymentTermsEvent
- 25 A_paymentTerms_PaymentTermsRelationTime
- 26 A_paymentTerms_netPaymentNetPaymentTermsType
- 27 A_paymentTerms_netPaymentTimePeriod
- 28 E_paymentTerms_netPaymentValue
- 29 A_paymentTerms_discountPaymentDiscountType
- 30 E_paymentTerms_discountPaymentPercentage
- 31 E_totalAmount_Amount
VirtualXML_Detallista10AddOrderIdentificationReferenceIdentification (Usar antes SetDetallista10)
- 01 E_orderIdentification_referenceIdentification
VirtualXML_Detallista10AddAdditionalInformationReferenceIdentification (Usar antes SetDetallista10)
VirtualXML_Detallista10AddSpecialInstruction (Usar antes SetDetallista10)
VirtualXML_Detallista10AddDeliveryNote (Usar antes SetDetallista10)
- 01 E_ReferenceDate
- 02 E_referenceIdentification01
- 03 E_referenceIdentification02
- 04 E_referenceIdentification03
- 05 E_referenceIdentification04
- 06 E_referenceIdentification05
- 07 E_referenceIdentification06
- 08 E_referenceIdentification07
- 09 E_referenceIdentification08
- 10 E_referenceIdentification09
- 11 E_referenceIdentification10
- 12 E_referenceIdentification11
- 13 E_referenceIdentification12
- 14 E_referenceIdentification13
- 15 E_referenceIdentification14
- 16 E_referenceIdentification15
- 17 E_referenceIdentification16
- 18 E_referenceIdentification17
- 19 E_referenceIdentification18
- 20 E_referenceIdentification19
- 21 E_referenceIdentification20
VirtualXML_Detallista10AddCustoms (Usar antes SetDetallista10)
- 01 E_gln
VirtualXML_Detallista10AddCurrency (Usar antes SetDetallista10)
VirtualXML_Detallista10AddShipmentDetail (Usar antes SetDetallista10)
- 01 E_shipmentDetail
VirtualXML_Detallista10AddAllowanceCharge (Usar antes SetDetallista10)
VirtualXML_Detallista10AddTotalAllowanceCharge (Usar antes SetDetallista10)
VirtualXML_Detallista10AddLineItem (Usar antes SetDetallista10)
- 01 A_type
- 02 A_number
- 03 E_tradeItemIdentification_gtin
- 04 A_tradeItemDescriptionInformation_language
- 05 E_tradeItemDescriptionInformation_longText
- 06 A_invoicedQuantity_unitOfMeasure
- 07 E_invoicedQuantity_invoicedQuantity
- 08 E_grossPrice_Amount
- 09 E_netPrice_Amount
- 10 A_AdditionalInformation_type
- 11 E_AdditionalInformation_referenceIdentification
- 12 A_LogisticUnits_type
- 13 E_LogisticUnits_serialShippingContainerCode
- 14 E_palletInformation_palletQuantity
- 15 A_palletInformation_type
- 16 E_palletInformation_description
- 17 E_palletInformation_methodOfPayment
- 18 E_totalLineAmount_grossAmount
- 19 E_totalLineAmount_netAmount
VirtualXML_Detallista10AddLineItemAlternateTradeItemIdentification (Usar antes Detallista10AddLineItem)
VirtualXML_Detallista10AddLineItemAditionalQuantity (Usar antes Detallista10AddLineItem)
VirtualXML_Detallista10AddLineItemCustoms (Usar antes Detallista10AddLineItem)
VirtualXML_Detallista10AddLineItemExtendedAttributes (Usar antes Detallista10AddLineItem)
VirtualXML_Detallista10AddLineItemAllowanceCharge (Usar antes Detallista10AddLineItem)
VirtualXML_Detallista10AddLineItemTradeItemTaxInformation (Usar antes Detallista10AddLineItem)
CFDI.Especiales
VirtualXML_AddComplemento
- 01 fragmentoXML (Debe ser válido e incluir los namespaces que pudiera utilizar)
VirtualXML_AddComplementoConcepto
- 01 fragmentoXML (Debe ser válido e incluir los namespaces que pudiera utilizar)
VirtualXML_AddNameSpace Agrega un namespace al nodo principal XML del CFDI.
Ejemplos
Solicitud de Cancelación
const VirtualXML = require('virtualxml-cfdi');
let vxml = new VirtualXML();
let ts = Date.now() - (new Date().getTimezoneOffset()) * 60000; // GMT-6
vxml.cancelaCFDI2022("demo_nodejs", // usuario VirtualPAC
"EKU9003173C9", // rfcemisor
"163feb31-9c01-40f0-b85b-ebe1c771da1f", // UUID
"02", // Motivo
"", // folioSustitucion
"./test/CSD_EKU9003173C9.cer", // CER
"./test/CSD_EKU9003173C9.key", // KEY
"12345678a", // usuario PWD
"./test/out/", // ruta para guardar acuse generado
"prefijo", // prefijo de archivo para acuse generado
"cancelacion") // sufijo de archivo para acuse generado
.then((response) => {
// Handle Response
}).catch((err) => {
// Handle Error
});
CFDI40 Sin Complemento
const VirtualXML = require('virtualxml-cfdi');
let vxml = new VirtualXML();
let ts = Date.now() - (new Date().getTimezoneOffset()) * 60000; // GMT-6
let FechaCFDI = (new Date(ts)).toISOString().substring(0, 19); // Fecha formato 2018-03-29T14:22:10
vxml.addFunctionCall('VirtualXML_SetComprobanteInfo_cfdi40', 'A', '1', FechaCFDI, '99', 'Contado Comercial', '1000.00', '50.00', 'MXN', '', '1102.00', 'I', 'PPD', '53050', '', '01');
vxml.addFunctionCall('VirtualXML_AddCfdiRelacionados_cfdi40', '04', 'FF93C8BE-AF7B-4FC5-8854-6DAE18CFB5B4', 'D8E18C2F-2859-4927-A0F0-EA3E93642DDC', '', '', '', '', '', '', '', '');
vxml.addFunctionCall('VirtualXML_AddCfdiRelacionado_cfdi40', 'BE1D4B47-E167-47A3-8049-70D4D43BCBE8');
vxml.addFunctionCall('VirtualXML_AddCfdiRelacionados_cfdi40', '01', 'FDBA380A-9732-4FB5-A6CB-5FB4BD831697', '', '', '', '', '', '', '', '', '');
vxml.addFunctionCall('VirtualXML_SetEmisorInfo_cfdi40', 'EKU9003173C9', 'ESCUELA KEMPER URGATE SA DE CV', '601', '');
vxml.addFunctionCall('VirtualXML_SetReceptorInfo_cfdi40', 'CTE940531F58', 'CIBERNETICA Y TECNOLOGIA SA DE CV', '', '', 'G01', '53050', '601');
vxml.addFunctionCall('VirtualXML_AddConcepto_cfdi40', '84111506', 'SEFXXX', '1', 'H87', 'Unidad', 'Paquete X - ObjetoImp2', '500.00', '500.00', '', '02');
vxml.addFunctionCall('VirtualXML_AddConceptoTraslado_cfdi40', '500.00', '002', 'Tasa', '0.160000', '80.00');
vxml.addFunctionCall('VirtualXML_AddConcepto_cfdi40', '84111506', 'SEFXXX', '2', 'H87', 'Unidad', 'Paquete X - ObjetoImp2', '250.00', '500.00',