--- updatedAt: 2025-06-11T01:56:24.000Z agentTools: projectIndex: https://developers.osigu.com/llms.txt --- # Proceso de carga de pacientes Endpoint para el registro de pacientes. Con este servicio puedes agregar pacientes a un doctor previamente registrado con Osigu. Si tu request se encuentra correcto, recibirás un código de estado HTTP 202 indicando que el proceso de carga ha sido creado exitosamente y te retornará el ID del proceso con el que puedes consultar el estado y el resultado de la carga de cada paciente. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "genérico", "version": "4.0" }, "servers": [ { "url": "https://sandbox.osigu.com/" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "Authorization", "x-bearer-format": "bearer", "x-default": "99a801b4-6e34-4f64-94a9-c59ffc525c84" } } }, "security": [ { "sec0": [] } ], "paths": { "/ehr/v1/patients/bulk": { "post": { "summary": "Proceso de carga de pacientes", "description": "Endpoint para el registro de pacientes. Con este servicio puedes agregar pacientes a un doctor previamente registrado con Osigu.", "operationId": "ehr-1", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "medical_license_number", "patients" ], "properties": { "doctor_country_code": { "type": "string", "description": "Código de país donde ejerce el doctor, es requerido si no se envía el campo organization_slug", "default": "GT" }, "medical_license_number": { "type": "string", "description": "Licencia médica/cédula profesional/número de colegiado del doctor, es requerido si no se envía el campo organization_slug", "default": "2012-654" }, "organization_slug": { "type": "string", "description": "Identificador de la organizacion a la que va a asociarce el paciente, es requerido si no se envían los cambios doctor_country_code y medical_license_number" }, "patients": { "type": "array", "description": "Listado o colección de pacientes que deseas cargar", "items": { "properties": { "nationality_country_code": { "type": "string", "description": "*Código de país de la nacionalidad del paciente.", "default": "GT" }, "given_names": { "type": "string", "description": "Nombres del paciente" }, "surnames": { "type": "string", "description": "Apellidos del paciente" }, "sex": { "type": "string", "description": "Sexo del paciente, los valores admisibles son MALE o FEMALE.", "default": "MALE" }, "date_of_birth": { "type": "string", "description": "Fecha de nacimiento del paciente, formato válido según ISO 8601 extendido", "default": "1984-06-14" }, "residence_country_code": { "type": "string", "description": "País donde se encuentra reside el paciente, este código será utilizado para determinar código de area para envío de SMS", "default": "GT" }, "area_code": { "type": "string", "description": "Código telefónico del país" }, "phone_number": { "type": "string", "description": "Teléfono residencial o fijo del paciente", "default": "53135485" }, "mobile_phone_number": { "type": "string", "description": "Número de teléfono móvil del paciente.", "default": "25468787" }, "residence_address": { "type": "string", "description": "Dirección de residencia del paciente", "default": "Ruta 2, 4-71 Zona 4, Cuatro Venezia, apto 102" }, "related_patient": { "type": "boolean", "description": "Indicador de si el paciente es un paciente relacionado y el cuál indica que el correo electrónico y teléfono no es el del paciente sino de un familiar", "default": false }, "email_address": { "type": "string", "description": "Dirección de correo del paciente", "default": "juan.padilla.r@gmail.com" }, "tutor_identification": { "type": "boolean", "description": "Indica si los documentos de identificación pertenece al tutor del paciente", "default": false }, "identity_document_type": { "type": "string", "description": "Tipo de documento de Identidad del paciente, los posibles tipos admitidos son: NATIONAL_IDENTITY_CARD, PASSPORT, SOCIAL_SECURITY_NUMBER, DRIVER_LICENSE", "default": "NATIONAL_IDENTITY_CARD" }, "identity_document_id": { "type": "string", "description": "Número de documento que identifica a un paciente", "default": "2515-67444-0102" }, "external_patient_id": { "type": "string", "description": "Id del paciente del lado del proveedor", "default": "6677" } }, "required": [ "given_names", "surnames", "date_of_birth", "nationality_country_code", "related_patient", "email_address", "tutor_identification" ], "type": "object" } } } } } } }, "responses": { "201": { "description": "201", "content": { "application/json": { "examples": { "Result": { "value": "{\n 'id': '645c1c99-38a6-4cef-b924-858f280dfda9'\n}" } } } } }, "401": { "description": "401", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"error\": \"unauthorized\",\n \"error_description\": \"Full authentication is required to access this resource\"\n}" } }, "schema": { "type": "object", "properties": { "error": { "type": "string", "example": "unauthorized" }, "error_description": { "type": "string", "example": "Full authentication is required to access this resource" } } } } } }, "404": { "description": "404", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"code\": \"025-0300\",\n \"message\": \"El doctor aún no se encuentra registrado en nuestra plataforma\"\n}" } }, "schema": { "type": "object", "properties": { "code": { "type": "string", "example": "025-0300" }, "message": { "type": "string", "example": "El doctor aún no se encuentra registrado en nuestra plataforma" } } } } } }, "422": { "description": "422", "content": { "text/plain": { "examples": { "Result": { "value": "{\n \"code\": \"025-0500\",\n \"message\": \"Uno o más de los parámetros son inválidos.\",\n \"errors\": [\n {\n \"path\": \"medical_license_number\",\n \"message\": \"El número de licencia médica es requerido\"\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "code": { "type": "string", "example": "025-0500" }, "message": { "type": "string", "example": "Uno o más de los parámetros son inválidos." }, "errors": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "example": "medical_license_number" }, "message": { "type": "string", "example": "El número de licencia médica es requerido" } } } } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```