Captura de datos de médico

El cliente deberá proveer a Osigu información del médico con la que se pueda realizar una verificación del profesional con las distintas entidades que regulan la actividad médica en cada país.

Si el cliente ya posee la información que en esta guía se describe en su sistema, puede saltarse esta información y proceder con el siguiente paso para el envío de dicha información.

Osigu requiere de la siguiente información:

Información Personal

Atributo

Descripción

Tipo de dato

given_names

Primer y segundo nombre del médico.

Cadena de texto, longitud máxima de 128 caracteres.

first_surname

Primer apellido del médico.

Cadena de texto, longitud máxima de 64 caracteres.

second_surname

Segundo apellido del médico.

Cadena de texto, longitud máxima de 63 caracteres.

identity_document_type

Tipo de documento de identificación, en la mayoría de casos será una constante, definida por el valor NATIONAL_IDENTITY_CARD que será el documento de identidad nacional oficial del país.

Cadena de texto, longitud máxima de 64.

identity_document_value

Número o código de identificación personal.

Cadena de texto, longitud máxima de 64.

identity_document_expiration_date

Fecha de expiración del documento de identificación.

Cadena de texto que representa la fecha de expiración del documento de identidad, en formato ISO 8601.

email_address

Correo electrónico del médico. Este correo electrónico será utilizado por la plataforma para el envío de códigos de verificación, recordatorios y notificaciones.

Cadena de texto, longitud máxima de 256.

Si el correo electrónico proporcionado no ha sido validado previamente por el proveedor o no se tiene certeza de dicho valor, se recomienda la validación del correo electrónico por medio de un código enviado a dicha cuenta.

Osigu pone a disposición de dos servicios con la que puede realizar dicha validación, los cuales encuentra en la sección llamada REST API.

  1. Generación de OTP.
  2. Validación de OTP.

La validez de este correo es requerido, pues parte del proceso de receta electrónica requiere de su uso la autenticación y códigos de verificación previos a una firma electrónica.

Información de consultorio

La siguiente información será utilizada en el documento de receta de manera que pueda ser identificado y ubicada la clínica o consultorio del médico.

Atributo

Descripción

Tipo de dato

physical_address

Dirección física de clínica o consultorio.

Cadena de texto, longitud máxima de 256.

country_code

Código ISO 3166-1 Alpha Code 2 del país.

Cadena de texto, longitud máxima de 2.

state_name

Nombre del estado/comunidad/departamento.

Si no cuenta con un catálogo, puede hacer uso de este servicio.

Cadena de texto, longitud máxima de 1024.

state_id (opcional)

Id del estado/comunidad/departamento.

Este campo es opcional pero se recomienda su uso si esta utilizando nuestro catálogo.

Entero

city_name

Nombre de la ciudad/provincia, en algunos países corresponde al municipio a excepción de España.

Si no cuenta con un catálogo puede hace uso de este servicio.

Cadena de texto, longitud máxima de 1024.

city_id (opcional)

Id de la ciudad/provincia.

Este campo es opcional pero se recomienda su uso si esta utilizando nuestro catálogo.

Entero

city_subdivision_name

Nombre de la subdivisión de la ciudad o provincia. Para España, este es el nombre del municipio.

Si no cuenta con un catálogo puede hace uso de este servicio.

Cadena de texto, longitud máxima de 1024.

city_subdivision_id (opcional)

Id de la subdivisión de la ciudad.

Este campo es opcional pero se recomienda su uso si esta utilizando nuestro catálogo.

Entero

phone_area_code

Código de área de marcación telefónica del país.

Cadena de texto, longitud máxima de 16.

phone_number

Número de teléfono.

Cadena de texto, longitud máxima de 32.

Información profesional

Atributo

Descripción

Tipo

main_specialty_name

Nombre de la especialidad médica primaria.

Si no cuenta con un catálogo puede hace uso de este servicio.

Cadena de texto, longitud máxima de 256.

main_specialty_slug

Llave de texto de la especialidad médica primaria.

Este campo es opcional pero se recomienda su uso si esta utilizando nuestro catálogo.

Cadena de texto, longitud máxima de 128.

medical_license_verification_institution_slug (Requerido solo para España)

Identificador del consejo médico a través de la cual se realiza la verificación de estado de la licencia médica.

  • Para médicos enviar es-omc.
  • Para podólogos enviar es-cgcop.
  • Para dentistas enviar es-ocde.

Cadena de texto, longitud máxima de 64.

medical_issuing_institution

Nombre del colegio médico en la que se encuentra registrado.

Si no cuenta con un catálogo puede hace uso de este servicio.

Cadena de texto, longitud máxima de 128.

medical_license_number

Número de colegiado o licencia médica.

Cadena de texto, longitud máxima de 32.

salutation

Saludo o título/etiqueta profesional que desea anteponer al nombre.

Cadena de texto, longitud máxima de 64.

Adicional deberá tener fotografías del anverso y reverso del documento o carné colegial físico del médico, de forma que pueda ser adjuntado como documento de soporte.

Toda esta información recabada del médico será revisada por los agentes de verificación de proveedores de Osigu.