VirtualXML incluye en su conjunto de funciones, 6 funciones especializadas para realizar algunas operaciones que, hasta el día de hoy, solo podían realizarse directamente en el portal administrativo VirtualPAC.
Estas funciones componen el API (Application Program Interface) de VirtualPAC y su objetivo principal es que puedas automatizar algunas funciones del portal desde tus propios programas.
Por ejemplo, puedes hacer versiones de tus programas que puedan empezar a timbrar inmediatamente después de intalarse, sin necesidad de que tengas que dar de alta los datos del nuevo emisor en el portal o asignarles timbres de forma manual.
¿ Por donde empiezo ?
Lo primero que tienes que hacer para comenzar a utilizar las funciones del API de VirtualPAC, es un proceso que debes realizar manualmente por motivos de seguridad y que es generar un "API KEY".
Este API KEY es una clave alfanumérica
que deberás generar manualmente desde el portal VirtualPAC, para ello,
deberás ingresar al portal VirtualPAC con tu usuario y contraseña y
deberás seleccionar con un click del ratón tu nombre de usuario en la
parte superior de la ventana del portal:
Esto te
llevará a nueva ventana donde además de visualizar tus datos de
distribuidor, podrás generar tu API
KEY.
Para generar tu API KEY, deberás presionar el botón de engrane que se encuenta en la sección API Administrativa, al final de la página, como se muestra en la siguiente imagen:
Presionando este botón, generarás tu API KEY, que es una cadena de 43 caracteres de longitud irrepetible y que únicamente funciona en combinación con tu nombre de usuario VirtualPAC, no se puede utilizar con ningún RFC emisor o clave de distribuidor distinta a la tuya, una vez que presiones el engrane tendrás tu API KEY generado y deberás usarlo en todas las llamadas a las funciones del API de VirtualPAC.
Si tienes
DISTRIBUIDORES dados de alta en tu usuario, cada distribuidor deberá
generar su propia API KEY individualmente desde el portal administativo
VirtualPAC.
Para tu seguridad este API KEY lo puedes generar tantas veces como desees y será válido mientras NO GENERES UN API KEY NUEVO.
Esto lo hacemos para darte mayor seguridad en el uso de las funciones, ya que si tu detectas algún uso indebido de las funciones del API con tu nombre de usuario, puedes generar un nuevo API KEY, y automaticamente el API KEY anterior se destruye y ya no puede hacer uso de las funciones del API.
¿ Que puedo hacer con las funciones del API de VirtualPAC ?
El API de VirtualPAC soporta 6 funcionalidades que son las que mas frecuentemente utilizas en el portal y que son:
- Alta de RFC de nuevos emisores VirtualXML_ApiEmisorAdd()
- Modificación de los datos de los emisores que ya tengas dados de
alta. VirtualXML_ApiEmisorUpd()
- Asignación de timbres a emisores. VirtualXML_ApiEmisorAsigna()
- Alta de nuevos Distribuidores. VirtualXML_ApiUsuarioAdd()
- Modificación de datos de los distribuidores existentes VirtualXML_ApiUsuarioUpd()
- Creación / Modificación de reglas de AutoAsignación de timbres a
emisores. VirtualXML_ApiEmisorAutoasignacion()