CreditnoteCreate

POST

/v1/dian/credit-notes/

📌

Endpoint que permite crear una Nota Crédito de Factura Electrónica de Venta, con los datos requeridos para enviar a la DIAN.

📌

Method: POST
Crear una Nota Crédito de Factura Electrónica de Venta

Solicitud

Autorización

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros de consulta

Parámetros del Body application/json

Ejemplos

Respuestas

🟢200

application/json

Objeto que representa la respuesta que contiene la información de la Nota Crédito de Factura Electrónica de Venta.

Bodyapplication/json

🟠400

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location '/v1/dian/credit-notes/?companyId=821001377&providerId=901084328' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "TypeCode": "92",
    "Number": 1,
    "Date": "2024-06-05T09:52:00.76",
    "DueDate": "2024-06-05T09:52:00.76",
    "CurrencyCode": "COP",
    "Note": "",
    "ConceptCode": "1",
    "DocumentReference": {
        "Uuid": "654007ba40f0cf676adcbb38717339bad990d023237ab9de06fbbc0319ac82287d90cf7a9647cbd053384c11a0110a8b",
        "Date": "2024-02-12T00:00:00",
        "SchemeName": "CUFE-SHA384",
        "TypeCode": "01",
        "Number": "EG13103"
    },
    "NumberingRange": {
        "Id": 0,
        "Date": "2024-05-28T00:00:00",
        "Prefix": "NDFE",
        "FromNumber": 1,
        "ToNumber": 10000,
        "StartDate": "2024-05-28T00:00:00",
        "EndDate": "2026-05-28T00:00:00"
    },
    "SoftwareProvider": {
        "Origin": "software_emisor"
    },
    "SigningCertificate": {
        "Password": "",
        "Content": "",
    },
    "CompanyParty": {
        "ImageUrl": null,
        "Id": "000000000",
        "IdentificationType": "31",
        "Name": "PEMPRESA SAS",
        "PhysicalLocation": {
            "Address": "",
            "CityCode": "54001",
            "SubentityCode": "54",
            "CountryCode": "CO",
            "CountryName": "",
            "PostalZone": ""
        },
        "OrganizationTypeCode": "2",
        "RegimeCode": "R-99-PN",
        "TaxLevelCode": "R-99-PN",
        "TaxCode": null,
        "CorporateRegistration": "000000",
        "IndustryClassificationCode": "00000",
        "Email": "contacto@miempresa.com",
        "Phone": "0000000000"
    },
    "CustomerParty": {
        "Id": "222222222",
        "IdentificationType": "31",
        "Name": "Consumidor final",
        "PhysicalLocation": {
            "Address": "",
            "CityCode": "54001",
            "SubentityCode": "54",
            "CountryCode": "CO",
            "CountryName": "Colombia",
            "PostalZone": ""
        },
        "OrganizationTypeCode": "2",
        "RegimeCode": "R-99-PN",
        "TaxLevelCode": "R-99-PN",
        "TaxCode": "",
        "CorporateRegistration": "00000",
        "IndustryClassificationCode": "",
        "Email": "consumidorfinal@gmail.com",
        "Phone": ""
    },
    "Items": [
        {
            "Code": "200332",
            "Description": "ITEM 1",
            "Quantity": 1.00,
            "Price": 840.34,
            "PriceReference": 27800.00,
            "SubtotalAmount": 840.34,
            "UnitCode": "EA",
            "BrandName": "",
            "ModelName": "",
            "Note": "",
            "Taxes": [
                {
                    "Code": "01",
                    "Amount": 159.66,
                    "Percentage": 19.00,
                    "TaxableAmount": 840.34,
                    "PerUnitAmount": 0.0,
                    "Concept": "Tarifa general"
                }
            ],
            "Discounts": [
                {
                    "Code": "00",
                    "Percentage": 0.0,
                    "Amount": 0.00,
                    "BaseAmount": 0.00,
                    "Reason": "razon/motivo del descuento"
                }
            ],
            "Charges": [
                {
                    "Code": "02",
                    "Percentage": 0.0,
                    "Amount": 0.00,
                    "BaseAmount": 0.00,
                    "Reason": "razon/motivo del recargo"
                }
            ]
        }
    ],
    "PaymentMeans": {
        "Code": "1",
        "MethodCode": "10",
        "Date": "2024-06-05T00:00:00"
    },
    "LegalMonetaryTotal": {
        "GrossAmount": 840.34,
        "TaxExclusiveAmount": 840.3400,
        "TaxInclusiveAmount": 1000.00,
        "DiscountAmount": 0.0,
        "ChargeAmount": 0.0,
        "PrepaidAmount": 0.00,
        "PayableAmount": 1000.00
    },
    "CustomizePrintFormat": {
        "HeaderText": "",
        "FooterText": ""
    }
}'

Ejemplo de Respuesta

200 - Éxito

{
  "id": "NCFE1",
  "name": "face_cNCFE09010843280000000001",
  "status": "submitted",
  "created": "2024-04-05T08:48:00.909+00:00",
  "document": {
    "uuid": "a5b8f21175a2f8d4330992b96d521d56364bfc1f611886897d6c9ccaa1f0b626c37da471fe83b62510a706b8b13907d7",
    "date": "2024-04-05T08:47:55.7+00:00",
    "type": "91",
    "number": 1,
    "prefix": "NCFE",
    "schemeName": "CUDE-SHA384",
    "signatureValue": "P3Dp4lgRLiI9rCiTpZpItfhDTZysKi0ElO6zgiEGcGBbaOhfeIswSwoxLK3Xf9Ot5z2syzKlHEcUpOUt8tV92am0fKCwARm2Oq2WJC2GdyRMKBjkuqo41nkOMxIs7849mkiik21P2GwBB3sKX0gRlkszTaxIeBzeAeN7j+YJJ2SraYNd5st4NY7x45l/SQbazGh2zUerNsLuWibbnCSMJJzEkCjaFdtce55n/wZuuK3OBRAyhtxbAe6HhlabmbZow7olKYtwrEdsFl4Zivig0SUlVIdMvq5IFFiEXxHez/Umy+hQfScKTVuQ0F0cS0xDOkULMgYuRBd1wcGeZ5CMVw==",
    "reference": "EG13103"
  },
  "response": {
    "statusCode": "00",
    "statusMessage": "La Nota de crédito electrónica NCFE1, ha sido autorizada.",
    "statusDescription": "Procesado Correctamente.",
    "errorMessage": "",
    "zipkey": ""
  }
}

Modificado en 2026-09-14 14:05:01

InvoiceCreate

EquivalentCreate