Factura Electrónica MTXCAService (RG2904)

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 "a) Factura con el detalle previsto en el Artículo 5º, inciso c)"):

Índice

1. Índice
2. Descripción General
3. Estado
4. Descargas
5. Instalación
6. Cambios respecto a WSFE, WSFEX, WSBFE
7. Ejemplo Intefase COM en VB (5/6)
8. Tablas de Parámetros
   1. Tipos de Comprobante
   2. Tipos de Documento
   3. Alicuotas de IVA
   4. Condiciones de IVA
   5. Monedas
   6. Unidades de Medida
   7. Tipos de Tributo
9. Novedades
10. Costos y Condiciones

Descripción General

EL WSMTXCA 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., correspondiente a la Resolución  Resolución General 2904/2010 Art.4 Opción A-

NOTA: Ver WSFEv1 (Proyecto Factura Electrónica v1, Opción B)

Este nuevo webservice contempla las operaciones de mercado interno (Facturas A y B) y CAE Anticipado.

Estado

La AFIP publicó la  información técnica, y el servicio WSMTXCA ya está disponible en homologación para realizar pruebas.

Por dicho motivo, dado la inminente fecha de aplicación, desarrollaremos para nuestros clientes, un SIMULADOR que emula los métodos del servicio web, para poder comenzar los desarrollos:

•  https://www.sistemasagiles.com.ar/simulador/

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-WSMTXCA-1.03b-homo.exe
• Ejemplo en VB:  wsmtx.bas
• Ejemplo en VFP:  wsmtxca.prg
• Manual de Uso: Documentación (PDF)
• Código Fuente (Python): ver archivos publicados en  Google Code

Instalación

Está disponible el instalador (ver Descargas), simplemente descargar, ejecutar seguir los pasos:

• Aceptar la licencia
• Seleccionar carpeta, por ej C:\WSMTXCA
• 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
• Subtotales de IVAs: id (según tabla de parámetros), base imponible, importe, similar a WSBFE
• Detallar cada artículo vendido (ítems)
  • Código MTX: Codificación del producto (Códigos GTIN 13, GTIN 12 y GTIN 8), correspondientes a la unidad de consumo minorista o presentación al consumidor final
  • Unidades MTX: Unidad de referencia (cantidades de unidades de consumo minoristas contenidas en la presentación que se comercializa)
  • Código interno del producto
  • Descripción completa
  • Precio Neto Unitario
  • Cantidad
  • Unidad de medida (según tabla de parámetros)
  • Bonificaciones
  • Categoría de IVA (según tabla de parámetros)
  • Importe de IVA
  • Importe subtotal

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 WSMTXCA 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 WSMTXv0 - AFIP o el manual manual de la presente interfaz.

Ejemplo Intefase COM en VB (5/6)

' Establezco los valores de la factura a autorizar:
tipo_cbte = 1
punto_vta = 4000
cbte_nro = WSMTXCA.ConsultarUltimoComprobanteAutorizado(tipo_cbte, punto_vta)
fecha = Format(Date, "yyyy-mm-dd")
concepto = 1
tipo_doc = 80: nro_doc = "30000000007"
cbt_desde = cbte_nro + 1: cbt_hasta = cbte_nro + 1
imp_total = "122.00": imp_tot_conc = "0.00": imp_neto = "100.00"
imp_trib = "1.00": imp_op_ex = "0.00": imp_subtotal = "100.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 = "PES": moneda_ctz = "1.000"
obs = "Observaciones Comerciales, libre"

' Creo la factura (internamente, sin llamar al WS)
ok = WSMTXCA.CrearFactura(concepto, tipo_doc, nro_doc, tipo_cbte, punto_vta, _
    cbt_desde, cbt_hasta, imp_total, imp_tot_conc, imp_neto, _
    imp_subtotal, imp_trib, imp_op_ex, fecha_cbte, fecha_venc_pago, _
    fecha_serv_desde, fecha_serv_hasta, _
    moneda_id, moneda_ctz, obs)

' Agrego los comprobantes asociados:
If False Then ' solo si es nc o nd
    tipo = 19
    pto_vta = 2
    nro = 1234
    ok = WSMTXCA.AgregarCmpAsoc(tipo, pto_vta, nro)
End If

' Agrego impuestos varios
id = 99
Desc = "Impuesto Municipal Matanza'"
base_imp = "100.00"
alic = "1.00"
importe = "1.00"
ok = WSMTXCA.AgregarTributo(id, Desc, base_imp, alic, importe)

' Agrego subtotales de IVA
id = 5 ' 21%
base_im = "100.00"
importe = "21.00"
ok = WSMTXCA.AgregarIva(id, base_imp, importe)

' Agrego un Artículo (repetir para todos los artículos y descuentos)
u_mtx = 123456
cod_mtx = "12345678901234"
codigo = "P0001"
ds = "Descripcion del producto P0001"
qty = "1.0000"
umed = 7
precio = "100.00"
bonif = "0.00"
cod_iva = 5
imp_iva = "21.00"
imp_subtotal = "121.00"
ok = WSMTXCA.AgregarItem(u_mtx, cod_mtx, codigo, ds, qty, _
            umed, precio, bonif, cod_iva, imp_iva, imp_subtotal)

' Solicito CAE:
cae = WSMTXCA.AutorizarComprobante()

' verifico que no haya errores
For Each er In WSMTXCA.Errores
    MsgBox er, vbInformation, "Error:"
Next

Debug.Print "Resultado", WSMTXCA.Resultado
Debug.Print "CAE", WSMTXCA.cae
Debug.Print "Vencimiento CAE", WSMTXCA.Vencimiento
Debug.Print "Observaciones", WSMTXCA.Obs
Debug.Print "Observaciones", WSMTXCA.Obs

Nota: La metodología es similar al resto de los webservices, y se trato de mantener similitud con el código existente:

• Método WSMTXCA.CrearFactura es similar a WSFE.Authorize (parámetros similares)
• Método WSMTXCA.AgregarCmpAsoc es similar a WSFEX.AgregarCmpAsoc
• Método WSMTXCA.AgregarItem es similar a WSBFE.AgregarItem
• Propiedades similares: WSMTXCA.CAE, WSMTXCA.Resultado, etc.

Tablas de Parámetros

Wste nuevo servicio funciona con tablas dinámicas de parámetros para los códigos de comprobante, moneda, IVA, tribuots, unidades de medida. 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 20/10/2010 (homologación):

Tipos de Comprobante

1	Factura A
2	Nota de Débito A
3	Nota de Crédito A
6	Factura B
7	Nota de Débito B
8	Nota de Crédito B

Tipos de Documento

80	CUIT
86	CUIL
87	CDI
89	LE
90	LC
91	CI Extranjera
92	en trámite
93	Acta Nacimiento
95	CI Bs. As. RNP
96	DNI
94	Pasaporte
0	CI Policía Federal
1	CI Buenos Aires
2	CI Catamarca
3	CI Córdoba
4	CI Corrientes
5	CI Entre Ríos
6	CI Jujuy
7	CI Mendoza
8	CI La Rioja
10	CI San Juan
11	CI San Luis
9	CI Salta
12	CI Santa Fe
13	CI Santiago del Estero
14	CI Tucumán
16	CI Chaco
17	CI Chubut
18	CI Formosa
19	CI Misiones
20	CI Neuquén
21	CI La Pampa
22	CI Río Negro
23	CI Santa Cruz
24	CI Tierra del Fuego
99	Doc. (Otro)

Alicuotas de IVA

3	0%
4	10.5%
5	21%
6	27%

Condiciones de IVA

1	No gravado
2	Exento
3	0%
4	10.5%
5	21%
6	27%

Monedas

PES	Pesos Argentinos
DOL	Dólar Estadounidense
007	Florines Holandeses
010	Pesos Mejicanos
011	Pesos Uruguayos
014	Coronas Danesas
015	Coronas Noruegas
016	Coronas Suecas
018	Dólar Canadiense
019	Yens
021	Libra Esterlina
023	Bolívar Venezolano
024	Corona Checa
025	Dinar Yugoslavo
026	Dólar Australiano
027	Dracma Griego
028	Florín (Antillas Holandesas)
029	Güaraní
031	Peso Boliviano
032	Peso Colombiano
033	Peso Chileno
034	Rand Sudafricano
036	Sucre Ecuatoriano
051	Dólar de Hong Kong
052	Dólar de Singapur
053	Dólar de Jamaica
054	Dólar de Taiwan
055	Quetzal Guatemalteco
056	Forint (Hungría)
057	Baht (Tailandia)
059	Dinar Kuwaiti
012	Real
030	Shekel (Israel)
035	Nuevo Sol Peruano
060	Euro
040	Lei Rumano
042	Peso Dominicano
043	Balboas Panameñas
044	Córdoba Nicaragüense
045	Dirham Marroquí
063	Lempira Hondureña
046	Libra Egipcia
047	Riyal Saudita
062	Rupia Hindú
061	Zloty Polaco
064	Yuan (Rep. Pop. China)
002	Dólar Libre EEUU
009	Franco Suizo
041	Derechos Especiales de Giro
049	Gramos de Oro Fino

Unidades de Medida

0
1	kilogramos
2	metros
3	metros cuadrados
4	metros cúbicos
5	litros
6	1000 kWh
7	unidades
8	pares
9	docenas
10	quilates
11	millares
14	gramos
15	milimetros
16	mm cúbicos
17	kilómetros
18	hectolitros
20	centímetros
25	jgo. pqt. mazo naipes
27	cm cúbicos
29	toneladas
30	dam cúbicos
31	hm cúbicos
32	km cúbicos
33	microgramos
34	nanogramos
35	picogramos
41	miligramos
47	mililitros
48	curie
49	milicurie
50	microcurie
51	uiacthor
52	muiacthor
53	kg base
54	gruesa
61	kg bruto
62	uiactant
63	muiactant
64	uiactig
65	muiactig
66	kg activo
67	gramo activo
68	gramo base
96	packs
97	seña/anticipo
98	otras unidades
99	bonificación

Tipos de Tributo

1	Impuestos Nacionales
2	Impuestos Provinciales
3	Impuestos Municipales
4	Impuestos Internos
99	Otros

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 paquete actual de PyAfipWs, 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.

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