Integração TRC AGCO

Versão: 1.0 Autores: Gustavo Nikititz e Maikel Losekann

TRC

TRC significa “Tecnologia com Resultados para o Concessionário”, é um programa de serviço de apoio ao gerenciamento de peças da multinacional AGCO (Your Agriculture Company).
Tem como objetivos principais: otimizar inventários, poupar tempo e identificar oportunidades de venda, melhorando o nível do serviço prestado.
Todos esses fatores trazem um ótimo resultado, tanto para a AGCO, quanto para a rede de parceiros, promovendo um melhor nível de serviço e maior retorno sobre o capital investido.

Sobre a AGCO

A AGCO, proprietária do sistema de gestão empresarial TRC, é a maior fabricante de tratores da América Latina. A multinacional tem, como focos principais: distribuir, fabricar e desenvolver soluções agrícolas para concessionárias de mais de 140 países ao redor do mundo.
A AGCO tem o objetivo de levar a tecnologia para o mercado da agricultura, buscando sempre proporcionar maiores lucros e produtividade para as fazendas e seus respectivos agricultores. A companhia atinge seu objetivo final por meio da fabricação de máquinas e equipamentos que respondam às demandas do mundo em constante mudança, afinal, como eles mesmos dizem, “o futuro está acontecendo agora. E a AGCO está na vanguarda disso”.

Marcas pertencentes à AGCO

Todas as cinco marcas da multinacional possuem os mesmos valores que ela, sempre buscando inovar, fazendo uso de tecnologias e procurando aumentar ao máximo a produtividade. Entre elas estão a Challenger, Fendt, GSI, Massey Ferguson e Valtra.

A integração TRC-Solution abrange as marcas Massey Ferguson e Valtra.

A Solution e o TRC

O trabalho da Solution para a AGCO acontece há quase 30 anos e, hoje, a Solution domina o processo de integração, atendendo mais de 50% da rede de concessionárias. Sendo assim, a Solution foi a primeira empresa a integrar o TRC ao ERP (Enterprise Resource Planning ou Planejamento de Recursos Empresariais, em português) gerando informações das concessionárias, transmitindo dados e sugerindo quais materiais devem ser comprados para abastecer o estoque de maneira correta, o que é de
extrema importância. Parafraseando a própria AGCO: “Peça certa, na hora certa, na quantidade certa, na filial certa”. A Solution oferece conveniência aos clientes, fazendo o uso de tecnologia e automatizando processos, ou seja, existem “robôs” que realizam a troca de informações em horários pré-definidos. Além disso, a alta especialização da empresa no serviço permitiu uma personalização: os cadastros da Solution foram projetados para atender a AGCO, o que resulta em mais agilidade nos processos de implantação e de suporte técnico.
A Solution foi a primeira empresa a entregar resultados concretos para a TRC, pois oferece um trabalho sério e amplo: atua acessando ambientes de TI (Tecnologia da Informação), verificando questões de estrutura e efetuando todo o processo de carga inicial, que é o envio de dados para que o programa possa efetuar sugestões de compras e demais análises.
Essa facilidade permite que o cliente obtenha uma redução de custos e mantenha 100% do foco em seu negócio, sem precisar se preocupar com o processo de integração.

Interfaces

A Integração TRC compreende a seis interfaces de envio de dados, são elas:

• DMS-01: Envia posição atual dos itens com e sem movimentação (incluindo estoques zerados). É enviada quando um item tem movimentação e/ou quando um novo código é cadastrado.
• DMS-02: Envia todas as peças cadastradas, com ou sem estoque. É enviada quando as informações da peça são atualizadas nos campos definidos no contrato de dados, ou quando for efetuado um novo cadastro. Gera obrigatoriamente a DMS-01 para todos os itens (com ou sem estoque).
• DMS-03: Envia todos os pedidos de compra de qualquer fornecedor. É enviada quando um pedido de compra é criado ou sempre que o mesmo sofrer uma alteração (status). Caso uma nova linha seja incluída no pedido, a mesma é enviada. As transferências entre filiais também são enviadas.
• DMS-04: Envia pedidos de vendas (balcão e oficina) e devoluções, os registros são enviados quando uma venda ou devolução for concluída ( status “CLOSED”) ou canceladas (status “CANCELLED”) para um cliente final. As transferências entre filiais NÃO são enviadas.
• DMS-05: Envia vendas perdidas. É enviada quando for registrada uma venda perdida.
• DMS-06: Enviar todos os clientes ativos, sendo ativos todos aqueles que realizaram compra, devolução, orçamentos ou gerarem uma venda perdida na concessionária. É enviada quando um cliente realiza alguma movimentação das citadas anteriormente.

Informações enviadas em cada interface

Serão listadas todas as informações enviadas em cada interface, com exemplos e informação de onde é originada/visualizada dentro do ERP Solution.

DMS-01 (Inventory)
TAG raiz da mensagem

• Descrição: Tag inicial agrupadora, que comporta as demais informações enviadas do DMS-01.
• ID: A01
• Campo: Data

CNPJ da concessionária

• Descrição: CNPJ da filial da concessionária.
• ID: A02
• Campo: DealerLegalNumber
• Exemplo: 99.999.999/0001-99
• Origem/visualização ERP Solution: Módulo Administrativo > Principal > Filiais (rotina 99002) campo “CNPJ/CPF”.

Data e hora da extração dos dados

• Descrição: Data e hora da extração dos dados da mensagem
• ID: A03
• Campo: ExtractionDateTime
• Exemplo: 2020-08-23T 10:45:00+03:00
• Origem/visualização ERP Solution: Data/hora atual do servidor no momento da geração da informação.

Parts

• Descrição: Tag agrupadora das informações de produtos (serão citadas na sequência).
• ID: A04
• Campo: Parts

Código do item

Descrição: Código do item que teve movimentação de estoque.

• ID: A05
• Campo: PartNumber
• Exemplo: 1444437P
• Origem/visualização ERP Solution: Estoque > Cadastros > Produtos> Cadastro de produtos (rotina 1068) > campo “produto”.

Quantidade de itens disponíveis

• Descrição: Saldo contábil dos itens no estoque.
• ID: A06
• Campo: availableQuantity
• Exemplo: 20
• Origem/visualização ERP Solution: Estoque > Principal > extrato de produtos (campo saldo contábil).

Quantidade de itens com pedido e transferência

• Descrição: Quantidade de itens com pedidos de compras em aberto ou transferências entre filiais pendentes e que não foram baixados no estoque.ID: A07
• Campo: onOrderQuantity
• Exemplo: 15
• Origem/visualização ERP Solution: Quantidade de itens em pedidos de compra pendentes de recebimento. Quantidade de itens em NF-e’s de transferência entre filiais destinada a filial que ainda não tiveram entrada da NF-e.

Itens de OS

• Descrição: Itens alocados para ordens de serviços abertas na oficina, independente do tipo de OS e que ainda não foi emitido nota.
• ID: A08
• Campo: reservedQuantityWorkOrders
• Exemplo: 1.0
• Origem/visualização ERP Solution: Somatório da quantidade de itens pendentes nas ordens de serviço.
• Visualizados em: Oficina> Ordens de serviço > Ordens de serviço (rotina 2292) > Dentro da OS, aba peças, coluna “pendente” ou itens que a fatura não teve emissão de nota fiscal.

Quantidade de itens reservados

• Descrição: Quantidade de itens alocados em ordem de compra que ainda não foram contados como venda.
• ID: A09
• Campo: reservedQuantityPartTickets
• Exemplo: 2.0
• Origem/visualização ERP Solution: Módulo balcão> Consultar > pedidos e alocações (rotina 1102).

Itens em aberto no estoque

• Descrição: Soma de itens em pedidos em aberto para cliente final.
• ID: A10
• Campo: openCustomerOrders
• Exemplo: 1.0
• Origem/visualização ERP Solution: Quantidade de itens pendentes em pedidos e ordem de compra (Balcão). Módulo estoque > Balcão > Principal > Pedido (rotina 1079), consultar, coluna “quantidade
• pendente”. Para Ordem de compra, idem anterior, porém em Consulta de ordem de compra (Rotina 1080).

Itens retornados para a fábrica

• Descrição: Itens retornados da concessionária para a AGCO
• ID: A11
• Campo: quantityReturnedByDealer
• Exemplo: 10
• Origem/visualização ERP Solution: Quantidade de itens em notas com operação de devolução de compra emitidas para clientes/fornecedores do tipo Fábrica.

DMS-02 (Parts):

TAG raiz da mensagem

• Descrição: Tag inicial agrupadora, que comporta as demais informações enviadas do DMS-02.
• ID: B01
• Campo: Data

CNPJ da concessionária

• Descrição: CNPJ da filial da concessionária.
• ID: B02
• Campo: DealerLegalNumber
• Exemplo: 99.999.999/0001-99
• Origem/visualização ERP Solution: Módulo Administrativo >
• Principal > Filiais (rotina 99002) campo “CNPJ/CPF”.

Data e hora da extração dos dados

• Descrição: Data e hora da extração dos dados da mensagem.
• ID: B03
• Campo: ExtractionDateTime
• Exemplo: 2020-08-23T 10:45:00+03:00
• Origem/visualização ERP Solution: Data/hora atual do servidor no
• momento da geração da informação.

Part

• Descrição: Tag agrupadora das informações de produtos (serão citadas na sequência).
• ID: B04
• Campo: Part

Código do item

• Descrição: Código do item que teve movimentação de estoque.
• ID: B05
• Campo: PartNumber
• Exemplo: 1444437P
• Origem/visualização ERP Solution: Estoque > Cadastros > Produtos > Cadastro de produtos (rotina 1068)> campo “produto”.

Código do item fornecido pela AGCO.

• Descrição: Caso o item não for um item genuíno AGCO a concessionária deve ter um código referência AGCO que corresponda ao item em questão. Se não houver a referência, preencher com o valor do campo “partNumber”.
• ID: B06
• Campo: agcoPartNumber
• Exemplo: 1480626M1
• Origem/visualização ERP Solution: Itens genuínos AGCO: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “produto”. Itens não genuínos: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “Referência”. Exceção: Quando o parâmetro #AgcoVMICodigoItemAGCO da classe @IntegracaoFabrica (Rotina 99001) estiver configurado como Código Referência, sempre vai ser enviado o código de referência, independente de ser genuíno ou não (caso não tenha a referência informada será enviado o part number).

Item genuíno ou não

• Descrição: Informação que define se o item partNumber é um item
• genuíno AGCO ou não.
• ID: B07
• Campo: originalPart
• Exemplo: True
• Origem/visualização ERP Solution: Se no cadastro do item estiver informada a bandeira da fábrica, o item é reconhecido como genuíno. Se não for genuíno o campo é enviado como false. Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “bandeira”.

Descrição do item

• Descrição: Descrição da peça da concessionária.
• ID: B08
• Campo: description
• Exemplo: REPARO C/ ALAVANCA 8 VELOCIDADES
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “descrição”.

Descrição adicional do item

• Descrição: Informação preenchida no campo de descrição adicional
• do item.
• ID: B09
• Campo: dealerNote
• Exemplo: Parafuso 12X70 MM Locação Obsoletos
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “Descrição adicional”.

Produto sob encomenda

• Descrição: Define se esse item será estocado ou não.
• ID: B10
• Campo: Stockable
• Exemplo: True
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), flag “produto sob encomenda”.

Data da última venda

• Descrição: Última data de venda da peça (data de nota fiscal),
• considerando apenas notas validadas – (campo situação, 1057).
• ID: B11
• Campo: lastSaleDate
• Exemplo: 2020-08-21
• Origem/visualização ERP Solution: Data de emissão da última NF-e de venda emitida para o item.

Localização dos itens

• Descrição: Local principal de armazenamento da peça na concessionária.
• ID: B12
• Campo: mainBinLocation
• Exemplo: B12
• Origem/visualização ERP Solution: Módulo estoque> Depósito> alocação de produtos em prateleira, rotina 1012. Campo “prateleira 1”

Localização secundária dos itens

• Descrição: Local secundário de armazenamento da peça na concessionária.
• ID: B13
• Campo: alternateBinLocation
• Exemplo: A13
• Origem/visualização ERP Solution: Módulo estoque> Depósito> alocação de produtos em prateleira, rotina 1012. Campo “prateleira 2”.

Estoque mínimo

• ID: B14
• Campo: minimumThreshold
• Exemplo: 1
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068) campo estoque mínimo. Importante! Caso cliente informe através do botão “dados
• do produto, aba dados por filial, a informação irá zerada, considera apenas dentro da 1068).

Estoque Máximo

• Descrição: Estoque máximo para o item na concessionária.
• ID: B15
• Campo: maximumThreshold
• Exemplo: 999999
• Origem/visualização ERP Solution: Fixo “999999” .

CNPJ fornecedor

• Descrição: CNPJ do fornecedor do item.
• ID: B16
• Campo: preferredSupplierLegalNumber
• Exemplo: “00.000.000/0001-00”
• Origem/visualização ERP Solution: Busca o CNPJ do fornecedor para o qual teve a compra da maior quantidade de itens, independente da data. Se o produto não teve compra, só implantação de saldo (por exemplo) não envia nada.

Nome fantasia do fornecedor

• Descrição: Nome fantasia do fornecedor preferencial para o item.
• ID: B17
• Campo: preferredSupplierName
• Exemplo: “NOME FORNECEDOR”
• Origem/visualização ERP Solution: Busca o nome do fornecedor para o qual teve a compra da maior quantidade de itens. Se o produto não teve compra, só implantação de saldo (por exemplo) não envia nada.

Preço de reposição

• Descrição: Preço de reposição do item na concessionária
• ID: B18
• Campo: netPrice
• Exemplo: 200,00
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), aba financeira, campo “preço de reposição”.

Custo médio do item

• Descrição: Custo médio do item na concessionária.
• ID: B19
• Campo: averageCost
• Exemplo: 200,00
• Origem/visualização ERP Solution: Módulo balcão > Consultar > Últimos custos (Rotina 1206), campo Custo médio da filial.

Unidade de medida

• Descrição: Unidade de medida de armazenamento do item (PC, UN, M, GAL, L, etc).
• ID: B20
• Campo: unitOfMeasure
• Exemplo: M
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “unidade”.

Fator de conversão de unidade

• Descrição: Fator para conversão de unidade de venda para cliente final em relação a compra.
• ID: B21
• Campo: dealerPartsPerPackage
• Exemplo: 1
• Origem/visualização ERP Solution: Fixo “1” .

Moeda

• Descrição: Código da moeda.
• ID: B22
• Campo: currencyCode
• Exemplo: BRL
• Origem/visualização ERP Solution: Fixo “BRL”.

Último preço de venda

• Descrição: Último preço de venda pago.
• ID: B23
• Campo: lastPurchasePrice
• Exemplo: 200,00
• Origem/visualização ERP Solution: Valor pago pago pelo item na última NF-e de compra

Itens em pedido de compra

• Descrição: Quantidade de itens em pedidos de compras pendentes a receber -abertos.
• ID: B24
• Campo: openPurchaseOrders
• Exemplo: 10
• Origem/visualização ERP Solution: Soma a quantidade do item pendente em pedido de compra.

Embalagem mínima

• Descrição: Informação apenas para itens não AGCO: Embalagem
• mínima que o item é solicitado no fornecedor.
• ID: B25
• Campo: vendorPackageQuantity
• Exemplo: 10
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “conteúdo da embalagem”.

Grupo

• Descrição: Informação do código do Grupo do item.
• ID: B26
• Campo: segmentationCode01
• Exemplo: “Grupo: 1101”
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “grupo”.

Marca (opcional)

• Descrição: Informação da Marca do item.
• ID: B27
• Campo: segmentationCode02
• Exemplo: “Marca: VALTRA”
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “marca”.

Modelo

• Descrição: Informação do Modelo do item.
• ID: B28
• Campo: segmentationCode03
• Exemplo: “Modelo: GERAL”
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “modelo”.

Classificação

• Descrição: Informação da Classificação do item
• ID: B29
• Campo: segmentationCode04
• Exemplo: “Classif: GERAL”
• Origem/visualização ERP Solution: Módulo estoque > Cadastros > Produtos > Cadastro de produtos, rotina (1068), campo “classificação”.

Primeira movimentação

• Descrição: Data da última compra do item, conforme data de lançamento da última NF-e de compra deste item. Se não tiver, envia a data 01/01/1990.
• ID: B30
• Campo: firstAvailableDate
• Exemplo: 2016-11-23
• Origem/visualização ERP Solution: Data da primeira NF de compra do item.

Primeira compra

• Descrição: Esse campo identifica se essa peça nunca esteve em estoque, porque é um registro de primeira compra.
• ID: B31
• Campo: firstPurchase
• Exemplo: false
• Origem/visualização ERP Solution: É atrelado ao campo firstAvailableDate, se achar nota de compra vai como FALSE, se não achar vai como TRUE. Só leva em consideração notas de compra validadas.

DMS-03 (Purchase Order):

TAG raiz da mensagem

• Descrição: Tag inicial agrupadora, que comporta as demais informações enviadas do DMS-03.
• ID: C01
• Campo: Data

CNPJ da concessionária

• Descrição: CNPJ da filial da concessionária.
• ID: C02
• Campo: DealerLegalNumber
• Exemplo: 99.999.999/0001-99
• Origem/visualização ERP Solution: Módulo Administrativo > Principal > Filiais (rotina 99002) campo “CNPJ/CPF”.

Data e hora da extração dos dados

• Descrição: Data e hora da extração dos dados da mensagem
• ID: C03
• Campo: ExtractionDateTime
• Exemplo: 2020-08-23T 10:45:00+03:00
• Origem/visualização ERP Solution: Data/hora atual do servidor no momento da geração da informação.

Order

• Descrição: Tag agrupadora das informações dos pedidos (serão citados na sequência).
• ID: C04
• Campo: Order

Número do pedido

• Descrição: Número do pedido na concessionária.
• ID: C05
• Campo: orderID
• Exemplo: “34562”
• Origem/visualização ERP Solution: Pedido de compra (Rotina 2735)
  • Campo Cod interno do Pedido.

Número do pedido do fornecedor

• Descrição: Número do pedido do fornecedor
• ID: C06
• Campo: orderAgco
• Exemplo: “AOL-123456”
• Origem/visualização ERP Solution: Compras > Compras > Pedido de compra (rotina 2735), dentro do pedido, campo “Nro pedido fornecedor”.

Número original do pedido

• Descrição: Número original do pedido na concessionária. O valor desse campo nunca pode mudar. Deve sempre manter o primeiro número recebido pelo pedido.
• ID: C07
• Campo: orderIdOriginal
• Exemplo: “4567”
• Origem/visualização ERP Solution: Pedido de compra (Rotina 2735)
  • Campo cód int do Pedido.

CNPJ da filial

• Descrição: CNPJ da filial que receberá o pedido.
• ID: C08
• Campo: deliveredDealerLegalNumber
• Exemplo: “11.000.000/0001-00”
• Origem/visualização ERP Solution: CNPJ da filial que gerou o pedido.

Data de abertura

• Descrição: Data da abertura do pedido
• ID: C09
• Campo: orderDate
• Exemplo: “2020-11-23”
• Origem/visualização ERP Solution: Compras > Compras > Pedido de compra (rotina 2735), dentro do pedido, campo “Abertura”.

Tipo

• Descrição: Tipo do pedido.
• ID: C10
• Campo: orderType
• Exemplo: “STOCK_ORDER”
• Origem/visualização ERP Solution: Compras > Fábrica > tipos de pedido, rotina 1538. Este valor leva em consideração a bandeira do fornecedor e o tipo do pedido. Com base nesse código, são feitas
• campo a informação ‘VOR’, se o código for “T”, “S” ou “P” é enviado a informação ‘STOCK_ORDER’, se o código for “G” é enviado a informação ‘SERVICE’, demais casos é enviada a informação ‘STOCK_ORDER’.

Cnpj Fornecedor

• Descrição: CNPJ do fornecedor do pedido.
• ID: C11
• Campo: supplierLegalNumber
• Exemplo: “00.000.000/0001-00”
• Origem/visualização ERP Solution: Balcão > Cadastros > Contas >Fornecedores (rotina 2622), campo CNPJ.

Nome fantasia do fornecedor

Descrição: Nome fantasia do fornecedor do pedido.

ID: C12
Campo: supplierName
Exemplo: “NOME FANTASIA DO FORNECEDOR”
Origem/visualização ERP Solution: Balcão > Cadastros > Contas >Fornecedores (rotina 2622), campo “nome fantasia”.

Itens

• Descrição: Grupo que contém as informações de peças do pedido.
• ID: C16
• Campo: itens

Linha única

• Descrição: Linha única do pedido (sequencial), a qual não pode ser alterada.
• ID: C18
• Campo: orderLineNumber
• Exemplo: 1
• Origem/visualização ERP Solution: Compras > Compras > Pedido de compra (rotina 2735), dentro do pedido, aba itens, Coluna item.

Código do item

• Descrição: Código do item do pedido.
• ID: C19
• Campo: partNumber
• Exemplo: “1444437P”
• Origem/visualização ERP Solution: Compras > Compras > Pedido de compra (rotina 2735), dentro do pedido, aba itens, coluna produto.

Data do recebimento

• Descrição: Data do fechamento do pedido, ou por recebimento ou por não recebimento do mesmo
• ID: C20
• Campo: receivedDate
• Exemplo: “2020-11-23”
• Origem/visualização ERP Solution: Compras > Compras > Pedido de compra (rotina 2735), dentro do pedido, aba geral, Campo Fechamento.

Quantidade solicitada

• Descrição: Quantidade solicitada no pedido
• ID: C21
• Campo: requestedQuantity
• Exemplo: 1.5
• Origem/visualização ERP Solution: Compras > Compras > Pedido de compra (rotina 2735), dentro do pedido, aba itens, coluna Quantidade.

Quantidade recebida

• Descrição: Quantidade recebida pela filial da concessionária
• ID: C22
• Campo: receivedQuantity
• Exemplo: 1.5
• Origem/visualização ERP Solution: Compras > Compras > Pedido de compra (rotina 2735), dentro do pedido, aba itens, coluna recebida.

Quantidade Pendentes

• Descrição: Quantidade pendentes de recebimento pela concessionária. Diferença entre a quantidade solicitada e recebida
• ID: C23
• Campo: openQuantity
• Exemplo: 1.5
• Origem/visualização ERP Solution: Compras > Compras > Pedido de compra (rotina 2735), dentro do pedido, aba itens, coluna Pendente.

Quantidade de itens cancelados

• Descrição: Quantidade de itens cancelados no pedido
• ID: C24
• Campo: canceledQuantity
• Exemplo: 1.5
• Origem/visualização ERP Solution: Compras > Compras > Pedido de compra (rotina 2735), dentro do pedido, aba itens, coluna “não recebível”.

Status

• Descrição: Situação do item no pedido, se está cancelado, aberto ou fechado.
• ID: C25
• Campo: lineStatus
• Exemplo: ‘OPEN’
• Origem/visualização ERP Solution: status Open, cancelled e closed informado de acordo com as regras para o pedido.CANCELLED: Se a quantidade não recebida é igual a total. CLOSED: Se a quantidade total corresponde a soma da quantidade recebida com a não recebida. OPEN: Caso não se enquadre nos casos acima.

Valor líquido

• Descrição: Valor líquido de venda do item.
• ID: C26
• Campo: netValue
• Exemplo: “14.84”
• Origem/visualização ERP Solution: Diferença entre o totalValue e Taxes.

Valor total de venda

• Descrição: Total de impostos do item.
• ID: C28
• Campo: Taxes
• Exemplo: “2.00”
• Origem/visualização ERP Solution: Pode ser verificado no mapa de compras (vide nota de compras) , rotina 1753, Coluna impostos.

Moeda

• Descrição: Moeda dos valores de venda do item
• ID: C29
• Campo: currency
• Exemplo: “”BRL”
• Origem/visualização ERP Solution: Fixo ‘BRL’

DMS-04 (Sales Order)

Observação1: Estes registros são referentes às notas fiscais enviadas à fábrica (notas com tipo de lançamento de venda, outras saídas e devolução de venda, exceto notas do máquinas e rental), cada registro refere-se a uma única nota fiscal, a qual está sendo enviada.

Observação2: A fábrica utiliza a nomenclatura pedido para se referir também a nota fiscal, então onde fala em pedido nos campos referente a esta DMS, está se referindo a nota fiscal.

TAG raiz da mensagem

• Descrição: Tag inicial agrupadora, que comporta as demais informações enviadas do DMS-02.
• ID: D01
• Campo: Data

CNPJ da concessionária

• Descrição: CNPJ da filial da concessionária.
• ID: D02
• Campo: DealerLegalNumber
• Exemplo: 99.999.999/0001-99
• Origem/visualização ERP Solution: Módulo Administrativo > Principal > Filiais (rotina 99002) campo “CNPJ/CPF”.

Data e hora da extração dos dados

• Descrição: Data e hora da extração dos dados da mensagem
• ID: D03
• Campo: ExtractionDateTime
• Exemplo: 2020-08-23T 10:45:00+03:00
• Origem/visualização ERP Solution: Data/hora atual do servidor no momento da geração da informação.

Order

• Descrição: Tag agrupadora das informações dos pedidos (serão citados na sequência).
• ID: D04
• Campo: Order

Data

• Descrição: Data que o pedido foi coloca no sistema (criação)
• ID: D05
• Campo: orderDate
• Exemplo: “2020-11-23”
• Origem/visualização ERP Solution: Dados gerais da nota fiscal (Rotina 1057) Aba Dados gerais, campo data do lançamento.

Tipo

• Descrição: Indica se a NF é uma venda da Oficina (W) ou Balcão (S) ou uma Devolução (R)
• ID: D06
• Campo: orderType
• Exemplo: “S”
• Origem/visualização ERP Solution: Caso a NF seja da oficina vai como W, se for uma NF de devolução de venda vai como R e demais casos (venda balcão) vai como S.

Número do pedido

• Descrição: Número da nota fiscal da concessionária (identificador
• único da nota).
• ID: D07
• Campo: orderId
• Exemplo: 1233
• Origem/visualização ERP Solution: Dados gerais da nota fiscal (Rotina 1057) campo código interno.

CPF/CNPJ

• Descrição: CPF ou CNPJ do cliente
• ID: D08
• Campo: customerLegalNumber
• Exemplo: “000.000.000-00”
• Origem/visualização ERP Solution: Dados gerais da notas fiscais enviadas pelo sales order. Rotina 10587 > Aba cliente, cnpj/cpf endereço de tributação.

Tipo de entrega

• Descrição: Tipo de entrega do pedido
• ID: D09
• Campo: “REGULAR”
• Exemplo: “000.000.000-00”
• Origem/visualização ERP Solution: Fixo ”REGULAR”

Items

• Descrição: Grupo que contém as informações de peças do pedido
• ID: D13
• Campo: Items

Linha única

• Descrição: Linha única do pedido (sequencial único)
• ID: D14
• Campo: orderLineNumber
• Exemplo: “1”
• Origem/visualização ERP Solution: Dados gerais da nota fiscal (Rotina 1057) Aba itens, coluna lançamentos.

Código do item

• Descrição: Código do item vendido. Código da concessionária
• ID: D15
• Campo: partnumber
• Exemplo: “1444437P”
• Origem/visualização ERP Solution: Dados gerais da nota fiscal (Rotina 1057) Aba itens, coluna produto.

Atendimento do pedido

• Descrição: Identifica se o pedido foi atendido por completo no momento da solicitação.
• ID: D16
• Campo: firstPassFill
• Exemplo: True
• Origem/visualização ERP Solution: Enviamos de forma fixa com o valor “True”.

Data da demanda

• Descrição: Data que surgiu a demanda do item. Por exemplo, data
• que a máquina quebrou.
• ID: D17
• Campo: demandDate
• Exemplo: “2020-11-23”
• Origem/visualização ERP Solution: 1057> consulta de nota fiscal > campo “data de lançamento”.

Data da entrega

• Descrição: Data que foi solicitada a entrega do pedido (que o cliente espera receber).
• ID: D18
• Campo: requestedDate
• Exemplo: “2020-11-23”
• Origem/visualização ERP Solution: estoque-> estoque-> altera lançamento, buscar pelo lançamento, coluna data lancto.

Quantidade solicitada

• Descrição: Quantidade de itens na nota fiscal
• ID: D19
• Campo: requestedQuantity
• Exemplo: 1.5
• Origem/visualização ERP Solution: Dados gerais da nota fiscal (Rotina 1057) Aba itens, lupa no produto, aba item, campo quantidade.

Quantidade Reservada

• Descrição: Quantidades de itens que estão reservados e que ainda não estão contando como venda.
• ID: D20
• Campo: reservedQuantity
• Exemplo: 1.5
• Origem/visualização ERP Solution: Enviado de forma fixa o valor “0” (zero), pois os itens informados na nota fiscal sempre são contados como vendidos.

Quantidade de itens faturados

• Descrição: Quantidade de itens que já foram enviados para o cliente (faturados).
• ID: D21
• Campo: shippedQuantity
• Exemplo: 1.5
• Origem/visualização ERP Solution: Estoque -> estoque-> altera lançamento, se a situação do lançamento estiver como anulada, campo vai zerado, caso não for vai o campo quantidade (Dados gerais da nota fiscal (Rotina 1057), Aba itens, lupa no produto, aba item). Este campo refere-se a quantidade de itens vendida na nota fiscal (nota que está sendo enviada a fábrica).

Quantidade de itens retornados

• Descrição: Quantidade de itens que foram retornados do cliente para a concessionária.
• ID: D22
• Campo: returnedQuantity
• Exemplo: 10
• Origem/visualização ERP Solution: Se tipo do lançamento for devolução de compra, é enviado o campo quantidade ( Dados gerais da nota fiscal (Rotina 1057) Aba itens, lupa no produto, aba item).

Quantidade de itens cancelados

• Descrição: Quantidade de itens que foram cancelados pelo cliente
• na concessionária.
• ID: D23
• Campo: canceledQuantity
• Exemplo: 0
• Origem/visualização ERP Solution: Estoque-> estoque-> altera lançamento, buscar pelo lançamento, se o mesmo tiver com a coluna da situação como anulada é enviado o campo quantidade ( Dados gerais da nota fiscal enviada pelo sales (Rotina 1057) Aba itens, lupa no produto, aba item), caso contrário o campo é enviado zerado.

Data de envio

• Descrição: Data que o pedido foi enviado para o cliente (data faturamento).
• ID: D24
• Campo: shippedDate
• Exemplo: “2020-11-23”
• Origem/visualização ERP Solution: Estoque-> estoque-> altera lançamento, buscar pelo lançamento, coluna data lancto referentes as notas enviadas pelo sales.

Quantidade disponível

• Descrição: Quantidade de itens disponíveis na data que o pedido foi solicitado.
• ID: D25
• Campo: quantityAvailable
• Exemplo: 0
• Origem/visualização ERP Solution: Campo enviado fixo zerado.

Status da linha

• Descrição: Situação da nota fiscal sales enviada.
• ID: D26
• Campo: lineStatus
• Exemplo: “Closed”
• Origem/visualização ERP Solution: 1057> localizar a nota fiscal, campo situação. Se o mesmo tiver com a coluna da situação como anulada é enviado o status CANCELLED, se não é enviado como CLOSED.

Venda atípica

• Descrição: Identifica se o item foi uma venda atípica.
• ID: D28
• Campo: unusualSale
• Exemplo: true
• Origem/visualização ERP Solution: Se o tipo de lançamento da operação da NF-e que está sendo enviada a fábrica, caso seja uma operação de outras saídas este campo é enviado como TRUE, o que indica que é uma saída de uso eventual, como por exemplo uma remessa a campo, caso seja outro tipo de lançamento (venda ou devolução de venda) é enviado como FALSE, o que indica uma operação de venda.

Valor líquido

• Descrição: Valor líquido de venda do item.
• ID: D29
• Campo: netValue
• Exemplo: “14.84”
• Origem/visualização ERP Solution: Diferença entre o totalValue e Taxes.

Valor total de venda do item

• Descrição: Valor total de venda do item
• ID: D30
• Campo: totalValue
• Exemplo: “14.84”
• Origem/visualização ERP Solution: Vide Dados gerais da NF-e (Rotina 1057) – Itens – Visualizar – Aba Item – Valor Item

Total de impostos do item

• Descrição: Total de impostos do item.
• ID: D31
• Campo: Taxes
• Exemplo: “2.00”
• Origem/visualização ERP Solution: Pode ser verificado no mapa de vendas (vide nota de venda), rotina 1174 – Modelo Simples – Coluna impostos.

Moeda

• Descrição: Moeda dos valores de venda do item
• ID: D32
• Campo: currency
• Exemplo: “BRL”
• Origem/visualização ERP Solution: Fixo ‘BRL’

DMS-05 (Lost Sales)

TAG raiz da mensagem

• Descrição: Tag inicial agrupadora, que comporta as demais informações enviadas do DMS-05.
• ID: E01
• Campo: Data

CNPJ da concessionária

• Descrição: CNPJ da filial da concessionária.
• ID: E02
• Campo: DealerLegalNumber
• Exemplo: 99.999.999/0001-99
• Origem/visualização ERP Solution: Módulo Administrativo > Principal > Filiais (rotina 99002) campo “CNPJ/CPF”.

Data e hora da extração dos dados

• Descrição: Data e hora da extração dos dados da mensagem
• ID: E03
• Campo: ExtractionDateTime
• Exemplo: 2020-08-23T 10:45:00+03:00
• Origem/visualização ERP Solution: Data/hora atual do servidor no momento da geração da informação.

Order

• Descrição: Tag agrupadora das informações dos pedidos (serão citados na sequência).
• ID: E04
• Campo: Order

CPF ou CNPJ cliente

• Descrição: CPF ou CNPJ do cliente
• ID: E05
• Campo: customerLegalNumber
• Exemplo: “000.000.000-00”
• Origem/visualização ERP Solution: Módulo CRM > Cadastros > Clientes (rotina 7034), cpf ou Cnpj do cliente.

Código do item

• Descrição: Código do item
• ID: E06
• Campo: partNumber
• Exemplo: “1444437P”
• Origem/visualização ERP Solution: Envia os códigos dos produtos que tiveram registro de vendas perdidas. Consulta de vendas perdidas (Rotina 1135) lupa, aba venda perdida, campo código do produto.

Quantidade de itens perdidos

• Descrição: Quantidade de itens perdidos por falta de estoque.
• ID: E07
• Campo: lostSalesQuantity
• Exemplo: 10
• Origem/visualização ERP Solution: Balcão> Vendas > Vendas perdidas > Consulta de vendas perdidas, rotina 1135, aba venda perdida, campo quantidade.

Tipo do pedido

• Descrição: Origem da venda perdida
• ID: E08
• Campo: lostSalesType
• Exemplo: W
• Origem/visualização ERP Solution: Se origem da venda perdida for da oficina vai com ”W”, demais vai como “S”.

Data da perda da venda

• Descrição: Data da perda da venda.
• ID: E09
• Campo: lostSalesDate
• Exemplo: “2020-11-23”
• Origem/visualização ERP Solution: Balcão> Vendas > Vendas perdidas > Consulta de vendas perdidas, rotina 1135, aba venda perdida, campo Data de lançamento.

DMS-07 (Customer)

TAG raiz da mensagem

• Descrição: Tag inicial agrupadora, que comporta as demais informações enviadas do DMS-05.
• ID: F01
• Campo: Data

CNPJ da concessionária

• Descrição: CNPJ da filial da concessionária.
• ID: F02
• Campo: DealerLegalNumber
• Exemplo: 99.999.999/0001-99
• Origem/visualização ERP Solution: Módulo Administrativo > Principal > Filiais (rotina 99002) campo “CNPJ/CPF”.

Data e hora da extração dos dados

• Descrição: Data e hora da extração dos dados da mensagem
• ID: F03
• Campo: ExtractionDateTime
• Exemplo: 2020-08-23T 10:45:00+03:00
• Origem/visualização ERP Solution: Data/hora atual do servidor no momento da geração da informação.

Customer

• Descrição: Tag agrupadora das informações dos clientes (serão citados na sequência).
• ID: F04
• Campo: Customer

CPF ou CNPJ do cliente

• Descrição: CPF ou CNPJ do cliente
• ID: F05
• Campo: customerLegalNumber
• Exemplo: “00.000.000/000100”
• Origem/visualização ERP Solution: Módulo CRM > Cadastros > Clientes (rotina 7034), cpf ou Cnpj do cliente.

Código do cliente

• Descrição: Código do cliente na concessionária
• ID: F06
• Campo: customerId
• Exemplo: “AAA-12345678”
• Origem/visualização ERP Solution: Módulo CRM > Cadastros > Clientes (rotina 7034), campo “conta”.

Nome do cliente

• Descrição: Nome do cliente
• ID: F07
• Campo: customerName
• Exemplo: NOME DO CLIENTE”
• Origem/visualização ERP Solution: Módulo CRM > Cadastros > Clientes (rotina 7034), campo “nome”.

País

• Descrição: País do cliente.
• ID: F08
• Campo: countryCode
• Exemplo: “BR”
• Origem/visualização ERP Solution: Módulo CRM > Cadastros > Clientes (rotina 7034), campo “país”.

Cidade do cliente

• Descrição: Cidade do cliente.
• ID: F10
• Campo: cityName
• Exemplo: “Canoas”
• Origem/visualização ERP Solution: Módulo CRM > Cadastros > Clientes (rotina 7034), campo “cidade”.

Tipo do cliente

• Descrição: Tipo do cliente.
• ID: E11
• Campo: Type
• Exemplo: “RC”
• Origem/visualização ERP Solution: Módulo CRM > Cadastros > Clientes (rotina 7034), campo “tipo” se Orgãos públicos vai “GE”, indústria vai “IN”, Frotista vai “FO” e demais vai como “RC”.

Data da última venda

• Descrição: Data da última venda para cliente.
• ID: E12
• Campo: lastSalesDate
• Exemplo: 2020-1123T10:45:00+03:00
• Origem/visualização ERP Solution: Data da Última venda para Cliente.