Proyecto Factura Electrónica Versión 1 (RG2485/RG2904)
Factura Electrónica y Servicios Web AFIP, ARBA y ANMAT
- PyAfipWs: Interfase con otros lenguajes (VB, VFP, Cobol ...) Costos y Condiciones
- Manual: Documentación, Información Importante, Certificados, Errores Frecuentes
- Interfaz simil SIAP/RECE: archivos de texto ("Cobol") o DBF (dBase, FoxPro, ...)
- PyFEPDF: Generador de facturas en formato PDF
- Factura Electrónica en Python: Información Técnica (SOAP, XML)
- Bonos Fiscales Electrónicos: Bienes de Capital (RG2557)
- Factura Electrónica Exportación: Exportadores (RG2758)
- Factura Electrónica MTX: Mercado Interno (RG2904)
- Proyecto Factura Electrónica Versión 1: Mercado Interno (RG2904, RG2757)
- Código de Autorización Electrónico Anticipado: CAEA (RG2926, RG2904)
- Código Trazabilidad de Granos: Transporte de granos (RG2806)
- Código de Operaciones de Translado: COT Remito Electronico (ARBA) ¡Nuevo!
- Consulta de Operaciones Cambiarias: Compra de Divisas (WSCOC) ¡Nuevo!
- Trazabilidad de Medicamentos: ANMAT Disposición 3683/2011 ¡Nuevo!
- PyRece: Aplicativo simil SIAP - RECE (CSV, PDF, Email) Costos y Condiciones
- FE.py: Herramienta universal, unificada e integrada
- FacturaLibre: Aplicacion online (web2py)
Interfaz para Servicio Web correspondiente a Factura Electrónica de Mercado Interno para el régimen especial los Sujetos notificados de su incorporación al Régimen de emisión y almacenamiento electrónico de comprobantes originales previstos originalmente en la RG 2757/2010, modificada por RG 2904/2010 (Artículo 4 opción "b) Factura electrónica según Resolución General Nº 2485, sus modificatorias y complementarias, y Régimen de Información de operaciones dispuesto en el Capítulo G ")
Índice
Descripción General
EL WSFEv1 (Web Service de Factura Electrónica Versión 1) es un nuevo Servicio Web de la AFIP para el Régimen especial para la emisión y almacenamiento electrónico de comprobantes originales que respalden las operaciones de compraventa de cosas muebles, locaciones y prestaciones de servicios, locaciones de cosas y de obras y de las señas o anticipos que congelen precios, efectuadas en el mercado interno. (RG2485), correspondiente a la Resolución Resolución General 2904/2010 Art.4 Opción B, próxima a entrar en vigencia:
- 27 de Octubre de 2010: Autoimpresores - CAE Anticipado RG2926
- 1 de Noviembre de 2010: Sujetos notificados RG2904
- 1 de Abril de 2011: Importadores RG2975 (opcional a partir de 1 de Enero de 2011)
- 1 de Julio de 2011: Obligatorio para todas las actividades y sujetos comprendidos en la RG2845 (reemplaza WSFE versión 0)
NOTA: La notificación es mediante nota cursada por Juez Administrativo (RG2904)
Este nuevo webservice contempla las operaciones de mercado interno (Facturas A y B) y CAE Anticipado.
NOTA: Ver WSMTXCA (webservice v0, Opción A).
Estado
La AFIP publicó la información técnica, el servicio WSFEv1 está disponible en homologación para realizar pruebas.
En su momento hemos desarrollado para nuestros clientes, un SIMULADOR que emula los métodos del servicio web, para poder comenzar los desarrollos:
Para esta interfaz, hemos desarrollado nuevas bibliotecas de Cliente/Servidor SOAP y manejo de XML mejorado, mejorando la versión anterior, lo que permitirá mayor flexibilidad, depuración y control de errores. Por este motivo, la interfaz se instalará de forma separada, para evitar inconvenientes, manteniendo la simplicidad y modo de uso actual.
Descargas
Ver archivos y últimas actualizaciones para descargas en GoogleCode:
- Instalador: instalador-WSFEV1-1.08a-homo.exe
- Ejemplo en VB 5/6: wsfev1.bas (última versión de dearrollo)
- Ejemplo en VB .NET: wsfev1.vb (última versión de dearrollo)
- Ejemplo en VFP: wsfev1.prg (última versión de dearrollo)
- Ejemplo en MS Acess/VBA: pyafipws.mdb: WSFEv1 y WSFEX (base de datos MS Access 97 o sup.)
- Manual de Uso: Documentación (PDF)
- Código Fuente (Python): ver archivos publicados en Google Code
Instalación
Está disponible el instalador, simplemente seguir los pasos:
- Aceptar la licencia
- Seleccionar carpeta, por ej C:\WSFEv1
- Instalación y registración automática
Adicionalmente es necesario instalar el instalador instalador-WSAA-2.02c-homo.exe para WSAA (autenticación)
Cambios respecto a WSFE, WSFEX, WSBFE
En este nuevo servicio web WSFEv1, además de los campos requeridos por el WSFE para autorizar una factura (obtener el CAE), se debe informar:
- Concepto: similar al tipo de exportación (WSFEX) / presta_serv (WSFE)
- Moneda (según tabla de parámetros) y cotización de la factura
- Comprobantes Asociados: tipo de comprobante, punto de venta y número, similar a WSFEX
- Tributos: id, descripción, base imponible, alícuota (porcentaje), importe
- IVAs: id (según tabla de parámetros), base imponible, importe, similar a WSBFE
Detallar cada artículo vendido (ítems): esto se removió de la versión 1 (si aplica en Matrix WSMTXCA)- Código del producto
- Descripción completa
- Precio Neto Unitario
- Cantidad
- Unidad de medida (según tabla de parámetros)
- Alicuota de Iva
- Importe total
La operatoria es bastante similar al método de autorización del WSFE, teniendo en cuenta esta mayor complejidad por tener que informar el detalle de cada item y las condiciones de exportación.
NOTA: Este webservice no tiene ID secuencial ni reproceso, por lo que el programa debe implementar la consulta de CAE en caso de errores de comunicación.
A su vez, el WSFEv1 devuelve mensajes de eventos (mantenimiento programado, advertencias, etc.), los que deben ser capturados e informados al usuario.
Para mayor información, se puede consultar la documentación orignal en Manual del WSFEv1 - AFIP o el manual manual de la presente interfaz.
Ejemplo Intefase COM en VB (5/6)
' Crear objeto interface Web Service de Factura Electrónica de Mercado Interno Set WSFEv1 = CreateObject("WSFEv1") Debug.Print WSFEv1.version ' Setear tocken y sing de autorización (pasos previos) WSFEv1.Token = WSAA.Token WSFEv1.Sign = WSAA.Sign ' CUIT del emisor (debe estar registrado en la AFIP) WSFEv1.Cuit = "20267565393" ' Conectar al Servicio Web de Facturación ok = WSFEv1.Conectar() ' homologación ' Llamo a un servicio nulo, para obtener el estado del servidor (opcional) WSFEv1.Dummy Debug.Print "appserver status", WSFEv1.AppServerStatus Debug.Print "dbserver status", WSFEv1.DbServerStatus Debug.Print "authserver status", WSFEv1.AuthServerStatus ' Establezco los valores de la factura a autorizar: tipo_cbte = 1 punto_vta = 1 cbte_nro = 0 fecha = "20101006" concepto = 1 tipo_doc = 80: nro_doc = "23111111113" cbt_desde = cbte_nro + 1: cbt_hasta = cbte_nro + 1 imp_total = "121.00": imp_tot_conc = "0.00": imp_neto = "100.00" imp_iva = "21.00": imp_trib = "0.00": imp_op_ex = "0.00" fecha_cbte = fecha: fecha_venc_pago = fecha ' Fechas del período del servicio facturado (solo si concepto = 1?) fecha_serv_desde = fecha: fecha_serv_hasta = fecha moneda_id = "DOL": moneda_ctz = "3.856" ok = WSFEv1.CrearFactura(concepto, tipo_doc, nro_doc, tipo_cbte, punto_vta, _ cbt_desde, cbt_hasta, imp_total, imp_tot_conc, imp_neto, _ imp_iva, imp_trib, imp_op_ex, fecha_cbte, fecha_venc_pago, _ fecha_serv_desde, fecha_serv_hasta, _ moneda_id, moneda_ctz) ' Agrego los comprobantes asociados: tipo = 19 pto_vta = 2 nro = 1234 ok = WSFEv1.AgregarCmpAsoc(tipo, pto_vta, nro) ' Agrego impuestos varios id = 0 Desc = "Impuesto Municipal Matanza'" base_imp = 150 alic = 5.2 importe = 5.8 ok = WSFEv1.AgregarTributo(id, Desc, base_imp, alic, importe) ' Agrego tasas de IVA id = 5 ' 21% base_im = 100 importe = 21 ok = WSFEv1.AgregarIva(id, base_imp, importe) ' Solicito CAE: cae = WSFEv1.CAESolicitar() Debug.Print "Resultado", WSFEv1.Resultado Debug.Print "CAE", WSFEv1.cae
Nota: La metodología es similar al resto de los webservices, y se trato de mantener similitud con el código existente:
- Método WSFEv1.CrearFactura es similar a WSFE.Authorize (parámetros similares)
- Método WSFEv1.AgregarCmpAsoc es similar a WSFEX.AgregarCmpAsoc
- Propiedades similares: WSFEv1.CAE, WSFEv1.Resultado, etc.
Tablas de Parámetros
Este nuevo servicio funciona con tablas dinámicas de parámetros para los códigos de comprobante, moneda, IVA, tributos, datos opcionales. Estas tablas pueden sufrir modificaciones realizadas por la AFIP, con altas y bajas lógicas, por lo que tienen una fecha de vigencia (desde, hasta) y se proveen métodos para consultarlas por el mismo servicio web (a diferencia del WSFE, que las tablas eran documentadas estaticamentes en el sitio web).
Ver Planilla Anexo Tablas del Sistema (puede estar desactualizado respecto los últimos cambios)
Como ejemplo, a continuación se copian los resultados de invocar a los webservices para consultar las tablas de parámetros al 22/10/2010 (homologación):
Tipos de Comprobante
| 1 | Factura A | 20100917 | NULL |
| 2 | Nota de Débito A | 20100917 | NULL |
| 3 | Nota de Crédito A | 20100917 | NULL |
| 6 | Factura B | 20100917 | NULL |
| 7 | Nota de Débito B | 20100917 | NULL |
| 8 | Nota de Crédito B | 20100917 | NULL |
| 4 | Recibos A | 20100917 | NULL |
| 5 | Notas de Venta al contado A | 20100917 | NULL |
| 9 | Recibos B | 20100917 | NULL |
| 10 | Notas de Venta al contado B | 20100917 | NULL |
| 63 | Liquidacion A | 20100917 | NULL |
| 64 | Liquidacion B | 20100917 | NULL |
| 34 | Cbtes. A del Anexo I, Apartado A,inc.f),R.G.Nro. 1415 | 20100917 | NULL |
| 35 | Cbtes. B del Anexo I,Apartado A,inc. f),R.G. Nro. 1415 | 20100917 | NULL |
| 39 | Otros comprobantes A que cumplan con R.G.Nro. 1415 | 20100917 | NULL |
| 40 | Otros comprobantes B que cumplan con R.G.Nro. 1415 | 20100917 | NULL |
| 60 | Cta de Vta y Liquido prod. A | 20100917 | NULL |
| 61 | Cta de Vta y Liquido prod. B | 20100917 | NULL |
| 11 | Factura C | 20110330 | NULL |
| 12 | Nota de Débito C | 20110330 | NULL |
| 13 | Nota de Crédito C | 20110330 | NULL |
| 15 | Recibo C | 20110330 | NULL |
Tipos de Concepto
| 1 | Producto | 20100917 | NULL |
| 2 | Servicios | 20100917 | NULL |
| 3 | Productos y Servicios | 20100917 | NULL |
Tipos de Documento
| 80 | CUIT | 20080725 | NULL |
| 86 | CUIL | 20080725 | NULL |
| 87 | CDI | 20080725 | NULL |
| 89 | LE | 20080725 | NULL |
| 90 | LC | 20080725 | NULL |
| 91 | CI Extranjera | 20080725 | NULL |
| 92 | en trámite | 20080725 | NULL |
| 93 | Acta Nacimiento | 20080725 | NULL |
| 95 | CI Bs. As. RNP | 20080725 | NULL |
| 96 | DNI | 20080725 | NULL |
| 94 | Pasaporte | 20080725 | NULL |
| 0 | CI Policía Federal | 20080725 | NULL |
| 1 | CI Buenos Aires | 20080725 | NULL |
| 2 | CI Catamarca | 20080725 | NULL |
| 3 | CI Córdoba | 20080725 | NULL |
| 4 | CI Corrientes | 20080728 | NULL |
| 5 | CI Entre Ríos | 20080728 | NULL |
| 6 | CI Jujuy | 20080728 | NULL |
| 7 | CI Mendoza | 20080728 | NULL |
| 8 | CI La Rioja | 20080728 | NULL |
| 9 | CI Salta | 20080728 | NULL |
| 10 | CI San Juan | 20080728 | NULL |
| 11 | CI San Luis | 20080728 | NULL |
| 12 | CI Santa Fe | 20080728 | NULL |
| 13 | CI Santiago del Estero | 20080728 | NULL |
| 14 | CI Tucumán | 20080728 | NULL |
| 16 | CI Chaco | 20080728 | NULL |
| 17 | CI Chubut | 20080728 | NULL |
| 18 | CI Formosa | 20080728 | NULL |
| 19 | CI Misiones | 20080728 | NULL |
| 20 | CI Neuquén | 20080728 | NULL |
| 21 | CI La Pampa | 20080728 | NULL |
| 22 | CI Río Negro | 20080728 | NULL |
| 23 | CI Santa Cruz | 20080728 | NULL |
| 24 | CI Tierra del Fuego | 20080728 | NULL |
| 99 | Doc. (Otro) | 20080728 | NULL |
Alicuotas de IVA
| 3 | 0% | 20090220 | NULL |
| 4 | 10.5% | 20090220 | NULL |
| 5 | 21% | 20090220 | NULL |
| 6 | 27% | 20090220 | NULL |
Monedas
| PES | Pesos Argentinos | 20090403 | NULL |
| DOL | Dólar Estadounidense | 20090403 | NULL |
| 002 | Dólar Libre EEUU | 20090416 | NULL |
| 007 | Florines Holandeses | 20090403 | NULL |
| 010 | Pesos Mejicanos | 20090403 | NULL |
| 011 | Pesos Uruguayos | 20090403 | NULL |
| 014 | Coronas Danesas | 20090403 | NULL |
| 015 | Coronas Noruegas | 20090403 | NULL |
| 016 | Coronas Suecas | 20090403 | NULL |
| 018 | Dólar Canadiense | 20090403 | NULL |
| 019 | Yens | 20090403 | NULL |
| 021 | Libra Esterlina | 20090403 | NULL |
| 023 | Bolívar Venezolano | 20090403 | NULL |
| 024 | Corona Checa | 20090403 | NULL |
| 025 | Dinar Yugoslavo | 20090403 | NULL |
| 026 | Dólar Australiano | 20090403 | NULL |
| 027 | Dracma Griego | 20090403 | NULL |
| 028 | Florín (Antillas Holandesas) | 20090403 | NULL |
| 029 | Güaraní | 20090403 | NULL |
| 031 | Peso Boliviano | 20090403 | NULL |
| 032 | Peso Colombiano | 20090403 | NULL |
| 033 | Peso Chileno | 20090403 | NULL |
| 034 | Rand Sudafricano | 20090403 | NULL |
| 036 | Sucre Ecuatoriano | 20090403 | NULL |
| 051 | Dólar de Hong Kong | 20090403 | NULL |
| 052 | Dólar de Singapur | 20090403 | NULL |
| 053 | Dólar de Jamaica | 20090403 | NULL |
| 054 | Dólar de Taiwan | 20090403 | NULL |
| 055 | Quetzal Guatemalteco | 20090403 | NULL |
| 056 | Forint (Hungría) | 20090403 | NULL |
| 057 | Baht (Tailandia) | 20090403 | NULL |
| 059 | Dinar Kuwaiti | 20090403 | NULL |
| 012 | Real | 20090403 | NULL |
| 030 | Shekel (Israel) | 20090403 | NULL |
| 035 | Nuevo Sol Peruano | 20090403 | NULL |
| 060 | Euro | 20090403 | NULL |
| 040 | Lei Rumano | 20090415 | NULL |
| 042 | Peso Dominicano | 20090415 | NULL |
| 043 | Balboas Panameñas | 20090415 | NULL |
| 044 | Córdoba Nicaragüense | 20090415 | NULL |
| 045 | Dirham Marroquí | 20090415 | NULL |
| 046 | Libra Egipcia | 20090415 | NULL |
| 047 | Riyal Saudita | 20090415 | NULL |
| 061 | Zloty Polaco | 20090415 | NULL |
| 062 | Rupia Hindú | 20090415 | NULL |
| 063 | Lempira Hondureña | 20090415 | NULL |
| 064 | Yuan (Rep. Pop. China) | 20090415 | NULL |
| 009 | Franco Suizo | 20091110 | NULL |
| 041 | Derechos Especiales de Giro | 20100125 | NULL |
| 049 | Gramos de Oro Fino | 20100125 | NULL |
Tipos de datos opcionales
| 2 | RG Empresas Promovidas - Indentificador de proyecto vinculado a Régimen de Promoción Industrial | 20100917 | NULL |
Tipos de Tributo
| 1 | Impuestos nacionales | 20100917 | NULL |
| 2 | Impuestos provinciales | 20100917 | NULL |
| 3 | Impuestos municipales | 20100917 | NULL |
| 4 | Impuestos Internos | 20100917 | NULL |
| 99 | Otro | 20100917 | NULL |
Novedades
Se recuerda que esta disponible el grupo de noticias ( http://groups.google.com.ar/group/pyafipws) donde se publicarán futuras novedades sobre PyAfipWS: servicios web de factura electrónica y sus interfases (se recomienda suscribirse)
Costos y Condiciones
Debido a cambios y mejoras internas, la interfase WSFEv1 NO será incluida en el instalador actual de PyAfipWs (WSFE original), por lo que los clientes que necesiten el soporte técnico comercial, deberán bajar la actualización del instalador por separado (con cargo).
Debido a la complejidad de este servicio, su fecha de aplicación y las modificaciones que pudieran surgir, los clientes que asi lo requieran pueden adquirir horas de soporte técnico adicional (se estima conveniente desde 25 hs por un valor total de dde. $1875.-) por 3 meses (ver Condiciones del Soporte Comercial).
Como este servicio web tiene varias modalidades (CAE normal y CAE anticipado), entre otros cambios, se recomienda consultar previamente.
Ofrecemos soporte técnico comercial (pago), independiente a la AFIP, desarrollos especiales, interfaces web, etc. Obtenga mas información enviando un mail a info@pyafipws.com.ar o (011) 4450-0716 / (011) 15-3048-9211 (asesoramiento sin cargo)
A su vez, se liberará el código fuente bajo licencia GPLv3 (software libre), al igual que se hizo con el restos de los servicios web. Para más detalles ver página FacturaElectronica.
La información de esta página es proporcionada a titulo informativo.
2008-2010 © MarianoReingart MarianoReingart MarianoReingart
