VirtualXML_ApiEmisorAdd

Función VirtualXML_ApiEmisorAdd

VirtualXML

Agrega un emisor nuevo en el listado de un distribuidor.

Esta función permite añadir un nuevo emisor (RFC) a un distribuidor y al mismo tiempo asignarle información adicional al emisor como su Clave de consulta, razón social o email de contacto, también permite hacer una asginación inicial de timbres, activar las notificaciones o bien suspender el servicio de timbrado para un emisor.

Su equivalente en el portal de administración de timbres VirtualPAC es esta pantalla:

Note que únicamente se puede asignar la Clave de Consulta, si se requiere asignar claves de emisión o cancelación, deberá hacerse directamente en el portal VirtualPAC.

Namespace: VirtualXML®
Aplicación: API VirtualXML

Sintaxis

C++

Copiar en el Portapapeles Imprimir

public static int VirtualXML_ApiEmisorAdd(
	string apiKey,
	string usuario,
	string rfcemisor,
	string pwdconsulta,
	string razonsocial,
	string email,
	string contacto,
	   int asignacion,
	   int suspendido,
	   int notificacion,
	string outLog,
	string reserved
)

public static void VirtualXML_AddConcepto(
	int p,
	string cantidad,
	string unidad,
	string descripcion,
	string valorUnitario,
	string importe,
	string noIdentificacion
)

Parametros

apiKey: Tipo: System String
Clave de acceso a funcionalidades administrativas.

usuario

Tipo: System String
Clave de usuario VirtualPAC, es decir, la clave con la que te identificas en el portal VirtualPAC.

rfcemisor: Tipo: System String
RFC del NUEVO emisor, no debe haber sido dado de alta con anterioridad, si desea modificar algun atributo de un RFC dado de alta anteriormente, utilice la función VirtualXML_ApiEmisorUpd(). Es el equivalente de este campo:

pwdconsulta

Tipo: System String
Clave de consulta (password) que el emisor podrá utilizar para consultar sus timbres emitidos por VirtualPAC, en el portal de consultas https://www.virtual-pac.mx/consultas . El usuario para este portal es el RFC del emisor y la contraseña será la que se indique en este parámetro. Es el equivalente de este campo:

razonsocial: Tipo: System String
Nombre / Razón social del nuevo emisor. Es el equivalente de este campo:

email: Tipo: System String
Dirección de correo electrónico para enviar notificaciones del sistema sobre el consumo de timbres (nivel bajo de timbres o timbres agotados). Es el equivalente de este campo:

contacto: Tipo: System String
Nombre de la persona de contacto del emisor. Es el equivalente de este campo:

asignacion: Tipo: System Int
Valor numérico para indicar una asignación inicial de timbres. Este es un valor para una carga inicial de timbres a un emisor, si posteriormente desea agregar mas timbres mediante funciones del API deberá utilizar la funcion VirtualXML_ApiEmisoAsigna().

suspendido: Tipo: System Int; Valor numérico que se utiliza para indicar si al momento de dar de alta un nuevo emisor este debe de aparecer como SUSPENDIO. Sus valores posibles 1 = emisor SUSPENDIDO, 0 = emisor ACTIVO. Es el equivalente de este campo:

notificacion

Tipo: System Int; Valor numérico que se utiliza para indicar si las notificaciones referentes al consumo de timbres están activadas, si se activan, se enviará un correo electrónico al emisor cuando que queden 100, 10 o 1 timbre disponible. Sus valores posibles 1 = notificaciones ACTIVAS, 0 = notificaciones INACTIVAS.

outlog

Tipo: System String
Nombre del archivo donde se guardará la bitácora resultado del proceso de alta de nuevo emisor.

reserved: Tipo: System String
Reservado para usos futuros.

Valor retornado:

Tipo: Int32

Retorna un valor númerico que si es = 0, indica que la función se ejecutó con éxito. Si devuelve cualquier otro valor, esto indica que hubo un error en la ejecución de la función y deberá revisar el archivo de bitácora para revisar el error obtenido.

Ejemplo

Copiar en el Portapapeles Imprimir

private void NuevoEmisor()
{
    // Creamos un comprobante 
    int hXml = VirtualXML_ApiEmisorAdd("8kp__cUyyV8D0dgmVUvH_jgejPnSCeRerwM4JU98ZE3x8",
				       "UsuarioVirtual",
				       "FOLR670417KT4",
				       "RAMON FONSECA LINARES",
				       "rfonseca@ghot.com",
				       "Ramon Fonseca",
					100,
					0,
					1,
					"BitacoraAPI.log");

    
}

private void GeneraDocto(String version)
{
    // Creamos un comprobante 
    int hXml = VirtualXML_New(version);

    // Llenado del documento 

    // Datos del emisor 

    // Datos del receptor 

    // Conceptos 
    // Aqui va un bucle de conceptos, aqui vamos a poner un for para agregar 5 conceptos 
    for ( int i = 0; i < 5; i++)
    {
        VirtualXML_AddConcepto( hXml, i.ToString(), "PZAS", "Descripcion", "1000", ( i * 1000 ).ToString(), "" );
    }

    // Procesamiento del documento 
    // .... 

    // Lectura de resultados 
    // .... 

    // Liberacion de memoria
    VirtualXML_Free(hXml);
}

Vease Tambien

VirtualXML® Class

VirtualXML® Namespace