ES
Español
English
Português
    Creación de Caso

    Esta operación crea un caso y al crearlo guarda los archivos adjuntos, tanto del caso, como de sus campos adicionales; después de guardarlos borra los archivos de la carpeta temporal creada para ello.

    Detalles de la petición

    • URL Base: {host}/ASMSAPI/
    • Uri: api/v9/item
    • Tipo: POST

    • Encabezados requeridos:

      • content-type: application/json
      • X-Authorization: Bearer {token}

    Descripción de la URL

    • {host}: Representa el dominio del ambiente en el que se encuentra la API.
    • ASMSAPI/: Prefijo fijo de la API.
    • Uri: Endpoint específico para la petición.


    ⚐ EJEMPLO URL:

    https://{host}/ASMSAPI/api/v9/item


    Parámetros:

    Nombre Tipo de dato Obligatorio Descripción
    applicantId Int No Identificador del solicitante del caso.
    authorId Int No Identificador del autor del caso.
    categoryId Int Si Identificador de la categoría del caso.
    cause String No Descripción de la causa raíz del problema, aplicable únicamente cuando el tipo de ítem (itemType) es 2, lo que indica que se trata de un problema.
    ciId Int No Identificador del ítem de configuración (CI).
    ciName String No Nombre del ítem de configuración (CI).
    companyId Int No Identificador de la compañía.
    consoleType String Si Tipo de consola usada para crear el caso (Specialist= 1, Client = 2, Administrator= 3, CMDB = 4).
    customerId Int No Identificador del cliente.
    description String No Descripción del caso, puede incluir contenido HTML.
    groupId Int No Identificador del grupo de especialista asociado al caso.
    impactId Int No Identificador del impacto.
    itemType Int Si Tipo de caso:
    1. Incidente
    2. Problema
    3. Cambio
    4. Requerimiento de servicio
    13. Liberación
    itemVersion Int No Versión del caso.
    locationId Int No Identificador de la ubicación.
    modelId Int Si Identificador del modelo operativo.
    priorityId Int No Identificador de la prioridad.
    projectId Int Si Identificador del proyecto.
    providerId Int No Identificador del proveedor.
    reasonId Int No Identificador de la razón.
    registryTypeId Int No Tipo de registro del caso.
    responsibleId Int No Identificador del responsable del caso.
    serviceId Int Si Identificador del servicio.
    stateId Int Si Identificador del estado inicial del caso.
    subject String No Asunto del caso.
    urgencyId Int No Identificador de la urgencia
    listAdditionalField Array Si Lista de campos adicionales del caso. Si el caso a crear no requiere campos adicionales, colocar el arreglo vacío. Ej. “listAdditionalField”: []
    tempItemId Int No Identificador temporal del ítem. este debe ser negativo. Ejemplo: -1

    Cuerpo de la petición

    {

  "categoryId": 1110,

  "cause": "",

  "ciId": 6955,

  "ciName": "HIS ISIS PRODUCCIÓN",

  "companyId": 35,

  "consoleType": 1,

  "correctActions": null,

  "currentTime": 0,

  "customerId": 19994,

  "applicantId": 19994,

  "description": "prueba",

  "foregroundColorRgb": "255.255.255",

  "followUpActions": null,

  "hasMoreInformation": false,

  "hasPendingSurvey": false,

  "estimatedCost": 0,

  "realCost": 0,

  "recomendations": null,

  "impactId": 3,

  "incorrectActions": null,

  "instance": 1782334251107,

  "isFeeAvailable": true,

  "itemType": 4,

  "itemVersion": 3,

  "knownError": null,

  "majorProblem": null,

  "modelId": 26,

  "unitId": null,

  "priorityReason": null,

  "projectId": 2,

  "providerId": null,

  "reasonId": 340,

  "registryTypeId": 11,

  "groupId": 17,

  "serviceId": 16,

  "stateId": 204,

  "subject": "CANCELAR - PRUEBA",

  "surveyToken": null,

  "thirdParty": null,

  "transformed": false,

  "listAdditionalField": [

    {

      "boolValue": null,

      "catalogId": null,

      "dataSourceId": null,

      "dateValue": null,

      "description": "[ES] Numero Celular",

      "enable": true,

      "fieldId": 455,

      "fieldType": 1,

      "fieldTypeName": "shortext",

      "floatValue": null,

      "identifier": null,

      "inputStream": null,

      "intValue": null,

      "itemId": null,

      "mandatory": true,

      "name": "[ES] Numero Celular",

      "order": null,

      "projectId": null,

      "stringValue": "123456",

      "type": null,

      "url": null,

      "visible": true

    },

    {

      "boolValue": null,

      "catalogId": null,

      "dataSourceId": null,

      "dateValue": null,

      "description": "[ES] Ubicación Exacta (Piso y Area)",

      "enable": true,

      "fieldId": 457,

      "fieldType": 1,

      "fieldTypeName": "shortext",

      "floatValue": null,

      "identifier": null,

      "inputStream": null,

      "intValue": null,

      "itemId": null,

      "mandatory": true,

      "name": "[ES] Ubicación Exacta (Piso y Area)",

      "order": null,

      "projectId": null,

      "stringValue": "Bogota",

      "type": null,

      "url": null,

      "visible": true

    },

    {

      "boolValue": null,

      "catalogId": null,

      "dataSourceId": null,

      "dateValue": null,

      "description": "[ES] Jefe de Area",

      "enable": true,

      "fieldId": 459,

      "fieldType": 1,

      "fieldTypeName": "shortext",

      "floatValue": null,

      "identifier": null,

      "inputStream": null,

      "intValue": null,

      "itemId": null,

      "mandatory": true,

      "name": "[ES] Jefe de Area",

      "order": null,

      "projectId": 2,

      "stringValue": "Cesar Munevar",

      "type": null,

      "url": null,

      "visible": true

    }

  ],

  "authorId": 19994,

  "tempItemId": -3

}

    Respuesta

    {

      "id": 84486,

      "idByProject": "RF-84486-19-407613" }

    Parámetros Response:

    Nombre Tipo de dato Descripción
    Id Int Identificador del caso
    idByProyect string Identificador del caso por proyecto

    Mensajes de error

    Código Estado HTTP Mensaje de error
    400 BadRequest \r\nNombre del parámetro: ConsoleType
    400 BadRequest \r\nNombre del parámetro: ItemType
    400 BadRequest \r\nNombre del parámetro: ListAdditionalField
    400 BadRequest \r\nNombre del parámetro: TempItemId
    400 BadRequest InvalidItemType
    400 BadRequest ModelIdIsEmpty
    400 BadRequest RequestNeedsSomeArguments
    400 BadRequest StateIdIsEmpty
    403 Forbidden DoNotHavePermissionForThisAction
    500 InternalServerError FailureAddItem