Campos nota de ajuste

Método: POST

Endpoint

Sandbox
Producción

https://api-sandbox.factus.com.co/v2/adjustment-notes/validate

https://api.factus.com.co/v2/adjustment-notes/validate

Encabezados de la Solicitud

Incluye los siguientes encabezados.

Content-Type : application/json
Indica que los datos se envían en formato JSON.

Authorization Bearer token_de_acceso
Token de autenticación necesario para acceder al recurso. Ver Cómo generar token

Accept : application/json
Indica que la respuesta debe estar en formato JSON.

  Nota: 
Reemplaza token_de_acceso con el token proporcionado tras autenticarte.

Estructura para crear la nota de ajuste a documento soporte

Para crear una nota de ajuste a documento soporte en Factus API debemos tener en cuenta los siguientes datos:

Datos generales del documento soporte.
Datos del documento que al cual se le hará la nota de ajuste.
Datos de los productos o servicios.

Parámetros del Cuerpo (Body)

El cuerpo (Body) de la solicitud debe enviarse en formato JSON y debe incluir los siguientes parámetros:

Parámetros notas de ajuste a documento soporte
`reference_code` `string` Código único que sirve para identificar cada nota de ajuste a documento soporte de manera unívoca en el sistema y garantizar que no haya duplicados. Esto nos ayuda a prevenir que se genere más de una nota de ajuste con la misma información.
`created_time` `string` `opcional` Fecha y hora de creación de la nota de ajuste en formato `HH:mm:ss`.
`numbering_range_id` `integer` `opcional` ID del rango de numeración. Es obligatorio solo si tienes múltiples rangos activos. Si se omite, el sistema utilizará el único rango disponible por defecto. Rangos de numeración para nota de ajuste , filtar por filter[document] = 25 para obtener solo los rangos de numeración para notas de ajuste.
`support_document_number` `string` Número del documento soporte al que se le hará la nota de ajuste.
`correction_concept_code` `string` Código del motivo por el cual se genera la nota de ajuste. Para conocer el código de cada motivo, consulte el siguiente endpoint: Motivos para la generación de las notas de ajuste
`observation` `string` `opcional` Agrega una observación de la nota de ajuste. No debe tener más de 250 caracteres.
`payment_details` `array` Este es un array de objetos para los medios de pago. Se debe enviar un objeto por cada medio de pago utilizado para pagar la nota de ajuste.
*`payment_details..payment_form`** `string` Código de la forma de pago. Formas de pago disponibles
*`payment_details..payment_method_code`** `string` Código del método de pago. Métodos de pago disponibles.
*`payment_details..reference_code`** `string` `opcional` Código de referencia del pago.
*`payment_details..amount`** `string` Monto pagado por ese medio y método de pago.
*`payment_details..due_date`** `string` `opcional` Fecha de vencimiento de la nota de ajuste, en formato `YYYY-MM-DD`. Requerido solo cuando la forma de pago (`payment_form`) contiene el valor de 2 (pago a crédito).
`cash_rounding_amount` `string` `opcional` Ajuste opcional que reconcilia la diferencia entre la suma de los montos en `⁠payment_details` y el `total` de la nota de ajuste, causada por las limitaciones de denominación de la moneda local. Acepta valores negativos (redondeo hacia abajo) o positivos (redondeo hacia arriba). El valor máximo permitido es ±500.00.
`provider` `object` Este es un objeto que contendrá la información del proveedor de la nota de ajuste.
`provider.identification_document_code` `string` Código que corresponde al tipo de identificación. Tipos de documentos de identidad disponibles
`provider.identification` `string` Número de identificación del proveedor.
`provider.dv` `string` `opcional` Dígito de verificación del proveedor. Requerido ya que el proveedor debe identificarse con NIT, sin embargo, si no se envía el API lo calcula automáticamente.
`provider.trade_name` `string` `opcional` Nombre comercial del proveedor.
`provider.names` `string` Nombre del proveedor.
`provider.address` `string` Dirección del proveedor.
`provider.country_code` `string` Código del país del proveedor. Países disponibles
`provider.municipality_code` `string` Código del municipio del proveedor. Municipios disponibles
`provider.email` `string` `opcional` Dirección del correo electrónico del proveedor.
`provider.phone` `string` `opcional` Número de teléfono del proveedor.
`items` `array` Este es un array de objetos (items) que corresponde a los productos o servicios de la nota de ajuste, se debe enviar un objeto por cada producto o servicio.
*`items..code_reference`** `string` Código de referencia del producto o servicio.
*`items..name`** `string` Nombre del producto o servicio.
*`items..quantity`** `string` Cantidad del producto o servicio (máximo dos decimales).
*`items..discount_rate`** `string` Porcentaje del descuento del producto o servicio (máximo dos decimales).
*`items..price`** `string` Precio por unidad del producto o servicio sin impuestos incluidos ni descuentos, valor neto (máximo dos decimales).
*`items..unit_measure_code`** `string` Código que corresponda a la unidad de medida del item. Unidades de medida disponibles
*`items..standard_code`** `string` Código que corresponde al estándar que se adopta para los productos o servicios. Códigos de estándar disponibles.
*`items..withholding_taxes`** `array` `opcional` Este es un array de objetos para informar las retenciones que se aplican al producto o servicio. Por cada retención que apliques al proveedor, debes enviar un objeto.
*`items..withholding_taxes..code`* `string` Código de la retención aplicada al producto o servicio. Códigos retenciones disponibles.
*`items..withholding_taxes..rate`* `string` Porcentaje de la retención aplicada al producto o servicio (máximo dos decimales).
*`items..taxes`** `array` Este es un array de objetos para los impuestos.
*`items..taxes..code`* `string` Código del impuesto aplicado al producto o servicio, para documento soporte debe ser `01` correspondiente al impuesto sobre la ventas - IVA.
*`items..taxes..rate`* `string` Porcentaje del impuesto aplicado al producto o servicio (máximo dos decimales).
*`items..taxes..is_excluded`* `boolean` `opcional` Indica si el ítem está excluido de impuestos. Valor: `true` o `false`.

El (*) al lado del nombre de un campo indica que se pueden enviar múltiples objetos con esa estructura dentro del array, por ejemplo, en el caso del campo items, se debe enviar un objeto por cada producto o servicio que se quiera incluir en la factura.