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 los datos que conforman el encabezado (Header) de la Nota de Ajuste al Documento Soporte en Adquisiciones efectuadas a sujetos no obligados a facturar.

headerNADS

1. Logo (NADS)

Json (DTO)

Logo viene del sistema (Pre configurado en la plataforma SaphetyDoc.)

UBL-XML

Se debe visualizar en la parte superior izquierda

Observaciones

Longitud

Tamaño en pixeles Horizontal: 180px Vertical: 70 px

2. Nombre Documento (NADS)

Json (DTO)

Nombre documento, establecido por anexo técnico DIAN.

UBL-XML

Observaciones

Longitud

3. Fecha de Emisión (NADS)

Json (DTO)

{
	"IssueDate": "2022-01-07T12:35:32",
	"DueDate": "2022-01-07T00:00:00",
	"DeliveryDate": "2022-01-07T00:00:00"
}

UBL-XML

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

Observaciones

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.

Longitud

25 CARACTERES

4. Moneda (NADS)

Json (DTO)

{
  "Currency": "COP"
}

UBL-XML

  <cbc:DocumentCurrencyCode>COP</cbc:DocumentCurrencyCode>

Observaciones

Currency: Divisa del documento. Códigos de moneda en el método del WEB API de Saphety Currencies.

Longitud

5. Tipo de Documento (NADS)

Json (DTO)

{
  "SeriePrefix": "SETT", //(2) 
  "SerieNumber": "999", //(2) 
  "OperationType": "10",
  "CorrelationDocumentId": "1234",
  "SerieExternalKey": "REkEmqg9Vh"
}

UBL-XML

    <cbc:ID>SETT999</cbc:ID>
    <cbc:DocumentCurrencyCode>COP</cbc:DocumentCurrencyCode>
    <cbc:CustomizationID>10</cbc:CustomizationID>

Observaciones

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.

Longitud

24 CARACTERES

6. Razón Social y Tipo Contribuyente del Proveedor (NADS)

Json (DTO)

{
	"SupplierParty": {
		"Name": "Vendedor SAS",
		"LegalType": "Legal",
		"Email": "correo@correo.com",
		"TaxScheme": "01",
		"ResponsabilityTypes": [
			"R-99-PN"
		]
	}
}

UBL-XML

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

Observaciones

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.

Longitud

45 CARACTERES

7. Datos Proveedor (NADS)

Json (DTO)

{
	"SupplierParty": {
		"Identification": {
			"DocumentNumber": "900900900",
			"DocumentType": "NIT",
			"CountryCode": "CO",
			"CheckDigit": "0"
		}
	}
}

UBL-XML

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

Observaciones

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.

Longitud

36 CARACTERES

8 - 9 - 10. Datos Ubicación Proveedor (NADS)

Json (DTO)

{
	"SupplierParty": {
		"Address": {
			"DepartmentCode": "13",
			"CityCode": "13001",
			"AddressLine": "Dirección Vendedor",
			"PostalCode": "130011",
			"Country": "CO"
		}
	}
}

UBL-XML

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

Observaciones

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.

Longitud

24: 45 Caracteres
25: 45 Caracteres
26: 45 Caracteres

11. Razón Social Adquiriente (NADS)

Json (DTO)

Razón Social “Adquiriente SAS” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).

UBL-XML

<cac:AccountingCustomerParty>
<cac:Party>
	<cac:PartyTaxScheme>
		<cbc:RegistrationName>Adquiriente SAS</cbc:RegistrationName>
	</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingCustomerParty>

Observaciones

Texto libre.

Longitud

36 CARACTERES

12. Datos Adquiriente (NADS)

Json (DTO)

{
	"CustomerParty": {
		"Identification": {
			"DocumentNumber": "830007691",
			"DocumentType": "NIT",
			"CountryCode": "CO",
			"CheckDigit": "2"
		}
	}
}

UBL-XML

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

Observaciones

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.

Longitud

36 CARACTERES

13. Dirección Adquiriente (NADS)

Json (DTO)

Dirección “Dirección Adquiriente” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).

UBL-XML

<cac:PhysicalLocation>
	<cac:Address>
		<cac:AddressLine>
			<cbc:Line>Dirección Adquiriente</cbc:Line>
		</cac:AddressLine>
	</cac:Address>
</cac:PhysicalLocation>

Observaciones

Texto libre.

Longitud

45 CARACTERES

14. Departamento Adquiriente (NADS)

Json (DTO)

Departamento “Bogotá” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).

UBL-XML

<cac:PhysicalLocation>
	<cac:Address>
		<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity>
	</cac:Address>
</cac:PhysicalLocation>

Observaciones

Texto libre.

Longitud

18 CARACTERES

15. Municipio Adquiriente (NADS)

Json (DTO)

Municipio “Bogotá D.C.” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).

UBL-XML

<cac:PhysicalLocation>
	<cac:Address>
		<cbc:CityName>Bogotá D.C.</cbc:CityName>
	</cac:Address>
</cac:PhysicalLocation>

Observaciones

Texto libre.

Longitud

30 CARACTERES

Otro. Forma de Pago (NADS)

Json (DTO)

{
	"PaymentMeans": [{
			"Mean": "1",
			"Code": "20",
			"DueDate": "2021-08-03"
		}]
}

UBL-XML

<cac:PaymentMeans>
	<cbc:ID>1</cbc:ID>
	<cbc:PaymentMeansCode>20</cbc:PaymentMeansCode>
	<cbc:PaymentDueDate>2021-08-03</cbc:PaymentDueDate>
</cac:PaymentMeans>

Observaciones

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

Longitud

Otro. Razón de Corrección (NADS)

Json (DTO)

{
  "ReasonCredit": "5"
}

UBL-XML

<cac:Response>
	<cbc:ResponseCode>5</cbc:ResponseCode>
	<cbc:Description>0</cbc:Description>
</cac:Response>

Observaciones

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

Longitud

Guía de Integración a Nivel Global (Header)

Contents

Guía de Integración a Nivel Global (Header)#

Campos generales a nivel global de una Nota de Ajuste#

Header#