Ir para o conteúdo

Arquivo de mapeamento XPath no Jitterbit EDI

Introdução

Um arquivo de mapeamento é um arquivo de referência para download que contém os XPaths para todos os códigos de elementos de segmento X12 EDI em um mapa e mostra como o backend EDI mapeia arquivos X12 EDI brutos para xCBL. Essas informações XPath podem ser usadas em seu Integration Studio ou transformações do Design Studio.

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

Use o arquivo de mapeamento

Para usar o arquivo de mapeamento em an Integration Studio ou projeto do Design Studio, siga estes passos:

  1. Baixe o arquivo de mapeamento para o workflow de um documento.
  2. Abra as Transações e localize o documento.
  3. Expanda a entrada para expor o painel Views.
  4. Clique no primeiro link Raw para abrir o conteúdo X12 EDI do documento.
  5. Clique no segundo link Raw para abrir o mesmo conteúdo convertido para o formato xCBL.
  6. No arquivo X12 EDI, localize o campo a ser transformado e observe 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 a correspondência do XPath e do valor mapeado.

Exemplo

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

Arquivo X12 EDI (Ordem 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
INÍCIO* 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 Avenida Woodbridge
N4* edison* nova Jersey* 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***LISTA DE LIVROS
DTM*038*20610467
TD5*****UPSN
CTT*1
SE*25*0002
GE*7*6
IEA*1*000000007

Arquivo xCBL

example_850.xml
<Pedido>
 <Cabeçalho do pedido>
 <Número do pedido>
 <Número do pedido do comprador> 99340993</NúmeroPedidoComprador>
 </NúmeroPedido>
 <DataEmissãoPedido> 2023-09-24 t00:00:00</DataEmissãoPedido>
 <ReferênciasPedido>
 <ReferênciasContrato>
 <núcleo:Contrato>
 <núcleo:IDContrato>
 <núcleo:IdentificaçãoContrato> 60006342</core:Ident>
 </core:ContractID>
 </core:Contract>
 </ContractReferences>
 <OtherOrderReferences>
 <core:ReferenceCoded>
 <core:ReferenceTypeCoded>InternalControlNumber</core:ReferenceTypeCoded>
 <core:PrimaryReference>
 <core:RefNum>121521807</core:RefNum>
 </core:PrimaryReference>
 </core:ReferenceCoded>
 <core:ReferenceCoded>
 <core:ReferenceTypeCoded>InternalVendorNumber</core:ReferenceTypeCoded>
 <core:PrimaryReference>
 <core:RefNum>60006342</core:RefNum>
 </core:PrimaryReference>
 </core:ReferenceCoded>
 <core:ReferenceCoded>
 <core:ReferenceTypeCoded>NúmeroDoPedidoDoCliente</core:ReferenceTypeCoded>
 <core:ReferencePrimária>
 <core:RefNum>W138156910</core:RefNum>
 </core:ReferencePrimária>
 </core:ReferenceCoded>
 <core:ReferenceCoded>
 <core:ReferenceTypeCoded>NúmeroDepartamento</core:ReferenceTypeCoded>
 <core:PrimaryReference>
 <core:RefNum>25</core:RefNum>
 </core:PrimaryReference>
 </core:ReferenceCoded>
 <core:ReferenceCoded>
 <core:ReferenceTypeCoded>SubdayNumber</core:ReferenceTypeCoded>
 <core:PrimaryReference>
 <core:RefNum>8119</core:RefNum>
 </core:PrimaryReference>
 </core:ReferenceCoded>
 </OutrasReferênciasDePedido>
 </ReferênciasDePedido>
 <Finalidade>
 <núcleo:CodificaçãoDeFinalidade> outro</core:Codificação de Propósito>
 <core:Codificação de PropósitoOutro> 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>
 <IdiomaDoPedido />
 <DatasDoPedido>
 <ListaDeDataCodificada>
 <núcleo:DataCodificada>
 <núcleo:QualificadorDeData>
 <núcleo:QualificadorDeDataCodificado>RequestedShip</núcleo:QualificadorDeDataCodificado>
 </core:DateQualifier>
 <core:Data>2023-09-11T00:00:00</core:Data>
 </core:DataCoded>
 </ListOfDateCoded>
 <RequestedShipByDate>2023-09-11T00:00:00</RequestedShipByDate>
 </DatasDoPedido>
 <FestaDoPedido>
 <FaturaParaFesta>
 <núcleo:NomeEndereço>
 <núcleo:Nome1> jane Smith</core:Nome1>
 <core:Rua> 2 Woodbridge Avenida</core:Rua>
 <core:Cidade> edison</core:Cidade>
 <core:Região>
 <core:RegiãoCodificada> outro</core:RegionCoded>
 <core:RegionCodedOther> nova Jersey</core:RegiãoCodedOther>
 </core:Região>
 <core:CódigoPostal> 08837</core:CódigoPostal>
 </core:NomeEndereço>
 <core:ContatoPrincipal>
 <core:FunçãoContato>
 <core:FunçãoContatoCodedOther>NomeOuDepartamentoComprador</core:FunçãoContatoCodedOther>
 </core:FunçãoContato>
 <core:ListaDeNúmeroDeContato>
 <core:NúmeroDeContato>
 <core:TipoDeContatoCodificado>NúmeroDeTelefone</core:TipoDeContatoCodificado>
 <core:ValorNúmeroDeContato>555-555-5555</core:ValorNúmeroDeContato>
 </core:NúmeroDeContato>
 </core:ListaDeNúmeroDeContato>
 </core:ContatoPrimário>
 </ContaParaFesta>

Arquivo de mapeamento XPath (extrato)

Esta tabela mostra parte de um arquivo de mapeamento de amostra baixado do workflow de um parceiro. Linhas não relevantes para este exemplo são omitidas.

ShortName LongName XPath DataType
bEG01 Código de finalidade do conjunto de transações ordem/Cabeçalho da Ordem/Finalidade[core:FinalidadeCoded='Outro']/core:FinalidadeCodedOther sequência
bEG02 Código do tipo de pedido de compra ordem/CabeçalhoDePedido/ListaDeConjuntoDeValoresDeNomes/núcleo:ConjuntoDeValoresDeNomes[núcleo:ConjuntoDeNomes='ReferênciasDeCabeçalho']/núcleo:ListaDeParDeValoresDeNomes/núcleo:ParDeValoresDeNomes[núcleo:Nome='TipoPO']/núcleo:Valor sequência
bEG03 Número do pedido de compra pedido/OrderHeader/OrderNumber/BuyerOrderNumber sequência
bEG05 Data de emissão do pedido pedido/OrderHeader/OrderIssueDate Data
bEG06 Número do contrato ordem/CabeçalhoPedido/ReferênciasPedido/ReferênciasContrato/núcleo:Contrato/núcleo:IDContrato/núcleo:Ident sequência
bT-N102 Nome da conta para a parte ordem/CabeçalhoPedido/PartePedido/FaturaParaParte/núcleo:EndereçoNome/núcleo:Nome1 sequência
bT-N103 Qualificador de código de identificação de fatura para parte ordem/CabeçalhoDePedido/ListaDeConjuntoDeValoresDeNomes/núcleo:ConjuntoDeValoresDeNomes[núcleo:ConjuntoDeNomes='ReferênciasDePartes']/núcleo:ListaDeParDeValoresDeNomes/núcleo:ParDeValoresDeNomes[núcleo:Nome='ContaParaParteQualificadorDeCódigoDeIdentificaçãoDePartes']/núcleo:Valor sequência
bT-N104 Código de identificação da fatura para a parte order/OrderHeader/OrderParty/BillToParty/core:PartyID/core:Ident sequência
bT-N301 Linha 1 do endereço da fatura para a parte ordem/CabeçalhoPedido/PartePedido/ContaParaParte/núcleo:NomeEndereço/núcleo:Rua sequência
bT-N302 Linha 2 do endereço da fatura para a parte ordem/CabeçalhoPedido/PartePedido/ContaParaParte/núcleo:NomeEndereço/núcleo:SuplementoRua1 sequência
bT-N401 Projeto de Lei para a Cidade da Festa ordem/CabeçalhoPedido/PartePedido/ContaParaParte/núcleo:NomeEndereço/núcleo:Cidade sequência
bT-N402 Código do estado ou província da conta para a parte ordem/CabeçalhoPedido/PartePedido/FaturaParaParte/núcleo:NomeEndereço/núcleo:Região[núcleo:RegiãoCoded='Outro']/núcleo:RegiãoCodedOutro sequência
bT-N403 Código postal da conta para a parte ordem/CabeçalhoPedido/PartePedido/FaturaParaParte/núcleo:NomeEndereço/núcleo:CódigoPostal sequência

Vídeo

Tutorial de mapeamento Jitterbit EDI XPath