Beneficiarios

1

insurer_slug

String[64]

Slug de Payer
otorgado por Osigu.

2

policy_number

String[32]

Número de plan/póliza, este debe de coincidir con algún registro incluido en el archivo v2_policies.csv.

3

group_code

String[32]

Código del grupo, este debe de coincidir con algún registro incluido en el archivo v2_groups.csv.

4

policyholder_certificate

String[64]

Certificado del beneficiario, si el Payer no cuenta con este valor puede enviar una constante, como por ejemplo "CERT01".

5

insured_id

String[64]

Código de identificación del beneficiario, este debe de ser el código con el que se identifica de manera única la persona dentro del sistema del Payer.

6

status

Enum ( ENABLED | SUSPENDED | DISABLED )

Estado del beneficiario dentro de la póliza.

7

maximum_lifetime_benefit

Decimal(15,5)

Beneficio máximo vitalicio aplicable particularmente al beneficiario.

Este valor remplaza cualquier valor indicado a nivel de grupo.

Si existe un valor mayor a 0 especificado en el campo max_annual_benefit, entonces max_lifetime_benefit debe de ser 0.

8

maximum_annual_benefit

Decimal(15,5)

Beneficio máximo durante vigencia de póliza, aplicable particularmente al beneficiario.

Este valor remplaza cualquier valor indicado a nivel de grupo.

Si existe un valor mayor a 0 especificado en el campo max_annual_benefit, entonces max_lifetime_benefit debe de ser 0.

9

policyholder_name

String[256]

Nombre del asegurado o beneficiario.

10

nationality_country_code

String[2] ISO 3166-1 alpha-2

Código de país de la nacionalidad del beneficiario.

11

identity_document_type

Enum ( NATIONAL_IDENTITY_CARD | PASSPORT | DRIVER_LICENSE | SOCIAL_SECURITY_NUMBER )

Tipo de documento de identificación del beneficiario.

Este campo es opcional, pero si el Payer decide utilizarlo dentro de los mecanismos de búsqueda de beneficiario, entonces deberá indicar este valor.

12

identity_document_id

String[64]

Número de identificación del beneficiario.

Este campo es opcional, pero si el Payer decide utilizarlo dentro de los mecanismos de búsqueda de beneficiario, entonces deberá indicar este valor.

13

sex

Enum ( MALE | FEMALE | NOT_KNOWN )

Sexo del paciente.

14

date_of_birth

Timestamp (string) using the ISO 8601

Fecha de nacimiento del beneficiario.

15

address

String[256]

Dirección del beneficiario.

16

email_address

String[256]

Dirección de correo electrónico del beneficiario.

17

phone_number

String[32]

Número de teléfono del beneficiario.

18

effective_date

timestamp (string) using the ISO 8601

Fecha de inicio de cobertura.

19

policyholder_owner

Boolean (string)

Indica si el beneficiario es dueño del certificado.

20

kinship

Enum ( WIFE | HUSBAND | SON | DAUGHTER )

Indica el parentesco entre el beneficiario y el dueño del certificado.

21

pre_existing_exclusion_period

Integer

Período de preexistencia o carencia que aún esta por cumplir, todas las preexistencias indicadas en la configuración de archivo o preexistencias configuradas a nivel general serán tomadas en cuenta cuando este valor no sea 0.

22

currency_code

String[3] using the ISO 4217

Código de la moneda utilizada para expresar los montos.

23

reimbursement_base_amount

Decimal(15,5)

Base de rembolso, este valor es únicamente para México, el resto de países deberá de enviar 0.

24

maximum_out_of_pocket

Decimal(15,5)

Monto máximo pagado por el asegurado, en donde el beneficiario deja de pagar participaciones (Stop Loss)

25

maximum_out_of_pocket_reached

Boolean (string)

Indica si el monto máximo de participación de beneficiario ya fue alcanzado.

26

outpatient_care_availability

Enum ( LIMITED | UNLIMITED | NOT_AVAILABLE | NOT_KNOWN )

Limite de eventos de cobertura de consultas médicas.

27

outpatient_care_limit

Integer

Límite total de eventos de consulta médica al que el beneficiario tiene derecho durante la vigencia de su póliza.

28

outpatient_care_available

Integer

Cantidad disponible de eventos de consulta médica al que el beneficiario tiene derecho.

29

net_premium_amount

Decimal(15,5)

Monto de la prima neta correspondiente al beneficiario.

Si el Payer no contempla este valor, deberá de enviar siempre 0.