Guía de Integración a Nivel Global (Header)#
Campos generales a nivel global de una nota de ajuste#
Header#
Especificación y definición de datos del Header de la Nota de Ajuste al documento Soporte en Adquisiciones efectuadas a sujetos no obligados a Facturar.
1. Logo (NADS)
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 (NADS)
Nombre documento, establecido por anexo técnico DIAN.
NA
NA
NA
3. Fecha de Emisión (NADS)
{
"IssueDate": "2022-01-07T12:35:32",
"DueDate": "2022-01-07T00:00:00",
"DeliveryDate": "2022-01-07T00:00:00"
}
<cbc:IssueDate>2022-01-07</cbc:IssueDate>
<cbc:IssueTime>12:35:32-05:00</cbc:IssueTime>
<cbc:DueDate>2022-01-07</cbc:DueDate>
<cac:Delivery>
<cbc:ActualDeliveryDate>2022-01-07</cbc:ActualDeliveryDate>
<cbc:ActualDeliveryTime>00:00:00-05:00</cbc:ActualDeliveryTime>
</cac:Delivery>
Fecha de emisión: Fecha de generación de la factura aaaa-mm-ddThh:mm:ss.
(IssueDate): Fecha de generación de la factura.
Formato predeterminado: aaaa-mm-dd Fecha de emisión.(IssueTime): Fecha de generación de la factura.
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.
25 CARACTERES
4. Moneda (NADS)
{
"Currency": "COP"
}
<cbc:DocumentCurrencyCode>COP</cbc:DocumentCurrencyCode>
Currency: Divisa del documento. Códigos de moneda en el método del WEB API de Saphety Currencies.
NA
5. Tipo de Documento (NADS)
{
"SeriePrefix": "SETT", //(2)
"SerieNumber": "999", //(2)
"OperationType": "10",
"CorrelationDocumentId": "1234",
"SerieExternalKey": "REkEmqg9Vh"
}
<cbc:ID>SETT999</cbc:ID>
<cbc:DocumentCurrencyCode>COP</cbc:DocumentCurrencyCode>
<cbc:CustomizationID>10</cbc:CustomizationID>
SeriePrefix: Prefijo de la autorización de numeración del documento dado por el SIE de Numeración.
*Rechazo:- No se permiten caracteres adicionales como espacios o guiones.
SerieNumber: Número/Consecutivo del documento.
Rechazo: No se permiten caracteres adicionales como espacios o guiones.
OperationType: Identificador de residencia fiscal del vendedor.
10 vendedor es residente en Colombia.
11 vendedor NO es residente en Colombia.
CorrelationDocumentId: Es un identificador único del sistema de generación del emisor y debe tener un máximo de 36 caracteres.
SerieExternalKey: El campo SerieExternalKey se obtiene realizando la consulta por el método API o consultando en el portal administrativo de Saphety.
24 CARACTERES
6. Razón Social y Tipo Contribuyente del Proveedor (NADS)
{
"SupplierParty": {
"Name": "Vendedor SAS",
"LegalType": "Legal",
"Email": "correo@correo.com",
"TaxScheme": "01",
"ResponsabilityTypes": [
"R-99-PN"
]
}
}
<cac:AccountingSupplierParty>
<cbc:AdditionalAccountID>1</cbc:AdditionalAccountID>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:RegistrationName>Vendedor SAS</cbc:RegistrationName>
</cac:PartyTaxScheme>
<cbc:TaxLevelCode>R-99-PN</cbc:TaxLevelCode>
<cac:TaxScheme>
<cbc:ID>01</cbc:ID>
<cbc:Name>IVA</cbc:Name>
</cac:TaxScheme>
</cac:Party>
</cac:AccountingCustomerParty>
Name: Nombre o razón social del proveedor que está registrado en el RUT.
LegalType: Los tipos de personas legales LegalTypes están disponibles en el método del WEB API de Saphety: LegalTypes.
Email: Correo electrónico del adquiriente.
TaxScheme: Identificador del Régimen Fiscal del proveedor, el listado de los tipos de TaxScheme están disponibles en el método del WEB API de Saphety: TaxScheme.
ResponsabilityTypes: Los códigos de las responsabilidades ResponsabilityTypes están disponibles en el método del WEB API de Saphety: ResponsabilityTypes.
45 CARACTERES
7. Datos Proveedor (NADS)
{
"SupplierParty": {
"Identification": {
"DocumentNumber": "900900900",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "0"
}
}
}
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:CompanyID schemeID="0"
schemeName="31"
schemeAgencyID="195"
schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)"> 900900900 </cbc:CompanyID>
</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingSupplierParty>
DocumentNumber: Número de documento del Proveedor.
DocumentType: Tipo de documento del Proveedor, el listado de los tipos de DocumentType están disponibles en el método del WEB API de Saphety: DocumentType.
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.
CheckDigit: DV del NIT del Proveedor.
Important
Para proveedores residentes en Colombia solo es permitido el tipo de identificacion NIT.
36 CARACTERES
8 - 9 - 10. Datos Ubicación Proveedor (NADS)
{
"SupplierParty": {
"Address": {
"DepartmentCode": "13",
"CityCode": "13001",
"AddressLine": "Dirección Vendedor",
"PostalCode": "130011",
"Country": "CO"
}
}
}
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PhysicalLocation>
<cac:Address>
<cbc:ID>13001</cbc:ID>
<cbc:CityName>Cartagena De Indias</cbc:CityName>
<cbc:PostalZone>130011</cbc:PostalZone>
<cbc:CountrySubentity>Bolívar</cbc:CountrySubentity>
<cbc:CountrySubentityCode>13 </cbc:CountrySubentityCode>
<cac:AddressLine>
<cbc:Line>Dirección Vendedor</cbc:Line>
</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:AccountingSupplierParty>
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.
PostalCode: Los códigos postales PostalCode están disponibles en el método del WEB API de Saphety: PostalCode.
Country: Los códigos de los paises CountryCodes están disponibles en el método del WEB API de Saphety: CountryCode.
Important
Debe tener encuentra que los códigos de DepartmentCode, CityCode y PostalCode deben cumplir con la referencia geográfica, es decir no se permite informar códigos postales o códigos de ciudades que no correspondan con el departamento.
24: 45 Caracteres
25: 45 Caracteres
26: 45 Caracteres
11. Razón Social Adquiriente (NADS)
Razón Social “Adquiriente SAS” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).
<cac:AccountingCustomerParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:RegistrationName>Adquiriente SAS</cbc:RegistrationName>
</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingCustomerParty>
Texto libre.
36 CARACTERES
12. Datos Adquiriente (NADS)
{
"CustomerParty": {
"Identification": {
"DocumentNumber": "830007691",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "2"
}
}
}
<cac:AccountingCustomerParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:CompanyID schemeID="2"
schemeName="31"
schemeAgencyID="195"
schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)"> 830007691 </cbc:CompanyID>
</cac:PartyTaxScheme
</cac:Party>
</cac:AccountingCustomerParty>
DocumentNumber: NIT del adquiriente.
Rechazo: NIT no autorizado a facturar electrónicamente.
DocumentType: Tipos de documento, el listado de los tipos de identificación están disponibles en el método del WEB API de Saphety: identificationDocumentTypes.
CountryCode: Los códigos de los países countrycodes están disponibles en el método del WEB API de Saphety: CountryCode.
CheckDigit: Digito de Verificación del NIT del emisor.
36 CARACTERES
13. Dirección Adquiriente (NADS)
Dirección “Dirección Adquiriente” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).
<cac:PhysicalLocation>
<cac:Address>
<cac:AddressLine>
<cbc:Line>Dirección Adquiriente</cbc:Line>
</cac:AddressLine>
</cac:Address>
</cac:PhysicalLocation>
Texto libre.
45 CARACTERES
14. Departamento Adquiriente (NADS)
Departamento “Bogotá” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).
<cac:PhysicalLocation>
<cac:Address>
<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity>
</cac:Address>
</cac:PhysicalLocation>
Texto libre.
18 CARACTERES
15. Municipio Adquiriente (NADS)
Municipio “Bogotá D.C.” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).
<cac:PhysicalLocation>
<cac:Address>
<cbc:CityName>Bogotá D.C.</cbc:CityName>
</cac:Address>
</cac:PhysicalLocation>
Texto libre.
30 CARACTERES
Otro. Forma de Pago (NADS)
{
"PaymentMeans": [{
"Mean": "1",
"Code": "20",
"DueDate": "2021-08-03"
}]
}
<cac:PaymentMeans>
<cbc:ID>1</cbc:ID>
<cbc:PaymentMeansCode>20</cbc:PaymentMeansCode>
<cbc:PaymentDueDate>2021-08-03</cbc:PaymentDueDate>
</cac:PaymentMeans>
PaymentMeans: Grupo de campos para información relacionadas con el pago del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente.
Mean: Método de pago. Los códigos del método de pago están disponibles en el método del WEB API de Saphety: PaymentMeansMeansCode.
Code: Código correspondiente al método de pago, el listado de los tipos de PaymentMeans están disponibles en el método del WEB API de Saphety: PaymentmeansCode.
DueDate: Fecha del plazo de la forma de pago cuando es crédito, Formato predeterminado: aaaa-mm-dd
NA
Otro. Razón de Corrección (NADS)
{
"ReasonCredit": "5"
}
<cac:Response>
<cbc:ResponseCode>5</cbc:ResponseCode>
<cbc:Description>0</cbc:Description>
</cac:Response>
ReasonCredit Código correspondiente al concepto de Corrección para Notas de Ajuste, el listado de los tipos de ReasonCredit están disponibles en el método del WEB API de Saphety: ReasonCredit
NA