Update Appointment External ID

Esta mutación permite actualizar de manera dinámica el identificador alfanumérico externo (externalId) asignado a una cita existente. Es una herramienta operativa clave para corregir, sincronizar o remapear las claves de correspondencia entre la plataforma y los sistemas de origen del integrador (como CRMs, gestores de expedientes o plataformas de tramitación).

⚠️ Regla crítica de estado (Business Rule): Para que la actualización sea procesada con éxito por el backend, la cita debe encontrarse estrictamente en un estado activo o pendiente. El motor de validación de la API denegará la mutación lanzando una excepción si la cita se encuentra en alguno de los siguientes estados de cierre o bloqueo:

• Cancelado (-1)

• Finalizado (60)

• Incompleto (65)

Detalles de la Solicitud

• Método HTTP: POST

• URL PRE: https://api.ovac.pre.councilbox.com/council/:councilId/act

• URL PRO: https://api.ovac.councilbox.com/council/:councilId/act

• Content-Type: multipart/form-data

Cabeceras (Headers)

Referencia de la API

Parámetros de entrada (Path parameters)

Campos de respuesta (Payload)

La mutación devuelve un objeto de confirmación estructurado bajo el campo raíz updateCouncil:

Ejemplos de código y peticiones

1. Consulta GraphQL

mutation UpdateCouncil (
    $council: CouncilInput!
){
    updateCouncil(
        council: $council
    ) {
        id
        externalId
    }
}

2. Variables de la petición (JSON Payload)

{
    "council": {
        "id": 65245,
        "externalId": "IdExterno000001" 
    }
}

3. Ejemplo de comando cURL

curl --location 'https://api.ovac.pre.councilbox.com/graphql' \
--header 'Content-Type: application/json' \
--header 'x-jwt-token: *****************' \
--data '{"query":"mutation UpdateCouncil ($council: CouncilInput!){ updateCouncil(council: $council) { id externalId } }","variables":{"council":{"id":65245,"externalId":"IdExterno000001"}}}'

4. Respuesta esperada (200 OK)

{
    "data": {
        "updateCouncil": {
            "id": 65245,
            "externalId": "IdExterno000001"
        }
    }
}

5. Respuesta cita Cancelada, Finalizada o Incompleta (400 KO)

{
    "errors": [
        {
            "message": "The externalId is not available in this company",
            "code": 400,
            "locations": [
                {
                    "line": 4,
                    "column": 5
                }
            ],
            "path": [
                "updateCouncil"
            ],
            "originalError": {
                "name": "UserError",
                "code": 400
            }
        }
    ],
    "data": {
        "updateCouncil": null
    }
}

Nota OpenAPI/Fern: esta operación GraphQL se documenta como /graphql/updatecouncil para que Fern pueda mostrarla como operación independiente. La ruta técnica real de ejecución es POST /graphql.