Skip to main content
El servicio permite a los usuarios registrar documentos soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente, en línea en formato JSON. Si el proveedor no existe en la plataforma, se registra automáticamente con los datos enviados en la solicitud. El método de solicitud es POST y se requiere un encabezado “Authorization” para la autenticación, que debe contener un token JWT obtenido previamente del servicio de autenticación.

​
Prerequisitos

Antes de realizar el registro de un documento soporte, se debe contar con los siguientes datos:
  • Token solicitado mediante el API de autenticación
  • Resolución de documento soporte vigente configurada en la plataforma para el prefijo y consecutivo que se va a registrar
  • Impuestos configurados en la plataforma con el código y porcentaje que se enviarán en los detalles
  • La sucursal no debe tener documentos soporte con errores

​
Registrar documento soporte

Request URL: https://{{Ambiente}}/API_FE/api/DocumentosElectronicos/DocumentoSoporteNoObligadosInsertar
Tipo: POST
Content Type: application/json

​
Datos del documento

​
string
required
Prefijo de la resolución de documento soporte autorizada por la DIAN (máx. 20 caracteres).
​
int
required
Consecutivo del documento.
​
string
required
Fecha de emisión del documento (ej. “2026-11-04T09:00:00”). No puede ser una fecha futura.
​
string
Fecha de vencimiento del documento. No puede ser menor a la fecha de emisión.
​
string
required
Código DIAN del medio de pago, según la tabla de medios de pago (ej. “47” para transferencia débito bancaria).
​
string
Número de la orden de compra (máx. 60 caracteres).
​
string
Fecha de la orden de compra.
​
string
Código de la moneda del documento, según la tabla de monedas (ej. “COP”). Si no se envía, se utiliza el peso colombiano.
​
number
Tasa de cambio. Es obligatoria cuando la moneda es diferente al peso colombiano (COP).
​
string
Observaciones generales del documento (máx. 1500 caracteres).
​
string
Email del usuario que registra el documento.

​
Datos del proveedor

​
int
required
Código del tipo de documento de identificación del proveedor. Para proveedores residentes en Colombia debe ser NIT (31).
​
string
required
Número de identificación del proveedor, sin puntos, sin comas y sin espacios (máx. 20 caracteres).
​
int
required
Tipo de persona del proveedor.
​
string
required
Primer nombre del proveedor si es persona natural; en caso contrario, la razón social (máx. 250 caracteres).
​
string
Otros nombres del proveedor.
​
string
Primer apellido del proveedor.
​
string
Segundo apellido del proveedor.
​
string
Dirección del proveedor (máx. 200 caracteres). Es obligatoria cuando el proveedor reside en Colombia.
​
string
Número de celular del proveedor, sin puntos, sin comas y sin espacios (máx. 20 caracteres).
​
string
required
Email del proveedor (máx. 400 caracteres).
​
string
required
Email del proveedor para el envío de documentos electrónicos (máx. 400 caracteres).
​
string
Responsabilidad tributaria del proveedor.
​
string
required
País del proveedor, código alfa-2 según la tabla de países (ej. “CO”).
​
string
Ciudad del proveedor, código de municipio de 5 dígitos según la tabla de municipios (ej. “11001” para Bogotá). Es obligatoria cuando el proveedor reside en Colombia.

​
Detalles del documento

​
array
required
Detalles (conceptos o productos) del documento.
​
array
Recargos y descuentos generales del documento. Opcional.

​
Validaciones

El servicio realiza las siguientes validaciones antes de registrar el documento. Si alguna no se cumple, no se registra el documento soporte y se retorna el error correspondiente. Resolución y consecutivo
  • El prefijo y el consecutivo deben corresponder a una resolución de documento soporte configurada en la plataforma y vigente a la fecha actual.
  • El consecutivo y la fecha de emisión se validan contra el rango y la vigencia de la resolución.
  • No debe existir un documento soporte registrado con el mismo consecutivo.
  • La sucursal no debe tener documentos soporte con errores.
Proveedor
  • El TipoDocumento debe ser uno de los permitidos para documento soporte: 21, 22, 31, 41, 42, 47 o 50.
  • El Pais es obligatorio.
  • Si el proveedor reside en Colombia (Pais = “CO”), la Ciudad y la Direccion son obligatorias y el TipoDocumento debe ser NIT (31).
  • Los datos del proveedor deben estar completos para la emisión del documento. Si el proveedor no existe en la plataforma, se registra automáticamente.
Fechas
  • La FechaEmision no puede ser posterior a la fecha actual.
  • La FechaVencimiento no puede ser menor a la FechaEmision.
Moneda y forma de pago
  • La moneda enviada debe estar configurada en la plataforma. Si es diferente a COP, la TasaCambio es obligatoria.
  • La FormaPago debe corresponder a un medio de pago definido por la DIAN. Si no está configurado en la plataforma, se registra automáticamente.
Detalles e impuestos
  • El ValorTotal de cada detalle debe ser diferente a cero e igual a (Cantidad × ValorUnitario) − Descuento, con una tolerancia de ±0,5.
  • El ProductoNombre no puede ser vacío ni “OTROS”.
  • La UnidadProducto, si se envía, debe estar registrada en la plataforma.
  • Los valores se redondean según el número de decimales configurado en la resolución.
  • El código y el porcentaje de cada impuesto deben estar configurados en la plataforma, y el ValorImpuesto y el Porcentaje deben ser diferentes a cero.
  • El ValorImpuesto debe ser igual a la base del detalle × Porcentaje / 100, con una tolerancia de ±0,5. Para la ReteIVA (05), la base es el valor del IVA del detalle.
Recargos y descuentos
  • El TipoRecargoDescuento debe ser un tipo válido (1: Descuento, 2: Recargo).

​
Respuesta

​
string
Resultado de la operación: “OK” o “Error”.
​
int
Código único del documento soporte registrado (ID). Retorna -1 cuando ocurre un error.
​
string
“Transacción Exitosa” cuando el registro es correcto, o el detalle del error precedido de “Error:”.