====== Introducción ======

Este documento pretende ser una guía para comprender el uso y la lectura de la información adjunta, la cual apuntala la definición consensuada en el Proyecto MAIS, para establecer un modelo único de transacción de ítems de facturación y débitos, entre prestadores y financiadores.

====== Servicios Definidos ======

Los servicios definidos son:

  * Login​: Servicio de autenticación de usuarios.
  * Facturación​: Recibe los ítems de facturación enviados por los Prestadores para su
  * posterior validación por parte del Financiador.
  * Débitos​: Retorna el resultado de la validación de los ítems de facturación que fueron
  * enviados con anterioridad a través del servicio de Facturación.
  * Documentación de Respaldo:​ Servicio para transferir la documentación digitalizada
  * que será referenciada en los trámites de facturación.

====== Endpoints Implementados ======

Todos los endpoints pueden trabajar con JSON o XML, 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.

  * Autenticación​: Utiliza oAuth.
      * POST /mais-fhir-conectathon/auth
  * Se debe enviar el usuario y la password.
  * Retorna token para utilizar en los endpoints restantes.
  * Facturación​: Se recomienda enviar archivos de 1000 items como máximo.
      * POST /mais-fhir-conectathon/facturacion
      * Se debe enviar los ítems de facturación en formato Bundle/Claim definido.
      * Retorna errores de formato del archivo, error de autenticación o un ID de tramite para ser consultado.
  * Débitos: ​Retorna los débitos con el formato definido Bundle/ClaimsResponse. Posee varios métodos de consulta.
      * Por rango de fechas: Fechas de emisión de las facturas. Formato de fechas ddMMyyyy
        * GET /mais-fhir-conectathon/debitos/fecha_rango/<desde>/<hasta>2
        * Retorna los débitos o una respuesta con el estado de los ítems contenidos en las facturas dentro del rango de fechas consultado.
      * Por número de factura: Formato: <Letra> <Delegación> <Número>
        * GET /mais-fhir-conectathon/debitos/nro_factura/<nro_factura>
        * Retorna los débitos o una respuesta con el estado de los ítems contenidos en la factura consultada.
      * Por ID de transacción: Es el ID retornado por el método de facturación.
        * GET /mais-fhir-conectathon/debitos/transaccion/<ID Transacción>
        * Retorna los débitos o una respuesta con el estado de los ítems con el ID consultado.
  * Documentos:
      * /mais-fhir-conectathon/documento
      * Se debe enviar una lista de objetos Binary.
      * Retorna una lista de ID de objetos almacenados.

====== Secuencia de Uso ======

{{  :e6156bbceffdf4d9c04b0b0adedd9e59.png  }}

Al mes o a los quince días.

{{  :dafb6ede476df275d05f995bf7c14d05.png  }}

====== Documentación Adjunta ======

Junto a este documento se entrega:

  * Raw con los ejemplos de los posibles Request y Response de los diferentes endpoints.
  * Proyecto de ejemplo para ser importado en [[https://chrome.google.com/webstore/detail/postman/fhbjgbiflinjbdggehcddcbncdddomop|Postman]]. (MAIS.Prod.postman_collection.json)
  * Documentación en linea: [[http://localhost:8052/help/#/|http://localhost:8052/help/#/]]
  * Servidor de Prueba:[[http://http://localhost/mais-fhir-conectathon|http://localhost/mais-fhir-conectathon]]
  * Fuentes del modelo [[https://github.com/mpielvitori/mais-fhir-conectathon|https://github.com/mpielvitori/mais-fhir-conectathon]].

====== Documentos Relacionados ======

  * Configuración y armado de un Bundle de Facturación
  * Configuración y armado de un Bundle de Débitos