---
title: "Cancelación del Endoso (040)"
method: POST
path: "/radian/endorsement-cancellation"
tags: ["RADIAN"]
---

# Cancelación del Endoso (040)

`POST /radian/endorsement-cancellation`

Endpoint para crear un evento de Cancelación de Endoso en el RADIAN. Este evento anula un endoso de una factura electrónica de venta como título valor.

## Request body

- object — Objeto con la información para crear un evento de Cancelación de Endoso (040).<br><i>Evento RADIAN 040 - Cancelación de endoso</i>
  - `documentId` string — <b>Identificador del documento registrado en la API.</b><br>Si el documento de referencia fue emitido a través de la API, este ID es suficiente para identificarlo. En caso contrario, todos los demás campos de la petición serán obligatorios
  - `number` string — Número del endoso, el valor es alfanumérico, no se puede repetir el numero para el tipo de evento.
  - `type` '401' | '402' — <b>Tipo de operación</b>, acepta uno de los siguientes códigos:<br><b>401</b>: Cancelación del Endoso en Garantia<br><b>402</b>: Cancelación de Endoso en Procuración
  - `companyId` string, required — Id de la empresa en la que se generará el endoso de garantía. Se utiliza para validar la existencia de la compañía en la base de datos y obtener los datos de la compañía. ⚠️ Importante: La información en la base de datos debe estar completa y actualizada.
  - `receiverParty` ReceiverParty — unresolved $ref
  - `associatedDocument` object — Objeto que contiene la información del endoso referenciado.<br><i>Campo oficial DIAN &lt;DocumentReference&gt;</i>
    - `number` string, required — Número consecutivo de la referencia.<br><i>Campo oficial DIAN &lt;ID&gt;</i>
    - `uuid` string, required — CUDE del evento del endoso en garantía o procuración referenciado.<br><i>Campo oficial DIAN &lt;UUID&gt;</i>
  - `notes` string[] — Información adicional que se quiera agregar en el evento.<br><i>Campo oficial DIAN &lt;Note&gt;</i>

## Other responses

- `201` — unresolved $ref
- `400` — Objeto que representa una respuesta de error por validaciones
- `404` — Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder
- `500` — Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

---

[API](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/revisions/5fcb0d90e251/schema)