Linha Logix

Páginas filhas
  • DT API de cadastro de itens/SKU WMS


01. DADOS GERAIS

Produto:

TOTVS Logística WMS

Linha de Produto:

Linha Logix

Segmento:

Logística

Módulo:

TOTVS WMS - Linha Logix - WMS Logix (LG-ARMAZ)

Função:

EDI0010 - Processamento Cadastro de Produtos

wmsItemSKU.4gl

WMSR_WMS_ITEM_SKU.4gl

País:Brasil
Ticket:-
Requisito/Story/Issue (informe o requisito relacionado) :DLOGWMSOL-17530


02. SITUAÇÃO/REQUISITO

O WMS Logix possui um EDI que permite realizar a importação de arquivos textos para o cadastro de itens e SKUs.

Os layouts dos arquivos podem ser configuráveis e possuem atributos correspondentes aos campos de tabelas necessárias para cadastro de um item e SKU, para utilização no WMS.

A execução da importação de arquivos EDI é configurada no agendador do Logix (JOB) ou pode ser processada manualmente via rotina EDI0009 (Importação de Arquivos Via EDI).

03. SOLUÇÃO

Para que haja integração direta do Portal WEB do cliente Operador Logístico com o WMS Logix é necessário gerar uma API pública Logix. 

Nesta API deve haver apenas os verbos POST e PUT, nos quais não está prevista a execução de consultas ou exclusões desse cadastro.

Operação POST

Permite incluir um novo item e seus respectivos SKUS.

No corpo da mensagem serão informados os dados para o cadastro do produto e SKU.

Também pode ser cadastrado um item e "N" SKUs em cada requisição.

POST 
{code:json}
{
      "_comment1": "Início Campos Obrigatórios Item",
      "CompanyId":"11",
      "Depositor":"38",
      "ItemDepositorCode":"38-API-003",
      "ItemDescription":"38-API-003",
      "ItemShortDescription":"38-API-003",
      "FiscalClassificationId":"3.901",
      "PctIPI":0.00,
      "UnityOfMeasure":"KG",
      "_comment2": "Fim Campos Obrigatórios Item",
      "NetWeight":1.00,      
      "Trail":"N",
      "Active":"A",      
      "ExpirationDate":"N",
      "Origin":"",
      "ICMSIncidenceType":"",
      "ONU":"",
      "OutputID":"",
      "ItemCategory":"",
      "ProductionDate":"N",
      "Piece":"N",
      "AbcRating":"A",
      "ShelfLife":0.00,
      "ShortValidity":0.00,
      "AllowMixedPallet":"S",
      "AllowsShipmentWithoutRegularization":"N",
      "FractionalUnityOfMeasure":"N",
      "AllowPicking":"S",
      "PermanentClassification":"N",
      "ControlIDPicking":"N",
      "MaximumReceivingTime":0.00,
      "TermAlarmValidity":0.00,
      "ArmyControl":"N",
      "CivilPoliceControl":"N",
      "FederalPoliceControl":"N",
      "TargetUnityOfMeasure":"",
      "ConversionFactor":1.00,
      "ListOfSKU":[
         {
            "_comment3": "Início Campos do SKU - não obrigatório",
            "Sku":"38-API-003-SKU-1",
            "DescriptionSKU":"38-API-003-SKU-1",
            "ReducedDescriptionSKU":"38-API-003-SKU-1",
            "NumberOfItems":1.00,
            "Height":0.01,
            "Length":0.01,
            "Width":0.05,
            "HeightBoxes":5.00,
            "BallastBoxes":5.00,
            "GrossWeight":1.00,
            "_comment4": "Fim Campos Obrigatórios SKU",
            "Ean8":"",
            "Ean13":"",
            "Ean128":"",
            "Dun14":"",
            "OtherBarCodes":"8-API-003-SKU-1",
            "ean13UpcDun14":""
         },
         {
            "Sku":"38-API-003-SKU-2",
            "DescriptionSKU":"38-API-003-SKU-2",
            "ReducedDescriptionSKU":"38-API-003-SKU-2",
            "NumberOfItems":2.00,
            "Height":0.02,
            "Length":0.02,
            "Width":0.10,
            "HeightBoxes":3.00,
            "BallastBoxes":5.00,
            "GrossWeight":2.00,
            "Ean8":"",
            "Ean13":"",
            "Ean128":"",
            "Dun14":"",
            "Ean13UpcDun14":"",
            "OtherBarCodes":"8-API-003-SKU-2"
         }
      ] 
} {code}

Operação PUT

Permite a alteração dos dados de um item ou SKU já cadastrado. Além disso, possibilita a inclusão de novos SKUs a um item cadastrado, sendo que devem ser enviadas as seguintes informações:

    • No cabeçalho da requisição devem ser informados: Empresa, Depositante e Item depositante, separados por "|" (pipe - barra vertical).
    • O corpo da mensagem deve conter os dados a serem alteradas no cadastro do item ou SKU, ou ainda, os dados do novo SKU a ser cadastrado. 
      Exemplos:
PUT 1 
{code:json} {
 
      "CompanyId":"11",
      "Depositor":"38",
      "ItemDepositorCode":"38-API-003",
      "ItemDescription":"38-API-003-TESTEALTERA"
 } {code}
PUT 2 
{code:json}
{
      "ListOfSKU":[
         {
            "Sku":"38-API-003-SKU-15",
            "DescriptionSKU":"38-API-003-SKU-15-des",
            "ReducedDescriptionSKU":"38-API-003-SKU-15",
            "NumberOfItems":15.00,
            "Height":0.01,
            "Length":0.01,
            "Width":0.05,
            "HeightBoxes":5.00,
            "BallastBoxes":5.00,
            "GrossWeight":1.00,
            "OtherBarCodes":"38-API-003-SKU-11"
         }
      ]  
} {code}

IMPORTANTE

04. DEMAIS INFORMAÇÕES

Tabelas Utilizadas

  • item
  • item_parametro
  • item_ctr_grade
  • item_barra
  • item_sup
  • item_sup_compl
  • wms_item_complemento
  • wms_item_sku
  • wms_item_sku_cod_barras
  • fat_conver

05. ASSUNTOS RELACIONADOS

Documento de Referência