CODIGO: PR-M-01 VERSION: 01

MANUAL DE USO ACEPTASDK (DLL) 1.RESUMEN EJECUTIVO

Una alternativa ptima de interconexin entre un ERP que opere en SO Windows y la solucin de factura electrnica de Acepta.com, es el AceptaSDK o DLL. En la prctica, es necesario intervenir el ERP, para que ejecute bsicamente 2 mtodos, uno que enva (Send) la informacin al Servicio de Factura Electrnica CA4XML_Service y otro que obtiene la respuesta o resultado de la operacin (GetLastResponse).

2.-

IMPLEMENTACIN

Para ejemplificar mejor el uso de los mtodos de la DLL, se utilizar cdigo basado en la herramienta de desarrollo Visual Basic.

2.1.- Registro de la DLL

Se provee de 2 dll: ca4xml_client.dll y AceptaTools.dll. El primer paso consiste en registrar la DLL AceptaTools.dll que permite la interaccin entre el servicio CA4XML_Service y la aplicacin del ERP. Para esto debe copiar en el directorio C:\Windows\System32 los archivos AceptaTools.dll y ca4xml_client.dll. Una vez copiados los archivos, debe ir a Inicio -> Ejecutar, escribir cmd y presionar enter para obtener acceso a la ventana de smbolo de sistema (DOS). En esta ventana debemos escribir la siguiente instruccin: regsvr32 AceptaTools.dll. De este modo, la DLL quedar registrada en Windows para ser usada por las aplicaciones que la requieran. No es necesario registrar ca4xml_client.dll ya que AceptaTools.dll realiza la interaccin necesaria con sta.

2.2.- Agregar referencia a (registrar) la DLL en el cdigo fuente del ERP

Para el ejemplo, se asumir que el ERP est desarrollado en Visual Basic. Por lo tanto, ingrese al proyecto de Visual Basic y valla al men Preferencias -> Referencias. Busque la referencia AceptaTools Library, sta debe ser chequeada y luego se debe aceptar. Con esto ya es posible hacer uso de los mtodos de la DLL.

2.3.- Descripcin de los mtodos usados y parmetros

La interaccin del sistema es muy simple y se puede ver en el cdigo de ejemplo, al final del documento.

CODIGO: PR-M-01 VERSION: 01

2.3.1.- Mtodo Send: Envo de informacin

USO: CA4XML.Send(VAR_ARCHIVO_CONFIGURACION,VAR_ID_DOCUMENTO, VAR_COMANDO, VAR_PARAMETROS, VAR_DATA, "") VAR_ARCHIVO_CONFIGURACION: Esta variable corresponde al archivo que indica los puertos donde Ca4xml_Service escuchar las llamadas de la DLL, la IP del servidor donde se encuentra el servicio instalado y el tiempo de espera mximo antes de indicar un fallo. En caso de no querer referenciar a un archivo, es posible entregar los parmetros de conexin a travs de la misma variable utilizando la siguiente sintaxis: cfg|IP|PUERTO|TIEMPO_ESPERA. Por ejemplo: cfg|127.0.0.1|5001|10000. Nota: El tiempo de espera se mide en milisegundos. VAR_ID_DOCUMENTO: Esta variable indica el nombre base que tendrn los archivos generados. Por ejemplo, se recomienda utilizar el cdigo del tipo de documento y el folio. Ej.: 331234, donde 33 indica el tipo de DTE que se emiti y 1234 indica el nmero de documento. VAR_COMANDO: Esta variable corresponde al comando de Ca4xml_Service que se ejecutar. Para realizar pruebas debe ser usar el comando test. Otro ejemplo es el comando enviar que publicar el documento en Acepta.com. VAR_PARAMETROS: Indica el nombre de la impresora y la cantidad de copias a imprimir. Debe ser escrito como String separando el nombre de la impresora de la cantidad de copias por una coma de la siguiente forma; NombreImpresora, 2 donde el numero 2 indica que se imprimirn 2 copias del documento. VAR_DATA: Esta variable es de tipo string. Corresponde a los datos que debe interpretar Ca4xml_Service, para generar un DTE vlido.

2.3.2.- Mtodo GetLastResponse: Respuesta de la DLL

El sistema recibir una respuesta que puede ser conocida usando el mtodo CA4XML.GetLastResponse. Donde, si la respuesta es exitosa se obtiene un string, que incluye una URL con la direccin custodia o almacenamiento del documento enviado y por lo tanto su ubicacin en internet. En caso de error, se obtiene el mensaje de error. Es importante conocer la configuracin de Ca4xml_Service para saber que otra informacin se incluir en la respuesta, dado que esto es totalmente configurable.

CODIGO: PR-M-01 VERSION: 01

2.4.- Ejemplo de interaccin entre VB6 y la DLL

Dim CA4XML As CA4XML_Client Dim resultadoGeneracionDTE As Integer Dim respuestaDeDte As String

Set CA4XML = New AceptaTools.CA4XML_Client

resultadoGeneracionDTE = CA4XML.Send(VAR_ARCHIVO_CONFIGURACION, _ VAR_ID_DOCUMENTO, VAR_COMANDO, VAR_PARAMETROS, VAR_DATA, "")

respuestaDeDte = CA4XML.GetLastResponse

If resultadoGeneracionDTE = 1 Then MsgBox "Documento Generado con xito" + vbNewLine _ + CA4XML.GetLastResponse, vbOKOnly Else MsgBox "Fallo en la Generacin del DTE:" + vbNewLine _ + CA4XML.GetLastResponse, vbOKOnly + vbCritical End If

Nota: Los mensajes en este cdigo son slo para visualizar la respuesta del sistema. Es necesario analizar cmo usar estas respuestas en el ERP.