Contingencia Tipo 3 para Factura de Venta Electronica

Contingencia Tipo 3 para Factura de Venta Electronica#

La factura de contingencia se utiliza cuando el emisor presenta una falla tecnológica (por ejemplo, caída del ERP, interrupción del servicio de internet, o fallas del proveedor tecnológico) y requiere emitir una factura de venta al adquiriente en ese momento.

Importante

Logo_DIAN

Se debe solicitar previamente la numeración consecutiva correspondiente, con su vigencia autorizada por la DIAN.

FechaNumeracion

Las fechas de generación y la numeración de las facturas electrónicas emitidas por contingencia deben coincidir con las registradas en la factura generada en papel.

WarningDoc

El facturador electrónico podrá emitir facturas de contingencia únicamente durante el tiempo que dure la contingencia.

Tipos de Contingencia#

Existen dos tipos de contingencia que pueden aplicarse según el origen del inconveniente tecnológico. No obstante, en este manual se abordará únicamente la Contingencia Tipo 003.

  • Contingencia por parte del Facturador Electrónico (Contingencia TIPO 003).

  • Contingencia por parte de la DIAN (Contingencia TIPO 004).

Contingencia por parte del Facturador Electrónico#

(Contingencia Tipo 003 — Inconvenientes Tecnológicos)

Este tipo de contingencia se utiliza cuando la plataforma del Facturador Electrónico o del Proveedor Tecnológico presenta algún inconveniente técnico que impide la generación o transmisión de la factura electrónica.

Algunos ejemplos comunes incluyen: falta de energía eléctrica, interrupción del servicio de internet o cualquier otra limitante tecnológica que afecte la operación normal del sistema.

¿Qué se debe hacer?

Contingencia-TIPO-3.

Creación de una Factura Electrónica de Venta por contingencia (FVC).#

Para consumir el servicio de creación de facturas electrónicas de venta por contingencia, 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.#

metodoFVC

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

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 Factura Electrónica de Venta por Contingencia (FVC).#

A continuación, se presenta la estructura base definida por SOVOS Saphety para la creación de una Factura Electrónica de Venta por Contingencia (FVC).

Esta estructura describe la organización general del mensaje en formato JSON, el cual debe cumplir con las especificaciones técnicas establecidas por la DIAN y las reglas de validación aplicables al proceso de facturación electrónica en escenarios de contingencia.

1. DocumentReferred (Factura Electrónica de Venta por contingencia (FVC))

Invoice.DocumentReferences.DocumentReferred

/Invoice/cac:ContingencyReference/cbc:ID

Prefijo y consecutivo del documento que se genero como contingencia a papel.

2. IssueDate (Factura Electrónica de Venta por contingencia (FVC))

Invoice.DocumentReferences.OrderReference.IssueDate

/Invoice/cac:OrderReference/cbc:IssueDate

Fecha y hora de generación del documento de contingencia a papel.

Formato fecha aaaa-mm-ddThh:mm:ss.

1. ContingencyReference (Factura Electrónica de Venta por contingencia (FVC))

Invoice.DocumentReferences.Type

/Invoice/cac:ContingencyReference

Relacionar el tipo de referencia en este caso para contingencia tipo 3 es “ContingencyReference”.
El listado de los tipos de DocumentReferences están disponibles en el método del WEB API de Saphety: DocumentReferences.

DTO Factura Electrónica de Venta por contingencia (FVC)#

JSON (DTO)
{
    "Currency": "COP",
    "SeriePrefix": "CFV",
    "SerieNumber": "32",
    "IssueDate": "2023-11-27T12:12:12",
    "DueDate": "2023-11-27T12:12:12",
    "DeliveryDate": "2023-11-27T12:12:12",
    "CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
    "SerieExternalKey": "{{serieexternalkeyCFV}}",
    "DocumentReferences": [
        {
            "DocumentReferred": "SETT9999", // prefijo y consecutivo del documento que se genero como contingencia a papel.
            "IssueDate": "2022-07-29T00:09:26", // fecha y hora de generación del documento de contingencia a papel.
            "Type": "ContingencyReference" // relacionar el tipo de referencia en este caso para contingencia tipo 3 es  "ContingencyReference".
        }
    ],
    "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"
    }
}

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: