Nota Débito de la Factura Electrónica de Venta

Nota Débito 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 un cargo adicional al cliente debido a un cobro inferior 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 Débito de la Factura Electrónica de Venta.

Creación de una Nota Débito de la Factura Electrónica de Venta (ND).#

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.#

metodoND

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/debitNoteAsync

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 Débito de la Factura Electrónica de Venta#

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

JSON (DTO)

{
    "Currency": "COP",
    "ReasonDebit": "1",
    "SeriePrefix": "ND",
    "SerieNumber": "120",
    "OperationType": "30",
    "IssueDate": "2023-11-27T12:12:12",
    "DueDate": "2023-11-27T12:12:12",
    "DeliveryDate": "2023-11-27T12:12:12",
    "CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
    "SerieExternalKey": "{{serieexternalkeyND}}",
    "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": "12345",
            "IssueDate": "2019-05-30T00:00:00",
            "Type": "InvoiceReference",
            "DocumentReferredCUFE": "002c3bf161743714e994f92226eae9f74a528c00f999d4e22b7094edf7560e2a6109b6421301f33e444f743d56be2135"
        }
    ]
}

Términos importantes

encontrará los siguientes términos, los cuales le ayudaran a identificar la estructura del mensaje Json y la información que se debe enviar en cada campo:

A nivel global de la factura: Datos generales de la factura de venta (Consecutivo de la factura, medios y formas de pago, total a pagar, impuestos globales, descuentos globales, fecha emisión de la factura, etc.).
A nivel de línea: Datos que detallan los productos o servicios de la factura (valor unitario, impuestos, descuentos, retenciones, etc).
Emisor: Datos que hacen referencia al Emisor de la factura.
Adquiriente: Datos que hacen referencia a la persona natural o Jurídica que se le emite el documento (Cliente).

status: 200 OK

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

status: 400 Bad Request

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

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