Especificaciones Técnicas
Relación de Pagos Consolidados
UAP
Formato 1269 - Versión 7
OBJETIVO
Definir las características y contenido de los archivos con la Información Hoja 2
Formulario 690 UAP.
ESPECIFICACIÓN TECNICA
El formato “Relación de Pagos Consolidados UAP”, debe enviarse en un archivo
XML que cumpla las siguientes especificaciones:
1. Estándar del Nombre de los Archivos
El nombre de cada uno de los archivos, debe especificarse mediante la siguiente
secuencia de caracteres:
Dmuisca_ccmmmmmvvaaaacccccccc.xml
cc : Concepto (Inserción = 01 Reemplazo = 02)
mmmmm : Formato (Relación de Pagos Consolidados 690 UAP =1269)
vv : Versión del formato (Versión = 07).
aaaa : Año de envío.
cccccccc : Consecutivo de envío por año.
2. Formato del Archivo
El formato “Relación de Pagos Consolidados UAP”, contiene un documento XML,
que está compuesto por dos elementos complejos: Encabezado y Contenido, las
cuales se deben enviar en el orden enunciado.
Encabezado
Contenido Información 1
Contenido Información 2
...
Contenido Información N
1. El documento XML debe cumplir con la especificación 1.0 Tercera edición.
2. El conjunto de caracteres utilizado en el documento XML debe ser el
alfabeto latino No. 1: “ISO-8859-1”.
3. El archivo debe contener un documento XML bien formado y valido de
acuerdo al esquema XSD que incluye en esta especificación técnica.
4. El archivo debe contener un elemento único elemento raíz llamado “mas”,
que a su vez contendrá toda la información del archivo, tanto el encabezado
como los registros.
2.1. Formato del Encabezado
El encabezado del archivo viene en el elemento “Cab” y contiene los siguientes
datos, todos de carácter obligatorio:
ETIQUETA DENOMINACION
CASILLA
TIPO LONGITUD
CAMPO
VALIDACIONES OBSERVACIONES
Ano Año de envío Int 4 Formato AAAA
CodCpt Concepto Int 2 1 = Inserción
2 = Reemplazo
Formato Código del
formato
Int 5 Información Hoja 2
Formulario 690 UAP
=1269
Versión Versión del
formato
Int 2 Versión = 7
NumEnvio Número de envío Int 8 Debe ser un número
consecutivo por año para
todos los formatos que el
remitente envíe a la DIAN
Consecutivo de envío
por año.
FecEnvio Fecha de envío DateTime 19 Debe ser la fecha
calendario.
Formato AAAA-MMDDTHH:
MM:SS
FecInicial Fecha Inicial Date 10 Debe ser la fecha
calendario.
Los registros
corresponden mínimo
ésta fecha inicial.
Formato AAAA-MMDD
ETIQUETA DENOMINACION
CASILLA
TIPO LONGITUD
CAMPO
VALIDACIONES OBSERVACIONES
FecFinal Fecha Final Date 10 Debe ser la fecha
calendario.
Los registros
corresponden
máximo a ésta fecha
Final. Formato AAAAMM-
DD
ValorTotal Valor Total double 20 Corresponde a la
sumatoria de la casilla
“ptotal” de los registros
reportados.
CantReg Cantidad de
registros
Int 4 La cantidad de registros
esta medida por el número
de elementos “infuap” que
contenga el archivo.
Cantidad de registros
reportados en el
contenido.
(*) Se enviarán archivos con máximo 5000 registros; si es necesario informar más
de 5000 registros, se fraccionará la información en archivos de 5000 registros o
menos.
2.3. Formato del Contenido
En el contenido del archivo se deben incluir tantos registros como se informó en la
cabecera en el campo “Cantidad de registros”.
Cada registro reportado debe mantener la misma estructura previamente
explicada y usada para la cabecera.
El contenido del archivo viene en el elemento “infuapl” y debe incluir los siguientes
datos:
ATRIBUTO CASIL
LA
DENOMINACION
CASILLA TIPO LONGITU
D OBSERVACIONES
fano 1 Año int 4 Siempre debe diligenciarse.
Esta casilla debe contener 4
dígitos.
cpt 2 Concepto int 1 Siempre debe diligenciarse.
prido 3 Periodo int 2 Siempre debe diligenciarse.
Debe registrar un dato
numérico entre 1 y 12.
numide 5 Número de
identificación
long 14 Siempre debe diligenciarse.
dv 6 Dígito de Verificación int 1 Siempre debe diligenciarse.
razsoc 11 Razón social string 250 Siempre debe diligenciarse.
codadm 12 Código Administración string 2 Siempre debe diligenciarse.
De acuerdo a la tabla
“Direcciones Seccionales”
candec 24 Cantidad de
Declaraciones
int 4 Siempre debe diligenciarse.
El dato registrado debe ser
mayor a cero.
ppagdes 25 Del date 10 Siempre debe diligenciarse.
ppaghas 26 Al date 10 Siempre debe diligenciarse.
numrec 27 Número de Recibo de
Pago
long 16 Siempre debe diligenciarse.
fecpagr 28 Fecha de Pago del
Recibo
date 10 Siempre debe diligenciarse.
ptotal 29 Pago Total double 20 Siempre debe diligenciarse.
Para cada elemento “infuapl”, el atributo “numrec” conforma la llave única, la cual
no debe repetirse para los registros de un mismo envío.
Cada elemento “infuapl” debe contener al menos un (1) elemento secundario
identificado como “uaph2”. El elemento “uaph2” está conformado por los
siguientes atributos:
ATRIBUTO CASIL
LA
DENOMINACION
CASILLA TIPO LONGITUD OBSERVACIONES
numfor 30 Número de Formulario
declaración
importación
string 25 Siempre debe diligenciarse.
fecdec 31 Fecha declaración date 10 Siempre debe diligenciarse.
aran 32 Arancel ($) double 20 Siempre debe diligenciarse.
El valor deber ser mayor o
igual a cero (0). No admite
decimales.
iva 33 IVA ($) double 20 Siempre debe diligenciarse.
El valor deber ser mayor o
igual a cero (0). No admite
decimales.
salvgua 34 Salvaguardia ($) double 20 Siempre debe diligenciarse.
El valor deber ser mayor o
igual a cero (0). No admite
decimales.
dercom 35 Derechos
compensatorios ($)
double 20 Siempre debe diligenciarse.
El valor deber ser mayor o
igual a cero (0). No admite
decimales.
derant 36 Derechos antidumping
($)
double 20 Siempre debe diligenciarse.
El valor deber ser mayor o
igual a cero (0). No admite
decimales.
sanc 37 Sanciones ($) double 20 Siempre debe diligenciarse.
El valor deber ser mayor o
igual a cero (0). No admite
decimales.
resct 38 Rescate ($) double 20 Siempre debe diligenciarse.
El valor deber ser mayor o
igual a cero (0). No admite
decimales.
intmor 39 Intereses de mora ($) double 20 Siempre debe diligenciarse.
El valor deber ser mayor o
igual a cero (0). No admite
decimales.
otros 40 Otros ($) double 20 Siempre debe diligenciarse.
El valor deber ser mayor o
igual a cero (0). No admite
decimales.
total 41 Total ($) double 20 Siempre debe diligenciarse.
El valor deber ser mayor o
igual a cero (0). No admite
decimales.
Para cada elemento “uaph2”, el atributo “numfor” conforma la llave única, la cual
no debe repetirse.
3. Validaciones
3.1. Validaciones Generales
1. El archivo debe contener todos los campos definidos para el encabezado y
estos campos deben estar correctamente diligenciados.
2. La información del contenido del archivo debe corresponder al esquema
XSD entregado.
3.
Los atributos que registran valores numéricos, se reportan con valores
numéricos positivos, sin signos ni puntuaciones, según lo reportado por el
informante o en su defecto con cero (0).
4. Los campos que corresponden a fechas, deben contener fechas validas en
cuando a año, mes, y día.
3.2. Validaciones del Encabezado
1. Los campos
concepto, formato y versión, deben venir diligenciados con
los valores estipulados en las especificaciones técnicas,
2.
Año de envío, debe ser el año calendario.
3.
Numero de envío, debe ser un número consecutivo por año para todos los
formatos que el remitente envíe a la DIAN.
4.
Fecha de envío, debe ser la fecha calendario, en formato AAAA-MMDDTHH:
MM:SS.
5.
Cantidad de registros, debe ser igual a la cantidad de registros reportados
en el contenido, que como máximo puede ser 5000 registros.
6.
Valor total, corresponde a la sumatoria de la casilla “ptotal” de los registros
reportados.
4. Esquema XSD
A continuación se incluye el esquema XSD para esta especificación técnica.
<?xml version="1.0" encoding="ISO-8859-1"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
attributeFormDefault="unqualified">
<xs:element name="infuapl">
<xs:annotation>
<xs:documentation>Elemento que encapsula la Información de Hoja 2 Formulario 690 UAP Formato
1269 - Versión 7</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element ref="uaph2" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="fano" use="required">
<xs:annotation>
<xs:documentation>Año</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:totalDigits value="4"/>
<xs:minInclusive value="1000"/>
<xs:maxInclusive value="9999"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="cpt" use="required">
<xs:annotation>
<xs:documentation>Concepto</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="9"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="prido" use="required">
<xs:annotation>
<xs:documentation>Periodo</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="99"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="numide" use="required">
<xs:annotation>
<xs:documentation>Número de identificación</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:long">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="99999999999999"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="dv" use="required">
<xs:annotation>
<xs:documentation>Dígito de Verificación</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="9"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="razsoc" use="required">
<xs:annotation>
<xs:documentation>Razón social</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
<xs:maxLength value="250"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="codadm" use="required">
<xs:annotation>
<xs:documentation>Código Administración</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="2"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="candec" use="required">
<xs:annotation>
<xs:documentation>Cantidad de Declaraciones</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="9999"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="ppagdes" type="xs:date" use="required">
<xs:annotation>
<xs:documentation>Periodo de pago (Fecha desde)</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ppaghas" type="xs:date" use="required">
<xs:annotation>
<xs:documentation>Periodo de Pago (Fecha hasta)</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="numrec" use="required">
<xs:annotation>
<xs:documentation>Número de Recibo de Pago</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:long">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="9999999999999999"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="fecpagr" type="xs:date" use="required">
<xs:annotation>
<xs:documentation>Fecha de Pago del Recibo</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ptotal" use="required">
<xs:annotation>
<xs:documentation>Pago Total</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
<xs:unique name="FormularioUnico">
<xs:selector xpath="uaph2"/>
<xs:field xpath="@numfor"/>
</xs:unique>
</xs:element>
<xs:element name="mas">
<xs:annotation>
<xs:documentation>Elemento raiz del xml de carga masiva</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Cab" type="CabType"/>
<xs:element ref="infuapl" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:unique name="ReciboUnico">
<xs:selector xpath="infuapl"/>
<xs:field xpath="@numrec"/>
</xs:unique>
</xs:element>
<xs:complexType name="CabType">
<xs:sequence>
<xs:element name="Ano" type="xs:gYear" nillable="false">
<xs:annotation>
<xs:documentation>Año de envio</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="CodCpt" nillable="false">
<xs:annotation>
<xs:documentation>Concepto</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="99"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="Formato" fixed="1269">
<xs:simpleType>
<xs:restriction base="xs:positiveInteger">
<xs:totalDigits value="4"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="Version" type="xs:positiveInteger" fixed="7"/>
<xs:element name="NumEnvio">
<xs:annotation>
<xs:documentation>Numero de envio</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:positiveInteger">
<xs:totalDigits value="8"/>
<xs:maxInclusive value="99999999"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="FecEnvio" type="xs:dateTime">
<xs:annotation>
<xs:documentation>Fecha de envio</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="FecInicial" type="xs:date">
<xs:annotation>
<xs:documentation>Fecha inicial</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="FecFinal" type="xs:date">
<xs:annotation>
<xs:documentation>Fecha Final</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="ValorTotal" type="xs:double">
<xs:annotation>
<xs:documentation>Valor Total</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="CantReg">
<xs:annotation>
<xs:documentation>Cantidad de registros</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:positiveInteger">
<xs:totalDigits value="4"/>
<xs:maxInclusive value="9999"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:element name="uaph2">
<xs:annotation>
<xs:documentation>UAP hoja 2</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="numfor" use="required">
<xs:annotation>
<xs:documentation>Número de Formulario declaración importación</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[0-9]{1,25}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="fecdec" type="xs:date" use="required">
<xs:annotation>
<xs:documentation>Fecha declaración</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="aran" use="required">
<xs:annotation>
<xs:documentation>Arancel ($)</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="iva" use="required">
<xs:annotation>
<xs:documentation>IVA ($)</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="salvgua" use="required">
<xs:annotation>
<xs:documentation>Salvaguardia ($)</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="dercom" use="required">
<xs:annotation>
<xs:documentation>Derechos compensatorios ($)</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="derant" use="required">
<xs:annotation>
<xs:documentation>Derechos antidumping ($)</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="sanc" use="required">
<xs:annotation>
<xs:documentation>Sanciones ($)</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="resct" use="required">
<xs:annotation>
<xs:documentation>Rescate ($)</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="intmor" use="required">
<xs:annotation>
<xs:documentation>Intereses de mora($)</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="otros" use="required">
<xs:annotation>
<xs:documentation>Total ($)</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="total" use="required">
<xs:annotation>
<xs:documentation>Total ($)</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:double">
<xs:pattern value="[0-9]{1,20}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:schema>