> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registro nuevo

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](https://tech.sedierp.com/quickstart.md).

## 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](https://tech.sedierp.com/quickstart.md)
* 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

**Prefijo** `string` *required*

Prefijo de la resolución de documento soporte autorizada por la DIAN (máx. 20 caracteres).

**Consecutivo** `int` *required*

Consecutivo del documento.

**FechaEmision** `string` *required*

Fecha de emisión del documento (ej. "2026-11-04T09:00:00"). No puede ser una fecha futura.

**FechaVencimiento** `string`

Fecha de vencimiento del documento. No puede ser menor a la fecha de emisión.

**FormaPago** `string` *required*

Código DIAN del medio de pago, según la [tabla de medios de pago](https://tech.sedierp.com/medios-de-pago.md) (ej. "47" para transferencia débito bancaria).

**OrdenCompraNumero** `string`

Número de la orden de compra (máx. 60 caracteres).

**OrdenCompraFecha** `string`

Fecha de la orden de compra.

**Moneda** `string`

Código de la moneda del documento, según la [tabla de monedas](https://tech.sedierp.com/monedas.md) (ej. "COP"). Si no se envía, se utiliza el peso colombiano.

**TasaCambio** `number`

Tasa de cambio. Es obligatoria cuando la moneda es diferente al peso colombiano (COP).

**Observaciones** `string`

Observaciones generales del documento (máx. 1500 caracteres).

**UsuarioEmail** `string`

Email del usuario que registra el documento.

### Datos del proveedor

**TipoDocumento** `int` *required*

Código del tipo de documento de identificación del proveedor. Para proveedores residentes en Colombia debe ser NIT (31).

| Código | Significado |
| - | - |
| 21 | Tarjeta de extranjería |
| 22 | Cédula de extranjería |
| 31 | NIT |
| 41 | Pasaporte |
| 42 | Documento de identificación extranjero |
| 47 | PEP |
| 50 | NIT de otro país |

**Documento** `string` *required*

Número de identificación del proveedor, sin puntos, sin comas y sin espacios (máx. 20 caracteres).

**TipoPersona** `int` *required*

Tipo de persona del proveedor.

| Código | Significado |
| - | - |
| 1 | Persona jurídica y asimiladas |
| 2 | Persona natural y asimiladas |

**Nombres** `string` *required*

Primer nombre del proveedor si es persona natural; en caso contrario, la razón social (máx. 250 caracteres).

**Nombres2** `string`

Otros nombres del proveedor.

**Apellidos** `string`

Primer apellido del proveedor.

**Apellidos2** `string`

Segundo apellido del proveedor.

**Direccion** `string`

Dirección del proveedor (máx. 200 caracteres). Es obligatoria cuando el proveedor reside en Colombia.

**Celular** `string`

Número de celular del proveedor, sin puntos, sin comas y sin espacios (máx. 20 caracteres).

**Email** `string` *required*

Email del proveedor (máx. 400 caracteres).

**EmailFacturacion** `string` *required*

Email del proveedor para el envío de documentos electrónicos (máx. 400 caracteres).

**ResponsabilidadTributaria** `string`

Responsabilidad tributaria del proveedor.

| Código | Significado |
| - | - |
| 48 | Responsable del impuesto sobre las ventas - IVA |
| 49 | No responsable de IVA |

**Pais** `string` *required*

País del proveedor, código alfa-2 según la [tabla de países](https://tech.sedierp.com/paises.md) (ej. "CO").

**Ciudad** `string`

Ciudad del proveedor, código de municipio de 5 dígitos según la [tabla de municipios](https://tech.sedierp.com/ciudades.md) (ej. "11001" para Bogotá). Es obligatoria cuando el proveedor reside en Colombia.

### Detalles del documento

**DocumentosSoportesDetalles** `array` *required*

Detalles (conceptos o productos) del documento.

**propiedades**

**Cantidad** `number` *required*

Cantidad del detalle.

**ProductoNombre** `string` *required*

Nombre o descripción del detalle (máx. 500 caracteres). No puede ser vacío ni "OTROS".

**UnidadProducto** `string`

Código de la unidad de medida del producto.

| Código | Nombre |
| - | - |
| 94 | Unidad |
| QTL | Cuarto líquido |
| DZN | Docena |
| MIK | Milla cuadrada |
| PR | Par |
| CR | Caja |
| PA | Paquete |
| LUN | Mes |
| DAY | Día |
| NG | Galón |
| MTR | Metros |
| KGM | Kilo |
| LM | Metro lineal |
| MTK | Metro cuadrado |
| MLT | Mililitro |
| CMT | Centímetros |
| LTR | Litros |

**ValorUnitario** `number` *required*

Valor unitario del detalle.

**Descuento** `number`

Valor del descuento del detalle.

**ValorTotal** `number` *required*

Valor total del detalle: (Cantidad × ValorUnitario) − Descuento. Debe ser diferente a cero.

**Orden** `int`

Orden en el que va ubicado el detalle.

**Impuestos** `array`

Impuestos y retenciones del detalle. Opcional.

**propiedades**

**CodigoImpuesto** `string` *required*

Código del impuesto o retención.

| Código | Nombre | Descripción |
| - | - | - |
| 01 | IVA | Impuesto sobre las ventas |
| 05 | ReteIVA | Retención sobre el IVA |
| 06 | ReteRenta | Retención sobre renta |

**ValorImpuesto** `number` *required*

Valor del impuesto o retención. No puede ser cero.

**Porcentaje** `number` *required*

Porcentaje del impuesto o retención. No puede ser cero.

**DocumentosSoportesRecargosDescuentos** `array`

Recargos y descuentos generales del documento. Opcional.

**propiedades**

**TipoRecargoDescuento** `string` *required*

Tipo de recargo o descuento.

| Código | Nombre |
| - | - |
| 1 | Descuento |
| 2 | Recargo |

**Concepto** `string` *required*

Concepto o descripción del recargo o descuento (máx. 100 caracteres).

**Valor** `number` *required*

Valor del recargo o descuento.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/DocumentoSoporteNoObligadosInsertar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"TipoDocumento": 31,
	"Documento": "1020304050",
	"TipoPersona": 2,
	"Nombres": "JUAN",
	"Nombres2": "CARLOS",
	"Apellidos": "RODRIGUEZ",
	"Apellidos2": "LOPEZ",
	"Direccion": "CARRERA 7 # 45-10",
	"Celular": "3109876543",
	"Email": "juan.rodriguez@correo.com",
	"EmailFacturacion": "juan.rodriguez@correo.com",
	"ResponsabilidadTributaria": "49",
	"Pais": "CO",
	"Ciudad": "11001",
	"FechaEmision": "2026-11-04T09:00:00",
	"FechaVencimiento": "2026-11-19T00:00:00",
	"Prefijo": "DS",
	"Consecutivo": 312,
	"FormaPago": "47",
	"OrdenCompraNumero": null,
	"OrdenCompraFecha": null,
	"Moneda": "COP",
	"TasaCambio": null,
	"Observaciones": "Mantenimiento locativo octubre 2026",
	"UsuarioEmail": "compras@empresa.com",
	"DocumentosSoportesDetalles": [
		{
			"Cantidad": 1,
			"ProductoNombre": "SERVICIO DE MANTENIMIENTO LOCATIVO",
			"UnidadProducto": "94",
			"ValorUnitario": 1200000,
			"Descuento": 0,
			"ValorTotal": 1200000,
			"Orden": 1,
			"Impuestos": [
				{ "CodigoImpuesto": "06", "ValorImpuesto": 48000, "Porcentaje": 4 }
			]
		},
		{
			"Cantidad": 2,
			"ProductoNombre": "MATERIALES DE PINTURA",
			"UnidadProducto": "NG",
			"ValorUnitario": 85000,
			"Descuento": 10000,
			"ValorTotal": 160000,
			"Orden": 2,
			"Impuestos": [
				{ "CodigoImpuesto": "06", "ValorImpuesto": 4000, "Porcentaje": 2.5 }
			]
		}
	],
	"DocumentosSoportesRecargosDescuentos": [
		{ "TipoRecargoDescuento": "1", "Concepto": "DESCUENTO POR PRONTO PAGO", "Valor": 20000 }
	]
}'
```

### 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

**TipoSalida** `string`

Resultado de la operación: "OK" o "Error".

**Codigo** `int`

Código único del documento soporte registrado (ID). Retorna -1 cuando ocurre un error.

**Descripcion** `string`

"Transacción Exitosa" cuando el registro es correcto, o el detalle del error precedido de "Error:".

```json Request theme={null}
{
  "TipoDocumento": 31,
  "Documento": "1020304050",
  "TipoPersona": 2,
  "Nombres": "JUAN",
  "Nombres2": "CARLOS",
  "Apellidos": "RODRIGUEZ",
  "Apellidos2": "LOPEZ",
  "Direccion": "CARRERA 7 # 45-10",
  "Celular": "3109876543",
  "Email": "juan.rodriguez@correo.com",
  "EmailFacturacion": "juan.rodriguez@correo.com",
  "ResponsabilidadTributaria": "49",
  "Pais": "CO",
  "Ciudad": "11001",
  "FechaEmision": "2026-11-04T09:00:00",
  "FechaVencimiento": "2026-11-19T00:00:00",
  "Prefijo": "DS",
  "Consecutivo": 312,
  "FormaPago": "47",
  "OrdenCompraNumero": null,
  "OrdenCompraFecha": null,
  "Moneda": "COP",
  "TasaCambio": null,
  "Observaciones": "Mantenimiento locativo octubre 2026",
  "UsuarioEmail": "compras@empresa.com",
  "DocumentosSoportesDetalles": [
    {
      "Cantidad": 1,
      "ProductoNombre": "SERVICIO DE MANTENIMIENTO LOCATIVO",
      "UnidadProducto": "94",
      "ValorUnitario": 1200000,
      "Descuento": 0,
      "ValorTotal": 1200000,
      "Orden": 1,
      "Impuestos": [
        {
          "CodigoImpuesto": "06",
          "ValorImpuesto": 48000,
          "Porcentaje": 4
        }
      ]
    },
    {
      "Cantidad": 2,
      "ProductoNombre": "MATERIALES DE PINTURA",
      "UnidadProducto": "NG",
      "ValorUnitario": 85000,
      "Descuento": 10000,
      "ValorTotal": 160000,
      "Orden": 2,
      "Impuestos": [
        {
          "CodigoImpuesto": "06",
          "ValorImpuesto": 4000,
          "Porcentaje": 2.5
        }
      ]
    }
  ],
  "DocumentosSoportesRecargosDescuentos": [
    {
      "TipoRecargoDescuento": "1",
      "Concepto": "DESCUENTO POR PRONTO PAGO",
      "Valor": 20000
    }
  ]
}
```

```json Exitosa theme={null}
{
    "TipoSalida": "OK",
    "Codigo": 2045,
    "Descripcion": "Transacción Exitosa"
}
```

```json Error theme={null}
{
    "TipoSalida": "Error",
    "Codigo": -1,
    "Descripcion": "Error: El tercero o proveedor debe tener Rut con NIT cuando reside en COLOMBIA"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.