EXPORTACIÓN OPCIÓN 2

EXPORTACIÓN OPCIÓN 2#

Este grupo de campos está diseñado para informar datos específicos en facturas relacionadas con operaciones de exportación cuando el origen NO es Colombia.

Al exportar bienes a otro país, es obligatorio generar una Factura Comercial de Exportación que refleje claramente la mercancía exportada y que sirva como prueba legal y fiscal de la transacción internacional.

Características importantes a considerar:

Objeto del documento: Reflejar la operación comercial internacional.
Normativa: La factura debe cumplir con los requisitos legales y aduaneros internacionales, así como las disposiciones vigentes en Colombia.
Datos específicos: Se deben incluir detalles particulares como país de destino, términos de entrega, medios de transporte, incoterms aplicables, entre otros.
Economía en la transacción: La factura debe optimizar los costos y trámites relacionados con la exportación.

Important

Identificación de Facturas de Exportación

La plataforma de Saphety identifica el tipo de documento a partir del campo DocumentSubType, enviado dentro del mensaje en formato JSON.

Valores permitidos

El campo DocumentSubType puede tomar los siguientes valores:

"0" → Factura de Exportación

Consideraciones importantes

El campo DocumentSubType debe enviarse explícitamente cuando se requiera clasificar el documento como Factura de Exportación.
Si el campo no se envía o se envía con valor null, el documento será procesado como Factura Nacional.
Es responsabilidad del integrador validar que este campo sea informado correctamente desde el sistema origen.
El valor debe enviarse como cadena de texto ("0"), respetando el formato definido en la estructura del mensaje JSON.

Ejemplos de uso

DocumentSubType	Tipo de documento
`"0"`	Factura de Exportación

Notas técnicas

El campo debe ubicarse en el nivel correspondiente del mensaje JSON según la especificación técnica vigente.
En caso de omisión o envío incorrecto del valor cuando se requiera una Factura de Exportación, el documento podría ser clasificado erróneamente o rechazado por la DIAN.

Moneda principal del documento

De acuerdo con los lineamientos de la DIAN, la moneda principal del documento debe ser siempre COP.
Por lo tanto, el campo Currency en el mensaje JSON debe enviarse obligatoriamente con el valor "COP", ya que la factura se registra oficialmente en pesos colombianos, independientemente de que se manejen valores informativos en otra moneda.

Información del Adquiriente de una factura exportación.#

DTO EXPORTACIÓN#

JSON (DTO) - EXPORTACIÓN

{
    "SeriePrefix": "SETP",
    "SerieNumber": "990042093",
    "IssueDate": "2026-02-16T12:12:12",
    "DueDate": "2024-11-27T12:12:12",
    "DeliveryDate": "2024-11-27T12:12:12",
    "CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
    "SerieExternalKey": "{{serieexternalkeyFV}}",
    "IssuerParty": {
        "Identification": {
            "DocumentNumber": "{{nit}}",
            "DocumentType": "NIT",
            "CountryCode": "CO",
            "CheckDigit": "{{digitoverificacion}}"
        }
    },
    "OperationType": "10",
    "PaymentMeans": [
        {
            "Code": "20",
            "Mean": "1",
            "DueDate": "2023-11-27"
        }
    ],
    "DocumentSubType": "0", /*  0 → Factura de Exportación | null o sin enviarlo → El sistema infiere automáticamente será factura nacional*/
    "Currency": "COP", /*Moneda principal siempre COP: El campo “Currency” en el JSON debe llevar siempre el valor “COP”, dado que la factura se registra oficialmente en pesos colombianos.*/
    "DeliveryTerms": { /*Seccion Exportacion  - Opcional*/
        "SpecialTerms": "Portes Debidos", /*Campo Exportacion - indicar cómo se pagan los costes del transporte (Texto libre)- Opcional*/
        "IncotermCode": "CFR" /*Campo Exportacion Opcional*/ //https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/incoterms//LossRiskResponsibilityCode
    },
    "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",
                    "RoundingAmount": "0.00"
                }
            ],
            "UnitPrice": "115000.00",
            "GrossAmount": "115000.00",
            "NetAmount": "115000.00",
            "Item": {
                "Gtin": "987654321",
                "Description": "Descripcion del producto o servicio",
                "BrandName": "SaphetyDoc", /*Campo para Exportación*/
                "ModelName": "V2" /*Campo para Exportación*/
            }
        }
    ],
    "TaxSubTotals": [
        {
            "TaxCategory": "01",
            "TaxPercentage": "19.00",
            "TaxableAmount": "115000.00",
            "TaxAmount": "21850.00"
        }
    ],
    "TaxTotals": [
        {
            "TaxCategory": "01",
            "TaxAmount": "21850.00",
            "RoundingAmount": "0.00"
        }
    ],
    "Total": {
        "GrossAmount": "115000.00",
        "TotalBillableAmount": "136850.00",
        "PayableAmount": "136850.00",
        "TaxableAmount": "115000.00"
    }
}