Factura Electrónica MTXCAService (RG2904, RG3536)


Interfaz para Servicio Web correspondiente a Factura Electrónica de Mercado Interno con detalle -Régimen CAE codificación de productos- ( Matrix: Codificación de las operaciones efectuadas  WSMTXCA Service) 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)") y  RG 3536/2013:

Índice

logo-pyafipws.png


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.

Importante: RG3536/2013 AFIP

Esta interfaz ya contempla la  Resolución General 3536/2013 que dió de baja el aplicativo del SIAP para informar el detalle de la factura, denominado "AFIP DGI - FACTURA ELECTRONICA - REGIMEN DE INFORMACION DE OPERACIONES - Versión 2.0".

Dicho aplicativo, junto con el webservice anterior (WSFEv1), podrá ser usado solo hasta el 31 de Diciembre de 2013 (usuarios preexistentes notificados por juez administrativo, que en su momento optaron por la opción B de la RG2904), debiendo usar este webservice a partir del 1° de Enero de 2014. Asimismo, el período comprendido entre los días 16 y 31 de diciembre de 2013, ambas fechas inclusive, deberá informarse hasta última hora del día 3 de enero de 2014, inclusive.

Los nuevos sujetos obligados solo pueden usar el webservice WSMTXCA e informar el detalle de la factura (incluyendo códigos de barra, descripción de productos, precio unitario e impuestos) de manera online.

Importante: Release v0.5

AFIP publicó una nueva  Especificación Técnica "Release v0.5" (manual para desarrolladores) con fecha 15 de Marzo de 2017 AFIP, con las siguientes novedades:

  • Nuevo campo Cuit en Comprobantes Asociados
    • 88 – Remito de Tabaco Acondicionado
    • 991 – Remito de Tabaco en Hebras

Los ajustes ya han sido realizados al componente, disponibles por actualización a partir de WSMTX.Version >= 1.13a (revisión 1941 o superior del instalador), igualmente recomendamos probarlo y evaluarlo en homologación (Ver Descargas), para ver como evoluciona desde AFIP.

Lamentablemente al 16 de Marzo de 2017 todavía no estaría disponible el WSDL de AFIP para homologación.

Recordamos que si no son necesarias las nuevas características, no es obligatorio actualizar y re-instalar el componente. Provisoriamente puede limpiarse la carpeta cache de archivos temporales, para que se regeneren y pueda continuar operando.

Para más información ver Service Pack 2 y documentación método WSMTX AgregarCmpAsoc en el manual

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:

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  GitHub (actualizado) y  GoogleCode (histórico):

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, si no se utilizó el instalador unificado con todos los webservices, es necesario instalar el instalador  instalador-WSAA-2.02c-homo.exe para WSAA (autenticación). Para más información ver el Manual de Uso

Cambios respecto a WSFE, WSFEX, WSBFE

En este nuevo servicio web WSMTXCA, 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_imp = "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

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

Tipos de Documento

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

Alicuotas de IVA

30%
410.5%
521%
627%

Condiciones de IVA

1No gravado
2Exento
30%
410.5%
521%
627%

Concepto

1 Productos
2 Servicios
3 Productos y Servicios

Monedas

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

Unidades de Medida

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

Tipos de Tributo

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

Detalle de Artículos

Ver  RG3188/11

Los importes correspondientes a descuentos, bonificaciones, contenidos en los documentos emitidos, sólo deberán ser informados como "Total de Descuento Global Diario".

Las notas de crédito que correspondan exclusivamente a descuentos y/o bonificaciones, así como las notas de débito que reviertan tales conceptos, deberán ser informadas incluyendo el respectivo código genérico y sin información del importe documentado".

Datos a suministrar en la solicitud de autorización de emisión de comprobantes electrónicos originales:

  1. Codificación del producto (cod_mtx): los códigos a consignar corresponderán a la estructura provista por la Asociación Argentina de Codificación de Productos Comerciales -código-, denominados códigos GTIN 8, GTIN 12 y GTIN 13, así como los que los modifiquen y/o complementen en el futuro, correspondientes a la unidad de consumo minorista o presentación al consumidor final. El precio unitario asociado a los códigos precitados siempre deberá ser mayor a cero.
  2. Unidad de referencia (u_mtx): cuando la comercialización de los productos se realice en presentaciones distintas a la unidad de consumo minorista o presentación al consumidor final, a la que hace referencia la codificación del producto mencionado en el punto anterior (vg. caja, bulto, "pack", etc.), en el campo "unidad de referencia" se deberá indicar la cantidad de unidades de consumo minorista contenidas en la presentación que se comercializa. En caso de que el producto ya se encuentre individualizado en su unidad de consumo minorista, tanto en el código como en el precio y unidad de medida, la unidad de referencia deberá ser igual a uno.
  3. Códigos genéricos (cod_mtx): cuando corresponda emitir comprobantes incluyendo conceptos distintos a los productos que conforman la operatoria comercial principal del contribuyente, deberán utilizarse los códigos de operación consignados en el apartado B del presente anexo. En el caso de entrega de material promocional y/o muestras se deberá informar el código genérico correspondiente a “ventas varias” previsto en el citado apartado.
  4. Códigos específicos (cod_mtx): cuando esta Administración Federal incorpore a contribuyentes -conforme el procedimiento previsto en el Artículo 2 de la presente– cuya actividad amerite la asignación de códigos específicos para reflejar la comercialización y/o prestación de servicios, deberán utilizarse los códigos que se indican en el apartado C.

Códigos Genéricos

Código Descripción
7790001001030 Descuentos y bonificaciones comerciales
7790001001047 Conceptos financieros
7790001001054 Ventas varias
7790001001061 Bienes de uso
7790001001078 Servicios prestados
7790001001085 Fletes
7790001001092 Alquileres
7790001001115 Depósito y servicios de logística
7790001001122 Repuestos y accesorios
7790001001139 Ajustes impositivos
7790001001146 Actividades comerciales no codificadas
7790001001153 Venta de material de rezago

Aclaraciones

Cálculo de importes (detalle de artículos) y validaciones:

  • imp_iva: Para tipo_cbte igual a 1, 2 ó 3 (A) y umed distinto a 97 o 99, deberá ser igual a (precio * qty - bonif) * alícuota de IVA (según iva_id correspondiente).
  • imp_subtotal: Si tipo_cbte es igual a 1, 2 ó 3 (A) y umed es distinto a 99 ó 97; deberá ser igual a ((precio sin IVA * qty)- bonif)*(1+alícuota). Si tipo_cbte es igual a 6, 7 u 8 (B) y umed es distinto a 99 ó 97; deberá ser igual a (precio con IVA * qty - bonif).

Para los productos sin cargo estableciendo imp_subtotal, precio e imp_iva en 0.

Cálculo de importes generales:

  • imp_neto: si tipo_cbte es igual a 1, 2 ó 3 (A): deberá ser igual a la sumatoria de imp_subtotal menos imp_iva para la totalidad de los ítems con iva_id igual a 3, 4, 5 ó 6. Si tipo_cbte es igual a 6, 7 u 8 (B): deberá ser igual a la sumatoria de imp_subtotal menos el IVA correspondiente (calculado en base al importe y la alícuota de cada ítem), para la totalidad de los ítems con iva_id igual a 3, 4, 5 ó 6.
  • imp_tot_conc: deberá coincidir con la sumatoria de imp_subtotal para los ítems con iva_id = 1.
  • imp_op_ex: deberá coincidir con la sumatoria de imp_subtotal para los ítems con iva_id = 2.
  • imp_subtotal: deberá coincidir con la sumatoria de los campos imp_tot_conc + imp_neto + imp_op_ex.
  • imp_trib: debe ser igual a la sumatoria de la totalidad de los campos importe de tributos (método AgregarTributo)
  • imp_total: debe ser igual a imp_subtotal + imp_trib + sumatoria de importe liquidado para los subtotales por alícuotas de IVA (método AgregarIVA)

Margen de error:

Error relativo porcentual deberá ser <= 0.01% o el error absoluto <=0.01

Mapeo de Campos (con documentación AFIP):

  • Generales: imp_subtotal: importeSubtotal, imp_tot_conc: importeNoGravado, imp_neto: importeGravado, imp_op_ex: importeExento, imp_trib: importeOtrosTributos, imp_total: importeTotal
  • Detalle: imp_subtotal: importeItem, imp_iva: importeIVA, iva_id: codigoCondicionIVA

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 la complejidad de este servicio, su fecha de aplicación y las modificaciones que pudieran surgir, los clientes que así lo requieran pueden adquirir horas de soporte técnico adicional pago, se estima conveniente 18 hs por un valor total de $2250.- por 3 meses de cobertura de WSAA + WSMTXCA (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 MarianoReingart MarianoReingart

Attachments