Constatación de Comprobantes emitidos (CAI, CAE, CAEA) por Web Service AFIP


Interfaz para los Servicios Web para verificar en forma dinámica si los comprobantes recibidos se encuentran autorizados por la AFIP.  Ley de Procedimiento Tributario N°11683 (Artículo 33) modificado por  Ley N° 25795 y reglamentado por  Decreto 477/2007

Índice

logo-pyafipws.png


Descripción General

Este servicio permite verificar la validez en los comprobantes respaldatorios de las operaciones, tanto con Código de Autorización de Impresión (CAI), el Código de Autorización Electrónico, y CAE Anticipado "CAEA". La modalidad CAE y CAEA es soportada por dos webservices:

  • WSFEv1(Web Service de Factura Electrónica Versión 1) correspondiente a la RG 2485 y modificatorias
  • WSMTXCA (Web Service de Factura Electrónica con detalle) correspondiente a la RG 2904

Actualmente los comprobantes se pueden validar también por el servicio interactivo de AFIP:

Este webservice permite la automatización de dichas consultas sin la necesidad de intervención del usuario. Publicación: Septiembre de 2013  Documentación Oficial

Se encuentran obligados a constatar la debida autorización de las facturas o documentos equivalentes -de conformidad con lo dispuesto por el artículo agregado a continuación del Artículo 33 de la  Ley Nº 11.683, texto ordenado en 1998 y sus modificaciones- los sujetos que, por poseer montos de compras significativos, montos de ventas relevantes y/o desarrollen actividades de riesgo y/o de relevante interés fiscal (según  Decreto 477/2007):

  1. Exportadores y sujetos que realicen actividades asimilables a la exportación, con carácter de habitualistas.
  2. Contribuyentes que actúen como agentes de retención del Impuesto al Valor Agregado.
  3. Contribuyentes que reciban comprobantes electrónicos.
  4. El ESTADO NACIONAL y sus dependencias y/u organismos dependientes, centralizados, descentralizados o autárquicos.

Descargas e Instalación

Ver archivos y últimas actualizaciones para descargas en  GitHub (actualizado) y  GoogleCode (histórico):

Métodos

Métodos principales:

  • ConstatarComprobante(cbte_modo, cuit_emisor, pto_vta, cbte_tipo,cbte_nro, cbte_fch, imp_total, cod_autorizacion, doc_tipo_receptor, doc_nro_receptor): Constatación de Comprobantes. Recibe los datos del comprobante a verificar (todos obligatorios excepto los datos del receptor). Devuelve verdadero en caso de ejecución satisfactoria, falso en caso de error. Establece Resultado, Obs y demás atributos. Ver Ejemplos.

Métodos secundarios:

  • Conectar(cache=None, url="", proxy=""): en homologación no hace falta pasarle ningùn paràmetro. En producciòn, el segudo parametro es la WSDL.
  • Dummy(): devuelve estado de servidores. Devuelve verdadero en caso de ejecución satisfactoria, falso en caso de error. Establece AppServerStatus, DbServerStatus y AuthServerStatus

Métodos auxiliares:

  • ConsultarModalidadComprobantes(sep="|"): Recuperador de modalidades de autorización de comprobantes ("CAI", "CAE", "CAEA")
  • ConsultarTipoComprobantes(sep="|"): Recuperador de valores referenciales de códigos de Tipos de comprobante
  • ConsultarTipoDocumentos(sep="|"): Recuperador de valores referenciales de códigos de Tipos de Documentos
  • ConsultarTipoOpcionales(sep="|"): Recuperador de valores referenciales de códigos de Tipos de datos Opcionales

Atributos

Propiedades principales retornadas por el WSCDC:

  • Resultado: "A": Aprobado, "O": Observado, "R": Rechazado
  • FechaCbte: fecha del comprobante
  • PuntoVenta: punto de venta del comprobante
  • CbteNro: fecha del comprobante
  • DocTipo: tipo de documento del receptor
  • DocNro: número de documento del receptor
  • ImpTotal: importe del comprobante
  • EmisionTipo: modo de comprobante (CAE, CAEA, CAI)
  • CAI, CAE, CAEA: código de autorización

Propiedades con validaciones devueltas por el WSCDC:

  • Obs (Observaciones): mensajes advertencia de AFIP
  • ErrMsg, ErrCode (Errores): mensajes de error de AFIP

Propiedades secundarias del WSCDC:

  • Token: es el código de autorización generado por la AFIP (WSAA)
  • Sign: es la firma de autorización generado por la AFIP (WSAA)
  • Cuit: es el número de CUIT del emisor de facturas, formato string sin guiones.
  • AppServerStatus, DbServerStatus, AuthServerStatus: estados de los servidores de AFIP (string “OK” en caso de estar funcionales)
  • XmlRequest, XmlResponse: requerimiento y respuesta XML (para depuración)
  • InstallDir Nuevo! : directorio de instalación (ej. C:\Archivos de Programa\WSCDC)
  • Excepcion, Traceback Nuevo! : mensaje de error y traza de rastreo (para depuración)
  • LanzarExcepciones Nuevo! : establece si se deben emitir errores al lenguaje de programación (habilitado por defecto), o serán controlados por el programa (revisando el atributo Excepcion luego de cada método)

Ejemplos

Pseudocódigo en Python para Constatación de un comprobante (Factura A con CAEA):

 
cbte_modo = "CAE"                    # modalidad de emision: CAI, CAE, CAEA
cuit_emisor = "20267565393"          # proveedor
pto_vta = 4002                       # punto de venta habilitado en AFIP
cbte_tipo = 1                        # 1: factura A (ver tabla de parametros)
cbte_nro = 109                       # numero de factura
cbte_fch = "20131227"                # fecha en formato aaaammdd
imp_total = "121.0"                  # importe total
cod_autorizacion = "63523178385550"  # numero de CAI, CAE o CAEA
doc_tipo_receptor = 80               # CUIT (obligatorio Facturas A o M)
doc_nro_receptor = "30628789661"     # numero de CUIT del cliente

ok = wscdc.ConstatarComprobante(cbte_modo, cuit_emisor, pto_vta, cbte_tipo, 
                                cbte_nro, cbte_fch, imp_total, cod_autorizacion, 
                                doc_tipo_receptor, doc_nro_receptor)

print "Resultado:", wscdc.Resultado
print "Mensaje de Error:", wscdc.ErrMsg
print "Observaciones:", wscdc.Obs    

En caso de que el comprobante esté correctamente autorizado por AFIP, Resultado será "A" (Aprobado), de lo contrario será "R" (Rechazado)

Observaciones más frecuentes:

  • 100: El N° de CAI/CAE/CAEA consultado no existe en las bases del organismo.
  • 101: Se podran constatar comprobantes con fecha de emision del 01/01/2013 en adelante.
  • 113: Para Comprobantes tipo A o tipo M, el documento del receptor debe ser CUIT.
  • 114: Para comprobantes tipo A o tipo M el documento del Receptor es obligatorio informarlo..

En caso de que ok no sea verdadero, revisar wscdc.ErrMsg y wscdc.Excepciones ya que posiblemente hay un problema interno.

Ver fragmentos de código para Visual Basic, Visual Fox Pro y VB.Net en Descargas e Instalacion

Linea de comandos

WSCDC puede también utilizarse por línea de comando (tanto para Windows como para GNU/Linux) y recibe los siguientes argumentos:

  • --constatar: realiza la constatación de un comprobante, recibe los mismos argumentos que el método ConstatarComprobante
  • --prueba: utiliza datos de prueba (ver ejemplo)
  • --dummy: comprueba la infraestructura de AFIP
  • --params: obtiene y muestra las tablas de parámetro de AFIP

Ejemplo para constatar un comprobante (sintaxis para windows):

C:\PYAFIPWS> WSCDC_CLI.EXE --constatar CAE 20267565393 5 1 171 20131206 2268.75  63493611413705 80 30606174159
Resultado: R
Mensaje de Error: 
Observaciones: 112: El tipo y número de documento del receptor no se corresponde con los informados para el comprobante consultado o no es válida y no se encontraba activa al momento de emisión de comprobante.

Ejemplo para verificar el estado de los servidores (sintaxis para linux):

reingart@s5ultra:~/pyafipws$ python wscdc.py --dummy
AppServerStatus OK
DbServerStatus OK
AuthServerStatus OK

La configuración se encuentra en el archivo RECE.INI:

[WSAA]
CERT=reingart.crt
PRIVATEKEY=reingart.key
#URL=https://wsaa.afip.gov.ar/ws/services/LoginCms

[WSCDC]
CUIT=20267565393
#URL=https://servicios1.afip.gov.ar/WSCDC/service.asmx?WSDL

Formato de Intercambio

Encabezado

Campo Posición Longitud Tipo Descripción
tipo_reg 1 1 Alfanumerico 0: encabezado
cbte_modo 2 4 Alfanumerico Modalidad de autorización (CAI, CAE, CAEA)
cuit_emisor 6 11 Alfanumerico CUIT del emisor del comprobante
pto_vta 17 4 Numerico Punto de Venta del comprobante
cbte_tipo 21 3 Numerico Tipo de comprobante
cbte_nro 24 8 Numerico Número de comprobante
cbte_fch 32 8 Alfanumerico Fecha en formato AAAAMMDD
imp_total 40 15 Importe Importe total Double (13 + 2)
cod_autorizacion 55 14 Alfanumerico Número de CAI, CAE, CAEA
doc_tipo_receptor 69 2 Alfanumerico Tipo de documento del receptor
doc_nro_receptor 71 20 Alfanumerico N° de documento del receptor
resultado 91 1 Alfanumerico Resultado (A: Aprobado, O: Observado, R: rechazado)
fch_proceso 92 14 Alfanumerico Fecha y hora de procesamiento

Observacion

Campo Posición Longitud Tipo Descripción
tipo_reg 1 1 Alfanumerico O: observaciones devueltas por AFIP
code 2 5 Numerico Código de Observación / Error / Evento
msg 7 255 Alfanumerico Mensaje

Evento

Campo Posición Longitud Tipo Descripción
tipo_reg 1 1 Alfanumerico O: observaciones devueltas por AFIP
code 2 5 Numerico Código de Observación / Error / Evento
msg 7 255 Alfanumerico Mensaje

Error

Campo Posición Longitud Tipo Descripción
tipo_reg 1 1 Alfanumerico O: observaciones devueltas por AFIP
code 2 5 Numerico Código de Observación / Error / Evento
msg 7 255 Alfanumerico Mensaje

Tablas de Parámetros

Modalidad Comprobantes

CAEComprobantes - CAE
CAEAComprobantes - CAEA
CAIComprobantes - CAI

Tipo Comprobantes

1Facturas A
2Notas de Debito A
3Notas de Credito A
4Recibos A
5Notas de Venta al contado A
6Facturas B
7Notas de Debito B
8Notas de Credito B
9Recibos B
10Notas de Venta al contado B
11FACTURAS C
12NOTAS DE DEBITO C
13NOTAS DE CREDITO C
15RECIBOS C
19Facturas de Exportacion
20N. Deb. p/operac. con el exterior
21N. Cre. p/operac. con el exterior
22Fac. Perm. Export. Simp. - Dto.855/97
30Cbtes. compra de bienes usados
31Mandato/Consignación
32COMPROBANTES DE COMPRA DE MATERIALES A RECICLAR PROVENIENTES
34Cbtes. A del Anexo I, Apartado A,inc.f),R.G.Nro. 1415
35Cbtes. B del Anexo I,Apartado A,inc. f),R.G. Nro. 1415
37N. Deb/doc. equiv. que cumplan con R.G.Nro. 1415
38N. Cred/doc. equiv. que cumplan con R.G.Nro. 1415
39Otros comprobantes A que cumplan con R.G.Nro. 1415
40Otros comprobantes B que cumplan con R.G.Nro. 1415
41OTROS COMPROBANTES C QUE CUMPLAN CON LA R.G. N° 1415
51Facturas M
52Notas de Debito M
53Notas de credito M
54Recibo M
55Notas de Venta al contado M
56Comprobantes M del anexo I, Apartado A,inc. f)R.G.Nro.1415
57Otros Comprobantes M que cumplan con la R.G. Nro. 1415
58Cuenta de Venta y Liquido producto M
59Liquidacion M
60Cta de Vta y Liquido prod. A
61Cta de Vta y Liquido prod. B
63Liquidacion A
64Liquidacion B
70Recibo de Factura de Credito R
91Remito R
49Comprobante de Compra de Bienes Usados

Tipo Documentos

80CUIT
86CUIL
87CDI
89LE
90LC
91CI Extranjera
92en trámite
93Acta Nacimiento
95CI Bs. As. RNP
96DNI
94Pasaporte
00CI Policía Federal
01CI Buenos Aires
02CI Catamarca
03CI Córdoba
04CI Corrientes
05CI Entre Ríos
06CI Jujuy
07CI Mendoza
08CI La Rioja
09CI Salta
10CI San Juan
11CI San Luis
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)

Tipo Opcionales

En homologación, actualmente AFIP devuelve:

Mensaje de Error: 503: Sin Resultados: - Metodo OpcionalesTipoConsultar

Novedades

Se recuerda que esta disponible el [grupo de usuarios y desarrolladores] ( 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)

También esta disponible el sitio  http://www.pyafipws.com.ar con noticias, anuncios e información técnica general

Costos y Condiciones

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 (ver Condiciones del Soporte Comercial), se estima conveniente los siguientes planes:

  • Soporte Mínimo: $1125.- por 1 semana de cobertura hasta 1 h en total (solo instalador para clientes actuales -por tiempo limitado-)
  • Soporte Básico: $1900.- por 2 semanas de cobertura hasta 2 hs en total (incluyendo consultas y ajustes generales)
  • Soporte Estándar: $2850.- por 1 mes de cobertura hasta 3 hs en total (incluyendo consultas y ajustes particulares, archivos de intercambio TXT, JSON y DBF, lenguajes especiales, etc.)
  • Soporte Avanzado: desde $3800+IVA por 2 meses máx. de cobertura, hasta 4 hs en total (incluyendo modificaciones y desarrollo de ejemplos, documentación, pruebas, bases de datos, etc., contempla temas urgentes y/o grandes empresas/ciclos de desarrollo)

Ofrecemos soporte técnico comercial avanzado (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-2015 © MarianoReingart

. 2008-2013 © MarianoReingart

Attachments