La información presentada a continuación, intenta ser una guía con recomendaciones de arquitectura, para implementar los medios interoperables, consensuados por el Proyecto MAIS, para establecer un modelo único de transacción para los ítems de facturación y débitos, entre Prestadores y Financiadores.
Los servicios definidos y que se deben implementar para respetar lo establecido son:
Todos los servicios pueden trabajar con JSON o XML (según definición de FHIR), por defecto utiliza JSON, ya que con esta implementación, la información que se transmite es menor. Para seleccionar un formato u otro se debe definir el HEADER HTTP “Accept” en “application/xml” o “application/json”.
Además están securizados con oAuth2, con excepción del endpoint de Autenticación.
POST /<context>/auth
Este servicio permite a las aplicaciones que deseen enviar información a un Financiador conectarse, autenticarse y obtener un token que habilita el acceso a los otros servicios. Ver bibliotecas que permiten la implementación de oAuth2 en http://oauth.net/2/
La secuencia es la siguiente:
Ejemplos xml o json con parametros definidos en formato Raw: http://mais.dasu.com.ar/index.php
POST /<context>/documento
Este servicio permite enviar al financiador la documentación de respaldo de la facturación, se puede tranferir los CDA recomendados por MAIS o documentos en cualquier otro formato. Estos documentos se pueden asociar a los ítems de facturación por medio de un ID o URL generada por el Financiador. El documento enviado se debe transformar al formato binario base 64.
Ejemplos xml o json con parametros definidos en formato Raw: http://mais.dasu.com.ar/index.php
POST /<context>/facturacion
A este servicio se envían las transacciones de facturación desde los Prestadores hacia los Financiadores, que las procesan y devuelven el estado inicial de aceptación de cada renglón. La validación completa es asincrónica y la respuesta de esta validación se gestiona con el servicio de Débitos. Por pruebas realizadas, se recomienda enviar archivos no mayores a 1000 items, utilizando formato JSON.
Ejemplos xml o json con parametros definidos en formato Raw: http://mais.dasu.com.ar/index.php
GET /<context>/debitos/fecha_rango/<desde (ddMMyyyy)>/<hasta (ddMMyyyy)> GET /<context>/debitos/nro_factura/<nro_factura (Letra%20Delegación%20Número)> GET /<context>/debitos/transaccion/<ID Transacción (ID que retorna servicio de facturación)>
Pedido de estado del análisis de los items de facturación., puede ser por fechas, número de factura o id de transacción.
A este servicio los Prestadores envían las consultas para conocer el estado de los trámites y ver si hay débitos generados por los Financiadores. Retornará una lista con información del estado del trámite, (en proceso, en proceso con débitos, finalizado y finalizado con débitos).
Ejemplos xml o json con parámetros definidos en formato Raw: http://mais.dasu.com.ar/index.php
Comienzo del proceso de transferencia de Información: Facturación
Consulta de Débitos, al mes o a los 15 días.