Función VirtualXML_ApiEmisorAutoasignacion VirtualXML
Establece una nueva regla de Autoasignación para un emisor.

El sistema de Autoasignación de VirtualPAC te permite asignar timbres automáticamente a un emisor cuando su consumo llega a cierto límite, esto evita que el emisor se quede sin timbres y te ahorra tener que entrar al portal para asignarle timbres, estos es particularmente útil cuando no tienes a mano algún dispositivo que te permita acceder al portal VirtualPAC.

Las Autoasignaciones se establecen por medio de "reglas", estas reglas indican el limite inferior de timbres, cuando el emisor llega a esta cantidad, se le asginan automaticamente una cantidad de timbres determinada por tí, hasta llegar a cierto límite superior (también establecidor por tí), cuando este límite se alcanza, debes actualizar la regla desde el portal VirtualPAC, recibirás un correo electrónico indicandote que debes actualizar la regla en el portal.

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



Note que únicamente se puede crear una regla por medio de esta función, si desea modificarla, deberá hacerlo directamente en el portal VirtualPAC.

Namespace:
 VirtualXML®
Aplicación: API VirtualXML
Sintaxis

public static int VirtualXML_ApiEmisorAutoasignacion(
string apiKey,
string usuario,
string rfcemisor,
int asignacion,
int threshold,
int limit,
string active,
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 emisor, que debe haber sido dado de alta con anterioridad, ya sea por medio de funciones o bien manualmente desde el portal VirtualPAC.

asignacion
Tipo: System  Int
Cantidad de timbres asignar cuando el consumo del emisor alcance el límite establecido. Es el equivalente de este campo:

threshold
Tipo: System  Int
Establece el límite inferior, que una vez alcanzado, asignará la cantidad de timbres indicada en el parámetro asignacion. Por ejemplo, asignar 100 timbres cuando el consumo alcance 5 timbres. Es el equivalente de este campo:

limit
Tipo: System  Int
Establece la cantidad maxima de timbres a asignar. Por ejemplo, asignar 100 timbres, cuando el consumo alcance 5, hasta un máximo de 500 timbres. Es el equivalente de este campo:

active
Tipo: System  Int
Valor numerico que indica si la regla debe estar activa al momento de crearla. Valores permitidos 1 = regla activa / 0 = regla inactiva. También es posible activar/desactivar reglas desde el portal VirtualPAC. Es el equivalente de este campo:

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_ApiEmisorAutoasignacion("8kp__cUyyV8D0dgmVUvH_jgejPnSCeRerwM4JU98ZE3x8",

omprobante 
    int hXml = VirtualXML_ApiEmisorAutoasignacion("8kp__cUyyV8D0dgmVUvH_jgejPnSCeRerwM4JU98ZE3x8",

"UsuarioVirtual",
"FOLR670417KT4",

100,
5,
500,
"BitacoraAPI.log");
}
Vease Tambien