Saltar al contenido

Archivo de mapeo XPath en Jitterbit EDI

Introducción

Un archivo de mapeo es un archivo de referencia descargable que contiene los XPaths para todos los códigos de elementos de segmento X12 EDI en un mapa, y muestra cómo el backend de EDI mapea archivos X12 EDI en bruto a xCBL. Esta información de XPath se puede utilizar en sus transformaciones de Studio o Design Studio.

El archivo es un archivo de texto plano con una extensión .csv que contiene campos separados por comas.

Uso del archivo de mapeo

Para utilizar el archivo de mapeo en un proyecto de Studio o Design Studio, siga estos pasos:

  1. Descargue el archivo de mapeo para el flujo de trabajo de un documento.
  2. Abra la página de Transacciones y localice el documento.
  3. Expanda la entrada para exponer el panel de Vistas.
  4. Haga clic en el primer enlace Raw para abrir el contenido X12 EDI del documento.
  5. Haga clic en el segundo enlace Raw para abrir el mismo contenido convertido al formato xCBL.
  6. En el archivo X12 EDI, localice el campo que se va a transformar y anote el código de elemento EDI.
  7. En el archivo de mapeo XPath, busque el código de elemento EDI y el XPath correspondiente. Utilice la versión xCBL para confirmar que el XPath y el valor mapeado coinciden.

Ejemplo

En este ejemplo, los campos equivalentes están resaltados en muestras de un archivo X12 EDI, el archivo xCBL convertido y un extracto del archivo de mapeo XPath.

Archivo X12 EDI (Orden de Compra, 850)

example_850.edi

ISA*00*          *00*          *12*7703844115CHQT *02*9050999992211  *200107*1214*U*00401*000000006*0*T*>
GS*PO*7703844115CHQT*9050999992211*20230924*12142024*6*X*004010
ST*850*0002
BEG*00*SA*99340993**20230924*60006342
REF*X9*881807
REF*IA*60006342
REF*CO*W138156910
REF*DP*25
DTM*010*20230924
TD5*****UPSN
N9*SD*8119
N1*BT*Jane Smith
N3*2 Woodbridge Ave
N4*Edison*NJ*08837
PER*BD**TE*555-555-5555
N1*ST*Jane Smith
N3*2 Woodbridge Ave
N4*Edison*NJ*08837
PER*BD**TE*555-555-5555
N1*SO*Jane Smith*93*8119
N1*PO*Home Depot*93*8119
PO1*06*2*EA*9.7*TE*SK*H2520*VN*H2520***UP*H2520***PI*H2520
PID*F*08***BOOK LISTING
DTM*038*20610467
TD5*****UPSN
CTT*1
SE*25*0002
GE*7*6
IEA*1*000000007

xCBL file

example_850.xml
<Order>
  <OrderHeader>
    <OrderNumber>
      <BuyerOrderNumber>99340993</BuyerOrderNumber>
    </OrderNumber>
    <OrderIssueDate>2023-09-24T00:00:00</OrderIssueDate>
    <OrderReferences>
      <ContractReferences>
        <core:Contract>
          <core:ContractID>
            <core:Ident>60006342</core:Ident>
          </core:ContractID>
        </core:Contract>
      </ContractReferences>
      <OtherOrderReferences>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>NúmeroDeControlInterno</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>121521807</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>NúmeroDeProveedorInterno</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>60006342</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>NúmeroDeOrdenDelCliente</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>W138156910</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>NúmeroDeDepartamento</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>25</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>NúmeroDeSubdía</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>8119</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
      </OtherOrderReferences>
    </OrderReferences>
    <Purpose>
      <core:PurposeCoded>Otro</core:PurposeCoded>
      <core:PurposeCodedOther>00</core:PurposeCodedOther>
    </Purpose>
    <OrderType>
      <core:OrderTypeCoded>Otro</core:OrderTypeCoded>
      <core:OrderTypeCodedOther>SA</core:OrderTypeCodedOther>
    </OrderType>
    <OrderCurrency>
      <core:CurrencyCoded>Otro</core:CurrencyCoded>
      <core:CurrencyCodedOther />
    </OrderCurrency>
    <OrderLanguage />
    <OrderDates>
      <ListOfDateCoded>
        <core:DateCoded>
          <core:DateQualifier>
            <core:DateQualifierCoded>FechaSolicitadaDeEnvio</core:DateQualifierCoded>
          </core:DateQualifier>
          <core:Date>2023-09-11T00:00:00</core:Date>
        </core:DateCoded>
      </ListOfDateCoded>
      <RequestedShipByDate>2023-09-11T00:00:00</RequestedShipByDate>
    </OrderDates>
    <OrderParty>
      <BillToParty>
        <core:NameAddress>
          <core:Name1>Jane Smith</core:Name1>
          <core:Street>2 Woodbridge Ave</core:Street>
          <core:City>Edison</core:City>
          <core:Region>
            <core:RegionCoded>Otro</core:RegionCoded>
            <core:RegionCodedOther>NJ</core:RegionCodedOther>
          </core:Region>
          <core:PostalCode>08837</core:PostalCode>
        </core:NameAddress>
        <core:PrimaryContact>
          <core:ContactFunction>
            <core:ContactFunctionCodedOther>NombreDelCompradorODepartamento</core:ContactFunctionCodedOther>
          </core:ContactFunction>
          <core:ListOfContactNumber>
            <core:ContactNumber>
              <core:ContactNumberTypeCoded>NúmeroDeTeléfono</core:ContactNumberTypeCoded>
              <core:ContactNumberValue>555-555-5555</core:ContactNumberValue>
            </core:ContactNumber>
          </core:ListOfContactNumber>
        </core:PrimaryContact>
      </BillToParty>

Archivo de mapeo XPath (extracto)

Esta tabla muestra parte de un archivo de mapeo de muestra descargado de un flujo de trabajo de un socio. Se omiten las filas no relevantes para este ejemplo.

NombreCorto NombreLargo XPath TipoDeDato
BEG01 Código de Propósito del Conjunto de Transacciones Order/OrderHeader/Purpose[core:PurposeCoded='Other']/core:PurposeCodedOther string
BEG02 Código de Tipo de Orden de Compra Order/OrderHeader/ListOfNameValueSet/core:NameValueSet[core:SetName='HeaderReferences']/core:ListOfNameValuePair/core:NameValuePair[core:Name='POType']/core:Value string
BEG03 Número de Orden de Compra Order/OrderHeader/OrderNumber/BuyerOrderNumber string
BEG05 Fecha de Emisión de la Orden Order/OrderHeader/OrderIssueDate Date
BEG06 Número de Contrato Order/OrderHeader/OrderReferences/ContractReferences/core:Contract/core:ContractID/core:Ident string
BT-N102 Nombre del Partido a Facturar Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Name1 string
BT-N103 Calificador del Código de Identificación del Partido a Facturar Order/OrderHeader/ListOfNameValueSet/core:NameValueSet[core:SetName='PartyReferences']/core:ListOfNameValuePair/core:NameValuePair[core:Name='BillToPartyPartyIdentificationCodeQualifier']/core:Value string
BT-N104 Código de Identificación del Partido a Facturar Order/OrderHeader/OrderParty/BillToParty/core:PartyID/core:Ident string
BT-N301 Línea de Dirección del Partido a Facturar 1 Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Street string
BT-N302 Línea de Dirección del Partido a Facturar 2 Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:StreetSupplement1 string
BT-N401 Ciudad del Partido a Facturar Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:City string
BT-N402 Código del Estado o Provincia del Partido a Facturar Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Region[core:RegionCoded='Other']/core:RegionCodedOther string
BT-N403 Código Postal del Partido a Facturar Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:PostalCode string

Video

Tutorial de mapeo EDI XPath de Jitterbit