EXPORTACIÓN#
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 un documento como Factura de Exportación únicamente cuando el valor del campo CustomerParty/Identification/countryCode de la sección para informar la identificación del Adquiriente, enviado dentro del mensaje en formato JSON, es diferente de CO.
Consideraciones importantes
El listado de los tipos de CountryCode están disponibles en el método del WEB API de Saphety: CountryCode.
Si el valor enviado es
CO, el documento será procesado por la plataforma como una Factura Nacional.Cualquier valor distinto de
CO(por ejemplo,US,MX,ES) permitirá que el documento sea tratado como una Factura de Exportación.Es responsabilidad del integrador validar que este campo sea informado correctamente desde el sistema origen.
Ejemplos de uso
countryCode |
Tipo de documento |
|---|---|
|
Factura de Exportación |
|
Factura de Exportación |
|
Factura Nacional |
Notas técnicas
El valor del campo
CustomerParty/Identification/countryCodedebe enviarse en mayúsculas, conforme al listado disponible en el método del WEB API de Saphety: CountryCode.En caso de omisión o envío incorrecto del campo, la DIAN podrá rechazar el documento o procesarlo con una clasificación errónea.
Información del Adquiriente de una factura exportación.#
1. Identification.CountryCode (EXPORTACIÓN)
Invoice.CustomerParty.Identification.CountryCode
/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:CompanyID/@schemeAgencyName
El código del país del adquiriente, tener en cuenta que esto se aplica siempre y cuando el país sea diferente de Colombia, el listado de los tipos de CountryCode están disponibles en el método del WEB API de Saphety: CountryCode.
2. DepartmentName (EXPORTACIÓN)
Invoice.CustomerParty.Address.DepartmentName
/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress/cbc:CountrySubentity
Nombre del Departamento.
3. CityName (EXPORTACIÓN)
Invoice.CustomerParty.Address.CityName
/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress/cbc:CityName
Nombre de la ciudad.
3. Country (EXPORTACIÓN)
Invoice.CustomerParty.Address.Country
/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress/cac:Country/cbc:Name
El código del país de la dirección del Adquiriente, El listado de los tipos de CountryCode están disponibles en el método del WEB API de Saphety: CountryCode.
DTO EXPORTACIÓN#
JSON (DTO) - EXPORTACIÓN
{
"SeriePrefix": "SETP",
"SerieNumber": "990041098",
"IssueDate": "2024-05-10T12: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"
}
],
"Currency": "COP", /*Campo moneda => COP*/
"CustomerParty": {
"LegalType": "Legal",
"Email": "correo@sovos.com",
"TaxScheme": "ZZ",
"ResponsabilityTypes": [
"R-99-PN"
],
"Name": "Saphety Transacciones Electrónicas S.A.S",
"Identification": { /*Seccion para Exportación*/
"DocumentNumber": "444444442eee", /*Campo para Exportación*/
"DocumentType": "ForeignNIT", /*Campo para Exportación*/
"CountryCode": "US" /*Campo para Exportación*/
},
"Address": { /*Seccion para Exportación*/
"DepartmentName": "New York", /*Campo para Exportación*/
"CityName": "New York", /*Campo para Exportación*/
"AddressLine": "CR 23 9 18", /*Campo para Exportación*/
"PostalCode": "123", /*Campo para Exportación*/
"Country": "US" /*Campo para Exportación*/
}
},
"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"
}
}