Ir para o conteúdo

Arquivo de mapeamento XPath no Jitterbit EDI

Introdução

Nota

Esta página se aplica apenas a fluxos de trabalho legados do XCBL. O EDIXml é o formato de intercâmbio recomendado para todos os novos projetos e fluxos de trabalho.

Um arquivo de mapeamento é um arquivo de referência baixável contendo os XPaths para todos os códigos de elementos de segmento EDI X12 em um mapa, e mostra como o backend EDI mapeia arquivos EDI X12 brutos para xCBL. Essas informações de XPath podem ser usadas em suas transformações no Studio ou Design Studio.

O arquivo é um arquivo de texto simples com a extensão .csv contendo campos separados por vírgulas.

Usar o arquivo de mapeamento

Para usar o arquivo de mapeamento em um projeto no Studio ou Design Studio, siga estas etapas:

  1. Baixe o arquivo de mapeamento para o fluxo de trabalho de um documento.
  2. Abra a página Transações e localize o documento.
  3. Expanda a entrada para expor o painel Visualizações.
  4. Clique no primeiro link Raw para abrir o conteúdo EDI X12 do documento.
  5. Clique no segundo link Raw para abrir o mesmo conteúdo convertido para o formato xCBL.
  6. No arquivo EDI X12, localize o campo a ser transformado e anote o código do elemento EDI.
  7. No arquivo de mapeamento XPath, encontre o código do elemento EDI e o XPath correspondente. Use a versão xCBL para confirmar se o XPath e o valor mapeado correspondem.

Exemplo

Neste exemplo, campos equivalentes são destacados em amostras de um arquivo EDI X12, o arquivo xCBL convertido e um extrato do arquivo de mapeamento XPath.

Arquivo EDI X12 (Pedido 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úmeroDeControleInterno</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>121521807</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>NúmeroDoFornecedorInterno</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>60006342</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>NúmeroDoPedidoDoCliente</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>W138156910</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>NúmeroDoDepartamento</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>25</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
        <core:ReferenceCoded>
          <core:ReferenceTypeCoded>NúmeroSubdia</core:ReferenceTypeCoded>
          <core:PrimaryReference>
            <core:RefNum>8119</core:RefNum>
          </core:PrimaryReference>
        </core:ReferenceCoded>
      </OtherOrderReferences>
    </OrderReferences>
    <Purpose>
      <core:PurposeCoded>Outro</core:PurposeCoded>
      <core:PurposeCodedOther>00</core:PurposeCodedOther>
    </Purpose>
    <OrderType>
      <core:OrderTypeCoded>Outro</core:OrderTypeCoded>
      <core:OrderTypeCodedOther>SA</core:OrderTypeCodedOther>
    </OrderType>
    <OrderCurrency>
      <core:CurrencyCoded>Outro</core:CurrencyCoded>
      <core:CurrencyCodedOther />
    </OrderCurrency>
    <OrderLanguage />
    <OrderDates>
      <ListOfDateCoded>
        <core:DateCoded>
          <core:DateQualifier>
            <core:DateQualifierCoded>DataSolicitadaParaEnvio</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>Outro</core:RegionCoded>
            <core:RegionCodedOther>NJ</core:RegionCodedOther>
          </core:Region>
          <core:PostalCode>08837</core:PostalCode>
        </core:NameAddress>
        <core:PrimaryContact>
          <core:ContactFunction>
            <core:ContactFunctionCodedOther>NomeOuDepartamentoDoComprador</core:ContactFunctionCodedOther>
          </core:ContactFunction>
          <core:ListOfContactNumber>
            <core:ContactNumber>
              <core:ContactNumberTypeCoded>NúmeroDeTelefone</core:ContactNumberTypeCoded>
              <core:ContactNumberValue>555-555-5555</core:ContactNumberValue>
            </core:ContactNumber>
          </core:ListOfContactNumber>
        </core:PrimaryContact>
      </BillToParty>

Arquivo de mapeamento XPath (extração)

Esta tabela mostra parte de um arquivo de mapeamento de exemplo baixado do fluxo de trabalho de um parceiro. Linhas não relevantes para este exemplo foram omitidas.

NomeCurto NomeLongo XPath TipoDeDado
BEG01 Código de Propósito do Conjunto de Transação Order/OrderHeader/Purpose[core:PurposeCoded='Other']/core:PurposeCodedOther string
BEG02 Código do Tipo de Pedido de Compra Order/OrderHeader/ListOfNameValueSet/core:NameValueSet[core:SetName='HeaderReferences']/core:ListOfNameValuePair/core:NameValuePair[core:Name='POType']/core:Value string
BEG03 Número do Pedido de Compra Order/OrderHeader/OrderNumber/BuyerOrderNumber string
BEG05 Data de Emissão do Pedido Order/OrderHeader/OrderIssueDate Date
BEG06 Número do Contrato Order/OrderHeader/OrderReferences/ContractReferences/core:Contract/core:ContractID/core:Ident string
BT-N102 Nome da Parte a Faturar Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Name1 string
BT-N103 Qualificador do Código de Identificação da Parte a Faturar Order/OrderHeader/ListOfNameValueSet/core:NameValueSet[core:SetName='PartyReferences']/core:ListOfNameValuePair/core:NameValuePair[core:Name='BillToPartyPartyIdentificationCodeQualifier']/core:Value string
BT-N104 Código de Identificação da Parte a Faturar Order/OrderHeader/OrderParty/BillToParty/core:PartyID/core:Ident string
BT-N301 Endereço da Parte a Faturar Linha 1 Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Street string
BT-N302 Endereço da Parte a Faturar Linha 2 Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:StreetSupplement1 string
BT-N401 Cidade da Parte a Faturar Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:City string
BT-N402 Código do Estado ou Província da Parte a Faturar Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:Region[core:RegionCoded='Other']/core:RegionCodedOther string
BT-N403 Código Postal da Parte a Faturar Order/OrderHeader/OrderParty/BillToParty/core:NameAddress/core:PostalCode string