Nota de Crédito Débito (NCD)

Se debe considerar que para emitir una nota de crédito-débito, es necesario que la factura correspondiente haya sido emitida en modo EN LÍNEA.

Paso 1: Autenticación

Igual que para las facturas, obtener un access_token.

Paso 2: Validar NIT

Validar el NIT enviando el nit y el branchCode. Similar al Paso 2 de las facturas.

GET/api/v1/sucursales/{branchCode}/validate-nit/{nit}Verificar si un NIT es válido o no ante Impuestos.

Paso 3: Emitir la NCD

Servicio para emitir una nota de crédito débito:

POST/api/v1/sucursales/{branchCode}/facturas/nota-debito-creditoCrea una Nota de Credito y Debito.

Parámetro URL:

• branchCode: El código de la sucursal de donde se va a emitir.

Cuerpo de la Petición:

{
  "facturaExterna": 1,
  "numeroFactura": 100,
  "numeroAutorizacionCuf": "1553FC196BD6D9773FCFD32BAA4FBB8A33B0C1D1021A41F7CDF446D71",
  "fechaFacturaOriginal": "2021-01-01 12:20:23",
  "descuentoFacturaOriginal": 0,
  "montoTotalFacturaOriginal": 12.32,
  "detalleFacturaOriginal": [
    {
      "codigoProducto": "CAM-1842574",
      "codigoProductoSin": 83141,
      "descripcion": "CAMISA DIPLOMAT",
      "cantidad": 1,
      "unidadMedida": 2,
      "precioUnitario": 12.32,
      "subTotal": 12.32,
      "montoDescuento": 0
    }
  ],
  "numeroNota": 400,
  "codigoPuntoVenta": 0,
  "nombreRazonSocial": "Empresa LTD",
  "codigoTipoDocumentoIdentidad": 1,
  "numeroDocumento": "31170026",
  "codigoCliente": "CLIE-0003",
  "codigoLeyenda": 203,
  "usuario": "JOSE ZARAVIA",
  "montoTotalDevuelto": 0.32,
  "montoDescuentoCreditoDebito": 12,
  "montoEfectivoCreditoDebito": 0.04,
  "detalles": [
    {
      "codigoProducto": "CAM-1842574",
      "codigoActividadSin": "99100",
      "codigoProductoSin": 83141,
      "descripcion": "CAMISA DIPLOMAT",
      "cantidad": 1,
      "unidadMedida": 2,
      "precioUnitario": 12.32,
      "subTotal": 12.32,
      "montoDescuento": 0
    }
  ]
}

A continuación se describe cada uno de los campos que se necesitan enviar. El campo facturaExterna es extremadamente importante ya que indica que la FACTURA ORIGINAL no se encuentra en el sistema de facturación EMIZOR. Caso contrario, no enviar este parámetro, ya que simplemente se usará el campo numeroAutorizacionCuf para referenciar a la factura original.

Especificaciones de los campos (NCD)

Campos	Tipo	Ejemplo	Formato	Tamaño Min	Tamaño Max	Obligatorio
facturaExterna	Número	1		1	1	No
numeroFactura	Número	1		1	9999999	Si
numeroAutorizacionCuf	Alfanumérico	15ABC...		1	60	Si
fechaFacturaOriginal	Cadena	2021-01-01 12:20:23	Y-m-d H:i:s	19	19	Si
descuentoFacturaOriginal	Número	0	17.2	1	1	No
montoTotalFacturaOriginal	Número	12.12	17.2	1	9999999.99	Si
detalleFacturaOriginal	Arreglo		[{},{},...]	1 (productos)	500 (productos)	SI (si facturaExterna=1)
numeroNota	Número	1		1	9999999	Si
codigoPuntoVenta	Número	0		1	5	Si
nombreRazonSocial	Cadena			3	150	Si
codigoTipoDocumentoIdentidad	Número	1		1	5	Si
numeroDocumento	Cadena			1	18	Si
codigoCliente	Cadena			3	150	Si
codigoLeyenda	Número	1		1	5	Si
usuario	Cadena	Roberto Lopez		3	80	Si
montoTotalDevuelto	Número	1000.36	17.2	1.0	9999999.99	Si
montoDescuentoCreditoDebito	Número	0	17.2	1.0	9999999.99	Si
montoEfectivoCreditoDebito	Número	1000.36	17.2	1.0	9999999.99	Si
detalles	Arreglo		[{},{},...]	1 (productos)	500 (productos)	Si

Descripción de cada campo (NCD):

Campo	Descripción
facturaExterna	Representa el estado de la factura original. Nota: enviar 1 si la factura original NO se encuentra en el sistema EMIZOR.
numeroFactura	Representa el número de la factura original.
numeroAutorizacionCuf	Representa el número de autorización (para facturas manuales o computarizadas SFV) o el CUF (para facturas computarizadas en línea) de la factura original.
fechaFacturaOriginal	Representa la fecha de emisión de la factura original.
descuentoFacturaOriginal	Representa el descuento aplicado a la factura original.
montoTotalFacturaOriginal	Representa el monto total de la factura original.
detalleFacturaOriginal	Representa el detalle de los ítems de la factura original (Enviar solo si facturaExterna=1).
numeroNota	Representa el número de nota de crédito y débito.
codigoPuntoVenta	Representa el código del punto de venta en el cual se emite la nota.
nombreRazonSocial	Representa el nombre o razón social del cliente.
codigoTipoDocumentoIdentidad	Representa el código del tipo de documento de identidad del cliente.
numeroDocumento	Representa el número de documento del cliente.
codigoCliente	Representa el código del cliente en el sistema local.
codigoLeyenda	Representa el código de la leyenda que se mostrará en la nota.
usuario	Representa el usuario que emite la nota.
montoTotalDevuelto	Representa el monto total devuelto de la factura original.
montoDescuentoCreditoDebito	Representa el descuento adicional aplicado a la nota.
montoEfectivoCreditoDebito	Representa el monto efectivo que se devuelve al cliente. Nota: Es el valor que se utiliza para el crédito fiscal IVA (13% del monto total devuelto).
detalles	Representa el detalle de los ítems de la nota de crédito y débito.

Paso 4: Revisar Estado de la NCD

Se usa el servicio descrito en la sección 3.2 de este documento.

Paso 5: Obtener Detalles de la NCD

Se usa el servicio descrito en la sección 3.3 de este documento.