Ir para o conteúdo

Item

Item

O item é enviado toda vez que for criado ou alterado e possua as informações da Capa, Engenharia, Suprimentos, Planejamento e Estoque do Cadastro de Itens (FITE0200). Além disso o mesmo deverá estar vinculado à [empresa base do Insight].

Caso o item já tenha sido enviado para o insight, será enviada uma atualização, caso sejo o primeiro envio será enviada uma inserção.

OBS.: O item só será enviado se não tiver sido inserido pelo Insight. Além disso desconsiderados no Insight itens de origem Structure Template.

Criação do item

Dados de envio do item

  • Endpoint: api/focco/v1/items
  • Exemplo de Payload:
<root>
    <Items>
        <Item ItemNumber="TESTE144" Description="TESTE144" IsPurchased="0" PrimaryUOMCode="UNIDAD" Effective="2023-07-24" Inactive="9999-12-31" OriginSystemCode="Manual" PrimaryUOMCodeISO="C62" ProcurementMethodCode="Order">
            <Purchasing Buyer="N/A" DemandOffset="10" />
            <CustomData>
                <ItemStockingLocations>
                    <ItemStockingLocation ItemNumber="TESTE44" wrhCode="30" IsPrimary="1" IsPrimaryReceipt="1" />
                </ItemStockingLocations>
            </CustomData>
            <UOMConversion UOMCode="KG" FactorToPrimary="15.2046"/>
            <Attribute AttributeCode="FOCCO_PESO_LIQ" Value="2.95" />
            <Attribute AttributeCode="FOCCO_CLA" Value="20.100.0003" />
        </Item>
    </Items>
</root>

Atributos padrão de itens no Cadastro de Respostas Padrão para Integrações via XML (FIST0100)

Tag Atributo Resposta
root/Items/Item ProcurementMethodCode Order
root/Items/Item OriginSystemCode Manual
root/Items/Item Inactive 9999-12-31
root/Items/Item ProcurementMethodCode Order
root/Items/Item/Attribute AttributeCode FOCCO_CLA
root/Items/Item/Attribute Value 
SELECT cla_grp.cod_grp_ite 
FROM tgrp_clas_ite cla_grp 
JOIN titens_engenharia it_eng ON cla_grp.id = it_eng.grp_clas_id JOIN titens_empr it_emp ON it_eng.itempr_id = it_emp.id 
WHERE it_emp.empr_id =  AND it_emp.cod_item = \root/Items/Item/@ItemNumber
root/Items/Item/Attribute AttributeCode FOCCO_PESO_LIQ
root/Items/Item/Attribute Value 
SELECT peso_liq 
FROM titens_engenharia it_eng 
JOIN titens_empr it_emp ON it_eng.itempr_id = it_emp.id 
WHERE it_emp.empr_id =  AND it_emp.cod_item = \root/Items/Item/@ItemNumber
root/Items/Item/Attribute AttributeCode FOCCO_REF_ITEM
root/Items/Item/Attribute Value 
SELECT referencia 
FROM titens_engenharia it_eng 
JOIN titens_empr it_emp ON it_eng.itempr_id = it_emp.id 
WHERE it_emp.empr_id =  AND it_emp.cod_item = \root/Items/Item/@ItemNumber
root/Items/Item/CustomData/ItemStockingLocation IsPrimary 1
root/Items/Item/CustomData/ItemStockingLocation IsPrimaryReceipt 1
root/Items/Item/Stocking/Lot LotControlMethodID 3
root/Items/Item/Purchasing Buyer N/A
root/Items/Item/Purchasing DemandOffset 10

OBS: a tag Lot só será enviada para o Insight caso o item no FoccoERP controle Lote.

De-Para de Cadastro de Itens

Apesar de existir uma Integração para cada ação com o item (atualização da capa, criação das pastas e atualização das pastas), os cadastros de de-para do item devem ser cadastrados na integração de envio de itens, visto que esta encapsula todos os envios.

Aba Insight Campo Insight Campo FoccoERP
Item OriginSystemCode Conforme parametrização Atributos Padrão
Item Inactive Conforme parametrização Atributos Padrão
Item Effective Data de Cadastro do Cadastro de Itens
Item PrimaryUOMCodeISO Conforme parametrização Atributos Padrão
Item PrimaryUOMCode Unidade de medida conforme a pasta estoque do Cadastro de Itens
Item ProcurementMethodCode Conforme parametrização Atributos Padrão
Item IsPurchased Tipo de Item conforme a pasta engenharia do Cadastro de Itens, neste caso será enviado se o item é ou não comprado
Item Description Descrição técnica do Cadastro de Itens
Item ItemNumber Código do item conforme Cadastro de Itens
Purchasing DemandOffset Conforme parametrização Atributos Padrão
Purchasing Buyer Conforme parametrização Atributos Padrão
Lot LotControlMethodID Conforme parametrização Atributos Padrão

OBS: o campo PrimaryUOMCode no Insight tem como tamanho máximo 5 caracteres.

Atualização do item

Dados de envio do item

  • Endpoint: api/focco/v1/items/{id}

  • Exemplo de Payload:

<root>
    <Items>
        <Item ItemNumber="13DENOVO55" Description="ITEM INSIGHT" IsPurchased="1" PrimaryUOMCode="UN" Effective="2022-09-28">
            <Purchasing/>
            <CustomData>
                <ItemStockingLocations>
                    <ItemStockingLocation ItemNumber="13DENOVO55" wrhCode="10"/>
                </ItemStockingLocations>
            </CustomData>
            <UOMConversion UOMCode="KG" FactorToPrimary="15.2046"/>
        </Item>
    </Items>
</root>

De-Para de Cadastro de Itens

Aba Insight Campo Insight Campo FoccoERP
Item Effective Data de Cadastro do Cadastro de Itens
Item PrimaryUOMCode Unidade de medida conforme a pasta estoque do Cadastro de Itens
Item IsPurchased Tipo de Item conforme a pasta engenharia do Cadastro de Itens, neste caso será enviado se o item é ou não comprado
Item Description Descrição técnica do Cadastro de Itens
Item ItemNumber Código do item conforme Cadastro de Itens
Item UOMConversion.UOMCode Código da unidade de medida do fator de conversão
Item UOMConversion.FactorToPrimary Peso bruto do item