> ## 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 notas débito asociadas a una factura de venta registrada en la plataforma, en línea en formato JSON. La nota débito queda pendiente de aprobación según la jerarquía de aprobación de notas débito configurada en la plataforma.

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 una nota débito, se debe contar con los siguientes datos:

* Token solicitado mediante el API de [autenticación](https://tech.sedierp.com/quickstart.md)
* Prefijo y consecutivo de la factura de venta a la cual se le registrará la nota débito
* Tipo de documento contable de nota débito configurado en la plataforma
* Plantilla de documento de nota débito configurada en la plataforma

## Registrar nota débito

**Request URL:** https\://\{\{Ambiente}}/API\_FE/api/DocumentosElectronicos/NotaDebitoInsertar\
**Tipo:** POST \
**Content Type:** application/json

**PrefijoFactura** `string`

Prefijo de la factura de venta a la cual se le registra la nota débito. Es obligatorio si la factura tiene prefijo.

**ConsecutivoFactura** `int` *required*

Consecutivo de la factura de venta a la cual se le registra la nota débito.

**CausalNotaDebitoCodigo** `string`

Código de la causal de la nota débito. Si no se envía o no corresponde a una causal válida, se asigna la causal configurada por defecto en la plataforma.

| Código | Descripción |
| - | - |
| 1 | Intereses |
| 2 | Gastos por cobrar |
| 3 | Cambio de valor |
| 4 | Otros |

**PrefijoNotaDebito** `string`

Prefijo (sigla) del tipo de documento contable de nota débito configurado en la plataforma. Si no se envía, se utiliza el tipo de documento de nota débito configurado para la sucursal de la factura.

**ConsecutivoNotaDebito** `int`

Consecutivo de la nota débito. Si no se envía, se asigna automáticamente el siguiente consecutivo disponible.

**Observaciones** `string`

Observaciones del documento (máx. 5000 caracteres).

**NotasDebitoDetalles** `array` *required*

Detalles (conceptos) de la nota débito. Debe contener al menos un detalle.

**propiedades**

**Concepto** `string` *required*

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

**Cantidad** `number`

Cantidad del concepto, por defecto (1).

**Valor** `number` *required*

Valor unitario del concepto. El valor total del detalle corresponde a Valor × Cantidad. Debe ser diferente a cero.

**AIU** `bool`

true = detalle marcado como A.I.U. (único detalle para el cálculo del IVA).

**Impuestos** `array`

Impuestos y retenciones del detalle. Opcional. Solo se admiten impuestos que estén incluidos en la factura referenciada.

**propiedades**

**CodigoImpuesto** `string` *required*

Código del impuesto o retención.

| Código | Nombre | Descripción |
| - | - | - |
| 01 | IVA | Impuesto de Valor Agregado |
| 02 | IC | Impuesto al Consumo Departamental Nominal |
| 03 | ICA | Impuesto de Industria, Comercio y Aviso |
| 04 | INC | Impuesto Nacional al Consumo |
| 05 | ReteIVA | Retención sobre el IVA |
| 06 | ReteFuente | Retención sobre Renta |
| 07 | ReteICA | Retención sobre el ICA |
| 20 | FtoHorticultura | Cuota de Fomento Hortifrutícola |
| 21 | Timbre | Impuesto de Timbre |
| 22 | Bolsas | Impuesto al Consumo de Bolsa Plástica |
| 23 | INCarbono | Impuesto Nacional al Carbono |
| 24 | INCombustibles | Impuesto Nacional a los Combustibles |
| 25 | Sobretasa Combustibles | Sobretasa a los combustibles |
| 26 | Sordicom | Contribución minoristas (Combustibles) |
| ZY | No causa | No responsable de tributo |
| ZZ | Nombre de la figura tributaria | Otros tributos, tasas, contribuciones y similares |

**ValorImpuesto** `number` *required*

Valor del impuesto o retención aplicado al detalle. Debe ser diferente a cero.

**Porcentaje** `number` *required*

Porcentaje del impuesto o retención aplicado al detalle. Debe ser diferente a cero.

**Mandantes** `array`

Mandante del detalle. Opcional. El mandante debe existir en la plataforma y estar asociado a la factura referenciada.

**propiedades**

**TipoDocumento** `int` *required*

Código del tipo de documento del mandante.

| Código | Significado |
| - | - |
| 11 | Registro civil |
| 12 | Tarjeta de identidad |
| 13 | Cédula de ciudadanía |
| 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 |
| 91 | NUIP |

**Documento** `string` *required*

Número del documento del mandante, sin puntos, sin comas y sin espacios.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/NotaDebitoInsertar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"PrefijoFactura": "FE",
	"ConsecutivoFactura": 1520,
	"CausalNotaDebitoCodigo": "2",
	"PrefijoNotaDebito": "ND",
	"Observaciones": "Gastos de cobranza e intereses de la factura FE-1520",
	"NotasDebitoDetalles": [
		{
			"Concepto": "GASTOS DE COBRANZA",
			"Cantidad": 1,
			"Valor": 50000,
			"AIU": false,
			"Impuestos": [
				{ "CodigoImpuesto": "01", "ValorImpuesto": 9500, "Porcentaje": 19 }
			],
			"Mandantes": []
		},
		{
			"Concepto": "INTERESES DE MORA",
			"Cantidad": 1,
			"Valor": 25000,
			"AIU": false,
			"Impuestos": [],
			"Mandantes": []
		}
	]
}'
```

### Validaciones

El servicio realiza las siguientes validaciones antes de registrar el documento. Si alguna no se cumple, no se registra la nota débito y se retorna el error correspondiente.

**Factura y configuración**

* La factura (prefijo y consecutivo) debe estar registrada en la plataforma.
* Debe existir un tipo de documento contable de nota débito configurado para la empresa y la sucursal de la factura.
* Debe existir una plantilla de documento de nota débito configurada en la plataforma.
* Los datos del cliente de la factura deben estar completos para la emisión del documento.
* El consecutivo de la nota débito no debe estar registrado previamente.

**Detalles**

* La nota débito debe contener al menos un detalle.
* El `Valor` de cada detalle debe ser diferente a cero.
* El `Concepto` no puede ser vacío ni "OTROS".
* Los valores y cantidades se redondean según los decimales configurados en la resolución de la factura.

**Impuestos**

* El código y el porcentaje de cada impuesto deben estar configurados en la plataforma.
* Cada impuesto debe estar incluido en los impuestos de la factura referenciada.
* El `ValorImpuesto` y el `Porcentaje` deben ser diferentes a cero.
* El `ValorImpuesto` debe ser igual a (Valor × Cantidad) × Porcentaje / 100, con una tolerancia de ±0,5.

**Mandantes**

* El tipo de documento del mandante debe ser válido.
* El mandante debe existir previamente en la plataforma.
* El mandante debe estar asociado a algún detalle de la factura referenciada.

### Respuesta

**TipoSalida** `string`

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

**Codigo** `int`

Código único de la nota débito registrada (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}
{
  "PrefijoFactura": "FE",
  "ConsecutivoFactura": 1520,
  "CausalNotaDebitoCodigo": "2",
  "PrefijoNotaDebito": "ND",
  "Observaciones": "Gastos de cobranza e intereses de la factura FE-1520",
  "NotasDebitoDetalles": [
    {
      "Concepto": "GASTOS DE COBRANZA",
      "Cantidad": 1,
      "Valor": 50000,
      "AIU": false,
      "Impuestos": [
        {
          "CodigoImpuesto": "01",
          "ValorImpuesto": 9500,
          "Porcentaje": 19
        }
      ],
      "Mandantes": []
    },
    {
      "Concepto": "INTERESES DE MORA",
      "Cantidad": 1,
      "Valor": 25000,
      "AIU": false,
      "Impuestos": [],
      "Mandantes": []
    }
  ]
}
```

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

```json Error theme={null}
{
    "TipoSalida": "Error",
    "Codigo": -1,
    "Descripcion": "Error: La factura no se encuentra registrada en el sistema"
}
```


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