API: Anulación del Documento Equivalente Electrónico POS

A partir de la Resolución 000165 de 2023 de la DIAN, todos los documentos equivalentes (incluyendo el POS) deben ser electrónicos y para anularlos es obligatorio emitir Notas de Ajuste Electrónicas asociadas al CUDE del documento original.

La API de Dataico simplifica ese proceso en dos pasos:

Crear la numeración exclusiva para las Notas de Ajuste.
Emitir la Nota de Ajuste de tipo "ANULACIÓN" que referencia al POS electrónico original.

Para utilizar esta funcionalidad se debe contar con el CUDE, el número y la fecha de emisión del documento equivalente POS que se desea anular.

Ambos pasos usan el encabezado Auth-token (tu llave API o el Auth Token de la cuenta) y Content-Type: application/json.

Paso 1: Crear la Numeración para Notas de Ajuste

Método: POST

Endpoint: https://api.dataico.com/direct/dataico_api/v2/numberings/pos_adjustment_note

Body:

{
  "numbering": {
    "prefix": "PNC"
  }
}

Función: Crea una serie para Notas de Ajuste Electrónicas con el prefijo que definas. La plataforma comenzará a contar desde 1 automáticamente.

Esta acción debe realizarse solo una vez. La cuenta tiene una sola numeración de Notas de Ajuste POS: si ya existe, la API no crea otra y responde Ya existe una numeración para Notas de Ajuste POS con el prefijo ..., con el prefijo existente. Si la crea, responde La numeracion para notas de ajuste POS fue creada exitosamente.

En la documentación de la API esta operación aparece en la sección numberings, como POST /numberings/{module}. El valor de {module} es pos_adjustment_note, en singular.

Paso 2: Emitir la Nota de Ajuste de Anulación

Método: POST

Endpoint: https://api.dataico.com/direct/dataico_api/v2/pos-credit-note (en singular)

Body:

{
  "source-document-number": 123,
  "source-document-cude": "<CUDE del POS original>",
  "source-document-issue-date": "15/05/2026",
  "numbering-prefix": "PNC",
  "send-dian": true
}

Campo	Descripción
`source-document-number`	Número del POS original, sin prefijo
`source-document-cude`	CUDE del POS original
`source-document-issue-date`	Fecha de emisión del POS original, en formato `dd/MM/yyyy`
`numbering-prefix`	Prefijo de la numeración de Notas de Ajuste creada en el paso 1
`send-dian`	`true` para enviar la Nota de Ajuste a la DIAN

Como en el resto de la API de POS, las claves van con guion (source-document-number), no con guion bajo.

Función:

La API busca el POS electrónico dentro de la cuenta usando el CUDE.
Verifica que el número y la fecha de emisión que enviaste coincidan con los de ese POS.
Genera el documento de Nota de Ajuste por concepto de ANULACIÓN con la numeración del prefijo indicado.
Si send-dian es true, la envía a la DIAN.

Errores posibles

Si algo no cuadra, la API responde con código HTTP 400 y la lista de errores:

Mensaje	Qué hacer
`Factura electronica POS no existe`	No hay un POS con ese CUDE en la cuenta. Revisa el CUDE y que uses las credenciales de la cuenta que emitió el POS
`Nota de ajuste POS ya existe`	Ese POS ya tiene una Nota de Ajuste: ya está anulado
`Numeración no existe`	No hay una numeración de Notas de Ajuste con ese `numbering-prefix`. Haz el paso 1 o corrige el prefijo
`No hay coincidencia entre la fecha de emisión y el número de documento...`	El número o la fecha de emisión no son los del POS que tiene ese CUDE. Corrígelos para que coincidan con el original

La ejemplificación completa se encuentra en la documentación de la API en la sección pos-credit-note.

Otros artículos que pueden interesar

Documentación Técnica de la API de DATAICO POS Electrónico