Emisión de Nota de Ajuste al Documento Soporte

1. Descripción

Emite una nota de ajuste sobre un documento soporte ya emitido y aceptado por la DIAN, y la
transmite en una sola llamada.

Se envía en formato JSON la referencia al documento que se corrige y el concepto de la corrección.
El servicio tiene dos comportamientos según lo que se informe:

Con Lines: se emite el ajuste con el detalle enviado (devoluciones parciales, rebajas,
correcciones de precio).

Sin Lines: se anula el documento referenciado con su mismo detalle —incluidos sus impuestos
y retenciones—. Es la forma más corta de anular: basta la referencia.

Como en el documento soporte, si no se envía la numeración se toma la resolución de notas vigente
registrada para la empresa y se asigna el siguiente consecutivo disponible.

2. Método y ruta

POST /arqGeneratorDSController/v1/process-adjustment-note

Content-Type: application/json

3. Headers

Header	Obligatorio	Descripción
`x-api-key`	Sí	Llave de integración entregada a la empresa.
`x-company-id`	Sí	Identificador de la empresa que emite la nota.
`Content-Type`	Sí	`application/json`

4. Tipo de documento

No se envía: la ruta emite siempre nota de ajuste al documento soporte, con su propia numeración.

5. Body

5.1 Nivel documento

Campo	Tipo	Obligatorio	Descripción
`DocumentReferences`	objeto[]	Sí	Documento soporte que se corrige.
`CorrectionConceptCode`	string	No	Concepto de corrección de la DIAN. Por defecto `2` (anulación).
`CorrectionConcept`	string	No	Descripción del concepto. Por defecto `Se anula documento`.
`Currency`	string	No	Solo se admite `COP`.
`SeriePrefix`	string	No	Prefijo de la resolución de notas. Si no se envía se usa la vigente de la empresa.
`SerieNumber`	string	No	Número de la nota. Si no se envía se asigna el siguiente consecutivo.
`IssueDate`	string	No	Fecha de la nota. Se emite con la fecha del día.
`Notes`	string[]	No	Observaciones de la nota.
`PaymentMeans`	objeto[]	No	Forma y medio de pago.
`SupplierParty`	objeto	Condicional	Proveedor no obligado a facturar. Obligatorio cuando se envían `Lines`.
`Lines`	objeto[]	No	Detalle de la nota. Si no se envía se anula el documento referenciado.
`TaxSubTotals` / `TaxTotals`	objeto[]	No	IVA de la nota.
`WithholdingTaxTotals`	objeto[]	No	Retenciones de la nota.
`Total`	objeto	Condicional	Totales de la nota. Obligatorio cuando se envían `Lines`.

5.2 `DocumentReferences`

Campo	Tipo	Obligatorio	Descripción
`DocumentReferred`	string	Condicional	Prefijo y número del documento soporte corregido (por ejemplo `SEDS984100450`).
`DocumentReferredCUFE`	string	Condicional	CUDS del documento soporte corregido.
`IssueDate`	string	No	Fecha de emisión del documento corregido. Si no se envía se toma la registrada.

Se requiere al menos uno de los dos identificadores. El documento referenciado debe existir para
la empresa y haber sido aceptado por la DIAN; si no, se devuelve error.

5.3 `SupplierParty`, `Lines`, impuestos y `Total`

Se informan exactamente igual que en el documento soporte, incluidas las reglas de IVA, ReteIVA y
ReteRenta. Ver la documentación del documento soporte — secciones
5.2 a 5.6.

5.4 Ejemplo: anulación

{
  "Currency": "COP",
  "IssueDate": "2026-08-04T10:30:00",
  "CorrectionConceptCode": "2",
  "CorrectionConcept": "Se anula documento",
  "DocumentReferences": [
    {
      "DocumentReferred": "SEDS984100450",
      "IssueDate": "2026-08-04"
    }
  ]
}

5.5 Ejemplo: ajuste parcial con IVA y retenciones

{
  "Currency": "COP",
  "SeriePrefix": "SENS",
  "IssueDate": "2026-08-04T10:30:00",
  "CorrectionConceptCode": "4",
  "CorrectionConcept": "Ajuste de precio",
  "DocumentReferences": [
    {
      "DocumentReferred": "SEDS984100450",
      "DocumentReferredCUFE": "6ac30395c03826db09c8cdb2e9658626cc8fab34b27c44edaf9cdbe8dc465d3d",
      "IssueDate": "2026-08-04"
    }
  ],
  "SupplierParty": {
    "LegalType": "Legal",
    "TaxScheme": "01",
    "ResponsabilityTypes": ["R-99-PN"],
    "Identification": {
      "DocumentNumber": "1006017896",
      "DocumentType": "NIT",
      "CountryCode": "CO",
      "CheckDigit": "1"
    },
    "Name": "OFUS NAME",
    "Address": {
      "DepartmentCode": "76",
      "CityCode": "76520",
      "AddressLine": "CL 5 # 12 - 34",
      "Country": "CO",
      "PostalCode": "765200"
    }
  },
  "Lines": [
    {
      "Number": "1",
      "Quantity": "1",
      "QuantityUnitOfMeasure": "94",
      "OperationType": "1",
      "PeriodStartDate": "2026-08-04",
      "UnitPrice": "100000.00",
      "NetAmount": "100000.00",
      "TaxSubTotals": [
        {
          "TaxCategory": "01",
          "TaxPercentage": "19.00",
          "TaxableAmount": "100000.00",
          "TaxAmount": "19000.00"
        }
      ],
      "WithholdingTaxSubTotals": [
        { "TaxCategory": "05", "TaxPercentage": "15.00" },
        { "TaxCategory": "06", "TaxPercentage": "2.50" }
      ],
      "Item": { "Gtin": "2002", "Description": "Servicio ajustado" }
    }
  ],
  "TaxTotals": [{ "TaxCategory": "01", "TaxAmount": "19000.00" }],
  "Total": {
    "TaxableAmount": "100000.00",
    "TaxAmount": "19000.00",
    "WithholdingTaxAmount": "5350.00",
    "PayableAmount": "119000.00"
  }
}

6. Respuesta

Idéntica a la del documento soporte:

Campo	Tipo	Descripción
`Errors`	string[]	Motivos por los que la nota no se emitió o fue rechazada por la DIAN.
`IsValid`	boolean	`true` cuando la nota fue emitida y aceptada por la DIAN.
`ResultCode`	number	Resultado del procesamiento.
`Warning`	string[]	Notificaciones que no impiden la emisión.
`ResultData`	string	Mensaje del resultado.

Nota: la respuesta HTTP es 200 en todos los casos de negocio. El resultado real se lee en
ResultCode e IsValid.

7. Códigos de resultado

`ResultCode`	HTTP	`IsValid`	Significado
200	200	`true`	Nota emitida y aceptada por la DIAN.
200	200	`false`	Nota emitida pero rechazada por la DIAN. El detalle viaja en `Errors`.
400	200	`false`	Los datos enviados no permiten emitir la nota (referencia inexistente o no aceptada, estructura, totales o numeración).
401	200	`false`	La llave de integración no corresponde a la empresa.
500	500	`false`	Error inesperado durante el procesamiento.

8. Ejemplos de respuesta

8.1 Anulación emitida

{
  "Errors": [],
  "IsValid": true,
  "ResultCode": 200,
  "Warning": [
    "No se informaron Lines: se emite la anulación del documento SEDS984100450 con su mismo detalle."
  ],
  "ResultData": "Procesado Correctamente."
}

8.2 Ajuste emitido

{
  "Errors": [],
  "IsValid": true,
  "ResultCode": 200,
  "Warning": [],
  "ResultData": "Procesado Correctamente."
}

8.3 Documento referenciado inexistente

{
  "Errors": [
    "No se encontró el documento soporte referenciado (SEDS000000000) para esta empresa."
  ],
  "IsValid": false,
  "ResultCode": 400,
  "Warning": [],
  "ResultData": "No se encontró el documento soporte referenciado (SEDS000000000) para esta empresa."
}

8.4 Sin referencia

{
  "Errors": [
    "DocumentReferences es obligatorio: identifica el documento soporte que se corrige."
  ],
  "IsValid": false,
  "ResultCode": 400,
  "Warning": [],
  "ResultData": "DocumentReferences es obligatorio: identifica el documento soporte que se corrige."
}

Generación Nota Documento Soporte

Emisión de Nota de Ajuste al Documento Soporte

1. Descripción

2. Método y ruta

3. Headers

4. Tipo de documento

5. Body

5.1 Nivel documento

5.2 `DocumentReferences`

5.3 `SupplierParty`, `Lines`, impuestos y `Total`

5.4 Ejemplo: anulación

5.5 Ejemplo: ajuste parcial con IVA y retenciones

6. Respuesta

7. Códigos de resultado

8. Ejemplos de respuesta

8.1 Anulación emitida

8.2 Ajuste emitido

8.3 Documento referenciado inexistente

8.4 Sin referencia

Solicitud

Respuestas

Generación Nota Documento Soporte

Emisión de Nota de Ajuste al Documento Soporte#

1. Descripción#

2. Método y ruta#

3. Headers#

4. Tipo de documento#

5. Body#

5.1 Nivel documento#

5.2 DocumentReferences#

5.3 SupplierParty, Lines, impuestos y Total#

5.4 Ejemplo: anulación#

5.5 Ejemplo: ajuste parcial con IVA y retenciones#

6. Respuesta#

7. Códigos de resultado#

8. Ejemplos de respuesta#

8.1 Anulación emitida#

8.2 Ajuste emitido#

8.3 Documento referenciado inexistente#

8.4 Sin referencia#

Solicitud

Respuestas

Emisión de Nota de Ajuste al Documento Soporte

1. Descripción

2. Método y ruta

3. Headers

4. Tipo de documento

5. Body

5.1 Nivel documento

5.2 `DocumentReferences`

5.3 `SupplierParty`, `Lines`, impuestos y `Total`

5.4 Ejemplo: anulación

5.5 Ejemplo: ajuste parcial con IVA y retenciones

6. Respuesta

7. Códigos de resultado

8. Ejemplos de respuesta

8.1 Anulación emitida

8.2 Ajuste emitido

8.3 Documento referenciado inexistente

8.4 Sin referencia