Introduccin a arquitectura de los mensajes EAN.UCC XML
La arquitectura de esquemas XML EAN.UCC considera tres capas que desempean distintas funciones. Estas capas son: Capa de Sobre o Envelope, Capa del Mensaje o Message y Capa del Documento o Document. Cada capa se encuentra anidada dentro de la otra siendo la Capa de Sobre la ms externa. La combinacin de ellas conforma el Mensaje XML.
Para ms detalle acerca de cmo usar los esquemas XML EAN.UCC consultar HOW TO USE EAN.UCC XML STANDARDS TECHNICAL GUIDELINES DRAFT v. 0.1.
Dado que los esquemas estndares EAN.UCC son globales, intentan satisfacer requerimientos de muchos usuarios del retail alrededor del mundo. Por dicho motivo es necesario una gua de Implementacin, la que tiene la importante misin de indicar como utilizar el estndar en el modelo de negocio local.
La siguiente estructura describe como se debe utilizar cada uno de los campos disponibles dentro del set de esquemas que compone la Orden de Compra XML.
La descripcin de las columnas es la siguiente:
Columna 1: M/O indica si el elemento es mandatorio u opcional Columna 2: Nombre Indica el nombre del elemento Columna 3: Etiqueta XML Corresponde a la ruta de la etiqueta dentro de un mensaje XML. Las rutas en negrita indican que son conjuntos de elementos que pueden contener atributos y/o otros elementos. Los atributos se distinguen por un signo @ que los encabeza. Columna 4: Formato Formato del elemento. Si dentro del formato hay un * implica que el dato contenido en la columna 5 Ejemplo (EN NEGRITA) es el requerido. Columna 5: Ejemplo un ejemplo del dato contenido Columna 6: EDICL indica la ubicacin del dato dentro del mensaje EDICL 1 .
M/O Nombre Descripcin Etiqueta XML Formato Ejemplo EDICL Capa del sobre del emnsaje o Envelope Envelope Capa de encabezado del sobre o MessageHeader Envelope/Mes sageHeader
1 EDICL. Formato estndar de documento electrnico basado en la semntica EDIFACT actualmente utilizado en el sector retail chileno. Guide: Orden de Compra; 1 Partner Short Guide
M Fecha del mensaje Fecha de creacin del documento @creationDate Xsd:dateTim e: CCYY- MM- DDThh:mm: ss
2001-09- 16T12:00:00 SI DTM_2005=1 37; DTM_2380 M Usuario Usuario que se debe especificar para asegurar el intercambio de documentos en el protocolo AS2. Debe ser el mismo nombre usuario que utiliza en la plataforma. UserId String1To20 7807900CL00 01 N/A M Control de Referencia de Intercambio de Documento Nmero de Identificacin nico para el intercambio (es decir para la totalidad del documento) MessageIdentifi er String1To20 123456789451 23484 N/A O Destino del mensaje Cdigo GLN que identifica al receptor de la transmisin to/gln Ineteger13 770123423568 9 UNB_0010 O Origen del mensaje Cdigo GLN que identifica al originador de la transmisin from/gln Ineteger13 770223412545 7 UNB_0004 M Intermediario de la Transaccin Campo que se usa para la identificacin de la parte intermediaria de la transaccin. En este caso la PTX RepresentingPar ty/gln Ineteger13 770223412545 7 N/A M Capa del cuerpo del mensaje o body Envelope/bod y
M Capa de la transaccin o Transaction Envelope/body /transaction
M Control de Referencia de la Transaccin Nmero de Identificacin nico para la transaccin (en un solo documento XML es posible incluir mltiples transacciones) EntityIdentificat ion/uniqueCreat orIdentification String1To80 001 UNH_0062 M Propietario de la Transaccin Cdigo GLN que identifica al propietario de la transaccin EntityIdentificat ion/contentOwn er/gln Integer13 770223412545 7 UNB_0004 M Capa del comando o Command Envelope/body/ transaction/co mmand
Funcin del mensaje: adicin, modificacin o borrado. Para hacer equivalente con los procesos EDI actuales, este comando siempre debe ser una adicin a menos que sea una cancelacin de una orden anterior, en cuyo caso ser un borrado. DocumentCo mmand/docu mentComma ndHeader@t ype String1To80 ADD CHANGE_BY_ REFRESH DELETE SI BGM_1225=9; DELETE SI BGM_1225=1; ADD M Control de Referencia del Comando Nmero de Identificacin nico para el comando (en un solo documento XML es posible incluir multiples comandos dentro de cada transaccin) DocumentCom mand/document CommandHeade r/entityIdentifica tion/uniqueCreat orIdentification 5674 M Propietario del Comando Cdigo GLN que identifica al propietario del comando DocumentCom mand/document CommandHeade r/entityIdentifica tion/contentOwn er/gln 770223412545 7
M Capa de informacin de la orden de compra order Envelope/body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order
M Fecha del Documento Fecha de generacin del documento @creationDate Xsd:dateTime 2001-08- 02T12:00:00 SI DTM_2005=13 7; DTM_2380 M Estado del Documento Indica si el documento es original o copia @documentSt atus * ORIGINAL O Capa de informacin de trminos de pago o paymentTerms Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/pay mentTerms
M Trmino de Pago Indica el tipo de trmino de pago a utilizar en esta capa @type * BASIC_(NET) SI PAT_4279 = 1; BASIC_(NET ) Guide: Orden de Compra; 1 Partner Short Guide
M Evento para el Pago Evento que sirve como referencia para el plazo del pago @eventType * RECEIPT_OF _GOODS SI PAT_2475 = 21; RECEIPT_O F_GOODS M Plazo para el pago Se utiliza para indicar el nmero de perodos de tiempo que conforman el plazo del pago NetPayment/Ti mePeriodDue Integer1To2 25 PAT_2152 M Tipo de perodos para el plazo del pago Se utiliza para especificar el tipo de perodos de tiempo del plazo del pago NetPayment/Ti mePeriodDue/ty pe * DAYS SI PAT_2151 = D; DAYS O Capa de Descuentos y Cargos o allowanceCharge Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/allo wanceCharge
M Cargo o descuento Se utiliza para indicar si se trata de un descuento o de un cargo @allowanceOrC argeType * ALLOWANCE CHARGE SI ALC_5463 = A; ALLOWANC E SI ALC_5463 = C; CHARGE M Cantidad del cargo o descuento en trminos porcentuales Se utiliza para indicar la cantidad del descuento o cargo en trminos porcentuales MonetaryAmou ntOrPercentage/ percentage SimpleFloat1 To10Type 0.06 PCD_5482 M Cantidad de cargo o descuento en trminos monetarios Se utiliza para indicar la cantidad del descuento o cargo en trminos monetarios MonetaryAmou ntOrPercentage/ amount Float1To18Ty pe 80500 MOA_5004 O Capa de Referencia a la Lista de Precios Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/pric eListNumber
M Nmero de la Lista de Precios Indica el nmero de la lista de precios relacionada a la actual orden de compra @number String1To35 LP121212456 2 SI RFF_1153 = PL; RFF_1154 M Fecha de la Lista de Precios Indica la fecha de la lista de precios relacionada a la actual orden de compra Date Guide: Orden de Compra; 1 Partner Short Guide
M Fecha de Movimiento de Mercaderas Utilizado para indicar fecha para la entrega de la mercadera Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/mo vementDate Xsd:date 25-09-2003 SI DTM_2005 = 2; DTM_2380 M Tipo de Fecha para el Movimiento de Mercaderas Indica que la fecha indicada es para la entrega de la mercadera Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/mo vementDateTy pe * REQUESTED _DELIVERY M Capa de Identificacin de la Entidad Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/typ edEntityIdentif ication
M Tipo de Documento Indica que tipo de documento es la actual transaccin @entityType * ORDER N/A M Control de Referencia del Contenido Nmero de Identificacin nico para el contenido EntityIdentificat ion/uniqueCreat orIdentification String1To80 780000022000 00000001 BGM_1004 M Propietario del Contenido GLN del propietario del contenido EntityIdentificat ion/contentOwn er/gln Integer13 780223412545 7 UNB_0004 M Capa de Informacin del Comprador o buyer Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/buy er
M Identificacin del comprador GLN del comprador Gln Integer13 780223412545 7 SI NAD_3035 = BY ; NAD_3039 Guide: Orden de Compra; 1 Partner Short Guide
M Capa de Informacin del Vendedor o seller Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/sell er
M Identificacin del vendedor GLN del vendedor Gln Integer13 780223412545 7 SI NAD_3035 = SU; NAD_3039 M Capa de Informacin del Lugar de Entrega seller Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/shi pParty
M Identificacin del lugar de entrga GLN del lugar de entrega Gln Integer13 780223414855 7 SI LOC_3227 = 7; LOC_3225 M Capa de Informacin de Item o lineItem Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/orders/lin eItem
M Nmero secuencial de la lnea Es un nmero secuencial que indica el nmero de lnea @number Integer1To6 1 LIN_1082 O Capa de Informacin de Precio o netPrice Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/orders/net Price
M Tipo de Moneda Especifica el tipo de moneda para el precio Amount@corre ncyISOCode String3 * CLP N/A Guide: Orden de Compra; 1 Partner Short Guide
M Precio Neto Sirve para colocar el precio neto unitario del tem solicitado. Debe ser el precio del tipo de unidad sealada en el Tipo de Unidad Solicitada. Si Tipo de Unidad es CSC, corresponde al precio de la Caja, si Tipo de Unidad es SIN, corresponde al precio de la unidad simple. Amount Float1To18 1500 PRI_5118 O Tipo de Precio Especifica el tipo de precio neto Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/Pri ceType String1To80 LIU Precio Lista DPR Precio con descuento, respecto lista normal. NTP Precio neto por unidad (no incluye impuestos) PPR Precio provisional acordado PRI_5387 M Cantidad Solicitada Nmero de Unidades solicitadas Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/req uestedQuantity Integer1To15 20 Si QTY 6063 = 21; QTY_6060 M Tipo de Unidad Solicitada Especifica el tipo de unidad solicitada Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/req uestedQuantity @UnitType String1To3
CSC Caja de Cartn CS Caja SIN Unidad Simple QTY_6411 Guide: Orden de Compra; 1 Partner Short Guide
O Unidades Contenidas Nmero de Unidades contenidas por la Unidad Solicitada Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/con tainedUnits Integer1To15 12 Si QTY 6063 = 129; QTY_6060 O Tipo de Unidades Contenidas Especifica el tipo de unidades contenidas en la Unidad Solicitada Envelope/Body/ transaction/co mmand/ documentCo mmand/docu mentComma ndOperand/o rder/containe dUnits@Unit Type String1To3
CSC Caja de Cartn CS Caja SIN Unidad Simple QTY_6411 O Capa de Descuentos y Cargos del item o allowanceCharge Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/line Item/allowance Charge
M Cargo o descuento Se utiliza para indicar si se trata de un descuento o de un cargo @allowanceOrC argeType * ALLOWANCE CHARGE SI ALC_5463 = A; ALLOWANC E SI ALC_5463 = C; CHARGE M Cantidad del cargo o descuento en trminos porcentuales Se utiliza para indicar la cantidad del descuento o cargo en trminos porcentuales MonetaryAmou ntOrPercentage/ percentage SimpleFloat1 To10Type 0.06 PCD_5482 M Cantidad del cargo o descuento en trminos monetarios Se utiliza para indicar la cantidad del descuento o cargo en trminos monetarios MonetaryAmou ntOrPercentage/ amount Float1To18Ty pe 80500 MOA_5004 Guide: Orden de Compra; 1 Partner Short Guide
M Identificacin del Producto GTIN que identifica el producto o servicio Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/ite mIdentification /gtin String1To14 78025000124 57 LIN_7140 O Capa de Descripcin del Producto Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/ite mDescription
M Lenguaje de la descripcin del producto Lenguaje en el cual est escrita la descripcin del producto @language * SP N/A M Descripcin del Producto Descripcin del Producto o servicio en forma de glosa text String1To70 EANimalitos 100 GRS. LIN_7008 O Capa de Valor Total de la Lnea Envelope/Body/ transaction/co mmand/ documentCom mand/documen tCommandOpe rand/order/tota lAmount
M Tipo de moneda Especifica el tipo de moneda para el total de la lnea Amount@corre ncyISOCode String3 * CLP N/A M Valor Total de la lnea Sirve para colocar el valor total del tem solicitado. Debe ser el valor del tipo de unidad sealada en el Tipo de Unidad Solicitada. Si Tipo de Unidad es CSC, corresponde al precio de la Caja, si Tipo de Unidad es SIN, corresponde al valor de la unidad simple.
El valor se calcula = (Cantidad del tem * Precio Unitario ) + Cargos - Descuentos. amount Float1To18 1500 PRI_5118
III. Mapa Orden de Compra EAN.UCC XML Orden de Compra EDICL
1
UNB
Constants/example: TAG XML
0004 R an13 78012341234 messageHeader/from/gln
0010 R an13 78098765432 messageHeader/to/gln
2
UNH Cabecera de mensaje Constants/example: TAG XML
0062 R an3 Nmero de referencia del mensaje 001 entityIdentification/uniqueCreatorIdentification
0065 R an6 Identificador del tipo de mensaje ORDERS Pedido N/A
0052 R an1 Nmero de versin del tipo de mensaje D Directorio de trabajo N/A
0054 R an3 Nmero de sub-versin del tipo de mensaje 96A Versin 96A N/A
0051 R an2 Agencia controladora UN UN/ECE/TRADE/WP.4, Mensaje N/A
3
BGM Principio del mensaje Constants/example: TAG XML
1001 R an3 Nombre del documento o mensaje, codificad 220 Pedido N/A
1004 R an21 Nmero del documento o mensaje 78012345678 Body/transaction/command/documentCommand/documentCommandOperand/order/typedEntityIdentification/entityIdentification/ uniqueCreatorIdentification
1225 R an1 Funcin del mensaje, codificado 9 Original body/transaction/command/documentCommand/documentCommandHeader@type
4
DTM Fecha de creacin del mensaje Constants/example: TAG XML
2005 R an3 Calificador de fecha/hora/perodo 137 Fecha/hora del documento/mens
2380 R an12 Fecha/hora/perodo 20020105000 messageHeader@creationDate
2379 R an3 Calificador de formato de fecha/hora/perodo 203 SSAAMMDDHHMM
5
DTM Fecha de entrega del pedido solicitada Constants/example: TAG XML
2005 R an3 Calificador de fecha/hora/perodo 2 Fecha/hora de entrega, solicitada
2380 R an12 Fecha/hora/perodo 20020105120 body/transaction/command/documentCommand/documentCommandOperand/order/movementDate
2379 R an3 Calificador de formato de fecha/hora/perodo 203 SSAAMMDDHHMM
6 SG1 RFF Referencia Constants/example: TAG XML
1153 R an3 Calificador de referencia PL Nmero de lista de precios N/A
1154 R an21 Nmero de referencia 78012345678 Body/transaction/command/documentCommand/documentCommandOperand/order/priceListNumber@number
7 SG1 DTM Fecha/hora/perodo Constants/example: TAG XML
2005 R an3 Calificador de fecha/hora/perodo 157 Fecha de comienzo de la validez N/A
2380 R an12 Fecha/hora/perodo 20020506000 Body/transaction/command/documentCommand/documentCommandOperand/order/priceListNumber/date
2379 R an3 Calificador de formato de fecha/hora/perodo 203 SSAAMMDDHHMM N/A
8 SG2 NAD Nombre y Direccin del Comprador Constants/example: TAG XML
3035 R an3 Calificador de parte BY Comprador N/A
3039 R an13 Identificacin del Comprador 78012345678 Body/transaction/command/documentCommand/documentCommandOperand/order/buyer/gln
9 SG5 CTA Informacin sobre un contacto Constants/example: TAG XML
3139 R an3 Funcin de contacto, codificado OC Contacto de pedidos
3412 R an35 Departamento o empleado JUAN PEREZ
10 SG2 NAD Nombre y Direccin del Vendedor Constants/example: TAG XML
3035 R an3 Calificador de parte SU Proveedor N/A
3039 R an13 Identificacin de parte, codificado 78012345675 Body/transaction/command/documentCommand/documentCommandOperand/order/seller/gln
11 SG5 CTA Informacin sobre un contacto Constants/example: TAG XML
3139 R an3 Funcin de contacto, codificado OC Contacto de pedidos
3412 R an35 Departamento o empleado JUAN PEREZ
12 SG8 PAT Condiciones bsicas de pago Constants/example: TAG XML
4279 R an3 Calificador de las condiciones de pago 1 Bsico Body/transaction/command/ documentCommand/documentCommandOperand/order/paymentTerms@type
2475 R an3 Referencia del tiempo de pago, codificado 21 Fecha de recepcin de la mercan Body/transaction/command/ documentCommand/documentCommandOperand/order/paymentTerms@eventType
2151 O an3 Tipo de perodo, codificado D Da Body/transaction/command/documentCommand/documentCommandOperand/order/paymentTerms/TimePeriodDue/type
2152 O n3 Nmero de perodos 030 Body/transaction/command/documentCommand/documentCommandOperand/order/paymentTerms/timePeriodDue
13 SG11 TOD Condiciones de entrega Constants/example: TAG XML
4215 O an3 Mtodo de pago de costes de transporte, co NC Servicio de flete, sin costes PENDIENTE
14 SG11 LOC Identificacin de lugar o ubicacin Constants/example: TAG XML
3227 R an3 Calificador del lugar o ubicacin 7 Lugar de entrega N/A
3225 R an13 Identificacin de lugar o ubicacin 78012345678 Body/transaction/command/ documentCommand/documentCommandOperand/order/shipParty/gln
15 SG18 ALC Descuento o cargo Constants/example: TAG XML
5463 M an3 Indicador de descuento o cargo, codificado A Descuento Body/transaction/command/documentCommand/documentCommandOperand/order/allowanceCharge@allowanceOrCargeType
7161 O an3 Servicios especiales, codificado DE1 N/A
16 SG20 PCD Detalles sobre un porcentaje Constants/example: TAG XML
5245 R an..3 Calificador de porcentaje 1 Descuento N/A
5482 R n..10 Porcentaje 0000005.00 Body/transaction/command/documentCommand/documentCommandOperand/order/allowanceCharge/MonetaryAmountOrPercentage/ percentage
17 SG21 MOA Importe monetario Constants/example: TAG XML
5025 R an..3 Calificador de tipo de importe monetario 204 Importe del Descuento N/A
5004 R n..18 Importe monetario 12345678901 Body/transaction/command/documentCommand/documentCommandOperand/order/allowanceCharge/MonetaryAmountOrPercentage/ amount
18 SG25 LIN Lnea de artculo Constants/example: TAG XML
1082 R n6 Nmero de lnea de artculo 000001 Body/transaction/command/ documentCommand/documentCommandOperand/orders/lineItem@number
7140 R an14 Nmero de artculo 17801234567 Body/transaction/command/ documentCommand/documentCommandOperand/order/itemIdentification/gtin
7143 R an3 Tipo de nmero de artculo EN International Article Numbering A N/A
19 SG25 IMD Descripcin de artculo Constants/example: TAG XML
7077 R an3 Tipo de descripcin de artculo, codificado F Formato libre N/A
7009 R an3 Descripcin del artculo, codificado CU Consumer unit (EAN Code) N/A
7008 R an35 Descripcin del artculo DESCRICION Body/transaction/command/documentCommand/documentCommandOperand/order/itemDescription/text
20 SG25 QTY Cantidad Solicitada (Cajas o Unidades de Embalaje) Constants/example: TAG XML
6063 R an3 Calificador de cantidad 21 Cantidad pedida N/A
6060 R n15 Cantidad 00000000000 Body/transaction/command/ documentCommand/documentCommandOperand/order/requestedQuantity
6411 D an3 Especificador de unidad de medida CSC Body/transaction/command/documentCommand/documentCommandOperand/order/requestedQuantity@UnitType
21 SG25 QTY Nmero de Unidades por Embalaje Constants/example: TAG XML
6063 R an3 Calificador de cantidad 129 Unidades por unidad de precio N/A
6060 R n15 Cantidad 00000000000 Body/transaction/command/documentCommand/documentCommandOperand/order/containedUnits
6411 D an3 Especificador de unidad de medida SIN Body/transaction/command/documentCommand/documentCommandOperand/order/containedUnits@UnitType
22 SG25 MOA Importe monetario Constants/example: TAG XML
5025 R an3 Calificador de tipo de importe monetario 203 Importe de la lnea de artculo N/A
5004 R n18 Importe monetario 12345678901 Body/transaction/command/documentCommand/documentCommandOperand/order/totalAmount/amount
23 SG28 PRI Detalles sobre el precio Constants/example: TAG XML
5125 R an3 Calificador de precio AAA Clculo neto N/A
5118 R n15 Precio 12345678901 Body/transaction/command/ documentCommand/documentCommandOperand/orders/netPrice/amount
5387 O an3 Calificador del tipo de precio LIU List price (EAN Code) Body/transaction/command/ documentCommand/documentCommandOperand/order/PriceType
6411 O an3 Especificador de unidad de medida CSC N/A
24 SG39 ALC Descuento o cargo Constants/example: TAG XML
5463 R an3 Indicador de descuento o cargo, codificado A Descuento Body/transaction/command/documentCommand/documentCommandOperand/order/lineItem/allowanceCharge@allowanceOrCargeType
7161 O an3 Servicios especiales, codificado DE4 N/A
25 SG41 PCD Detalles sobre un porcentaje Constants/example: TAG XML
5245 R an3 Calificador de porcentaje 1 Descuento N/A
5482 R n10 Porcentaje 0000000.02 Body/transaction/command/documentCommand/documentCommandOperand/order/lineItem/ allowanceChargeMonetaryAmountOrPercentage/percentage
26 MOA Importe monetario Constants/example: TAG XML
5025 R an3 Calificador de tipo de importe monetario 204 Importe del Descuento Body/transaction/command/documentCommand/documentCommandOperand/order/lineItem/ allowanceChargeMonetaryAmountOrPercentage/amount
5004 R n18 Importe monetario 00000000000
27
UNS Separador de secciones Constants/example: TAG XML
0081 R a1 Identificacin de seccin S Separacin de secciones de deta N/A
28
MOA Importe monetario Constants/example: TAG XML
5025 R an3 Calificador de tipo de importe monetario 86 Importe monetario total del mens N/A
5004 R n18 Importe monetario 00000000100 PENDIENTE
29
CNT Total de control Constants/example: TAG XML
6069 R an3 Calificador de control 2 Nmero de lneas de artculo en N/A
6066 R n6 Valor de control 000029 N/A
30
UNT Final de mensaje Constants/example: TAG XML
0074 R n6 Nmero de segmentos en el mensaje 000029 N/A
0062 R an3 Nmero de referencia del mensaje 001 N/A