Endpoint que permite crear, editar y eliminar un beneficiario Consideraciones: Este endpoint permite crear, editar y eliminar un beneficiario. Para hacer estas acciones se debe enviar la información de la siguiente manera: 1. Crear Enviar los siguientes parámetros (son requeridos worker_entities_to_affiliate, beneficiary_entities_to_affiliate, kinship, y name sin beneficiary_id). | Parámetro | Descripción | Obligatorio | Valores posibles | |-------------------------------------|----------------------------------------------------------------|-------------|-------------------------------------------------------------------------------------------------------------------| | worker_entities_to_affiliate | Entidades a las que se va a afiliar el cotizante (trabajador). | Sí | Arreglo que puede contener alguno o todos: [compensation_fund, health_provider, pension_provider, risk_provider]| | beneficiary_entities_to_affiliate | Entidades a las que se va a afiliar el beneficiario. | Sí | Arreglo que puede contener alguno o ambos: [compensation_fund, health_provider] | Documentos a solicitar dependiendo del tipo de beneficiario y las entidades a las que se va a afiliar el beneficiario: | Beneficiario | Salud | CCF | |----------------------|--------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------| | Hijo (0 - 7 años) | civil_registration - Registro Civil | civil_registration - Registro Civil | | Hijo (8 a 18 años) | civil_registration - Registro Civil, identification_document - Tarjeta de identidad | civil_registration - Registro Civil, identification_document - Tarjeta de identidad | | Hijo (19 a 25 años) | civil_registration - Registro Civil, identification_document - Documento de identificación | civil_registration - Registro Civil, identification_document - Documento de identificación, study_document - Certificado de estudios, dependency_declaration - Certificado de dependencia económica, disability_certificate - Certificado de discapacidad | | Cónyuge | identification_document - Documento de identificación, marriage_certificate - Registro de matrimonio o declaración de unión libre | identification_document - Documento de identificación, marriage_certificate - Registro de matrimonio o declaración de unión libre, labor_certificate - Certificado laboral o carta indicando que no se encuentra laborando | | Padres | identification_document - Documento de identificación, civil_registration - Registro Civil del trabajador | identification_document - Documento de identificación, civil_registration - Registro Civil del trabajador, health_affiliation_certificate - Certificado de afiliación a EPS en su grupo familiar, dependency_declaration - Declaración juramentada de dependencia | --- En caso de que se vaya a afiliar al beneficiario a ambas opciones (Salud y CCF), los documentos requeridos son: | Beneficiario | Ambas (Salud - CCF) | |----------------------|----------------------------------------------------------------------------------------------------| | Hijo (0 - 7 años) | civil_registration - Registro Civil | | Hijo (8 a 18 años) | civil_registration - Registro Civil, identification_document - Tarjeta de identidad | | Hijo (19 a 25 años) | civil_registration - Registro Civil, identification_document - Documento de identificación, study_document - Certificado de estudios, dependency_declaration - Certificado de dependencia económica, disability_certificate - Certificado de discapacidad | | Cónyuge | identification_document - Documento de identidad, marriage_certificate - Registro del matrimonio o declaración de unión libre, labor_certificate - Certificado laboral o carta indicando que no se encuentra laborando | | Padres | identification_document - Documento de identificación, civil_registration - Registro Civil del trabajador, health_affiliation_certificate - Certificado de afiliación a EPS en su grupo familiar, dependency_declaration - Declaración juramentada de dependencia | | Hijastros | identification_document - Documento de identificación, adoption_certificate - Certificado de adopción, dependency_declaration - Declaración juramentada de dependencia, health_affiliation_certificate - Certificado de afiliación a EPS en su grupo familiar, study_document - Certificado de estudios, parents_death_certificate - Registro civil de defunción de los padres biológicos | --- Documentos requeridos para hijastros: | Beneficiario | Salud | CCF | |--------------|---------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------| | Hijastro | identification_document - Documento de identificación, adoption_certificate - Certificado de adopción | civil_registration - Registro Civil, dependency_declaration - Declaración juramentada de dependencia económica, health_affiliation_certificate - Certificado de afiliación a EPS en su grupo familiar, study_document - Certificado de estudios, parents_death_certificate - Registro civil de defunción de los padres biológicos | --- Si se quiere afiliar a un hijastro a ambos beneficios (Salud y CCF), serían obligatorios todos los documentos de ambas categorías. --- 2. Editar Enviar los parámetros a editar junto con el beneficiary_id del beneficiario a editar. 3. Eliminar Enviar únicamente el beneficiary_id del beneficiario a eliminar. > ⚠️ Solo se puede crear o actualizar un beneficiario si el estado de la afiliación es pending_info o rejected.
patch
https://nominapp-api-stage.herokuapp.com/v1//workers//beneficiary