Registro nuevo

{
  "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": []
    }
  ]
}

{
    "TipoSalida": "OK",
    "Codigo": 418,
    "Descripcion": "Transacción Exitosa"
}

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

{
  "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": []
    }
  ]
}

{
    "TipoSalida": "OK",
    "Codigo": 418,
    "Descripcion": "Transacción Exitosa"
}

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

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.

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

string

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

int

required

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

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

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.

int

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

string

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

array

required

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

Show propiedades

string

required

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

number

Cantidad del concepto, por defecto (1).

number

required

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

bool

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

array

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

Show propiedades

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

number

required

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

number

required

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

array

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

Show propiedades

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

string

required

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

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

string

Resultado de la operación: “OK” o “Error”.

int

Código único de la nota débito registrada (ID). Retorna -1 cuando ocurre un error.

string

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

{
  "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": []
    }
  ]
}

{
    "TipoSalida": "OK",
    "Codigo": 418,
    "Descripcion": "Transacción Exitosa"
}

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

Primeros pasos

CRM

Facturación

Custodia

Común

Prerequisitos

Registrar nota débito

Validaciones

Respuesta

​Prerequisitos

​Registrar nota débito

​Validaciones

​Respuesta

Prerequisitos

Registrar nota débito

Validaciones

Respuesta