---
title: "Endoso en propiedad (037)"
method: POST
path: "/radian/ownership-endorsement"
tags: ["RADIAN"]
---

# Endoso en propiedad (037)

`POST /radian/ownership-endorsement`

Endpoint para crear un evento de Endoso en Propiedad en el RADIAN. Este evento endosa una factura electrónica de venta como título valor.

Tipos de endoso:
- **01**: Con responsabilidad del endosante
- **02**: En blanco con responsabilidad del endosante
- **03**: Sin responsabilidad del endosante
- **04**: En blanco sin responsabilidad del endosante

Cuando hay más de un endosante, exactamente uno debe tener `isMandatingParty: true` (mandante).

## Request body

- object — Objeto con la información para crear un evento de Endoso en Propiedad (037).<br><i>Evento RADIAN 037 - Endoso en propiedad</i>
  - `number` string, required — Consecutivo alfanumérico del evento de endoso. Debe ser único por empresa.<br><i>Campo oficial DIAN &lt;ID&gt;</i>
  - `type` '01' | '02' | '03' | '04', required — <b>Tipo de operación</b>, acepta uno de los siguientes códigos:<br><b>01</b>: Con responsabilidad del endosante<br><b>02</b>: En blanco con responsabilidad del endosante<br><b>03</b>: Sin responsabilidad del endosante<br><b>04</b>: En blanco sin responsabilidad del endosante
  - `companyId` string, required — Id de la empresa en la que se generará el endoso de propiedad. 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.
  - `endorsers` object[], required — Lista de endosantes cuando hay múltiples participantes en el endoso. Solo uno puede tener isMandatingParty = true (mandante).<br><i>Campo oficial DIAN &lt;PartyLegalEntity&gt; (Endosante)</i>
    - `isMandatingParty` boolean — Indica si el endoso se realiza mediante un mandato y participan uno o más endosantes.<br>Cuando el valor es true, el endoso es generado por el mandante y es obligatorio enviar la información de <b>cada endosante</b> en el arreglo <b>endorsers</b>.<br>Cuando el valor es false y no participan múltiples endosantes, el endoso es generado directamente por el emisor de la factura
    - `name` string — Nombre o Razón Social del generador del evento.<br><i>Campo oficial DIAN &lt;RegistrationName&gt;</i>
    - `organizationType` 1 | 2 — <b>Tipo de identificador de organización</b>. Se debe colocar el Código que corresponda de la tabla de tipos de organización jurídica de la DIAN.<br>Persona Jurídica y asimiladas (1). Persona Natural y asimiladas (2)<br><i>Campo oficial DIAN &lt;@schemeVersionID&gt;</i>
    - `identificationType` string — <b>Tipo de identificación</b>. Se debe colocar el Código que corresponda de la tabla de tipos de identificación de la DIAN.<br><i>Campo oficial DIAN &lt;@schemeName&gt;</i>
    - `identification` string — Número de identificación o NIT, sin guiones ni dv.<br><i>Campo oficial DIAN &lt;CompanyID&gt;</i>
    - `dv` string — DV del NIT. Es obligatorio si identificationType = 31.<br><i>Campo oficial DIAN &lt;@schemeID&gt;</i>
    - `taxCode` '01' | '04' | 'ZA' | 'ZZ' — Código tipo de impuesto según los códigos de la tabla de la DIAN.<br>IVA (01). INC (04). IVA e INC (ZA). No aplica (ZZ)<br><i>Campo oficial DIAN &lt;TaxScheme/ID&gt;</i>
    - `endorsedAmount` number — Valor sobre el cual participa como Endosante en el endoso.<br><i>CorporateStockAmount</i>
  - `issuerParty` object, required — Información del Adquiriente/Deudor del documento electrónico.<br><i>Campo oficial DIAN &lt;IssuerParty&gt;</i>
    - `name` string, required — Nombre o Razón Social del Adquiriente/Deudor del documento electrónico referenciado.<br><i>Campo oficial DIAN &lt;RegistrationName&gt;</i>
    - `identificationType` string, required — <b>Tipo de identificación</b>. Se debe colocar el Código que corresponda de la tabla de tipos de identificación de la DIAN.<br><i>Campo oficial DIAN &lt;@schemeName&gt;</i>
    - `identification` string, required — Nit del destinatario del del Adquiriente/deudor del documento electrónico referenciado, sin guiones ni dv.<br><i>Campo oficial DIAN &lt;CompanyID&gt;</i>
    - `dv` string — DV. Obligatorio si identificationType = 31.<br><i>Campo oficial DIAN &lt;@schemeID&gt;</i>
    - `organizationType` 1 | 2, required — <b>Tipo de identificador de organización</b>. Se debe colocar el Código que corresponda de la tabla de tipos de organización jurídica de la DIAN.<br>Persona Jurídica y asimiladas (1). Persona Natural y asimiladas (2)<br><i>Campo oficial DIAN &lt;@schemeVersionID&gt;</i>
    - `taxCode` '01' | '04' | 'ZA' | 'ZZ', required — Código de impuesto (TaxScheme/ID).
  - `notes` string[] — Notas adicionales del evento. Para tipo 372 (sin responsabilidad), se agrega automáticamente 'Sin mi responsabilidad u otra equivalente'.<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)