Crea una solicitud en Modela con toda la información recibida, esta solicitud generada, se generará en estado BORRADOR si no recibe la acción a ejecutar o se pondrá en el estado correspondiente a la acción recibida en el JSON la cual siempre debe ser una acción del estado INICIO de la solicitud.
TIPO: POST
URL: https://HOST_MODELA/public/external/request/create
Para su uso necesitamos un token del tipo Creación petición.
Debemos enviar el JSON, que obtenemos en la llamada a Obtener el JSON para crear una solicitud, con los valores deseados en el cuerpo de esta petición.
Si no enviamos la propiedad Action la solicitud la crearemos en estado Borrador
Debemos tener en cuenta que Modela realizará las mismas validaciones de campos requeridos, calculados, etc… que si creáramos la solicitud desde la web de Modela.
Ejemplo de una llamada, donde {REPLACE_INSTANCE_GENERATED_TOKEN} debe ser el valor del token:
curl --location 'https://demo.getmodela.com/public/external/request/create' \
--header 'token: {REPLACE_INSTANCE_GENERATED_TOKEN}'
--header 'Company-Id: {REPLACE_COMPANY_ID}'
--header 'Content-Type: application/json' \
--data '{
"ProcessCode": "FAC",
"ObjectIdOwner": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeee",
"CompanyCode": "MT",
"Subject": "Test solicitud externa",
"Summary": "Test solicitud externa",
"AdditionalComments": "Comentario adicional",
"AdditionalInfoAttachments": [ {
"fileName": "prueba.txt",
"content": "data:text/plain;base64,AmljaGVybyBkZSBwcnVlYmEgP29uIHjleHRfIHBhcmEgcHJ1ZWJhcw==",
"mimeType": "text/plain",
"description": "fichero de prueba 1"
}],
"Action": "Cond",
"FormField":[
{
"IdInternal":"FIELD_TEXT_1",
"Value":[
{
"Value":"Campo con valor de texto"
}
]
},
{
"IdInternal":"FIELD_DATE_1",
"Value":[
{
"Value":"2024-08-25"
}
]
},
{
"IdInternal":"FIELD_NUMBER_1",
"Value":[
{
"Value":"123.45"
}
]
}
]
}'
Los posibles errores que nos devuelve este método, al realizar las validaciones previas a generar la solicitud, pueden ser:
OWNER_NOT_EXISTS: El creador que hemos enviado no existe.
OWNER_NO_ROLES: El creador que hemos enviado no tiene rol para acceder a Orchestra.
PROCESS_NOT_FOUND: No existe ningún proceso para el código recibido.
NOT_VERSION_PUBLISH: No existe una versión pública para el código proceso indicado.
COMPANY_NOT_EXISTS: No existe la Sociedad.
INVALID_TARGET_STATUS: El estado que hemos enviado para la solicitud no existe o no es válido.
ERROR_NUMBER_VALUE: El formato de un campo numérico no es valido.
NOT_EXISTS_CODE: El código de un campo de tipo opción de selección no existe.
ERROR_DATE_VALUE: El formato de un campo fecha no es valido (debe ser YYYY-MM-DD)
NOT_EXISTS_USER: No existe en Azure alguno de los usuarios para el tipo de campo lista de usuarios.
NOT_EXISTS_CUSTOM_LIST_CODE: No existe un código para la lista personalizada.
CUSTOM_LIST_DATA_INVALID: Algún código de una lista personalizada no es válido, puede ser por enviar una jerarquía y que no sea correcta.
NOT_EXISTS_ID_INTERNAL: Algún Id Interno enviado no existe en el formulario.
A parte de estos errores, este método puede devolver los errores propios a la creación de una solicitud desde la web de Modela.