Guía de Integración a Nivel Global (Header)#
Campos generales a nivel global de una nota de ajuste genérica#
Header#
Especificación y definición de datos del Header de la nota de ajuste de documento equivalente electrónico.
1. Logo (NADE)
Logo viene del sistema (Pre configurado en la plataforma SaphetyDoc.)
Se debe visualizar en la parte superior izquierda
NA
Tamaño en pixeles Horizontal: 180px Vertical: 70 px
2. Nombre Documento (NADE)
Nombre documento, establecido por anexo técnico DIAN.
NA
NA
NA
3. Fecha de Emisión y Moneda (NADE)
{
"IssueDate": "2022-01-07T12:35:32",
"DueDate": "2022-01-07T00:00:00",
"DeliveryDate": "2022-01-07T00:00:00",
"Currency": "COP”,
"ReasonCredit":"1"
}
<cbc:IssueDate>2023-11-27</cbc:IssueDate>
<cbc:IssueTime>15:43:09-05:00</cbc:IssueTime>
<cbc:DueDate>2023-11-27</cbc:DueDate>
<cac:Delivery>
<cbc:ActualDeliveryDate>2023-11-27</cbc:ActualDeliveryDate>
<cbc:ActualDeliveryTime>15:43:09-05:00</cbc:ActualDeliveryTime>
</cac:Delivery>
<cbc:DocumentCurrencyCode>COP</cbc:DocumentCurrencyCode>
<cac:DiscrepancyResponse>
<cbc:ResponseCode>1</cbc:ResponseCode>
<cbc:Description>Devolución de parte de los bienes; no aceptación de partes del servicio</cbc:Description>
</cac:DiscrepancyResponse>
Fecha de emisión: Fecha de generación del documento aaaa-mm-ddThh:mm:ss.
(IssueDate): Fecha de generación del documento.
Formato predeterminado: aaaa-mm-dd Fecha de emisión.(IssueTime): Fecha de generación del documento.
Formato predeterminado: hh:mm:ss
Rechazo: La fecha de emisión debe ser igual a la fecha de firma de la factura.
DueDate: Fecha de pago.
Formato predeterminado: aaaa-mm-ddThh:mm:ss.
DeliveryDate: Fecha efectiva de entrega de los bienes y/o servicios.
Formato predeterminado: aaaa-mm-ddThh:mm:ss
Rechazo: Si ActualDeliveryDate < IssueDate.
Currency: Los código de los tipos de moneda están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/currencies.
ReasonCredit: Código de descripción de la corrección. Los códigos de las causales de una Nota de ajuste al DE. están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/creditnotereasons.
25 CARACTERES
4. Tipo de Documento (NADE)
{
"SeriePrefix": "SETP", //( 4 )
"SerieNumber": "990008032", //( 4 )
"SerieExternalKey": "REkEmqg9Vh",
"CorrelationDocumentId": "123456abc*"
}
<cbc:ID>SETT990008032</cbc:ID> <!-- ( 4 ) -->
SerieExternalKey (clave externa): es utilizada para la generación de documentos y es configurada en el mensaje de integración JSON, esta se obtiene de la plataforma de Saphety (No visible en el XML).
SeriePrefix: Prefijo de la autorización de numeración de Documento Equivalente POS dado por el SIE de Numeración.
Rechazo: No se permiten caracteres adicionales como espacios o guiones.
SerieNumber: Consecutivo de la numeración de Documento Equivalente POS dado por el SIE de Numeración.
Rechazo: No se permiten caracteres adicionales como espacios o guiones.
CorrelationDocumentId: es un identificador único del sistema de generación del emisor y debe tener un máximo de 50 caracteres (No visible en el XML).
24 CARACTERES
5 - 9. Datos Emisor (NADE)
{
"IssuerParty": {
"Identification": {
"DocumentNumber": "900606963",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "4"
}
}
}
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyName>
<cbc:Name>Saphety Transacciones Electrónicas S.A.S</cbc:Name>
</cac:PartyName>
<cac:PhysicalLocation>
<cac:Address>
<cbc:ID>11001</cbc:ID>
<cbc:CityName>Bogotá, D.c. </cbc:CityName><!-- (9) -->
<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity><!-- (8) -->
<cbc:CountrySubentityCode>11</cbc:CountrySubentityCode>
<cac:AddressLine>
<cbc:Line>Calle 97a No. 9 - 45</cbc:Line><!-- (7) -->
</cac:AddressLine>
<cac:Country>
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
<cbc:Name languageID="es">Colombia</cbc:Name>
</cac:Country>
</cac:Address>
</cac:PhysicalLocation>
<cac:PartyTaxScheme>
<cbc:RegistrationName>Saphety Transacciones Electrónicas S.A.S</cbc:RegistrationName><!-- (5) -->
<cbc:CompanyID schemeID="4"
schemeName="31"
schemeAgencyID="195"
schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)">900606963
</cbc:CompanyID><!-- (6) -->
<cbc:TaxLevelCode>O-13</cbc:TaxLevelCode>
<cac:RegistrationAddress>
<cbc:ID>11001</cbc:ID>
<cbc:CityName>Bogotá, D.c. </cbc:CityName>
<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity>
<cbc:CountrySubentityCode>11</cbc:CountrySubentityCode>
<cac:AddressLine>
<cbc:Line>Edifício Strategic 97, Calle 97, N.º 9 - 45, Oficina 207</cbc:Line>
</cac:AddressLine>
<cac:Country>
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
<cbc:Name languageID="es">Colombia</cbc:Name>
</cac:Country>
</cac:RegistrationAddress>
<cac:TaxScheme>
<cbc:ID>01</cbc:ID>
<cbc:Name>IVA</cbc:Name>
</cac:TaxScheme>
</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingSupplierParty>
DocumentNumber: NIT del emisor.
DocumentType: Valida el Tipo de identificador fiscal. Los tipos de identificación están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/IdentificationDocumentTypes.
CountryCode: código del país del emisor. Los códigos del país están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/countrycodes.
CheckDigit: Digito de Verificación del NIT del emisor.
Nota: Los demás datos del emisor vienen Pre configurado en la plataforma SaphetyDoc.
45 Caracteres (5)
36 Caracteres (6)
45 Caracteres (7)
45 Caracteres (8)
45 Caracteres (9)
10. Razón Social (NADE)
{
"CustomerParty": { //Si es persona jurídica = Legal
"LegalType": "Legal",
"Email": "correo@sovos.com",
"TaxScheme": "ZZ",
"ResponsabilityTypes": [
"R-99-PN"
],
"Name": "Saphety Transacciones Electrónicas S.A.S"//(10)
},
"CustomerParty": { //Si es persona natural= Natural
"LegalType": "Natural",
"Email": "correo@sovos.com",
"TaxScheme": "ZZ",
"ResponsabilityTypes": [
"R-99-PN"
],
"Person": {
"FirstName": "FirstName",//(10)
"MiddleName": "MiddleName",//(10)
"FamilyName": "FamilyName"//(10)
}
}
}
<cac:AccountingCustomerParty><!-- Si es persona jurídica = 1 -->
<cbc:AdditionalAccountID schemeAgencyID="195">1 </cbc:AdditionalAccountID>
<cac:Party>
<cac:PartyName>
<cbc:Name> Saphety Transacciones Electrónicas S.A.S </cbc:Name><!-- (10) -->
</cac:PartyName>
</cac:Party>
</cac:AccountingCustomerParty><!-- Si es persona natural= 2 -->
<cac:AccountingCustomerParty>
<cbc:AdditionalAccountID schemeAgencyID="195">2 </cbc:AdditionalAccountID>
<cac:Party>
<cac:PartyName>
<cbc:Name>FirstName MiddleName FamilyName</cbc:Name><!-- (10) -->
</cac:PartyName>
</cac:Party>
</cac:AccountingCustomerParty>
LegalType: Identificador de tipo de organización. Los tipos de organización están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/legaltypes.
Email: Correo electrónico de notificación del adquiriente.
TaxScheme: Identificador del tributo. Los tipos de taxscheme están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/taxschemes.
ResponsabilityTypes: Obligaciones o responsabilidades del contribuyente; incluye el régimen al que pertenece el vendedor. Los tipos de responsabilidades están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/ResponsabilityTypes.
45 CARACTERES
11. Datos del Adquiriente (NADE)
{
// Si el Adquiriente es de tipo Legal
"CustomerParty": {
"Identification": {
"DocumentNumber": "900606963",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "4"
}
},
//Si el Adquiriente es de tipo Natural
"CustomerParty": {
"Identification": {
"DocumentNumber": "123456789",
"DocumentType": "CitizenshipCard",
"CountryCode": "CO"
}
}
}
<!-- Si el Adquiriente es de tipo Legal -->
<cac:AccountingCustomerParty>
<cac:Party><cac:PartyTaxScheme>
<cbc:CompanyID schemeID="4" schemeName="31" schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)">900606963</cbc:CompanyID>
<cac:Country>
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
<cbc:Name languageID="es">Colombia</cbc:Name>
</cac:Country>
</cac:PartyTaxScheme></cac:Party>
</cac:AccountingCustomerParty>
<!-- Si el Adquiriente es de tipo Natural -->
<cac:AccountingCustomerParty>
<cac:Party><cac:PartyTaxScheme>
<cbc:CompanyID schemeName="13" schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)">123456789</cbc:CompanyID>
<cac:Country>
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
<cbc:Name languageID="es">Colombia</cbc:Name>
</cac:Country>
</cac:PartyTaxScheme></cac:Party>
</cac:AccountingCustomerParty>
DocumentNumber: Número de documento del adquiriente.
Rechazo: NIT no autorizado a facturar electrónicamente
Rechazo: Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.
DocumentType: Tipo de documento, el listado de los tipos de DocumentType están disponibles en el método del WEB API de Saphety: DocumentType.
CheckDigit: DV del NIT del Adquiriente CountryCode: Código identificador del país, el listado de los tipos de CountryCode están disponibles en el método del WEB API de Saphety: CountryCode.
36 CARACTERES
12 - 13 - 14. Datos Ubicación (NADE)
{
"CustomerParty": {
"Address": {
"DepartmentCode": "11", //(13)
"CityCode": "11001", //(14)
"AddressLine": " Calle 97a No. 9 - 45", //(12)
"PostalCode": "110221",
"Country": "CO"
}
}
}
<cac:AccountingCustomerParty>
<cac:Party><cac:PhysicalLocation>
<cac:Address>
<cbc:ID>11001</cbc:ID> <!-- (14) -->
<cbc:CityName>Bogota D.C.</cbc:CityName> <!-- (14) -->
<cbc:PostalZone>110221</cbc:PostalZone> <!-- (13) -->
<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity>
<cbc:CountrySubentityCode>11</cbc:CountrySubentityCode> <!-- (13) -->
<cac:AddressLine>
<cbc:Line>Calle 97a No. 9 - 45</cbc:Line> <!-- (12) -->
</cac:AddressLine>
<cac:Country>
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
<cbc:Name languageID="es">Colombia</cbc:Name>
</cac:Country>
</cac:Address>
</cac:PhysicalLocation></cac:Party>
</cac:AccountingCustomerParty>
DepartmentCode: Los códigos de los departamentos DepartmentCode están disponibles en el método del WEB API de Saphety: DeparmentCode.
CityCode: Los códigos de los países CityCode están disponibles en el método del WEB API de Saphety: CityCode.
AddressLine: Elemento de texto libre, que el emisor puede utilizar para poner toda la información de la dirección del adquirente, en lugar de utilizar elementos estructurados.
Country: Los códigos de los paises CountryCodes están disponibles en el método del WEB API de Saphety: CountryCode.
12: 45 CARACTERES
13: 45 CARACTERES
14: 45 CARACTERES
Otro. Forma de Pago (NADE)
{
"PaymentMeans": [
{
"Code": "20",
"Mean": "1",
"DueDate": "2023-11-27"
}
]
}
<cac:PaymentMeans>
<cbc:ID>1</cbc:ID>
<cbc:PaymentMeansCode>20</cbc:PaymentMeansCode>
<cbc:PaymentDueDate>2023-11-27</cbc:PaymentDueDate>
</cac:PaymentMeans>
Mean: Método de pago. Los códigos de las Método de pago paymentmeansmeans están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/paymentmeansmeans
Code: Medio de pago. Los códigos de los medios de pago están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/paymentmeanscode
DueDate: Fecha de vencimiento de la factura o fecha de compromiso de pago. Obligatorio: si es venta a crédito.
Rechazo: si PaymentMeans/ID = 2 y PaymentDueDate no es informado.
NA
Otro. Tipo de Operación (NADE)
{
"OperationType": "10"
}
<cbc:CustomizationID>10</cbc:CustomizationID>
OperationType: Indicador del tipo de operación. Los códigos de los tipos de operacion están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/docoperationtypes.
NA