Este documento contiene la especificación de requerimientos del archivo de cambio de régimen en formato XML.
Este documento reúne la información necesaria para formar correctamente el archivo de cambio de régimen con la estructura correcta.
El archivo de cambio de régimen es un archivo en el formato estándar de XML (Extended Markup Lenguaje). La extensión del archivo debe ser .xml y la definición y estructura del archivo debe ser como se explica en la tabla de abajo. Definición y Estructura del Archivo.
| DEFINICIÓN Y ESTRUCTURA DEL ARCHIVO | |||||
|---|---|---|---|---|---|
| Campo | Requerido | Tipo Datos | Restricciones | Notas | |
| 1 | factura | SI | Cadena | Máx. 36 caracteres | |
| 2 | fecha | SI | Fecha | dd/mm/yyyy | |
| 3 | Catipo_cambio | NO | Numérico | Máx. 5 decimales | Default 1 |
| 4 | clave_material | SI | Cadena | Máx. 30 caracteres | Debe existir en Aranxel |
| 5 | cantidad | SI | Numérico | Default 1.0 | |
| 6 | clave_unidad | SI | Cadena | Max. 10 caracteres | Debe existir en Aranxel |
| 7 | valorusd | SI | Numérico | Default 0.00 | |
| 8 | clave_pais | NO | Cadena | Max. 3 caracteres | Debe existir en Aranxel |
El archivo debe tener un elemento de definición del archivo XML:
<?xml version="1.0" standalone="yes" ?>
El archivo de cambio de regimen comienza con un elemento padre en el cual contiene toda la información de los cambios de régimen:
<cambios_regimen>
</cambios_regimen>
Dentro de este elemento principal deben estar elementos para cada una de los cambios de régimen llamados "cambioreg" en la cual se agregan los atributos "factura", "fecha", "tipo_cambio", y "adicional3":
<cambioreg factura="NA035014" fecha="25/01/2015" tipo_cambio="14.612" adicional3="">
</cambioreg>
Para cada elemento "material" debe existir una colección de elementos de materiales llamados "material", es decir que aparecerán todas las partidas de materiales que componen el cambio de régimen. Cada elemento material tendrá los siguientes atributos: "clave_material", "cantidad", "clave_unidad", "valorusd" y "clave_pais":
<material clave_material="PA-0011386T" cantidad="1" clave_unidad="EA" valorusd="10117.1" clave_pais="USA"/>
A continuación se muestra un ejemplo completo de un archivo XML de Ventas:
<?xml version="1.0" standalone="yes"?>
<cambios_regimen>
<cambioreg factura="NA035014" fecha="25/01/2015" tipo_cambio="14.612" adicional3="">
<material clave_material="PA-0011386T" cantidad="1" clave_unidad="EA" valorusd="10117.1" clave_pais="USA" />
</cambioreg>
</cambios_regimen>