ELJD1000 .JD ELIPS – Integração de OS
Este programa é um "robô" executado via Crontab. O objetivo é enviar para a montadora via DTF arquivos no padrão XML com as informações relativas ao Vendas de Peças Balcão e Ordens de Serviço no período parametrizado ('ELJD1001').
O processamento do programa ELJD1000 exige configurações do DMS Sisdia pelo TI do cliente, conforme abaixo:
- Configurar o Crontab da máquina para que o programa ELJD1000 seja executado automaticamente no dia e horário determinados pela montadora JD Para maiores informações sobre a configuração do Crontab acessar o documento ('PROCESSO_CRONTAB).
- Editar e configurar corretamente o arquivo do tipo Shell: "Run_ELJD1000.sh". Esse shell é disponibilizado na página de liberações do DMS Sisdia.
Ao ser acionado o robô ELJD1000 obtém os parâmetros para processamento ('ELJD1001'), verifica se as filiais possuem bandeira John Deere e estão parametrizadas na integração ('CADA0900'), seleciona as notas fiscais de vendas de peças balcão e Ordens de Serviço (Faturadas, em Andamento, Canceladas) e gera o arquivo XML.
A geração do Elips é baseada nas informações de integração ('CADA0900'), caso as informações: "filial integração", "código integração" ou "empresa integração" não estejam preenchidas, essas filiais serão consideradas não JD e serão desprezadas no processamento do Elips.
Seleção das Notas Fiscais e Ordens de Serviço
- Vendas de Peças Balcão:
Todas as notas fiscais envolvidas com vendas de peças Balcão (cada0305 – tipo de setor = "B"), emitidas no período informado.
Transações de vendas (cada0160=cttransa) cujo tipo (cttptran) esteja como compvend = "S"
Notas fiscais de vendas - Atributo movimento = "S", desde que o campo cptrans.devolução = "N".
Notas fiscais de devolução - Atributo movimento = "E", desde que o campo cptrans.devolução = "S".
- Ordens de Serviços:
- Ordens de Serviços Faturadas:
Enviar todas as notas fiscais envolvidas com vendas da OFICINA (Peças e Serviços), faturadas no período informado (cada0305 – tipo de setor = "S").
Transações de vendas (cada0160=cttransa) cujo tipo (cttptran) esteja como compvend = "S"
Notas fiscais de vendas - Atributo movimento = "S", desde que o campo cptrans.devolução = "N".
Notas fiscais de devolução - Atributo movimento = "E", desde que o campo cptrans.devolução = "S".
Status da OS "Faturada": Somente O.S. cuja Data do faturamento (emissão da Nota Fiscal), esteja contida no período a ser listado.
- Ordens de Serviços em Andamento:
Carregar no arquivo todas informações de ordens de serviço (peças e serviços) com status:
"Aberta" – Somente O.S. cuja Data de Abertura, esteja contida no período a ser listado.
Para o Status "Aberta" também considerar (desde que a alteração / movimentação esteja contida no período a ser listado)
Alterações na Ordem de Serviço: OFIC1000 ou OFIC3000
Movimentação de Peças: inclusão ou exclusão de peças na OS
Inclusão / exclusão de serviços: OFIC1000 ou OFIC3000
Apontamentos de trabalho: início ou finalização de apontamentos de tempos
"Enviada para o Caixa" – Somente O.S. cuja Data de Valorização / Encerramento, esteja contida no período a ser listado.
- Ordens de Serviços Canceladas:
Carregar no arquivo todas informações de ordens de serviço (peças e serviços) com status:
"OS Cancelada" – Somente O.S. cuja Data de Cancelamento, esteja contida no período a ser listado.
Nome dos arquivos a serem gerados
É necessário apontar para o sistema, o local onde o programa ELJD1000, deve gerar os arquivos com informações pertinentes ao Elips, a serem enviados à John Deere via DTF.
- Arquivo Hist ou Carga Inicial:
DLR2JD_ELIPS_Hist_xxxxxx_YYYMMDD_HHMMSS.xml
- Arquivo Delta ou Movimentação:
DLR2JD_ELIPS_Delta_xxxxxx_YYYMMDD_HHMMSS.xml
Onde: "xxxxxx" é o ID da conta principal da pesquisa de 6 dígitos dos Concessionários.
Geração de Log do Processamento
A cada processamento é gerado um arquivo de log com informações referentes ao processamento com o nome ELJD1000_xxxxxx.log
Onde: "xxxxxx" é o ID da conta principal da pesquisa de 6 dígitos dos Concessionários.
Descrição dos campos enviado pela Montadora
Element Name | Description |
DBSIdentifier | Value identifying the Dealer System Software. Examples would be "EQUIP", "JDIS Legacy", "CDK", "Charter", "PAPE", etc. All business systems of a common type should send the same value in this field. |
DBSVersion | Version of Dealer Business System Software |
LanguageCode | "EN" for English; "DE" for German (Deutsch), "ES" for Spanish (Espanol), "FR" for French (Francais), "IT" for Italian (Italiano), "PT" for Portugues (Portuguese) |
InterfaceVersion | Version of Deere interface being used. |
LocationID | 6 Digit Account ID for Dealer location |
WorkOrderNumber | Work Order or Repair Order Number |
PIN | Equipment Serial Number or PIN. Valid Deere 13 or 17 digit PIN. |
Model | Equipment Model or Decal Number. Example: 8360R, 844K, S670 |
ReportedHours | Reported Equipment Hours at time of service work or part replacement. If unavailable, populate "null" |
UsageType | C = Customer Machine; R = Rental Machine; S = Stock Unit (Internal or Dealer-owned machine); D = Demo machine. Indicates type of equipment usage. |
JobName | Name or Description of the workorder segment / job code. |
SegmentID | This field identifies the numeric Work Order / Repair Order segment (job) associated to the work |
ClaimSequenceNumber | If a Warranty claim, this value is the claim sequence number passed back to the Dealer system via Warranty web service. |
FieldRepair | "true" if service work conducted outside of Dealer premises. "false" if service work conducted on Dealer premises. |
Warranty | "true" if Warranty. "false" if Retail Sales, Internal Sales, etc. |
EventTime | The date that the failure occurred, if available. If not available, use "CreatedTimestamp" |
CreatedTime | Timestamp of when the electronic work order or repair order was created in the system. Also referred to as "Open" timestamp. |
RepairTime | Timestamp of last recorded technician time reported on segment or job code |
InvoiceTime | Timestamp of Invoice |
WIP | "true" if Work Order or Repair order is still open and can be changed (i.e. not yet invoiced). "false" if record is invoiced and cannot be changed. |
MachineDown | Mandatory if accurately and consistently captured by Dealer system. "true" if event caused machine to be down unscheduled; "false" if event cause NO unscheduled down time |
InvoiceNumber | If record invoiced (not "WIP"), Mandatory. Reference number of invoiced record. |
LaborHours | Sum of the total technician(s) time, in Hours, for the service work performed on the segment or job code. 1 aggregate hours value per job code. |
PrimaryFailedPart | Part Number that caused the failure (or need of replacement) – not available for non-Warranty in initial rollout |
FailureMode | Follow Warranty interface definition for FailureModes – not available for non-Warranty in initial rollout |
Complaint | Description of the reported issue, request, symptons experienced, etc. Same definition as in Warranty interface. |
Cause | If available, description of the Cause of issue. Same definition as in Warranty interface. |
Correction | If available, description of Corrective service work performed to correct the issue. Same definition as in Warranty interface. |
DTACCase | DTAC Case ID, if exists |
PartNumber | Part Number replaced |
PartSerialNumber | If Part has a serial number and is captured, send. |
Quantity | Quantity of part replaced. If Part returned and quantity for line item is negative, indicate with "-" in front of value. For example, "-2" for a quantity of two returned. |
Description | Part's description in the system. |
DeerePart | "true" if Deere part. "false" if non-Deere part. |
MiscellaneousPart | "true" if a "miscellaneous," "non-quantity," or "sundry" part. Examples include mileage, fees, labor charged as a part number, etc. Value is "false" if a physical part. |
PartsPerPackage | Dealer Parts Per Package for the part. If Dealer chooses to sub-divide the manufacturing part into multiple Dealer units, the value is greater than 1. |
StockingLogicCode | Part's Stocking Logic Code (SLC) at time of transaction. Combination of Deere's Critical Code and Inventory Class Code. |
Montagem das <Tags> a partir das informações do Sisdia
Abaixo o relacionamento (de-para) das tags XML com os campos do Sisdia:
<DBSIdentifier> "SISDIA"
<DBSVersion> "0830"
<InterfaceVersion> "1.0"
<LanguageCode> "PT"
<LocationID> caparint.filial_integracao
<WorkOrderNumber> cscapas.ordemserv
<PIN> cscapas.chassis
<Model> csgajdca.modelo (OS SG)
cxcadast.descrmaqvei (OS Normal)
<ReportedHours> cscapas.quilometr
<UsageType> csgajdca.cod_propriedade
"1" -> "C" (máquina do cliente)
"2" -> "S" (Máquina de aluguel)
"3" -> "D" (Unidade de estoque)
"4" -> "R" (máquina de demonstração)
<JobName> csgajdmo.cod_trabalho (OS SG)
csitens.descritem (OS Normal)
<SegmentID> csitens.nroitem
<ClaimSequenceNumber> csgajdca.nrosg (OS SG)<FieldRepair>cscapas.nroprisma (OS SG)
<Warranty> csgajdca.nrosg (OS SG)
<EventTimestamp> csitens.dtdigitacao
<CreatedTimestamp> csitens.dtdigitacao
<RepairTimestamp> csitens.dtdigitacao
<InvoiceTimestamp> csitens.dtdigitacao
<WIP> cscapas.dtfechament
<MachineDown> csgajdca.cod_ind_temp_inat (OS SG)
<InvoiceNumber> cnnfcapa.nronota
<LaborHours> csserexe.tempovendido (*somatório de todos os serviços do item)
<PrimaryFailedPart> csgajdca.pecacausadora (OS SG)
<FailureMode> csgajdca.cod_tipo_falha (OS SG)
<Complaint> csgajdob.observacao / csgajdob.tipo_obs = 'P' (OS SG)
<Cause> csgajdob.observacao / csgajdob.tipo_obs = 'C' (OS SG)
<Correction> csgajdob.observacao / csgajdob.tipo_obs = 'O' (OS SG)
<DTACCase> csgajdca.cod_dtac (OS SG)
<PartNumber> cspecasa.produto
<Quantity> cspecasa.quantidade
<Description> cspecasa.descrproduto
<DeerePart> cmgrupos.tpgrupo = "O" or
cmgrupos.tpgrupo = "C" or
cmgrupos.tpgrupo = "B" -> "True"
<MiscellaneousPart>cstipoos.tpmanut <> "O" -> "False"
<PartsPerPackage> cmprodut.embalagem
<StockingLogicCode> cmprodet.cricodglobal