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

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

Este documento permite realizar cambios, ajustes y/o correcciones a las facturas electrónicas de venta. Su uso principal es generar un cargo adicional al cliente cuando el cobro inicialmente transmitido en la factura de venta fue inferior al valor real.

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

A continuación, se describen los métodos y estructuras necesarias para la creación y manejo 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 consumir el servicio de creación de una Nota Débito de la Factura Electrónica de Venta, es necesario tener en cuenta el Entorno en el que se va a operar.

SOVOS Saphety dispone de dos ambientes: QA (pruebas) y Producción, detallados en el apartado correspondiente de esta documentación.

Consumo del método de creación.#

metodoND

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

Parameters

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, se presenta la estructura base definida por Saphety para la creación de una 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

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

Respuesta#

{
    "IsValid": true,
    "Warnings": [],
    "Errors": [],
    "ResultData": "25ed3777-ba70-4fd9-b019-d9dbeb1495ab",
    "ResultCode": 200
}

{
    "IsValid": false,
    "Warnings": [],
    "Errors": [
        {
            "Field": "SalesInvoice.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: