Crear o editar una afiliación

Endpoint que permite crear o editar una afiliación. Editar comentario Para editar comentario es necesario la llave commenty el string del comentario. Para eliminar comentario, enviar un string vacío. Formato: Las llaves y los valores del cuerpo de la solicitud se deben enviar en form-data. Archivos adjuntos: Los documentos que se envíen en el form_data deben ser de tipo PDF y de un tamaño máximo de 1 MB. Crear una afiliación: Solo los usuarios administradores de la empresa pueden crear una afiliación. Se debe enviar el parámetro entities_to_affiliate como un arreglo que puede contener alguno o todos: [compensation_fund, health_provider, pension_provider, risk_provider] Actualizar la afiliación: Los usuarios administradores y contadores de la empresa solo pueden editar la información de la afiliación cuando el estado de esta sea pending_info o rejected. Los usuarios superadmin y editor de Aleluya son quienes aprueban, rechazan o reciben una afiliación. Adicional, pueden realizar las mismas acciones que los usuarios administradores y contadores de la empresa. > ⚠️ Para solicitar una afiliación, deben especificarse las entidades a las que se realizará la afiliación, tanto para el cotizante como para los beneficiarios. En caso de que haya algún reproceso con alguna de las entidades, como por ejemplo la falta de credenciales para esa entidad, el superadmin puede agregar la propiedad missing_credentials a la entidad específica que presenta el problema. Aprobar una afiliación: Un usuario superadmin o editor de Aleluya es el único que puede aprobar una afiliación. Se debe enviar obligatoriamente el status como approved y los documentos que certifiquen las afiliaciones. Solo se pueden aprobar una afiliación si esta se encuentra en estado received o occurrence y tiene al menos un certificado adjunto. A continuación, más detalle: | Campo | Comentarios | Valor | | --- | --- | --- | | status | Estado a actualizar de la afiliación | approved | | approved_compensation_fund_document | Se debe adjuntar si se realizó afiliación del empleado a la caja de compensación | Archivo con el certificado de afiliación a la caja de compensación | | approved_health_document | Se debe adjuntar si se realizó afiliación del empleado a la EPS | Archivo con el certificado de afiliación a la EPS | | approved_pension_document | Se debe adjuntar si se realizó afiliación del empleado a pensión | Archivo con el certificado de afiliación a pensión | | approved_risk_document | Se debe adjuntar si se realizó afiliación del empleado a la ARL | Archivo con el certificado de afiliación a la ARL | | approved_severance_document | Se debe adjuntar si se realizó afiliación del empleado al fondo de cesantías | Archivo con el certificado de afiliación al fondo de cesantías | Rechazar una afiliación: Un usuario superadmin o editor de Aleluya es el único que puede rechazar una afiliación. Se debe enviar obligatoriamente el status como rejected y la justificación del rechazo. A continuación, más detalle: | Campo | Comentarios | Valor | | --- | --- | --- | | status | Estado a actualizar de la afiliación | rejected | | rejected_comment | Es la justificación del por qué no se afilió al empleado | Comentario del rechazo de la afiliación | | rejected_reason | Es la razón del rechazo de la afiliación | slow_response | | invalid_documents | Es el objeto con la información de los archivos que no son correctos | { "documents": ["identification_document_file"] } | Para rejected_reason, las posibles razones de rechazo son: - error_in_beneficiary_documents: Documentos del beneficiario incompletos o erróneos - error_in_company_documents: Documentos de la empresa incompletos o erróneos - error_in_credentials: Credenciales erróneas - error_in_worker_documents: Documentos del empleado incompletos o erróneos Para invalid_documents en la llave documents, los posibles documentos que pueden incluirse en el arreglo para el empleado, son: - contract_document: Contrato de aprendizaje - identification_document: Documento de identificación Para la empresa, los posibles documentos son: - bank_certificate_document: Certificación bancaria - identification_document: Documento de Cámara de Comercio - legal_representative_document: Documento del representante legal - tax_document: RUT Para un beneficiario, los posibles documentos son: - adoption_certificate: Certificado de adopción - civil_registration: Registro civil - dependency_declaration: Declaración de dependencia - disability_certificate: Certificado de discapacidad - health_affiliation_certificate: Certificado de afiliación a salud - identification_document: Documento de identificación - labor_certificate: Certificado laboral - marriage_certificate: Certificado de matrimonio - parents_death_certificate: Certificado de defunción de los padres - study_document: Certificado de estudio > ⚠️ En caso de rechazar los documentos de un beneficiario, es necesario especificar el id del beneficiario, por ejemplo: { "id": abc, "documents": ["identification_document_file"] }. Recibir una afiliación: Un usuario superadmin o editor de Aleluya es el único que puede recibir una afiliación. Se debe enviar obligatoriamente el status como received. Cuando la afiliación se encuentre en este estado, se entiende que la información enviada por el cliente estuvo correcta y solo queda adjuntar los certificados de afiliación por parte del superadmin. Pasar a estado de novedad: Un usuario superadmin o editor de Aleluya puede pasar una afiliación al estado de novedad en caso de que se esté presentando una demora en la afiliación. Se debe enviar obligatoriamente el status como occurrence y la justificación de la novedad (ocurrence_reason). Las razones para la novedad pueden ser: - slow_response: Tiempo de respuesta mayor al habitual - auth_required: Se requiere segundo factor de autenticación - in_person_signup: Entidad solicita afiliación presencial - other: Otro