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

  1. 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".

  1. Ordens de Serviços:
    1. 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.

    1. 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.

    1. 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

  • Sem rótulos