> ## 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 crédito asociadas a una factura de venta registrada en la plataforma, en línea en formato JSON. La nota crédito queda pendiente de aprobación según la jerarquía de aprobación de notas crédito 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 crédito, 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 crédito
* Tipo de documento contable de nota crédito configurado en la plataforma, con la sigla que se enviará en `PrefijoNotaCredito`
* Plantilla de documento de nota crédito configurada en la plataforma

## Registrar nota crédito

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

**PrefijoFactura** `string`

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

**ConsecutivoFactura** `int` *required*

Consecutivo de la factura de venta a la cual se le registra la nota crédito.

**CausalNotaCreditoCodigo** `string`

Código de la causal de la nota crédito. 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 | Devolución de parte de los bienes; no aceptación de partes del servicio |
| 2 | Anulación de factura electrónica |
| 3 | Rebaja total aplicada |
| 4 | Descuento total aplicado |
| 5 | Rescisión: nulidad por falta de requisitos |
| 6 | Otros |

**PrefijoNotaCredito** `string` *required*

Prefijo (sigla) del tipo de documento contable de nota crédito configurado en la plataforma.

**ConsecutivoNotaCredito** `int`

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

**Observaciones** `string`

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

**NotasCreditoDetalles** `array` *required*

Detalles (conceptos) de la nota crédito. 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/NotaCreditoInsertar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"PrefijoFactura": "FE",
	"ConsecutivoFactura": 1520,
	"CausalNotaCreditoCodigo": "1",
	"PrefijoNotaCredito": "NC",
	"Observaciones": "Devolución parcial de la factura FE-1520",
	"NotasCreditoDetalles": [
		{
			"Concepto": "LICENCIA ANUAL MODULO CONTABLE",
			"Cantidad": 1,
			"Valor": 450000,
			"AIU": false,
			"Impuestos": [
				{ "CodigoImpuesto": "01", "ValorImpuesto": 85500, "Porcentaje": 19 }
			],
			"Mandantes": []
		}
	]
}'
```

### Validaciones

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

**Factura y configuración**

* La factura (prefijo y consecutivo) debe estar registrada en la plataforma.
* El `PrefijoNotaCredito` debe corresponder a un tipo de documento contable de nota crédito configurado para la empresa y la sucursal de la factura.
* Debe existir una plantilla de documento de nota crédito 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 crédito no debe estar registrado previamente.

**Detalles**

* La nota crédito 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 crédito 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,
  "CausalNotaCreditoCodigo": "1",
  "PrefijoNotaCredito": "NC",
  "Observaciones": "Devolución parcial de la factura FE-1520",
  "NotasCreditoDetalles": [
    {
      "Concepto": "LICENCIA ANUAL MODULO CONTABLE",
      "Cantidad": 1,
      "Valor": 450000,
      "AIU": false,
      "Impuestos": [
        {
          "CodigoImpuesto": "01",
          "ValorImpuesto": 85500,
          "Porcentaje": 19
        }
      ],
      "Mandantes": []
    }
  ]
}
```

```json Exitosa theme={null}
{
    "TipoSalida": "OK",
    "Codigo": 3127,
    "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.