Nota Crédito de la Factura Electrónica de Venta

Este documento permite hacer cambios, ajustes y/o correcciones a las facturas electrónicas de venta como generar abonos o créditos a favor del cliente debido un cobro mayor en la factura de venta inicialmente transmitida, para esto, a través de Saphety en calidad de Proveedor Tecnológico autorizado por DIAN, permite realizar la generación, trasmisión para validación, validación y expedición del documento de acuerdo con los requisitos y definiciones legales del anexo técnico vigente regulado por DIAN.

A continuación se describe los métodos y estructuras para la creación de una Nota Crédito de la Factura Electrónica de Venta.

Creación de una Nota Crédito de la Factura Electrónica de Venta (NC).

Para hacer el consumo de la API se deben tener en cuenta en que entorno se va a trabajar, SOVOS Saphety cuenta con dos ambientes especificados en el apartado de Entornos.

Consumo del método de creación.

Verbo Http

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

POST

Método Http

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

    /v2/{virtualOperator}/outbounddocuments/creditNoteAsync

Parameters

Parámetros

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 Crédito de la Factura Electrónica de Venta

A continuación encontrara la estructura Base definida por Saphety para la creación de Nota Crédito de la Factura Electrónica de Venta.

JSON (DTO)

{
    "Currency": "COP",
    "OperationType": "20",    
    "ReasonCredit": "5",
    "SeriePrefix": "NC",
    "SerieNumber": "120",
    "IssueDate": "2023-11-27T12:12:12",
    "DueDate": "2023-11-27T12:12:12",
    "DeliveryDate": "2023-11-27T12:12:12",
    "CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
    "SerieExternalKey": "{{serieexternalkeyNC}}",
    "IssuerParty": {
        "Identification": {
            "DocumentNumber": "{{nit}}",
            "DocumentType": "NIT",
            "CountryCode": "CO",
            "CheckDigit": "{{digitoverificacion}}"
        }
    },
    "PaymentMeans": [
        {
            "Code": "20",
            "Mean": "1",
            "DueDate": "2023-11-27"
        }
    ],
    "CustomerParty": {
        "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"
        }
    },
    "Lines": [
        {
            "Number": "1",
            "Quantity": "1",
            "QuantityUnitOfMeasure": "NAR",
            "TaxSubTotals": [
                {
                    "TaxCategory": "01",
                    "TaxPercentage": "19.00",
                    "TaxableAmount": "115000.00",
                    "TaxAmount": "21850.00"
                }
            ],
            "TaxTotals": [
                {
                    "TaxCategory": "01",
                    "TaxAmount": "21850.00"
                }
            ],
            "UnitPrice": "115000.00",
            "GrossAmount": "115000.00",
            "NetAmount": "115000.00",
            "Item": {
                "Gtin": "987654321",
                "Description": "Descripcion del producto o servicio"
            }
        }
    ],
    "TaxSubTotals": [
        {
            "TaxCategory": "01",
            "TaxPercentage": "19.00",
            "TaxableAmount": "115000.00",
            "TaxAmount": "21850.00"
        }
    ],
    "TaxTotals": [
        {
            "TaxCategory": "01",
            "TaxAmount": "21850.00"
        }
    ],
    "Total": {
        "GrossAmount": "115000.00",
        "TotalBillableAmount": "136850.00",
        "PayableAmount": "136850.00",
        "TaxableAmount": "115000.00"
    },
    "DocumentReferences": [
        {
            "DocumentReferred": "SETP990040002",
            "IssueDate": "2022-04-09T12:12:12",
            "Type": "InvoiceReference",
            "DocumentReferredCUFE": "b67f5d88bb625349aef46f1c30e474e298a3d21ef9fe451ad32afb2854c5c642b518f14288635c0c63b6d61912c516b5"
        }
    ]
}

Referencia: Swagger

Si quieres más información dirígete a Swagger que es el modelo del API de SOVOS Saphety, para el ambiente de QA https://api-factura-electronica-co-qa.saphety.com/swagger/index.html y para el ambiente de producción https://api-factura-electronica-co.saphety.com/swagger/index.html