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

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
)

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

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"
);


}
Vease Tambien