Espec Orden de Compra XML

Guide: Orden de Compra; 1 Partner Short Guide

Used database: EDICL EANCOM 2002; 1; 1 Message type: ORDERS Report name: EDICL2 Report file name: c:\...\orders\edicl_02.rep Layout name: Application: Partner Short Guide Layout file name: c:\...\orders\gd_sle91.lyt

Author: EAN Chile Printed by EdiFix: 04/09/2003 1

Gua de Implementacin Orden de Compra EAN.UCC XML

DRAFT v1.0




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.




I. Notas para la Implementacin del mensajes 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 EDICL1.

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/MessageHeader

1 EDICL. Formato estndar de documento electrnico basado en la semntica EDIFACT actualmente utilizado en el sector retail chileno.




M Fecha del mensaje Fecha de creacin del documento @creationDate Xsd:dateTime: CCYY-MM-DDThh:mm:ss

2001-09-16T12:00:00

SI DTM_2005=137; 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 7807900CL0001

N/A

M Control de Referencia de Intercambio de Documento

Nmero de Identificacin nico para el intercambio (es decir para la totalidad del documento)

MessageIdentifier

String1To20 12345678945123484

N/A

O Destino del mensaje Cdigo GLN que identifica al receptor de la transmisin

to/gln Ineteger13 7701234235689

UNB_0010

O Origen del mensaje Cdigo GLN que identifica al originador de la transmisin

from/gln Ineteger13 7702234125457

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

RepresentingParty/gln

Ineteger13 7702234125457

N/A

M Capa del cuerpo del mensaje o body

Envelope/body

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)

EntityIdentification/uniqueCreatorIdentification

String1To80 001 UNH_0062

M Propietario de la Transaccin

Cdigo GLN que identifica al propietario de la transaccin

EntityIdentification/contentOwner/gln

Integer13 7702234125457

UNB_0004

M Capa del comando o Command

Envelope/body/transaction/command




M Funcin del mensaje

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.

DocumentCommand/documentCommandHeader@type

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)

DocumentCommand/documentCommandHeader/entityIdentification/uniqueCreatorIdentification

5674

M Propietario del Comando

Cdigo GLN que identifica al propietario del comando

DocumentCommand/documentCommandHeader/entityIdentification/contentOwner/gln

7702234125457

M Capa de informacin de la orden de compra order

Envelope/body/transaction/command/ documentCommand/documentCommandOperand/order

M Fecha del Documento Fecha de generacin del documento @creationDate Xsd:dateTime 2001-08-02T12:00:00

SI DTM_2005=137; DTM_2380

M Estado del Documento Indica si el documento es original o copia @documentStatus

* ORIGINAL

O Capa de informacin de trminos de pago o paymentTerms

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/paymentTerms

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)




M Evento para el Pago Evento que sirve como referencia para el plazo del pago

@eventType * RECEIPT_OF_GOODS

SI PAT_2475 = 21; RECEIPT_OF_GOODS

M Plazo para el pago Se utiliza para indicar el nmero de perodos de tiempo que conforman el plazo del pago

NetPayment/TimePeriodDue

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/TimePeriodDue/type

* DAYS SI PAT_2151 = D; DAYS

O Capa de Descuentos y Cargos o allowanceCharge

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/allowanceCharge

M Cargo o descuento Se utiliza para indicar si se trata de un descuento o de un cargo

@allowanceOrCargeType

* ALLOWANCECHARGE

SI ALC_5463 = A; ALLOWANCE 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

MonetaryAmountOrPercentage/percentage

SimpleFloat1To10Type

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

MonetaryAmountOrPercentage/amount

Float1To18Type

80500 MOA_5004

O Capa de Referencia a la Lista de Precios

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/priceListNumber

M Nmero de la Lista de Precios

Indica el nmero de la lista de precios relacionada a la actual orden de compra

@number String1To35 LP1212124562

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




M Fecha de Movimiento de Mercaderas

Utilizado para indicar fecha para la entrega de la mercadera

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/movementDate

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/command/ documentCommand/documentCommandOperand/order/movementDateType

* REQUESTED_DELIVERY

M Capa de Identificacin de la Entidad

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/typedEntityIdentification

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

EntityIdentification/uniqueCreatorIdentification

String1To80 78000002200000000001

BGM_1004

M Propietario del Contenido

GLN del propietario del contenido EntityIdentification/contentOwner/gln

Integer13 7802234125457

UNB_0004

M Capa de Informacin del Comprador o buyer

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/buyer

M Identificacin del comprador

GLN del comprador Gln Integer13 7802234125457

SI NAD_3035 = BY ; NAD_3039




M Capa de Informacin del Vendedor o seller

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/seller

M Identificacin del vendedor

GLN del vendedor Gln Integer13 7802234125457

SI NAD_3035 = SU; NAD_3039

M Capa de Informacin del Lugar de Entrega seller

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/shipParty

M Identificacin del lugar de entrga

GLN del lugar de entrega Gln Integer13 7802234148557

SI LOC_3227 = 7; LOC_3225

M Capa de Informacin de Item o lineItem

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/orders/lineItem

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/command/ documentCommand/documentCommandOperand/orders/netPrice

M Tipo de Moneda Especifica el tipo de moneda para el precio Amount@correncyISOCode

String3 * CLP N/A




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/command/ documentCommand/documentCommandOperand/order/PriceType

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/command/ documentCommand/documentCommandOperand/order/requestedQuantity

Integer1To15 20 Si QTY 6063 = 21; QTY_6060

M Tipo de Unidad Solicitada

Especifica el tipo de unidad solicitada Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/requestedQuantity@UnitType

String1To3

CSC Caja de Cartn CS Caja SIN Unidad Simple

QTY_6411




O Unidades Contenidas Nmero de Unidades contenidas por la Unidad Solicitada

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/containedUnits

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/command/ documentCommand/documentCommandOperand/order/containedUnits@UnitType

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/command/ documentCommand/documentCommandOperand/order/lineItem/allowanceCharge

M Cargo o descuento Se utiliza para indicar si se trata de un descuento o de un cargo

@allowanceOrCargeType

* ALLOWANCECHARGE

SI ALC_5463 = A; ALLOWANCE 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

MonetaryAmountOrPercentage/percentage

SimpleFloat1To10Type

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

MonetaryAmountOrPercentage/amount

Float1To18Type

80500 MOA_5004




M Identificacin del Producto

GTIN que identifica el producto o servicio Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/itemIdentification/gtin

String1To14 7802500012457

LIN_7140

O Capa de Descripcin del Producto

Envelope/Body/transaction/command/ documentCommand/documentCommandOperand/order/itemDescription

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/command/ documentCommand/documentCommandOperand/order/totalAmount

M Tipo de moneda Especifica el tipo de moneda para el total de la lnea

Amount@correncyISOCode

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




II. Ejemplo Orden de Compra XML




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 SG42




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

Documents

Espec Orden de Compra XML