Sector Salud
      Volver al inicio
      1. Centro de Ayuda
      2. Integración API DATAICO S.A.S
      3. Sector Salud

      Documentación Técnica de la API de DATAICO FACTURA ELECTRÓNICA para el Sector Salud

      Guía Práctica

      Swagger (API Documentation): API DOCS Documentación Técnica FE

       

      Autentificación

      Para la transmisión de factura electronica para el sector salud, la API utiliza como método de autenticación los parámetros "Dataico_account_id" y "Auth-token". Para obtener estos datos de autenticación, sigue estos pasos:


      Haz clic en las opciones en la parte superior / selecciona "Configuración".

       

      Numeración

      Para obtener los datos de autorización de tu numeración o consecutivo de facturación electrónica, sigue estos pasos:

      Ventas / Facturas > Numeraciones > [Editar] 



       

      Crear factura electrónica para el sector salud

      Método: POST

      Endpoints (URL): https://api.dataico.com/direct/dataico_api/v2/invoices

      Headers

      • Content-type : application/json
      • Auth-token (Cuenta DATAICO)

      Ejemplo configuración en Postman


      ¿Cuáles son los nuevos campos que deben incluirse en las facturas electrónicas?

      A partir de la implementación de esta normativa, los prestadores de servicios de salud deberán incluir información adicional a los campos tradicionales. Los nuevos datos que deben figurar en las facturas electrónicas son:

      • Código del prestador de servicios de salud ("provider_code")
      • Tipo de documento de identificación del usuario ("identification_type")
      • Número de documento de identificación del usuario ("identification")
      • Primer apellido del usuario ("last_name")
      • Segundo apellido del usuario ("second_last_name")
      • Primer nombre del usuario ("first_name")
      • Segundo nombre del usuario ("second_first_name")
      • Tipo de usuario ("user_type")
      • Modalidades de contratación y pago ("payment_modality")
      • Cobertura o plan de beneficios ("coverage")
      • Número de autorización ("authorization_number")
      • Número de prescripción (MIPRES) ("mipres_number")
      • ID de entrega de prescripción (MIPRES) ("mipres_delivery_number")
      • Número de contrato ("contract_number")
      • Número de póliza ("policy_number")
      • Copago ("COPAGO")
      • Cuota moderadora ("CUOTA_MODERADORA")
      • Cuota de recuperación ("CUOTA_RECUPERACION")
      • Pagos compartidos en planes voluntarios de salud ("PAGOS_COMPARTIDOS")
      • Fecha de inicio del periodo de facturación ("period_start_date": "01/03/2024")
      • Fecha final del periodo de facturación ("period_end_date": "01/03/2024")


      Estructura JSON estándar

       

      Tipos de operación Salud (Conceptos)


      • SS-CUFE: (Acreditación) Este documento incluye referencias de Factura Electrónica de Venta (tipo 01 o 04) que comprueba el recaudo de Cuotas Moderadoras, Copagos o Cuotas de Recuperación, con recursos a favor de terceros, los cuales son acreditados a la presente Factura Electrónica de Venta con destino a la aseguradora que aparece como adquiriente. Activa el Método de cálculo del Sector Salud.
      • SS-CUDE: (Acreditación) Este documento incluye referencias de Factura de Contingencia (tipos 03) que reconoce valores recaudados correspondientes a Cuotas Moderadoras, Copagos o Cuotas de Recuperación, como ingresos a favor de terceros, los cuales son acreditados a la presente Factura Electrónica de Venta con destino a la aseguradora que aparece como adquiriente. Activa el Método de cálculo del Sector Salud.
      • SS-POS: (Observación) Los valores recaudados a favor de terceros por el operador del sistema de salud mediante los comprobantes del Sistema POS serán automatizados por la DIAN, y deberán reportarse cada vez que se cierra una caja de recaudo. 
      • SS-SNum: (Acreditación) Este documento incluye referencias de Factura Talonario que comprueba el recaudo de Cuotas Moderadoras, Copagos o Cuotas de Recuperación, con recursos a favor de terceros, los cuales son acreditados a la presente Factura Electrónica de Venta con destino a la aseguradora que aparece como adquiriente. Activa el Método de cálculo del Sector Salud.
      • SS-Recaudo: (Recaudación) Comprobante de recaudo de Cuotas Moderadoras, Copagos o Cuotas de Recuperación, con recursos a favor de terceros. No Activa el Método de cálculo del Sector Salud.
      • SS-Reporte: (Reporte) Este documento reporta referencias de diversas índole que comprueban recaudo de Cuotas Moderadoras, Copagos o Cuotas de Recuperación a las aseguradoras y se les trata contablemente. No Activa el Método de cálculo del Sector Salud.
      • SS-SinAporte:  (Reporte) Sin aporte ni recaudo en dinero por parte de los afiliados del régimen contributivo por concepto de Cuotas Moderadoras, Copagos o Cuotas de Recuperación. No Activa el Método de cálculo del Sector Salud.

      • Activa el Método del cálculo del Sector Salud: Hace referencia a que el Anticipo, Cuota moderadora o Copago, DESCUENTA del total de la factura, el valor recibido o registrado.
      • No Activa el Método del cálculo del Sector Salud: Hace referencia a que el Anticipo, Cuota moderadora o Copago, NO DESCUENTA del total de la factura, el valor recibido o registrado.

       

      Recursos Adicionales

      +  Código ciudades y departamentos de Colombia
      +  Código países
      +  Código unidades de medidas
      +  Guía de Solución de Problemas API DATAICO FACTURA ELECTRÓNICA
      +  Consultar factura
      +  Reenviar factura
      +  Enviar factura al cliente con una representación gráfica personalizada.
      +  Crear nota crédito
      +  Crear nota debito

       

      Contacto

      Si después de seguir estos pasos tienes alguna duda o encuentras algún problema, no dudes en ponerte en contacto con nuestro equipo de soporte a través de nuestro Chat 💬.

       

      small-logo