Este documento contiene la especificación de requerimientos del archivo de compras en formato XML.
Este documento reúne la información necesaria para formar correctamente el archivo de compras con la estructura correcta.
El archivo de compras 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 COMPRA | |||||||||||
| Campo | Requerido ERP | Requerido Agente Aduanal | Tipo Dato | Restricciones | Notas | ||||||
| 1 | factura | SI | SI | Cadena | Máx. 36 caracteres | Número de factura | |||||
| 2 | clave_proveedor | SI | SI | Cadena | Máx. 20 caracteres | Código del proveedor [Debe existir en Aranxel] | |||||
| 3 | tipo_factura | NO | SI | Cadena | Máx. 1 caracter |
A - Importación Directa B - Importación Virtual C - Compra Nacional |
|||||
| 4 | fecha | SI | SI | Fecha | Formato: dd/mm/yyyy | Fecha de la factura | |||||
| 5 | tipo_cambio | NO | SI | Numérico | Máx. 8 decimales | Default 1 | |||||
| 6 | clave_transportista | NO | NO | Cadena | Máx. 20 caracteres | Código de transportista | |||||
| 7 | enviado_por | NO | NO | Cadena | Máx. 20 caracteres | Código del que envía la mercancía | |||||
| 8 | enviado_a | NO | NO | Cadena | Máx. 20 caracteres | Código del que recibe la mercancía | |||||
| 9 | facturado_a | NO | NO | Cadena | Máx. 20 caracteres | Código al que se le factura la mercancía | |||||
| 10 | clave_incoterm | NO | SI | Cadena | Máx. 3 caracteres | Termino de facturación [Debe existir en Aranxel] | |||||
| 11 | clave_moneda | SI | SI | Cadena | Máx. 3 caracteres | Clave de la moneda factura [Debe existir en Aranxel] | |||||
| 12 | factor_moneda | SI | SI | Numérico | Máx. 8 decimales | Factor moneda factura [Default 1] | |||||
| 13 | edocument | NO | SI | Cadena | Máx. 30 caracteres | Número de edocument que se obtiene de VU después de transmitir el comprobante | |||||
| 14 | patente | NO | SI | Cadena | Máx. 4 caracteres | Patente del Agente Aduanal [Debe existir en Aranxel] | |||||
| 15 | pedimento_aper | NO | NO | Cadena | Máx. 20 caracteres | Número del pedimento siempre y cuando se conozca con anticipación | |||||
| 16 | tarimas | NO | NO | Numérico | 0 decimales | Número de bultos en la factura | |||||
| 17 | peso_gross | NO | NO | Numérico | Máx. 8 decimales | Peso bruto por factura [Default 0] | |||||
| 18 | bol | NO | NO | Cadena | Máx. 20 caracteres | Bill of Landing | |||||
| 19 | remesa | NO | SI | Numérico | 0 decimales | Número de remesa [Default 0] | |||||
| 20 | sellos | NO | NO | Cadena | Máx. 30 caracteres | ||||||
| 21 | trailer | NO | NO | Cadena | Máx. 20 caracteres | ||||||
| 22 | tipo_vehiculo | NO | NO | Numérico | 0 decimales | [Default 0] | |||||
| 23 | descri_vehiculo | NO | NO | Cadena | Máx. 250 caracteres | Dato de referencia adicional | |||||
| 24 | descripcion | NO | NO | Cadena | Máx. 250 caracteres | Descripción adicional | |||||
| 25 | observaciones | NO | NO | Cadena | Máx. 250 caracteres | Observaciones de la factura | |||||
| 26 | adicional1 | NO | NO | Cadena | Máx. 50 caracteres | Campo para información adicional | |||||
| 27 | adicional2 | NO | NO | Cadena | Máx. 50 caracteres | Campo para información adicional | |||||
| 28 | adicional3 | NO | NO | Cadena | Máx. 50 caracteres | Campo para información adicional | |||||
| ELEMENTO MATERIAL | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Campo | Requerido ERP | Requerido Agente Aduanal | Tipo Dato | Restricciones | Notas | ||||||
| 29 | item | NO | NO | Numérico | 0 decimales | Consecutivo de partidas [Default 0] | |||||
| 30 | id | NO | SI | Numérico | 0 decimales | Identificador de la partida por parte de MBGE, este dato deberá venir al recibir el pedimento por parte del Agente Aduanal [Default 0] | |||||
| 31 | secuencia | NO | SI | Numérico | 0 decimales | Identificador de la partida a nivel fracción, este dato deberá venir al recibir el pedimento por parte del Agente Aduanal [Default 0] | |||||
| 32 | clave_material | SI | SI | Cadena | Máx. 30 caracteres | Número de parte [Debe existir en Aranxel] | |||||
| 33 | descripcion | NO | NO | Cadena | Máx. 250 caracteres | Descripción del número de parte | |||||
| 34 | cantidad | SI | SI | Numérico | Máx. 8 decimales | Cantidad en UM Base | |||||
| 35 | clave_unidad | SI | SI | Cadena | Máx. 10 caracteres | Código de UM Base [Debe existir en Aranxel] | |||||
| 36 | cantidad_umc | NO | SI | Numérico | Máx. 8 decimales | Cantidad en UM Comercial [Default 0] | |||||
| 37 | um_comercial | SI | SI | Cadena | Máx. 10 caracteres | Código de UM Comercial [Debe existir en Aranxel] | |||||
| 38 | valor_factura | NO | NO | Numérico | Máx. 8 decimales | Importe en moneda factura [Default 0] | |||||
| 39 | precio_unitario | NO | NO | Numérico | Máx. 8 decimales | Precio Unitario del material basado en Unidad de Medida especificada [Default 1] | |||||
| 40 | valorusd | SI | SI | Numérico | Máx. 6 decimales | Importe en dólares [Default 0] | |||||
| 41 | clave_fraccion | NO | SI | Cadena | Máx. 20 caracteres | Fracción Arancelaria | |||||
| 42 | clave_fraccion8va | NO | NO | Cadena | Máx. 20 caracteres | Fracción Arancelaria de Regla 8va | |||||
| 43 | id_permr8a | NO | NO | Numérico | 0 decimales | Identificador de Regla 8va [Exclusivo MBGE] | |||||
| 44 | clave_pais | NO | SI | Cadena | Máx. 3 caracteres | País de origen | |||||
| 45 | clave_tratado | NO | NO | Cadena | Máx. 20 caracteres | Clave tratado (TLCAN, TLCUE, etc.) [Debe existir en Aranxel] | |||||
| 46 | clave_ppse | NO | NO | Cadena | Máx. 20 caracteres | Clave prosec (XIX, etc.) [Debe existir en Aranxel] | |||||
| 47 | clave_categoria | NO | SI | Cadena | Máx. 5 caracteres | Clave Categoria (IA, V, etc.) [Debe existir en Aranxel] | |||||
| 48 | advalorem | NO | SI | Numérico | Máx. 2 decimales | % de Advalorem [Default 0] | |||||
| 49 | tipoadvalorem | NO | SI | Cadena | Máx. 10 caracteres | Tipo Advalorem (GN-General; PS-Prosec; TL-TLC; R8-Recla 8va) | |||||
| 50 | clave_formapago | NO | SI | Numérico | 0 decimales | Forma de Pago [Debe existir en Aranxel] | |||||
| 51 | clave_formapagoiva | NO | SI | Numérico | 0 decimales | Forma de Pago IVA [Debe existir en Aranxel] | |||||
| 52 | clave_formapagoieps | NO | SI | Numérico | 0 decimales | Forma de Pago IEPS [Debe existir en Aranxel] | |||||
| 53 | clave_metodo | NO | SI | Numérico | 0 decimales | Método de Valoración [Debe existir en Aranxel] | |||||
| 54 | clave_almacen | NO | NO | Cadena | Máx. 10 caracteres | Clave de Almacén [Debe existir en Aranxel] | |||||
| 55 | iva | NO | SI | Numérico | Máx. 2 decimales | % de IVA [Default 0] | |||||
| 56 | ieps | NO | NO | Numérico | Máx. 2 decimales | % de IEPS [Default 0] | |||||
| 57 | peso_neto | NO | NO | Numérico | Máx. 2 decimales | Peso neto por partida [Default 0] | |||||
| 58 | peso_gross | NO | NO | Numérico | Máx. 6 decimales | Peso bruto por partida [Default 0] | |||||
| 59 | marca | NO | NO | Cadena | Máx. 100 caracteres | Marca del producto automotriz | |||||
| 60 | modelo | NO | NO | Cadena | Máx. 50 caracteres | Modelo del producto automotriz | |||||
| 61 | submodelo | NO | NO | Cadena | Máx. 50 caracteres | Submodelo del producto automotriz | |||||
| 62 | serie | NO | NO | Cadena | Máx. 30 caracteres | Número de serie del producto automotriz | |||||
| 63 | contrato | NO | NO | Cadena | Máx. 50 caracteres | ||||||
| 64 | corte | NO | NO | Cadena | Máx. 50 caracteres | ||||||
| 65 | tarimas | NO | NO | Numérico | 0 decimales | Número de Tarimas [Default 0] | |||||
| 66 | clave_empaque | NO | NO | Cadena | Máx. 30 caracteres | Clave del empaque | |||||
| 67 | orden_compra | NO | NO | Cadena | Máx. 30 caracteres | Número de la Orden de Compra | |||||
| 68 | adicional1 | NO | NO | Cadena | Máx. 250 caracteres | Campo para información adicional | |||||
| 69 | adicional2 | NO | NO | Cadena | Máx. 50 caracteres | Campo para información adicional | |||||
| 70 | adicional3 | NO | NO | Cadena | Máx. 50 caracteres | Campo para información adicional | |||||
El archivo debe tener un elemento de definición del archivo XML:
<?xml version="1.0" standalone="yes" ?>
El archivo de compras comienza con un elemento padre en el cual contiene toda la información de las compras:
<compras>
</compras>
Dentro de este elemento principal deben estar elementos para cada una de las compras llamadas "compra" en la cual se agregan los atributos correspondientes:
<compra factura="NA035014" clave_proveedor="48248" tipo_factura="A" fecha="01/01/2014" tipo_cambio="14.612" clave_transportista="TR-00014"
enviado_por="48248" enviado_a="87423" facturado_a="87423" clave_incoterm="DAF" clave_moneda="USD" factor_moneda="1" edocument="COVE12000LWH7"
patente="3012" pedimento_aper="14 80 3012 4999999" tarimas="0" peso_gross="3170.400" bol="0" remesa="1" sellos="" trailer=""
tipo_vehiculo="51" descri_vehiculo="" descripcion="" observaciones="" adicional1="" adicional2="" adicional3="" >
</compra>
Para cada elemento "compra" debe existir una colección de elementos de materiales llamados "material", es decir que aparecerán todas las partidas de materiales que componen la compra. Cada elemento material tendrá sus atributos correspondientes:
<material item="1" id="25898" secuencia="1" clave_material="PA-0011386T" descripcion="Material PA-0011386T" cantidad="2923.900"
clave_unidad="KG" cantidad_umc="2923.900" um_comercial="1" valor_factura="28000.65" precio_unitario="1" valorusd="28000.65"
clave_fraccion="39159099" clave_fraccion8va="" id_permr8a="0" clave_pais="USA" clave_tratado="" clave_ppse="" clave_categoria="V"
advalorem="0" tipoadvalorem="GN" clave_formapago="0" clave_formapagoiva="21" clave_formapagoieps="0" clave_metodo="6"
clave_almacen="NYT" iva="16" ieps="0" peso_neto="2923.900" peso_gross="2923.900" marca="" modelo="" submodelo="" serie=""
clave_empaque="" orden_compra="" adicional1="" adicional2="" adicional3="" />
A continuación se muestra un ejemplo completo de un archivo XML de Compras:
<?xml version="1.0" standalone="yes" ?>
<compras>
<compra factura="NA035014" clave_proveedor="48248" tipo_factura="A" fecha="01/01/2014" tipo_cambio="14.612" clave_transportista="TR-00014"
enviado_por="48248" enviado_a="87423" facturado_a="87423" clave_incoterm="DAF" clave_moneda="USD" factor_moneda="1" edocument="COVE12000LWH7"
patente="3012" pedimento_aper="14 80 3012 4999999" tarimas="0" peso_gross="3170.400" bol="0" remesa="1" sellos="" trailer=""
tipo_vehiculo="51" descri_vehiculo="" descripcion="" observaciones="" adicional1="" adicional2="" adicional3="" >
<material item="1" id="25898" secuencia="1" clave_material="PA-0011386T" descripcion="Material PA-0011386T" cantidad="2923.900"
clave_unidad="KG" cantidad_umc="2923.900" um_comercial="1" valor_factura="28000.65" precio_unitario="1" valorusd="28000.65"
clave_fraccion="39159099" clave_fraccion8va="" id_permr8a="0" clave_pais="USA" clave_tratado="" clave_ppse="" clave_categoria="V"
advalorem="0" tipoadvalorem="GN" clave_formapago="0" clave_formapagoiva="21" clave_formapagoieps="0" clave_metodo="6"
clave_almacen="NYT" iva="16" ieps="0" peso_neto="2923.900" peso_gross="2923.900" marca="" modelo="" submodelo="" serie=""
clave_empaque="" orden_compra="" adicional1="" adicional2="" adicional3="" />
</compra>
</compras>