API Endpoints
Contáctanos

Endoso en propiedad (037)

post
https://sandbox-api.alegra.com/e-provider/col/v1/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).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Objeto con la información del evento de Endoso en Propiedad

Objeto con la información para crear un evento de Endoso en Propiedad (037).
Evento RADIAN 037 - Endoso en propiedad

string
required
length between 1 and 50
^[a-zA-Z0-9\-]+$

Consecutivo alfanumérico del evento de endoso. Debe ser único por empresa.
Campo oficial DIAN <ID>

string
enum
required

Tipo de operación, acepta uno de los siguientes códigos:
01: Con responsabilidad del endosante
02: En blanco con responsabilidad del endosante
03: Sin responsabilidad del endosante
04: En blanco sin responsabilidad del endosante

Allowed:
string
required
length between 26 and 26

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
array of objects
required
length ≥ 1

Lista de endosantes cuando hay múltiples participantes en el endoso. Solo uno puede tener isMandatingParty = true (mandante).
Campo oficial DIAN <PartyLegalEntity> (Endosante)

endorsers*

Contiene los detalles de la organización que genera el evento. Corresponde al endosante, el cual puede ser el Emisor/Facturador Electrónico o el Tenedor Legítimo de la factura.
Cuando exista más de un endosante, se debe garantizar el envío del evento de endoso en propiedad sea realizado por un Mandatario. Adicionalmente, se debe validar que se cumplan las condiciones requeridas para cada uno de los endosantes que deberán ser informados en objetos endosers separados.
⚠️ Importante: En los endosos en propiedad en blanco (con o sin responsabilidad) que cuenten con un único endosante, se deberá informar únicamente el valor sobre el cual participa en el endoso.
La demás información del endosante será obtenida desde los datos registrados de la compañía en la base de datos.
⚠️Importante: Los elementos name, organizationType, identificationType, identificationNumber y taxCode deberán ser enviados obligatoriamente en los endosos que no sean en blanco.
Campo oficial DIAN <SenderParty>

boolean

Indica si el endoso se realiza mediante un mandato y participan uno o más endosantes.
Cuando el valor es true, el endoso es generado por el mandante y es obligatorio enviar la información de cada endosante en el arreglo endorsers.
Cuando el valor es false y no participan múltiples endosantes, el endoso es generado directamente por el emisor de la factura

string
length between 1 and 450

Nombre o Razón Social del generador del evento.
Campo oficial DIAN <RegistrationName>

integer
enum

Tipo de identificador de organización. Se debe colocar el Código que corresponda de la tabla de tipos de organización jurídica de la DIAN.
Persona Jurídica y asimiladas (1). Persona Natural y asimiladas (2)
Campo oficial DIAN <@schemeVersionID>

Allowed:
string

Tipo de identificación. Se debe colocar el Código que corresponda de la tabla de tipos de identificación de la DIAN.
Campo oficial DIAN <@schemeName>

string
length between 1 and 50

Número de identificación o NIT, sin guiones ni dv.
Campo oficial DIAN <CompanyID>

string
length ≤ 1

DV del NIT. Es obligatorio si identificationType = 31.
Campo oficial DIAN <@schemeID>

string
enum

Código tipo de impuesto según los códigos de la tabla de la DIAN.
IVA (01). INC (04). IVA e INC (ZA). No aplica (ZZ)
Campo oficial DIAN <TaxScheme/ID>

Allowed:
number
≥ 0

Valor sobre el cual participa como Endosante en el endoso.
CorporateStockAmount

receiverParty
object
required

Información del receptor del evento. Corresponde a los endosatarios.
Campo oficial DIAN <ReceiverParty>

associatedDocument
object
required

Objeto que contiene la información del documento de referencia.
Campo oficial DIAN <DocumentReference>

issuerParty
object
required

Información del Adquiriente/Deudor del documento electrónico.
Campo oficial DIAN <IssuerParty>

notes
array of strings

Notas adicionales del evento. Para tipo 372 (sin responsabilidad), se agrega automáticamente 'Sin mi responsabilidad u otra equivalente'.
Campo oficial DIAN <Note>

notes
Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?