= Constatación de Comprobantes emitidos (CAI, CAE, CAEA) por Web Service AFIP =
[[TracNav(noreorder|FacturaElectronica)]]

Interfaz para los Servicios Web para verificar en forma dinámica si los comprobantes recibidos se encuentran autorizados por la AFIP.
[http://infoleg.mecon.gov.ar/infolegInternet/anexos/15000-19999/18771/texact.htm Ley de Procedimiento Tributario N°11683] (Artículo 33) modificado por [http://infoleg.mecon.gov.ar/scripts1/busquedas/cnsnorma.asp?tipo=Ley&nro=25795 Ley N° 25795] y reglamentado por [http://biblioteca.afip.gob.ar/dcp/DEC_C_000477_2007_05_02 Decreto 477/2007] 
== Índice ==
[[Image(htdocs:logo-pyafipws.png, align=right)]]
[[TOC(noheading,inline,depth=3)]]

== 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:
 * [wiki:ProyectoWSFEv1 WSFEv1](Web Service de Factura Electrónica Versión 1) correspondiente a la  RG 2485 y modificatorias
 * [wiki:FacturaElectronicaMTXCAService 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:
 * http://www.afip.gob.ar/genericos/imprentas/facturas.asp Constatación de comprobantes emitidos (C.A.I.) 
 * http://www.afip.gob.ar/genericos/consultaCAE/ Constatación de comprobantes electrónicos emitidos (C.A.E.)
 * http://www.afip.gob.ar/genericos/consultaCAEA/ Constatación de comprobantes electrónicos emitidos (C.A.E.A.) 

Este webservice permite la automatización de dichas consultas sin la necesidad de intervención del usuario. Publicación: Septiembre de 2013 [http://www.afip.gob.ar/ws/WSCDCV1/ManualDelDesarrolladorWSCDCV1.pdf 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 [http://infoleg.mecon.gov.ar/infolegInternet/anexos/15000-19999/18771/texact.htm 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 [http://biblioteca.afip.gob.ar/dcp/DEC_C_000477_2007_05_02 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 [https://github.com/reingart/pyafipws/releases GitHub] (actualizado) y [http://code.google.com/p/pyafipws/downloads/list GoogleCode] (histórico):
 * Instalador: [https://www.sistemasagiles.com.ar/soft/pyafipws/PyAfipWs-2.7.1994-32bit+wsaa_2.11c+wscdc_1.02e-homo.exe]
 * Ejemplos de código (última versión de desarrollo):
  * Visual Basic 5/6: [https://github.com/reingart/pyafipws/blob/master/ejemplos/wscdc/wscdc.bas wscdc.bas]
  * Visual Fox Pro 5: [https://github.com/reingart/pyafipws/blob/master/ejemplos/wscdc/wscdc.prg wscdc.prg]
  * Visual Basic .NET: [https://github.com/reingart/pyafipws/blob/master/ejemplos/wscdc/wscdc.vb wscdc.vb]
 * Muestra de archivo de intercambio:
  * [attachment:salida_wscdc.txt salida_wscdc.txt] texto plano, universal (con campos de ancho fijo, simil COBOL)  
 * [wiki:ManualPyAfipWs Manual de Uso]: Documentación General ([http://www.sistemasagiles.com.ar/trac/wiki/ManualPyAfipWs?format=pdf PDF]) y [http://www.afip.gob.ar/ws/WSCDCV1/ManualDelDesarrolladorWSCDCV1.pdf Manual del Desarrollador WSCDCv1 (AFIP)]
 * Código Fuente (Python): ver [https://code.google.com/p/pyafipws/source/browse/wscdc.py wscdc.py] y [https://code.google.com/p/pyafipws/source/browse/tests/wscdc.py unit test]
== 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 [http://www.sistemasagiles.com.ar/trac/wiki/ConstatacionComprobantes#Ejemplos 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):

{{{
#!python
 
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 [http://www.sistemasagiles.com.ar/trac/wiki/ConstatacionComprobantes#DescargaseInstalación 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 ===

||CAE||Comprobantes - CAE||
||CAEA||Comprobantes - CAEA||
||CAI||Comprobantes - CAI||

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

=== Tipo Documentos ===
||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||
||00||CI Policía Federal||
||01||CI Buenos Aires||
||02||CI Catamarca||
||03||CI Córdoba||
||04||CI Corrientes||
||05||CI Entre Ríos||
||06||CI Jujuy||
||07||CI Mendoza||
||08||CI La Rioja||
||09||CI Salta||
||10||CI San Juan||
||11||CI San Luis||
||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)||

=== 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 == 

Ofrecemos soporte técnico comercial (pago), independiente a la AFIP, desarrollos especiales, interfaces web, etc. 

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.

Ver [wiki:PyAfipWs#CostosyCondiciones Condiciones del Soporte Comercial]

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 e