WEB SERVICES

Los denominados “Web Services” (ws) o Servicios Web, posibilitan que en vez de efectuar consultas o solicitudes desde “navegadores web” y esperar visualizar la respuesta en una página web, se efectúe la comunicación directamente entre sistemas implementados por los contribuyentes o consultantes y los sistemas o bases de datos de la AFIP.

La AFIP recepciona y procesa los requerimientos de información, que deberán efectuarse en formato XML, de acuerdo a los diseños previamente acordados, y comunicará el resultado de la consulta o del proceso informático utilizando protocolos estándares de Internet tales como el Hypertext Transfer Protocol (HTTP) respetando un formato XML previamente acordado.

Las empresas que utilicen los webservices de AFIP deberán incorporar en sus servidores certificados digitales. Para descargar los mismos, ingrese aquí.


En La actualidad la AFIP tiene disponibles distintos servicios habilitados bajo la metodología “Web Services”:
WebService Consulta de Operaciones Cambiarias ( C.O.C.)
WebService
WebService de Autenticación y Autorización
WebService de Factura Electronica
WebService de Factura Electronica de Exportación
TRABAJO_F931
WebService PUC Consulta nivel 3
WebService PUC Consulta nivel 10
WebService Creación de VEPs para entidades externas
WebService Consulta de Deuda
WebService Transmisión del MIC Chile
WebService Envío de Documentación Mic-Dta y seguimiento a traves de eventos
WebService Transmisión Padrón de e ATAs y Transportistas
WebService Consulta de Tablas de Referencia
Consultas Depositario Fiel
Coraza Electrónica de Seguridad (CES)
WebService Movimientos de Ingreso/Egreso para Terminales/Deposistarios
Ingreso de Peso de Balanza MIC-DTA
WebService-Digitalizacion de Depositario Fiel
Recepcion de Eventos de Entrada y Salida de Vehiculos
WebService-Aprobar y Denegar Despachos INV
WebService Transmisión de Tablas de Referencia
WebService Interfase Credenciales Control de Acceso
WebService Autenticacion y Autorizacion
WebService Bonos Fiscales Electronicos - BFE
WebService Certificados DNRPA
WebService Código de Trazabilidad de Granos
WebService Factura Electrónica con Detalle - MTXCA
WebService Automatizacion Res. Revocacion A.P.E.
WebService de ONCCA Reporte Fiscal Compensaciones
WebService Regimen Percepcion IVA
WebService - Operacion de Seguros de Caucion - SEG
WebService Seguimiento Vehicular
Normativa

















































Normativa


  Título Número Fecha Estado Ubicación
1. R.G. AFIP Nº 2969/2010 2969 10/11/2010 Vigente Resoluciones Generales
PROCEDIMIENTO. Régimen especial de emisión y almacenamiento electrónico de comprobantes originales. Codificación de las operaciones efectuadas. Código de Autorización Electrónico Anticipado "C.A.E.A.". Resolución General N° 2904. Resolución General N° 2926. Norma complementaria.
2. R.G. AFIP Nº 2955/2010 2955 04/11/2010 Vigente Resoluciones Generales
Impuesto al Valor Agregado. Operaciones de venta de cosas muebles nuevas, locaciones y prestaciones de obras y/o servicios concertadas electrónicamente a través de "portales virtuales". Régimen especial de ingreso. Requisitos, plazos y demás condiciones.
3. R.G. AFIP Nº 2904/2010 2904 06/09/2010 Vigente Resoluciones Generales
ADMINISTRACION FEDERAL DE INGRESOS PUBLICOS - Procedimiento. Régimen especial de emisión y almacenamiento electrónico de comprobantes originales. Codificación de las operaciones efectuadas. Resolución General Nº 2485, sus modificatorias y complementarias. Norma complementaria. Resolución General Nº 2757, su modificatoria y sus complementarias. Su derogación.

[arriba]




Consideraciones generales


Tabla de Documentación

Arquitectura Webservices
Asociar el Ceritificado Digital a un Webservice de Negocio
Herramientas de Análisis / Depuración


Lista de autoridades certificantes reconocidas y utilizadas por AFIP para servicios SSL/TLS. Verifique que las mismas se encuentren incluidas en las aplicaciones informáticas que utilizan los Webservices del organismo.

Autoridad Certificado
Geotrust Global CA. Formato DER
Formato PEM
Servidor Certificado
wsaa.afip.gov.ar  * Formato DER
Formato PEM

El día 15 de mayo de 2012 a las 11hs, se realizará el cambio de certificado SSL del  servidor wsaa.afip.gov.ar. La autoridad certificante emisora de dicho certificado  continuará siendo la misma por lo que la gran mayoría de los casos no se verán afectados.


[arriba]


WSAA - WebService de Autenticación y Autorización

Para poder autenticarse ante el WSAA necesita obtener un certificado digital X.509 emitido por la CA (Autoridad Certificante) de AFIP, a tales efectos, deberá generar una clave privada y un CSR (Certificate Signing Request). Deberá enviar el CSR, en el entorno de Testing a través de correo a la cuenta webservices@afip.gov.ar, y en el entorno de Producción a través de nuestro portal http://www.afip.gov.ar siguiendo los pasos indicados en la documentación.


Documentación

Especificación Técnica del WebService de Autenticación y Autorización
Generación de Certificados Digitales para Utilización con Webservices AFIP
Delegación de Webservices AFIP con el Administrador de Relaciones


Ejemplos



URLs

TESTING
PRODUCCION
https://wsaa.afip.gov.ar/ws/services/LoginCms


[arriba]




WSFE - WebService de Factura Electrónica



Documentación


Funcionamiento General del Servicio Web
Manual para el Desarrollador
Guía Adicional para el Desarrollador

Ejemplos


[arriba]



WSFEX- WebService de Factura Electrónica de Exportación


Documentación


Manual para el Desarrollador

Ejemplos




TRABAJO_F931

Permite consultar información de las Declaraciones Juradas F931 registradas en la base de datos de Seguridad Social de AFIP.
Actualmente es un servicio exclusivo habilitado para el Ministerio de Trabajo, Empleo y Seguridad Social Permite acceder a la siguiente información de las Declaraciones Juradas F931 registradas en la base de datos de Seguridad Social de AFIP:

1)
Consultas de presentación para una relación Empleador / Empleado / Período Fiscal. El webservice busca la declaración jurada del período (de no encontrar presentación, se busca hasta 3 períodos anteriores) e informa:
  PERIODO FISCAL de la DJ
  REMUNERACIÓN TOTAL declarada para el empleado en la DJ
  REMUNERACIÓN IMPONIBLE DE APORTES DE SEGURIDAD SOCIAL declarada para el empleado en la DJ
 
REMUNERACIÓN IMPONIBLE DE CONTRIBUCIONES DE SEGURIDAD SOCIAL declarada para el empleado en la DJ
Nota: el período fiscal solicitado debe estar dentro de los últimos 12 meses.
2)
Consultas de presentación para una relación Empleador / Período. El webservice busca la declaración jurada del período (de no encontrar presentación, se busca hasta 3 períodos anteriores) e informa:
  REMUNERACIÓN TOTAL declarada en la DJ determinativa
  REMUNERACIÓN IMPONIBLE DE APORTES DE SEGURIDAD SOCIAL declarada en la DJ determinativa.
  CANTIDAD DE EMPLEADOS declarados en la DJ.
Nota: el período fiscal solicitado debe estar dentro de los últimos 12 meses.


Documentación

Manual para el desarrollador README Casos de prueba


Ejemplos

[arriba]








WebService PUC Consulta nivel 3

Consulta los siguientes datos de un contribuyente pasando como parámetro su CUIT: datos de la persona, domicilios e impuestos inscriptos.


Documentación

Manual para el desarrollador CUITS.txt CONTRIBUYENTE-N3.xml TABLAS_SUPA_PARAMETROS
  README contribuyente-nivel3.dtd contribuyente-nivel3.xls

Ejemplos







WebService Creación de VEPs para entidades externas

Permite crear un VEP y enviarlo a una entidad de pago. También permite consultar el estado (enviado, pagado, expirado) de un VEP creado mediante este servicio.


Documentación





WebService Consulta de Deuda

Permite consultar si un contribuyente mantiene deuda liquida y exigible con AFIP pasando como parámetro su CUIT. Para responder (tiene o no tiene deuda) el sistema consulta los siguientes sistemas: Cuenta Corriente de Autónomos y Monotributo, SIRAEF (Juicios), Sistema de Cuentas Tributarias, Dosmil, Regional y Planes de Pago anteriores a MisFacilidades. Dependiendo del tipo de contribuyente y del estado de la deuda el servicio crea una tarea de relevamiento de deuda para la agencia posponiendo la respuesta e indicando la fecha en que puede volver a consultar.





WebService PUC Consulta nivel 10

Permite consultar los siguientes datos de un contribuyente pasando como parámetro su cuit: datos de la persona y domicilios


Documentación








WS Transmisión del MIC Chile

Permite la recepción del Documento Mic-Dta provinientes de Chile.





WS Envío de Documementación Mic-Dta y seguimiento a traves de eventos

Permite la recepción del Documento Mic-Dta de los estados partes del acuerdo.




WS Transmisión Padrón de e ATAs y Transportistas

Permite consultar las tablas de ATA y transportistas. A ser reemplazado por el wGesTabRef.






WS-Consulta de Tablas de Referencia

Permite visualizar las tablas de referencia MARIA. A ser reemplazado por el wGesTabRef..





Consultas Depositario Fiel

Permite realizar consultas de estados de los legajos y además lista todos los legajos que se encuentran en estado ENDO para un determinado PSAD.




WS Movimientos de Ingreso/Egreso para Terminales/Deposistarios

Posibilita realizar salidas de zona primaria de importacion general, salida directo a plaza, salida zona primaria de exportacion, salida de contenedores


Documentación

Manual Para El Desarrollador README






Actualización/Consulta PEMA

Permite a los prestadores PEMA actualizar los dispositivos DES para traslados, tránsito como asi también realizar la consulta de los mismos.


Documentación

Manual Para El Desarrollador README






WS-Digitalizacion de Depositario Fiel

Permite digitalizar legajos a los PSAD y Despachantes.




Recepcion de Eventos de Entrada y Salida de Vehiculos

Posibilita la recepción de información de Chile relativa al Ingreso y egreso de vehículos (argentinos o correspondientes a dicho país) y consulta de los datos de egreso de un vehículo argentino.


Documentación







WebService-Aprobar y Denegar Despachos INV

Permite al Instituto Nacional de Vitivinicultura consultar, aprobar o denegar despachos que se encuentren bajo el régimen de vitivinicultura.



Documentación

Manual Para El Desarrollador README


Ejemplos





WebService Transmisión de Tablas de Referencia

Posiblita visualizar las tablas de referencia MARIA.





WebService Autenticacion y Autorizacion

Permite la obtencion de credenciales de acceso para los WebSerivices de negocio


Documentación

AFIP-WS-Arquitectura README
Especificacion_Tecnica_WSAA_1.2.0. cert-req-howto
Herramientas Utiles ClienteLoginCms_VB.exe.zip
wsaa_obtener_certificado_produccion  
wsaa_asociar_certificado_a_wsn_produccion  



Ejemplos






WebService Bonos Fiscales Electronicos - BFE

Permite la autorización de comprobantes electrónicos, a fin de gestionar los Bonos en la Secretaría de Industria según RG 2557


Documentación

Guia Adicional Para El Programador README
Manual Para El Desarrollador  





WebService Certificados DNRPA

Permite la consulta por parte de la Dirección Nacional de los Registros de la Propiedad Automotor de los certificados CETA (Certificado de Transferencia



Documentación

Manual Para El Desarrollador README


Ejemplos





WebService Código de Trazabilidad de Granos

Permite la obtención del Código de Trazabilidad de Granos para los contribuyentes del universo agropecuario.


Documentación

Manual Para El Desarrollador - V.1.1 README
Diseño de Registros XML - V.1.1 AFIPRootDesaCA.zip

Ejemplos






WebService Factura Electrónica con Detalle - MTXCA

Permite la autorización de comprobantes (cabecera y detalle) para Facturación Electrónica para nominados en el marco del Programa MATRIX según RG 2904



Documentación

Manual Para El Desarrollador README


Ejemplos




WebService Automatizacion Res. Revocacion A.P.E.

Web-Service para envío automático por parte del organimso A.P.E. del Ministerio de Salud,  de las Resoluciones de Revocación emitidas para el  cobro de deudas que mantienen las Obras Sociales con dicho organismo. Estas RR son procesadas internamente por el sistema S.T.E. (Sistema de Transferencias Externas) que se encarga de retener de la distribución previsional de cada O.S. los fondos adeudados y transferirlos al A.P.E. a través  de Notas de Transferencia enviadas al B.N.A. La funcionalidad descripta está reglamentada por el Decreto 213/04.





WebService de ONCCA Reporte Fiscal Compensaciones

Web-Service para envío automático por parte del organimso A.P.E. del Ministerio de Salud,  de las Resoluciones de Revocación emitidas para el  cobro de deudas que mantienen las Obras Sociales con dicho organismo. Estas RR son procesadas internamente por el sistema S.T.E. (Sistema de Transferencias Externas) que se encarga de retener de la distribución previsional de cada O.S. los fondos adeudados y transferirlos al A.P.E. a través  de Notas de Transferencia enviadas al B.N.A. La funcionalidad descripta está reglamentada por el Decreto 213/04.



Documentación

README
AFIPRootDesaCA.zip





WebService Regimen Percepcion IVA

Permite la consulta por parte de los responsables obligados a actuar como agentes del Régimen especial de ingreso de IVA en el comercio por Internet a través de “portales virtuales” puedan consultar la situación de los sujetos pasibles, a fin de cumplir con lo establecido en la RG 2955/2010.


Documentación

Manual Para El Desarrollador README


Ejemplos







WebService - Operacion de Seguros de Caucion - SEG

Permite la autorización de comprobantes (cabecera y montos globales) para Facturación Electrónica para las empresas que emiten Seguros de Caución según RG 2668


Documentación

Guia Adicional Para El Programador F136_MOTIVOS
Manual Para El Desarrollador README


Ejemplos






WebService Seguimiento Vehicular

Usado por los prestadores OLS para informar las posiciones geográficas y estado de los Precintos Electrónicos de Monitoreo Aduanero instalados en los contenedores en tránsito.



Documentación

Manual Para El Desarrollador README
Manual De Generacion De Rutas Con GoogleEarth  
Ruta De Calibracion  
Agregar Datos De Rutas  


Ejemplos





WebService Consulta de Operaciones Cambiarias ( C.O.C.)

.


Documentación

 
Manual Para El Desarrollador (Versión 1.0 - Versión 1.1 - Versión 2.0 - Versión 2.1)
Presentacion de WS COC




Ejemplos

Cliente SOAP para el webservice de Consulta de Operaciones Cambiarias. Es un ejemplo open source para Visual Basic .NET.
Descargar ejemplo
Cliente SOAP para el webservice de Consulta de Operaciones Cambiarias. Proyecto .NET "Windows Forms Application" open source para Visual Basic .NET.
Descargar ejemplo