Eliminar entidad personalizada (ítem)

Esta operación te permite eliminar un elemento específico que pertenece a una entidad personalizada.

Sigue los principios REST y se ajusta al estándar OData v4.01.

Endpoint de [DELETE] Entidad personalizada (ítem)

https://api2.saleslayer.com/rest/Catalog/CustomEntities('{customEntityDenominator}')/Item({itemId})

Realizar una solicitud

• Usa el método HTTP: DELETE.
• Incluye la API key en las cabeceras de la solicitud para la autenticación.
• No requiere body en la solicitud.
• Parámetros obligatorios en la ruta
  • CustomEntityDenominator: nombre identificador de la entidad personalizada.
  • itemId: identificador único del elemento que se va a eliminar.

Ejemplo de solicitud:

DELETE /rest/Catalog/CustomEntity('Sales')/Item(507)

Respuesta

204 Sin contenido

El elemento se ha eliminado correctamente. No se devuelve contenido adicional.

400 Solicitud incorrecta

Los errores más habituales incluyen:

• El ID proporcionado tiene un formato incorrecto, debe ser numérico.
• Faltan parámetros obligatorios o no son válidos.

"The identifier xxxx_id is invalid or not found"

401 No autorizado

Falta la API key o no es válida.

403 Prohibido

El usuario no tiene permisos para realizar esta operación.

404 No encontrado

El elemento especificado por itemtId no existe o su estado es 'X' (ya eliminado).

412 Fallo de precondición

El sistema no está en un estado válido para realizar la operación.

500 Error interno del servidor

Fallo inesperado del sistema.

Limitaciones y consideraciones

• Solo se puede eliminar un elemento de la entidad personalizada por solicitud.
• La eliminación no es compatible en entornos con atributos de múltiples tablas.