Este documento contiene la especificación de requerimientos del archivo de materiales en formato XML.
Este documento reúne la información necesaria para formar correctamente el archivo de materiales con la estructura correcta.
El archivo de maateriales 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.
Todos los campos que NO son requeridos, pueden ir o no especificados en el XML. Sin embargo, cuando el campo es númerico y es enviado en el XML, éste deberá de tener un valor de 0 por defecto.
| DEFINICIÓN Y ESTRUCTURA DEL ARCHIVO | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| ELEMENTO MATERIAL | |||||||||||
| Campo | Requerido ERP | Tipo Dato | Restricciones | Notas | |||||||
| 1 | clave_material | SI | Cadena | Máx. 36 caracteres | Número de factura | ||||||
| 2 | descripcion | SI | Cadena | Máx. 250 caracteres | Descripción del Material | ||||||
| 3 | descripcion2 | NO | Cadena | Máx. 250 caracteres | Descripción del Material [Usualmente utilizado para su descripción en Inglés] | ||||||
| 4 | comprado | SI | Boleano |
0 - No Comprado 1 - Comprado |
|||||||
| 5 | vendido | SI | Boleano |
0 - No Vendido 1 - Vendido |
|||||||
| 6 | padre | SI | Boleano |
0 - No Padre 1 - Padre |
|||||||
| 7 | hijo | SI | Boleano |
0 - No Hijo 1 - Hijo |
|||||||
| 8 | tipo | SI | Numérico | 0 decimales |
0 - Material 1 - Activo Fijo 2 - Empaque |
||||||
| 9 | precio_unitario | NO | Numérico | Máx. 6 decimales | Precio Unitario del Material | ||||||
| 10 | clave_categoria | NO | Cadena | Máx. 5 caracteres | |||||||
| 11 | clave_fraccion | NO | Cadena | Máx. 20 caracteres | Fracción Arancelaria | ||||||
| 12 | clave_fraccionusa | NO | Cadena | Máx. 20 caracteres | Fracción Arancelaria Americana | ||||||
| 13 | clave_pais | NO | Cadena | Máx. 3 caracteres | Clave del País de Origen [Debe de existir en Aranxel] | ||||||
| 14 | clave_unidad | SI | Cadena | Máx. 10 caracteres | Unidad de Medida Base | ||||||
| 15 | manejo | SI | Numérico | 0 decimales | Numero de decimales que usará el material | ||||||
| 16 | umcomercial | NO | Cadena | Máx. 10 caracteres | Unidad de Medida Comercial | ||||||
| 17 | factorcomercial | NO | Numérico | Máx. 5 decimales | Factor de conversión | ||||||
| 18 | umtarifa | NO | Cadena | Máx. 10 caracteres | Unidad de Medida Tarifa | ||||||
| 19 | factortarifa | NO | Numérico | Máx. 5 decimales | Factor de conversión | ||||||
| 20 | umotra | NO | Cadena | Máx. 10 caracteres | Unidad de Medida Adicional | ||||||
| 21 | factorotra | NO | Numérico | Máx. 5 decimales | Factor de conversión | ||||||
| 22 | va | NO | Numérico | Máx. 5 decimales | Valor Agregado | ||||||
| 23 | adicional1 | NO | Cadena | Máx. 50 caracteres | Información Adicional | ||||||
| 24 | adicional2 | NO | Cadena | Máx. 50 caracteres | Información Adicional | ||||||
| 25 | adicional3 | NO | Cadena | Máx. 50 caracteres | Información Adicional | ||||||
El archivo debe tener un elemento de definición del archivo XML:
<?xml version="1.0" standalone="yes" ?>
El archivo de Materiales comienza con un elemento padre en el cual contiene toda la información de los materiales:
<materiales>
</materiales>
Dentro de este elemento principal deben estar elementos para cada una de las compras llamadas "material" en la cual se agregan los atributos correspondientes:
<material clave_material="MATE0104" descripcion="Aceites Lubricantes" descripcion2="" comprado="1" vendido="0"
padre="0" hijo="0" tipo="0" precio_unitario="0" clave_categoria="III" clave_fraccion="27101902"
clave_fraccionusa="" clave_pais="" clave_unidad="08" manejo="8" umcomercial="" factorcomercial="0"
umtarifa="" factortarifa="0" umotra="" factorotra="" va="0" adicional1="" adicional2="" adicional3="" />
A continuación se muestra un ejemplo completo de un archivo XML de Materiales:
<?xml version="1.0" standalone="yes" ?>
<materiales>
<material clave_material="MATE0104" descripcion="Aceites Lubricantes" descripcion2="" comprado="1" vendido="0"
padre="0" hijo="0" tipo="0" precio_unitario="0" clave_categoria="III" clave_fraccion="27101902"
clave_fraccionusa="" clave_pais="" clave_unidad="08" manejo="8" umcomercial="" factorcomercial="0"
umtarifa="" factortarifa="0" umotra="" factorotra="" va="0" adicional1="" adicional2="" adicional3="" />
<material clave_material="MATE221" descripcion="Gas Licuado" descripcion2="" comprado="1" vendido="0"
padre="0" hijo="0" tipo="0" precio_unitario="0" clave_categoria="" clave_fraccion="82055999"
clave_fraccionusa="" clave_pais="" clave_unidad="08" manejo="8" umcomercial="" factorcomercial="0"
umtarifa="" factortarifa="0" umotra="" factorotra="" va="0" adicional1="" adicional2="" adicional3="" />
</materiales>