Documento de Especificaciones técnicas WS (webservices) Mi Facuturero.

Transcripción

1 Documento de Especificaciones técnicas WS (webservices) Mi Facuturero. Contenido Contenido... 1 Objetivo... 2 Alcance... 2 Porqué usar los Web Services Mi Facturero WebServices disponibles:... 2 Detalle de Web Services... 3 Web Service: WsContribuyente:... 3 Funciones:... 3 WSDL:... 3 Web Service: WsCE Funciones:... 3 WSDL:... 3 Web Service: WsTablasReferencias Funciones:... 4 WSDL:... 4 Web Service: WsAFIP Funciones:... 4 WSDL:... 4 Web Service: WsUtil Funciones:... 5 WSDL:... 5 Anexo I Autenticación... 6 Anexo II Estructura de Respuestas... 7 Contenido del mensaje de Respuesta... 8 Anexo I Tipos de Datos... 9

2 Objetivo Desarrolladores de aplicaciones de Escritorio, Webs o Móviles que requieran usar los WS (webservices) Mi Facuturero, e implementarlos en sus desarrollos. Alcance Este documento brinda las especificaciones técnicas para desarrollar el cliente de WebServices para consumir los WS Mi Facturero. Debe complementarse con los Anexos de Autenticación, Respuestas, Tipos de Datos y Ejemplos de peticiones y respuestas respectivamente. Porqué usar los Web Services Mi Facturero. Agiliza los tiempos de desarrollo. Configuración rápida y sencilla. Compatible con cualquier lenguaje de programación. Disponible para todas las aplicaciones, de escritorio, móviles, webs, etc. No debe preocuparse por los mantenimientos actualización ya que los WS Mi Facturero se actualizan de forma automática. Puede enfocarse mejor en su trabajo de desarrollo ya que solo debe procesar las respuestas de los WS Mi Facturero. Respuestas amigables en formato XML o JSON según su elección. Conexión segura SSL. Transparente para usted y sus clientes. WebServices disponibles: 1. WsContribuyente: Alta/Gestión Contratante WebServicesy Emisores de Comprobantes Electrónicos. 2. WsCE.: Emisión/Gestión Comprobante Electrónicos. 3. WsTablasReferencias: Tablas de referencias. 4. WsAFIP: Consulta Información útil de AFIP. 5. WsUtil: Funciones útiles.

3 Especificaciones técnicas WebServices Mi Facturero. 3 Detalle de Web Services Web Service: WsContribuyente: Descripción: Alta/Gestión Contratante WebServices y Emisores de Comprobantes Electrónicos. Funciones: 1. MisDatos (auth): Devuelve datos del contratante de Web Service. 2. AltaEmisor (auth, datosemisor, datoscd): Da de alta a un Emisor de Comprobantes (EC). 3. DatosEmisorPorCuit (auth, cuitemisor): Devuelve datos un EC según su CUIT. 4. ActualizaCarpetaDigital (auth, cuitemisor, datoscd): Actualiza datos de la Carpeta Digital de EC 5. DatosCarpetaDigital (auth, cuitemisor): Devuelve datos de Carpeta Digital de un EC WSDL: Web Service: WsCE. Descripción: Emisión/Gestión Comprobante Electrónicos. Funciones: 1. AutorizaCE(auth, CbteTipo, PtoVta, Encabezado, Tributos, Iva): Solicita Autorización de CE. 2. AutorizarLoteCE (auth, lotecbtes): Solicita Autorización para lote de CE. 3. UltimoNroCE(auth, cbtetipo, ptovta): Devuelve último número de Comprobante WSDL:

4 Web Service: WsTablasReferencias. Descripción: Consulta de tablas de Referencias Funciones: 1. TiposComprobantes(auth): Devuelve lista de Tipos de Comprobantes Aceptados. 2. TiposResponsables (auth): Devuelve lista de Tipos de Responsables. 3. TiposTributos(auth): Devuelve lista de Tributos 4. Provicnias(auth): Devuelve lista provincias. 5. TiposAlicutoas(auth): Devuelve lista de lista de Referencia Alícuotas 6. TiposReceptores(auth): Devuelve lista de Tipos de Receptores de CE (CUIT, DNI, CUIL, etc ) 7. ClasificadorActividades(auth): Devuelve arreglo con lista Tipos de Actividades. WSDL: Web Service: WsAFIP. Descripción: Consulta Información útil de AFIP Funciones: 1. EstadoServiciosAFIP (auth): Devuelve estado de servicios AFIP. 2. CotizacionMoneda(auth, moneda): Devuelve valor de cotización oficial de una moneda especifica. 3. FacturasApocrifas(auth, listacuits): Devuelve información relacionada con un CUIT Informado por AFIP como Factura Apócrifa. Consulta pública en WSDL:

5 Especificaciones técnicas WebServices Mi Facturero. 5 Web Service: WsUtil. Descripción: Funciones útiles Funciones: 1. GeneraCSR(auth, datos): Devuelve Firme CSR. WSDL:

6 Anexo I Autenticación Para consumir los WS Mi Facturero usted debe tener las credenciales de autenticación. Éstas credenciales están visibles en su Perfil Mi Facturero Opción de menú API, una vez que haya contratado algún tipo de licencia B2C o B2B. Auth : Arreglo asociativo compuesto por: cuit: CUIT del Contratante WS apikey: Generada al contratar licencia B2X. loginkey: Generada al contratar licencia B2X. devolverdatos (opcional): Indica si el WS Mi Facturero debe incluir los Datos Enviados, dentro de la Respuesta, al tener el valor s o n. Los Datos Enviados serán siempre devueltos dentro de la Respuesta por defecto, hasta que no se especifique lo contrario. formato_respuesta: (opcional): Indica el formato en que WS Mi Facturero responderá las variantes son xml o json. El formato por defecto de respuesta es xml, se incluya o no esta variable.

7 Especificaciones técnicas WebServices Mi Facturero. 7 Anexo II Estructura de Respuestas Familiarizarse con las respuestas de los WS Mi Facturero es lo único y más importante a realizar en la tarea de adecuación de aplicaciones para el programador. El desarrollador solamente debe procesar las respuestas de WS Mi Facturero. Los WS Mi Facturero, simplifican una tarea compleja en simples respuestas, para que las aplicaciones se comuniquen y funcionen correctamente, agilizando los tiempos de desarrollo, y ganando una, importante, reducción en el tiempo de implementación, actualización o desarrollo de aplicaciones. Los WS Mi Facturero, mantienen una encapsulación que permiten la actualización de los mismos de forma transparente y escalar en funciones y servicios sin necesidad de hacer ningún cambio drástico o significativo en las aplicaciones que los consuman. Es por ello que el desarrollador de aplicaciones, al usar los WS Mi Facturero, solamente debe enfocarse en las respuestas, para interpretarlas y procesarlas, sin que emplee mucho tiempo en ello y pueda continuar su labor de desarrollo, mantenimiento o actualización de aplicaciones propias, sin preocuparse de tareas de depuraciones, conexiones, integraciones, servidores, etc. Sencillamente debe hacer una llamada a los WS Mi Facturero y procesar su respuesta. Interpretar esta respuesta es sencillo y rápido y permite procesarlas desde la aplicación origen en dos formatos como son XML y JSON. Las respuestas de los WS Mi Facturero, son bien simples, amigables y claras para el lenguaje castellano. A continuación un simple ejemplo de comunicación Aplicación (escritorio, web o móvil) WS Mi Facturero, que ocurre en dos (2) simples pasos 1. Aplicación: Envía mensaje vía SOAP/WSDL a algún WS Mi Facturero. 2. WS Mi Facturero: Da una Respuesta con Datos solicitados o Errores ocurridos con código y mensaje de error, según sea el caso y dentro de la misma Respuesta. WS Mi Facturero devuelve los *Datos Enviados, útil para la depuración o procesamiento de la respuesta.

8 *: Los Datos Enviados serán siempre devueltos dentro de la Respuesta por defecto, hasta que no se especifique lo contrario. Si desea minimizar el tráfico de respuesta o no desea que estos los Datos Enviados no estén incluidos en la Respuesta, debe enviar dentro de Auth, la variable devolverdatos con valor n. Contenido del mensaje de Respuesta Respuesta: Raíz principal de respuesta del WS. Datos: Datos Solicitados. Se compone de la estructura de información de lo solicitado en cualquier WS. Errores: Errores ocurridos en la solicitud. Se compone de campos code y message indicando el código del error y mensaje devuelto respectivamente. DatosEnviados: Datos o parámetros enviados a la llamada WS. RespuestaAFIP: Estructura de respuesta WS de AFIP

9 Especificaciones técnicas WebServices Mi Facturero. 9 Anexo I Tipos de Datos En proceso

10