Skip to main content

Nota de ajuste de documento soporte

POST 

/api/ubl2.1/sd-credit-note/:testSetId

PRIMER ENVIO DE NOTA DE AJUSTE DE DOCUMENTO SOPORTE

  • Si se instalo un dominio se debe utilizar de la siguiente manera:

http://midominio.com/api/ubl2.1/sd-credit-note

  • Requiere el token de la empresa en el header Authorization: Bearer {api_token}. Ese token se entrega en la respuesta del Paso 1 - Config Company; si se extravio, se cambia con el comando php artisan api:rotate-token {nit} o con PUT /api/ubl2.1/config/rotate-token/{nit} usando el header X-Admin-Token.

  • Es la nota de ajuste que corrige un documento soporte ya emitido, por lo que requiere el software y la resolucion de NC de documento soporte configurados en la seccion 01D (Pasos 1 y 3).

  • El bloque billing_reference identifica el documento soporte que se esta ajustando con su number, uuid (el CUDS) e issue_date.

  • Como en el documento soporte, el bloque seller corresponde al proveedor del bien o servicio, no al adquiriente.

  • En URL el ultimo parametro corresponde al id del set de pruebas que la dian entrego al momento de registrar el modo de operacion software propio.

.../ubl2.1/sd-credit-note/iddelsetdepruebasdeladian

  • Este endpoint se puede utilizar de dos modos:
  1. Asincrono:
    .../ubl2.1/sd-credit-note/iddelsetdepruebasdeladian

  2. Sincrono:
    .../ubl2.1/sd-credit-note

  • El modo sincrono no afecta al set de pruebas, pero la respuesta de la DIAN incluye posibles errores de validacion y el estado de la nota de ajuste, valida o no valida.

  • El modo asincrono, afecta el set de pruebas y en la respuesta no se incluye el resultado de la nota de ajuste, solo se entrega un ZIP_KEY el cual debe ser consultado mediante el endpoint:

.../ubl2.1/status/zip

de la seccion 03 - Consultas de estado para asi poder establecer si la nota de ajuste fue valida o no y los errores de validacion.

Tipos de identificación del vendedor permitidos

Valores permitidos para seller.type_document_identification_id.

IDNombreResidenteNo Residente
4Tarjeta de extranjeríaX
5Cédula de extranjeríaX
6NITXX
7PasaporteX
8Documento de identificación extranjeroX
9NIT de otro paísX
11PEP (Permiso Especial de Permanencia)X

Se envía el ID, no el código DIAN. Cualquier otro valor es rechazado por validación.

Request​

Headers​

HeaderValor
Content-Typeapplication/json
Acceptapplication/json
AuthorizationBearer <TU_TOKEN>

Responses​

Successful response