Añadir Documentación a una Solicitud de Cancelación

Este método permite que Colaborador adjunte documentos a una solicitud de cancelación ya creada en el sistema de Experticket.

1. Método de Acceso

Parámetro

Descripción

URL

https://demo.api.experticket.com/api/cancellationrequest

Verbo HTTP

PUT

Tipo de Contenido

multipart/form-data

⚠️ IMPORTANTE: La solicitud NO debe enviarse en JSON ni XML, sino como multipart/form-data.

 

2. Estructura de Datos de Envío

Campo

Descripción

ApiKey

Clave única y privada del colaborador. Mantener en secreto.

CancellationRequestId

Obligatorio. Identificador de la solicitud de cancelación.

SaleId

Obligatorio. Identificador de la venta.

Attachments[n]

Archivos adjuntos en formato multipart/form-data. Se deben enumerar secuencialmente (Attachment[0]Attachment[1], etc.).

api-version

Versión del API (3.47 por defecto).

📌 Se pueden adjuntar múltiples documentos. Si se envía un solo archivo, debe ser Attachment[0].

 

3. Ejemplo de Solicitud PUT

🔹 Adjuntar 2 documentos a una solicitud de cancelación

PUT /api/cancellationrequest HTTP/1.1

Host: demo.api.experticket.com

Content-Type: multipart/form-data; boundary=----BoundaryString

 

------BoundaryString

Content-Disposition: form-data; name="ApiKey"

 

xyz123

------BoundaryString

Content-Disposition: form-data; name="CancellationRequestId"

 

81e8hfmxa16s6

------BoundaryString

Content-Disposition: form-data; name="SaleId"

 

5254956087182040038

------BoundaryString

Content-Disposition: form-data; name="Attachments[0]"; filename="document1.pdf"

Content-Type: application/pdf

 

(Binary file content here)

------BoundaryString

Content-Disposition: form-data; name="Attachments[1]"; filename="document2.jpg"

Content-Type: image/jpeg

 

(Binary file content here)

------BoundaryString--

4. Estructura de la Respuesta

Campo

Descripción

Success

true si los documentos se adjuntaron correctamente.

Timestamp

Marca de tiempo de la respuesta.

ErrorMessage

Mensaje de error si la solicitud falla.

ErrorCodes

Lista de códigos de error, si aplica.

ErrorEntityBreakDown

Información detallada en caso de error.

 

5. Ejemplo de Respuesta Exitosa

{

    "Success": true,

    "Timestamp": "2021-02-18T17:02:27.8165916",

    "ErrorEntityBreakDown": []

}

6. Consideraciones Finales

  • ✅ Este método permite agregar documentos justificativos a una solicitud de cancelación existente.
  • 📌 Debe enviarse como multipart/form-data, no JSON ni XML.
  • 📎 Se pueden adjuntar múltiples archivos (Attachment[0]Attachment[1], etc.).
  • ⚠️ Si Success = false, revisar ErrorMessageErrorCodes para más detalles.

¿Te ha parecido útil este artículo?