--- title: "Mandato (043)" method: POST path: "/radian/mandate" tags: ["RADIAN"] --- # Mandato (043) `POST /radian/mandate` ## Request - Base URL: `https://sandbox-api.alegra.com/e-provider/col/v1` - URL: `https://sandbox-api.alegra.com/e-provider/col/v1/radian/mandate` - Auth: HTTP bearer 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 ## Request body - object: Objeto con la información para crear un evento de Mandato (043). - `number` 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> - `type` '431' | '432' | '433' | '434', 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. - `companyId` 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. - `mandateNatureCode` 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> - `docReferenceCode` '1' | '2' | '3', 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> - `mandateStartDate` string, 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> - `principalTypeCode` '01' | '02' | '03' | '04', required: Código del tipo de mandante.
Acepta una de las siguientes opciones:
01: Mandante Facutrador Electrónico
02: Mandante Legitimo Tenedor
03: Mandante Avalista
04: Mandante Adquiriente/Deudor
Campo oficial DIAN <Description/ID en AgentParty> - `legalRepresentative` Items[], required: Información del representante legal de la organización.
Contiene los datos de identificación y contacto de la persona que actúa en representación legal de la entidad dentro del evento.
Campo oficial DIAN <Person> (unresolved $ref) - `associatedDocument` object[], required: 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> - `prefix` string, required: Prefijo del documento referencia.
Campo oficial DIAN <ID> - `number` string, required: Número del documento de referencia.
Campo oficial DIAN <ID> - `uuid` string, required: CUFE del documento de referencia.
Campo oficial DIAN <UUID> - `mandateFacultyCode` 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> - `mandateDocumentTypeCode` '1' | '2', 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> - `descriptionCode` '1' | '2', 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> - `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> - `startDate` string, date: Fecha de inicio del mandato.
⚠️ Se debe enviar de manera obligatoria en los mandatos por tiempo (operationTypeCode "431" y "433")
Campo oficial DIAN <StartDate> - `endDate` string, date: Fecha de fin del mandato.
⚠️ Se debe enviar de manera obligatoria en los mandatos por tiempo (operationTypeCode "431" y "433")
Campo oficial DIAN <EndDate> - `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> - `identificationType` string, required: Tipo de identificador fiscal.
Campo oficial DIAN <@schemeName> - `identification` string, required: Número de identificación de la persona.
Campo oficial DIAN <ID> - `dv` string: DV del NIT de la persona. Obligatorio cuando el identificationType es 31.
Campo oficial DIAN <@schemeID> - `agentTypeCode` '01' | '02' | '03' | '04', required: Código del tipo de mandatario, este elemento acepta una de las siguientes opciones:
01: Mandatario Sistema de Negociación Electrónica
02: Mandatario Factor
03: Mandatario Proveedor Tecnológico
04: Mandatario Facturador Electrónico
Campo oficial DIAN <Description/ID en AgentParty> - `legalRepresentative` Items[], required: Información del representante legal de la organización.
Contiene los datos de identificación y contacto de la persona que actúa en representación legal de la entidad dentro del evento.
Campo oficial DIAN <Person> (unresolved $ref) - `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> - `number` string, required: Debe ser informado el consecutivo del contrato de mandato.
Campo oficial DIAN <ID> - `mandateContractFile` string, required: Corresponde al contrato entre las partes (Mandante y Mandatario) el cual ebe ser informado en base64.
Campo oficial DIAN<Attachement> - `publicDeedDate` string, date, required: Fecha de la escritura pública mediante la cual se formaliza el acto (por ejemplo, el mandato o la representación).
Campo oficial DIAN <EffectiveDate> - `notary` object[], required: Grupo de información del notario
Campo oficial DIAN - `identificationType` string, required: Tipo de identificador fiscal.
Campo oficial DIAN <@schemeName> - `identification` string, required: Número de identificación de la persona.
Campo oficial DIAN <ID> - `dv` string: DV del NIT de la persona. Obligatorio cuando el identificationType es 31.
Campo oficial DIAN <@schemeID> - `firstName` string, required: Nombre del notario.
Campo oficial DIAN <FirstName> - `familyName` string, required: Apellido del notario.
Campo oficial DIAN <FamilyName> - `jobTitle` string, required: Cargo del notario.
Campo oficial DIAN <JobTitle> - `organizationDepartment` string: Area, sección o departamento del notario.
Campo oficial DIAN <OrganizationDepartment> - `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> - `number` string, required: Debe ser informado el consecutivo de la nota de vigencia del contrato de mandato
Campo oficial DIAN <ID> - `validityNoteFile` string, required: Corresponde a la nota de vigencia el cual debe ser informado en base64.
Campo oficial DIAN <Attachement> - `notary` object[], required: Grupo de información del notario
Campo oficial DIAN - `identificationType` string, required: Tipo de identificador fiscal.
Campo oficial DIAN <@schemeName> - `identification` string, required: Número de identificación de la persona.
Campo oficial DIAN <ID> - `dv` string: DV del NIT de la persona. Obligatorio cuando el identificationType es 31.
Campo oficial DIAN <@schemeID> - `firstName` string, required: Nombre del notario.
Campo oficial DIAN <FirstName> - `familyName` string, required: Apellido del notario.
Campo oficial DIAN <FamilyName> - `jobTitle` string, required: Cargo del notario.
Campo oficial DIAN <JobTitle> - `organizationDepartment` string, required: Area, sección o departamento del notario.
Campo oficial DIAN <OrganizationDepartment> - `notes` string[]: Información adicional que se quiera agregar en el evento.
Campo oficial DIAN <Note> ## 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)