Nota de Ajuste de Documento Soporte

Nota de Ajuste de Documento Soporte#

La Nota de Ajuste permite realizar cambios, correcciones o actualizaciones sobre un Documento Soporte Electrónico previamente emitido, cuando se presentan errores en valores, descripciones o impuestos aplicados.

A través de SOVOS Saphety, en calidad de Proveedor Tecnológico autorizado por la DIAN, es posible efectuar la generación, transmisión para validación, validación y expedición de este tipo de documento, cumpliendo con los requisitos y definiciones legales establecidos en el anexo técnico vigente regulado por la DIAN.

Creación de una Nota de Ajuste de Documento Soporte Electrónico (NADS).#

A continuación, se describen los métodos y estructuras necesarios para la creación de una Nota de Ajuste del Documento Soporte Electrónico.

Para realizar el consumo de la API, es importante definir previamente el entorno de trabajo en el que se ejecutará la solicitud.

SOVOS Saphety cuenta con dos ambientes disponibles, los cuales se encuentran especificados en el apartado de Entornos.

Consumo del método de creación.#

metodoNADS

El Verbo Http (acción) que se utiliza para la creación de este documento es:

POST

El método que se utiliza para la creación de este documento es:

    /v2/{virtualOperator}/outbounddocuments/supportDocumentAdjustAsync

Para esta petición se requiere como parámetro el alias de su operador virtual.

Parametro virtualOperator

Recuerde reemplazar en el método el parámetro {virtualOperator} con el alias de su operador virtual en minúsculas, por defecto el alias es “saphety”.

Body#

Estructura del mensaje JSON de una Nota de Ajuste de Documento Soporte Electrónico#

A continuación encontrara la estructura Base definida por Saphety para la creación de Nota de Ajuste de Documento Soporte Electrónico.

JSON (DTO)
{
	"Currency": "COP",
    "ReasonCredit":"5", // Causales de rechazo de la nota de ajuste --> https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/creditnotereasons
	"SeriePrefix": "NADS",
	"SerieNumber": "6",
	"IssueDate": "2023-11-27T12:12:12",
	"DueDate": "2023-11-27T12:12:12",
	"DeliveryDate": "2023-11-27T12:12:12",
	"OperationType": "10",
	"CorrelationDocumentId": "POSTMAN-{{$timestamp}}", // Codigo unico generado por el erp o plataforma tecnologica del emisor.
	"SerieExternalKey": "{{serialexternalkeyNADS}}",// Clave externa de NADS generada en saphety.
	"PaymentMeans": [
		{
			"Code": "20",
			"Mean": "1",
			"DueDate": "2023-11-27"
		}
	],
	"CustomerParty": {
		"Identification": {
			"DocumentNumber": "{{nit}}",  // Nit del adquiriente de NADS.
			"DocumentType": "NIT",
			"CountryCode": "CO",
			"CheckDigit": "{{digitoverificacion}}" //Digito de verificacion del adquiriente de NADS.
		}
	},
	"SupplierParty": {
        "LegalType": "Legal",
        "Email": "correo@sovos.com",
        "TaxScheme": "ZZ",
        "ResponsabilityTypes": [
            "R-99-PN"
        ],
        "Identification": {
            "DocumentNumber": "{{nit}}",
            "DocumentType": "NIT",
            "CountryCode": "CO",
            "CheckDigit": "{{digitoverificacion}}"
        },
        "Name": "Saphety Transacciones Electrónicas S.A.S",
        "Address": {
            "DepartmentCode": "11",
            "CityCode": "11001",
            "AddressLine": "Calle 97a No. 9 - 45",
            "Country": "CO",
            "PostalCode": "000000"
        }
    },
	"Lines": [
		{
			"Number": "1",
			"Quantity": "1",
			"QuantityUnitOfMeasure": "NAR",
			"TaxSubTotals": [
				{
					"TaxCategory": "01",
					"TaxPercentage": "19.00",
					"TaxableAmount": "100000.00",
					"TaxAmount": "19000.00"
				}
			],
			"TaxTotals": [
				{
					"TaxCategory": "01",
					"TaxAmount": "19000.00",
					"RoundingAmount": "0.00"
				}
			],
			"UnitPrice": "100000.00",
			"GrossAmount": "100000.00",
			"NetAmount": "100000.00",
			"Item": {
				"Gtin": "xxxxx",
				"Description": "Servicio 1"
			},
			"InvoicePeriod": {
				"From": "2023-11-27",
				"DescriptionCode": "1"
			}
		}
	],
	"TaxSubTotals": [
		{
			"TaxCategory": "01",
			"TaxPercentage": "19.00",
			"TaxableAmount": "100000.00",
			"TaxAmount": "19000.00"
		}
	],
	"TaxTotals": [
		{
			"TaxCategory": "01",
			"TaxAmount": "19000.00",
			"RoundingAmount": "0.00"
		}
	],
	"Total": {
		"GrossAmount": "100000.00",
		"TotalBillableAmount": "119000.00",
		"PayableAmount": "119000.00",
		"TaxableAmount": "100000.00"
	},
	"DocumentReferences": [ // Seccion para referenciar el documento soporte a afectar total o parcialmente.
		{
			"DocumentReferred": "SETP990013006", // prefijo+consecutivo del DS a afectar
			"IssueDate": "2022-07-15T00:00:00", // fecha de emision del DS a afectar
			"Type": "InvoiceReference",// InvoiceReference -->https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/docreferencetypes
			"DocumentReferredCUFE": "053265517bdd990eeac64599fbce7a3dd2c9f2364485a6e94f60a24ed278149a0231273ff0efb448ba199fba7b99bd36" //cuds del DS a afectar
		}
	],
	"Notes": [
		"Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum."
	]
}

Términos importantes

A continuación, se describen las secciones clave del mensaje JSON para una Factura Electrónica de Venta:

  • A nivel global de la factura: Contiene información general como número consecutivo, fecha de emisión, forma y medio de pago, valor total, impuestos y descuentos globales, entre otros.

  • A nivel de línea: Describe los productos o servicios facturados, con sus respectivos valores unitarios, cantidades, descuentos, impuestos, retenciones, etc.

  • Emisor: Información completa de la persona natural o jurídica que emite la factura.

  • Adquiriente: Datos de identificación del receptor del documento (cliente o comprador).

{
    "IsValid": true,
    "Warnings": [],
    "Errors": [],
    "ResultData": "a9d6c173-0cce-4f67-a1c0-d65811c182ad",
    "ResultCode": 200
}

{
    "IsValid": false,
    "Warnings": [],
    "Errors": [
        {
            "Field": "supportDocumentAdjust.Currency",
            "Code": "Required",
            "Description": null,
            "ExplanationValues": []
        }
    ],
    "ResultData": "00000000-0000-0000-0000-000000000000",
    "ResultCode": 400
}

Referencia: Swagger#

Para obtener más información, puedes consultar la documentación del API de SOVOS Saphety en Swagger. A continuación, se indican los enlaces según el ambiente: