API Endpoints

Mandato (043)

post
https://sandbox-api.alegra.com/e-provider/col/v1/radian/mandate

Endpoint para crear un evento de Mandato en el RADIAN.
⚠️ Importante:
El tamaño total del archivo del contrato de mandato y la nota de vigencia no puede superar los 4 MB en conjunto.
Si la suma de de ambos archivos excede este límite, la petición será rechaza automáticamente con 413 Request Entity Too Large

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

Objeto con la información para crear un evento de Mandato (043).
Evento RADIAN 043 - Mandato

Objeto con la información para crear un evento de Mandato (043).

string
required

Número del mandato, el valor es alfanumérico, no se puede repetir el numero para el tipo de evento.
Campo oficial DIAN <ID>

string
enum
required

Tipo de operación, acepta uno de los siguientes códigos:
431: Mandato por documento general por tiempo limitado
432: Mandato por documento general por tiempo ilimitado
433: Mandato por documento limitado por tiempo limitado
434: Mandato por documento limitado por tiempo ilimitado.

Allowed:
string
required

Id de la empresa en la que se generará el mandato. 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.

string
required

Código que identifica la naturaleza del mandato. Este elemento acepta una de las siguientes opciones:
1: Mandato por Poder Especial
2: Mandato por Poder General
Campo oficial DIAN <@schemeID>

string
enum
required

Código que identifica el tipo de documento electrónico referenciado en el evento. Este elemento acepta una de las siguientes opciones:
[1] Un documento electrónico de tipo invoice "01" donde se referencia el numero de factura, el CUFE y el tipo de documento.
[2] Maximo 20 documentos electrónicos. Corresponde a la referencia de varios documento electrónico tipo invoice "01" donde se referencia el número de factural, el CUFE y el tipo de documento.
[3] Todos los documentos de tipo invoice "01" donde no se debe referenciar el número de factura, el CUFE y el tipo de documento.
Campo oficial DIAN <@listID en DocumentResponse>

Allowed:
date
required

Fecha desde la cual el mandato entra en vigencia y el mandatario puede ejercer sus facultades.
Campo oficial DIAN <EffectiveDate>

mandatary
object
required

Grupo de información del generador del mandato.
Campo oficial DIAN <SenderParty>

associatedDocument
array of objects
required
length between 1 and 20

Objeto que contiene la información del documento de referencia. Se debe informar N cantidad de veces en los casos que la referencia se realice a más de un documento electrónico. Solo se permite un máximo de 20 referencias a documentos electrónicos.
Campo oficial DIAN <DocumentReference>

associatedDocument*

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

string
required

Prefijo del documento referencia.
Campo oficial DIAN <ID>

string
required

Número del documento de referencia.
Campo oficial DIAN <ID>

string
required

CUFE del documento de referencia.
Campo oficial DIAN <UUID>

string
required

Debe corresponder a un valor de las columnas Sistema de Negociación "SNE", Proveedor Tecnológico "PT", Factor "F" del catalogo de facultades. En el caso de tratarse de un mandato por documento limitado, para poder reportar varias facultades se debe incluir inicialmente la facultad MR91 y seguida a esta, separadas por punto y coma (;), el resto de facultades acorde a la lista de valores correspondiente.Ejemplo MR91- PT, R05-PT;R07-PT;R08-PT
Campo oficial DIAN <ResponseCode>

string
enum
required

Código del tipo de mandato de acuerdo a la operación realizada, este elemento acepta una de las siguientes opciones:
(1) Mandato por documento General cuando el mandato sea de alcance general.
(2) Mandato por documento Limitado cuando el mandato sea de alcance limitado.
Campo oficial DIAN <DocumentResponse>/<DescriptionCode>

Allowed:
string
enum
required

Tiempo del mandato, este elemento acepta una de las siguientes opciones:
(1) Tiempo Limitado .
(2) Tiempo Ilimitado cuando el mandato sea de alcance ilimitado.
⚠️ Para operationTypeCode 431, 433 se deberá enviar el código [1] ; para operationTypeCode 432,434 se deberá enviar el código 2
Campo oficial DIAN <DocumentResponse>/<DescriptionCode>

Allowed:
validityPeriod
object

Periodo de vigencia del mandato.
Indica las fechas de inicio y fin durante las cuales el mandato se encuentra vigente.
Campo oficial DIAN <ValidityPeriod>

mandatedAgent
object
required

Información del mandatario.
Contiene los datos de la persona juridica habilitada en el RADIAN (PT/Factor/SNE) que actúa en representación del mandante dentro del evento.
Campo oficial DIAN <IssuerParty>

mandateEvidence
object

Indica la evidencia o soporte documental que acredita la existencia del contrado de mandato. Corresponde a la información del documento que respalda la representación otorgada al mandatario.
⚠️ Este objeto deberá ser enviado de manera obligatoria cuando mandateNatureCode sea "2" Mandato poder general
Campo oficial DIAN <LineResponse>

validityEvidence
object

Grupo de información de la nota de vigencia
⚠️ Este objeto deberá ser enviado de manera obligatoria cuando mandateNatureCode sea "2" Mandato poder general
Campo oficial DIAN <LineResponse>

notes
array of strings

Información adicional que se quiera agregar en el evento.
Campo oficial DIAN <Note>

notes
Responses

Updated about 1 month ago

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 about 1 month ago