---
title: "Inscripción en el RADIAN (036)"
method: POST
path: "/radian/inscription"
tags: ["RADIAN"]
---

# Inscripción en el RADIAN (036)

`POST /radian/inscription`

## Request

- Base URL: `https://sandbox-api.alegra.com/e-provider/col/v1`
- URL: `https://sandbox-api.alegra.com/e-provider/col/v1/radian/inscription`
- Auth: HTTP bearer

Endpoint para crear un evento de Inscripción en el RADIAN. Este evento inscribe una factura electrónica de venta como título valor.

Tipos de inscripción:
- **361**: Negociación General (Primera vez)
- **362**: Negociación Directa (Primera vez) - Requiere issuerParty
- **363**: Negociación General (Posterior)
- **364**: Negociación Directa (Posterior) - Requiere issuerParty

## Request body

- object: Objeto con la información para crear un evento de Inscripción (036)
  - `number` string, required: Número de la inscripción de la FE en el RADIAN como titulo valor, el valor es alfanumérico y único por evento dentro de la misma compañía
  - `type` '361' | '362' | '363' | '364', required: <b>Tipo de operación</b> de la inscripción en el RADIAN de la factura electrónica de venta como título valor que circula en el territorio nacional, este elemento acepta uno de los siguientes códigos:<br><b>361</b>: Negociación General (Primera vez)<br><b>362</b>: Negociación Directa Previa (Primera vez)<br><b>363</b>: Negociación General (Posterior)<br><b>364</b>: Negociación Directa Previa (Posterior)
  - `companyId` string, required: Id de la empresa que desea inscribir la factura en el RADIAN. ⚠️ Importante: La información en la base de datos debe estar completa y actualizada.
  - `issuerParty` object: Comprador directo. Obligatorio para tipos 362 y 364
    - `identification` string, required: Número de identificación del endosatario (comprador directo), sin guiones ni dv.<br><i>Campo oficial DIAN &lt;CompanyID&gt;</i>
    - `identificationType` string, required: Tipo de identificación fiscal. 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>
    - `dv` string: DV del NIT del endosatario (comprador directo). Es obligatorio si identificationType = 31.<br><i>Campo oficial DIAN &lt;@schemeID&gt;</i>
    - `organizationType` 1 | 2, required: Identificador de tipo 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)<br><i>Campo oficial DIAN &lt;@schemeVersionID&gt;</i>
    - `name` string, required: Nombre o Razón Social del endosatario (comprador directo).<br><i>Campo oficial DIAN &lt;RegistrationName&gt;</i>
  - `associatedDocument` object, required: Factura electrónica con información financiera para inscripción
    - `prefix` string: Prefijo del documento referenciado.<br><i>Campo oficial DIAN &lt;ID&gt;</i>
    - `number` string, required: Número del documento referenciado.<br><i>Campo oficial DIAN &lt;ID&gt;</i>
    - `uuid` string, required: CUFE del documento referenciado.<br><i>Campo oficial DIAN &lt;UUID&gt;</i>
    - `dueDate` string, date, required: Fecha de vencimiento del documento referenciado.<br><i>Campo oficial DIAN &lt;EndDate&gt;</i>
    - `invoiceTotalAmount` number, required: Valor total del documento electrónico a inscribir.<br><i>Campo oficial DIAN &lt;ValorFEV-TV&gt;</i>
    - `amountPaid` number, required: Valor pagado del documento electrónico.<br><i>Campo oficial DIAN &lt;ValorPagado&gt;</i>
    - `pendingAmount` number, required: Valor a pagar para el documento electrónico referenciado.<br><i>Campo oficial DIAN &lt;NuevoValorTV&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.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) - [All operations](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/revisions/2bc52ab55c2b?raw)