LibPyAfipWs: Biblioteca DLL/.so para acceder a Servicios Web de la AFIP/ANMAT/etc


Biblioteca compartida multiplataforma para Emisión y almacenamiento electrónico de comprobantes originales AFIP - Argentina. AFIP RG 1956/05, 1361/02, 1345/02, 2265/07, 2289/07, 2485/08, 2557/09, 2668/09, 2758/10, 2853/10, 2904/10, 2959/10, 2974/10, 3066/11, 3067/11, 3210/11, 3419/12 (servicios web de Factura Electrónica, Trazabilidad y Liquidación de Granos, Consultas de Operaciones cambiarías y otros) Código de Operaciones de Translado (Remito Electrónico). Ley Provincial 13.405. Normativas 34/2011 y 45/2011 ARBA. Programa Nacional de Trazabilidad de Medicamentos. Resolución 435/2011 del Ministerio de Salud y Disposición 3683/2011 de ANMAT.

Para otros productos (herramientas, aplicativos, generación de PDF, etc.) ver el menú lateral.

logo-pyafipws.png

Índice

  1. Índice
  2. Introducción
  3. Funciones exportadas
  4. Ejemplos
  5. Licencia
  6. Características
  7. Contacto

Introducción

LibPyAfipWs es una biblioteca de software libre a los Servicios Web de la AFIP, desarrollado en Python compatible con C, C++, C#, Visual Basic, Visual Fox Pro, Cobol, Delphi, .Net, Java, etc. y cualquier lenguaje/aplicación que pueda crear utilizar bibliotecas compartidas de enlace dinámico  DLL en Windows o .SO en linux.

La biblioteca utiliza interfaces y librerías que han sido inspirados en los ejemplos de la AFIP y han sido probadas con éxito por varias empresas.

Actualmente implementa el WebService de Autenticación (WSAA) y métodos de Factura Electrónica (emisión electrónica de comprobantes originales), proximamente se incluirán más webservices y métodos.

Funciones exportadas

Funciones genéricas (similares a C.O.M. para crear y acceder internamente a los objetos python):

  • void * PYAFIPWS_CreateObject(char *module, char *name): instanciar un objeto para acceder a sus métodos y atributos
  • void PYAFIPWS_DestroyObject(void *object): destruir el objeto
  • char * PYAFIPWS_Get(void *object, char *name): obtener el valor de un atributo de un objeto
  • bool PYAFIPWS_Set(void * object, char * name, char * value): establecer el valor de un atributo de un objeto
  • void PYAFIPWS_Free(char *psz): liberar recursos de valores devueltos por la librería

Autenticación y Auotrización (WSAA):

  • char * WSAA_CreateTRA(char *service, long ttl): generar un ticket de requerimiento de acceso
  • char * WSAA_SignTRA(char *tra, char *cert, char *privatekey): firmar digitalmente el requerimiento
  • char * WSAA_LoginCMS(char *cms): solicitar un ticket de acceso

Factura electrónica (WSFEv1):

  • bool WSFEv1_Conectar(void *object, char *cache, char *wsdl, char *proxy): conectar al webservice
  • bool WSFEv1_Dummy(void *object): obtener estados de los servidores
  • bool WSFEv1_SetTicketAcceso(void *object, char *ta): establecer el ticket de acceso (token y sign)
  • long WSFEv1_CompUltimoAutorizado(void *object, char *tipo_cbte, char *punto_vta): obtener el último número de comprobante autorizado.

Proximamente se adicionarán más funciones. Para una descripción completa de los métodos y su funcionamiento, ver ManualPyAfipWs.

Importante: las declaraciones de las funciones han sido simplificadas, ver  libpyafipws.h para el encabezado completo

Notas para Windows:

  • Las funciones están exportadas usando __stdcall (la convención de llamadas estandar que usa Pascal y VB por ej.).
  • Los strings son  BSTR (OleAutomation) para soportar temas de encodings y compatibilidad con lenguajes como VB, VFP, etc.. En C, C++, C#, también pueden ser tratados como char * (Ansi).

Recordar liberar la memoria alojada para los string que devuelve con PYAFIPWS_Free.

Ejemplos

Ejemplo básico en C: 


#include "libpyafipws.h"

int main(int argc, char *argv[]) {
  BSTR tra, cms, ta;
  void *wsfev1;
  BSTR ret;
  bool ok;
  long nro;

  /* Generar ticket de requerimiento de acceso */
  tra = WSAA_CreateTRA("wsfe", 999);
  printf("TRA:\n%s\n", tra);
  /* Firmar criptograficamente el mensaje */
  cms = WSAA_SignTRA((char*) tra, "reingart.crt", "reingart.key");
  printf("CMS:\n%s\n", cms);  
  /* Llamar al webservice y obtener el ticket de acceso */
  ta = WSAA_LoginCMS((char*) cms);
  printf("TA:\n%s\n", ta);

  /* Crear una objeto WSFEv1 (interfaz webservice factura electronica) */
  wsfev1 = PYAFIPWS_CreateObject("wsfev1", "WSFEv1");
  printf("crear wsfev1: %p\n", wsfev1);    /* si funcionó ok, no debe ser NULL! */  
  
  /* conectar al webservice (para produccion cambiar URL) */
  ok = WSFEv1_Conectar(wsfev1, "", "", "");
  printf("concetar: %s\n", ok ? "true" : "false");
  
  /* obtener datos genericos de la interfaz (version y ruta de instalación) */
  ret = PYAFIPWS_Get(wsfev1, "Version");
  printf("wsfev1 Version: %s\n", ret);
  free(ret);
  ret = PYAFIPWS_Get(wsfev1, "InstallDir");
  printf("wsfev1 InstallDir: %s\n", ret);
  free(ret);
  
  /* obtener el estado de los servidores (llama al ws) */
  ok = WSFEv1_Dummy(wsfev1);
  printf("llamar a dummy: %s\n", ok ? "true" : "false");
  /* obtener los atributos devueltos por AFIP */
  ret = PYAFIPWS_Get(wsfev1, "AppServerStatus");
  printf("dummy AppServerStatus: %s\n", ret);
  free(ret);
  ret = PYAFIPWS_Get(wsfev1, "DbServerStatus");
  printf("dummy DbServerStatus: %s\n", ret);
  free(ret);
  ret = PYAFIPWS_Get(wsfev1, "AuthServerStatus");
  printf("dummy AuthServerStatus: %s\n", ret);
  free(ret);

  /* establezco los datos para operar el webservice */
  ok = PYAFIPWS_Set(wsfev1, "Cuit", "20267565393");
  ok = WSFEv1_SetTicketAcceso(wsfev1, (char*) ta);  /* devuelto por WSAA_LoginCMS */

  /* obtengo el ultimo numero de comprobante generado */
  nro = WSFEv1_CompUltimoAutorizado(wsfev1, "1", "1");
  printf("ultimo comprobante: %ld\n", nro);

  /* destruir el objeto */
  PYAFIPWS_DestroyObject(wsfev1);  

  /* liberar la memoria adquirida para los valores devueltos de WSAA */
  PYAFIPWS_Free(ta);
  PYAFIPWS_Free(cms);
  PYAFIPWS_Free(tra);

}

Ver DllFacturaElectronica para más ejemplos (incluyendo LoadLibrary, GetProcAddress, DECLARE en VFP y Declare en VB)

Licencia

El código fuente puede ser descargado y utilizado sin cargo (gratis) respentando la licencia  GPLv3 de software libre: sin garantías, sin soporte técnico dedicado y/o obligatorio, informar copyright, no incorporarlo ni distribuirlo junto con software propietario, mantener derivados como software libre y contribuir modificaciones, etc.

Se ofrece instalación y soporte técnico comercial pago, incluyendo atención prioritaria y autorización especial para incorporar y distribuir esta interfaz a sistemas propietarios que no sean software libre.

A su vez, al ser software libre de código abierto, permite proteger su inversión, al no depender de un componente cerrado del cual no puede tener acceso al código fuente, revisar su funcionamiento, realizar futuras actualizaciones, etc.

Por consultas sobre el lenguaje python y demás, dirigirse a  PyAr. Para más información ver FacturaElectronica.

Consultar por desarrollos especiales, interfaces web, etc.

Características

  • DLL directa (online) de simple uso: autenticación y obtención de CAE en pocas líneas!
  • No usa archivos temporales ni formatos especiales
  • No usa servidores intermedios (conexión directa con WS de AFIP)
  • No requiere programas residentes o batch (por lotes)
  • No es necesario tener conocimientos de encriptación ni protocolos web
  • Autoinstalable 2.5MB (Todo en uno)
  • Sin dependencias ni librerias o runtimes externas (Php, .Net o Java)
  • Sin licencia de uso propietarias ni límites por cada usuario final
  • Código abierto: archivos fuentes publicados, revisados y modificables (Software Libre)
  • Sin problemas de instalación de OCX ni ActiveX (ver comparativa)
  • No requiere formularios visuales

Contacto

Para mayor información, consultar por mail a  facturaelectronica@sistemasagiles.com.ar o telefónicamente al 15-3048-9211

Para soporte sin cargo de la comunidad, revisar la  lista de temas y/o  crear uno nuevo. Por novedades y consultas genereales, puede usar el  Google Groups (Foro Público). Código fuente en  GitHub.

PyAfipWs Copyright 2008, 2009, 2010, 2011, 2012, 2013 por MarianoReingart PyAfipWs Copyright 2008, 2009, 2010, 2011, 2012, 2013 por MarianoReingart