ALalegra
RADIAN

Mandato (043)

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

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

Request body

numberstring required

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

type'431' | '432' | '433' | '434' required

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

companyIdstring 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.

mandateNatureCodestring required

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

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:<br><b>[1]</b> Un documento electrónico de tipo invoice "01" donde se referencia el numero de factura, el CUFE y el tipo de documento.<br><b>[2]</b> 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.<br><b>[3]</b> Todos los documentos de tipo invoice "01" donde <b>no</b> se debe referenciar el número de factura, el CUFE y el tipo de documento.<br><i>Campo oficial DIAN <@listID en DocumentResponse></i>

mandateStartDatestring date required

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

notesstring[]

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

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 2 revisions of this API.