Integração - CataLog Feed 1
Atualmente a integração de cadastro | atualização de produtos e embalagens para o WMS é realizada via importação dos arquivos textos %cat%.dat e %upc%.dat respectivamente.
Inserimos esta funcionalidade a partir da versão 8.11.20.0 e algumas modificações na 8.11.24.0.
Observação: a começar da versão WMSCT5-5, existe a possibilidade de controlar manualmente as alterações do Catalog Feed 1 (Para mais detalhes).
Durante a integração do Catalog Feed, se o produto coleta data de vencimento ou fabricação o produto é marcado como FEFO, caso não colete, ele é marcado como Sequência de Locais, referente ao campo Regra Personalizada de Expedição do Produto do Cadastro do Produto.
Agora para realizar integração de cadastro | atualização de produtos e embalagens não é mais necessário enviar os dois arquivos TXTs acima para a importação dos produtos e embalagens, é enviado apenas o arquivo TXT Catalog Feed que cadastra os produtos e embalagens, com este novo processo de recebimento de mercadorias no armazém, exemplificado na Integração de Arquivo Catalog Feed, layout abaixo:
Arquivos de Integração InboundASN, SAM e Catalog Feed
This file will be a plain text file (tab delimited format) | ||
Field Name | Description | Detalhes |
SNAPSHOT_DATE | Date of catalog snapshot | Data do arquivo |
ASIN | Amazon ASIN ID | Código do Produto |
ASIN PARENT | Amazon Parent ASIN ID | Não Escopo |
EAN | Product EAN | Código de Barras Embalagem |
UPC | Product UPC | Não Escopo |
GL_GROUP | Amazon Product Category Group code | Tipo de Produto |
SUBCATEGORY | Amazon Product Sub-Category Group code | Subtipo de Produto |
DESCRIPTION | Product Description | Descrição Produto |
HEIGHT | Product Height | Altura Embalagem (cm) |
WIDTH | Product Width | Largura Embalagem (cm) |
LENGTH | Product Length | Comprimento Embalagem (cm) |
WEIGHT | Product Weight | Peso Embalagem (kg) |
IS_HAZMAT | Flag to define if Product is Hazmat item (according to Amazon classification) | Vincular ao Setor de HAZMAT, referente a materiais perigosos |
HTRC | Hazmat Transportation Regulatory Class | |
HAZMAT_EXCEPTION | Hazmat Exception | |
UN | United Nations Regulatory ID | |
CONTAINS_FOOD_BEVERAGE | Flag to indicate if the item contains food or beverage | |
SIOC | Flag to define if Product must be "shipped in its own container" (SIOC) | Box Recomendation na Saída / caixa recomendada na expedição do produto. |
ACTIVE | Flag to define if Product is still active in Amazon Catalog | Ativo |
BAGGING | Flag to define if Product required Prep (bagging) | Colocar em Saco Plástico |
BOXING | Flag to define if Product required Prep (boxing) | Colocar em Caixa |
BUBBLE_WRAP | Flag to define if Product required Prep (bubble wrap) | Plástico Bolha |
SET_CREATION | Flag to define if Product required Prep (set creation) | Montagem de Kit |
SHARP_LBL_STICKERING | Flag to define if Product required Prep (sharp lbl stickering) | Colocar Etiqueta de Produto Cortante |
SHRINKWRAP | Flag to define if Product required Prep (shrinkwrap) | Embalar com Plástico Filme |
STUFFING | Flag to define if Product required Prep (stuffing) | Preenchimento de caixa |
SUFFOCATION_STICKERING | Flag to define if Product required Prep (suffocation stickering) | Colocar Etiqueta de Risco de Sufocamento |
IS_SN_REQUIRED | Flag to define if item serial number must be captured during packing | Coleta Número de Série |
IS_DATELOT_REQUIRED | Flag to define if item must have datelot captured during Inbound and requires expiration date control | Coleta Vencimento |
EXPIRATION_TYPE | Define expiration date type - string | |
SHELF_LIFE | Shelf life time (in days) - Decimal | |
RECEIVE_PAD_TIME | Receive Pad time - Decimal | |
SHELF_LIFE_PAD_TIME | Shelf life time pad time - string |
Observação: durante a Importação do Catalog Feed alteramos os vínculos do Produto x Depositante x Setores que possuem a classificação pelo HTRC e Hazmat_Exception.
- Se o produto é HAZMAT, o sistema identifica qual é o HTRC e HAZMAT EXCEPTION e vincula ao Setor definido na Setor Padrão do Depositante que contém as mesmas informações.
- Se o HTRC e HAZMAT EXCEPTION do txt não coincidir com o cadastro definido no Setor Padrão.
Possibilitaremos a trocar de Setor na Integração, caso a Classificação do Produto seja HAZMAT e não exista Movimentação de Estoque no Setor anterior, com isso o sistema retira o vínculo do setor anterior e vincular no novo setor correspondente a classificação enviada.
Caso tenha ocorrido Movimentação de Estoque do produto para o setor anterior, o produto é HAZMAT e haja alteração do setor HAZMAT, para esta condição o sistema manter o vínculo nos setores anteriores e vincula ao novo setor a classificação enviada.
Arquivo no formato texto que possuem os produtos e suas embalagens, informações delimitadas por tabulação (\t), o nome do arquivo é composto de um prefixo inicial PCF. seguindo no PARTID. e por último a data\hora:
PCF.<PARTYID>.<CREATION TIMESTAMP: YYYYMMDDHHMMSS>.txt
Por exemplo: PCF.PARTYID.20190411121212.txt.
Algumas considerações:
- PARTYID: nome do arquivo referente ao código interno do fornecedor;
- As dimensões de altura, largura e comprimento da embalagem são enviadas em centímetros (cm) e o sistema converte para milímetros (mm) que é o padrão do sistema;
- O peso da embalagem foi enviado em quilos (kg) e o sistema converte para gramas (gr) que é o padrão do sistema;
- As informações referentes a prep. presente no layout são cadastradas no Produto x Depositante > Botão: Informação de Preparação;
- O sistema vincula produto HAZMAT somente ao setor desse tipo que está como setor padrão na integração do produto no depositante;
- Quando o produto não for HAZMAT o sistema vincula ao setor padrão que não é desse tipo na integração do produto no depositante;
- Os campos HTRC e Hazmat Exception estão preenchidos o produto é HAZMAT;
- Os campos HTRC e Hazmat Exception não estão preenchidos o produto não é HAZMAT;
- Se tiver preenchido as duas informação UPC e EAN, o sistema cadastra os dois;
- Caso tenha informação apenas no EAN e não tiver o UPC, o sistema cadastra o EAN;
- Caso somente o campo UPC tenha informação e não exista para o campo EAN, o sistema cadastra a barra com a informação do UPC;
- Mas se não tiver nenhuma informação para os campos UPC e EAN, o sistema retorna mensagem de erro de integração apenas na linha e,
- Caso campo IS_DATELOT_REQUIRED vir preenchido como ativo, marca o produto para Coletar Data de Vencimento no parâmetro Coletar vencimento do lote no Produto x Depositante.
- A começar das versões 8.11.23.4 e 8.11.25.0, criamos uma tratativa para que um produto HAZMAT seja vinculado a um setor HAZMAT apenas quando a informação de "Localização no FC (Location in FC)" da classificação de material perigoso esteja atribuída a informação: "HAZMAT SPECIALIZED AREA".
- Porém, quando o produto é HAZMAT, se a informação de "Localização no FC (Location in FC)" da classificação de material perigoso NÃO está atribuida a informação: "HAZMAT SPECIALIZED AREA", o produto é vinculado à setores considerados NORMAIS (que não são HAZMAT e também não são ESPECIAIS).
Menu: Cadastro > Produto > Classificação de Material Perigoso (HAZMAT)
Considerações:
- Sobre o campo: Pré cadastro se o parâmetro ativado determina que o cadastro foi feito por integração e precisa ser revisado, e no Gerenciador de OR não permite Gerar Alocação quando estiver vinculado a algum produto conferido na OR.
- Com referência ao botão Excluir o sistema não permite excluir uma classificação que já está vinculada em algum setor.
Menu: Cadastro > Armazém > Setor
Adicionamos o parâmetro: Materiais Perigosos (HAZMAT) informa que o produto associado ao setor faz parte de um depositante que controla produto perigoso.
Considerações:
- Somente produtos parametrizados com Materiais Perigosos (HAZMAT) podem ser vinculados ao setor.
- Caso haja algum vínculo de produto a um Setor, o sistema não permite ativar o parâmetro Materiais Perigosos (HAZMAT).
- Não existe trava ao vincular Depositante ao Setor.
- Para vincular um produto ao Setor do tipo HAZMAT, o sistema obriga que exista no mínimo um depositante vinculado, para que o sistema valide se o produto x depositante é do tipo HAZMAT.
A começar das versões 8.11.23.4 e 8.11.25.0, modificamos o sistema para que não seja possível vincular um produto HAZMAT à um setor HAZMAT cujo a classificação de material perigoso do produto não esteja vinculado ao setor. Caso tente efetuar o vínculo, a mensagem de erro abaixo é exibido:
Adicionamos travas de Produtos x Depositante x Setores HAZMAT x Classificação HAZMAT
- Na tela de Setor, se ele for HAZMAT, o sistema permite vincular um produto somente quando o Setor já possui Depositante, Classificação HAZMAT vinculado e o Produto ter a mesma Classificação HAZMAT definida no setor.
- Na tela de Produtos, se ele for HAZMAT, o sistema permite vincular um Setor apenas se a Classificação HAZMAT do setor for a mesma do produto depositante. Porém se as duas combinações estiverem vazias, o sistema não permite o vinculo do setor para o produto HAZMAT.
- Exemplo:
Menu: Cadastro > Depositante > Botão: Setor Padrão
Ajustamos o vínculo da tela de Setor Padrão ao Depositante, indicando se o setor é ou não de produto de Materiais Perigosos HAZMAT.
Adicionamos controles especiais para a preparação de materiais perigosos, no Controle de Produto x Depositante.
Menu: Cadastro > Produto > Produto > botão: Depositante > Botão: Informações Associadas > sub menu: Regras de Alocação
- Coleta Número de Série (IS_SN_REQUIRED): obriga o usuário a informar o número de série durante a Conferência de Entrada.
- Material Perigoso (HAZMAT): indica que o produto é um material perigoso e precisa estar em setor específico conforme os registros marcados na tela de Cadastro de Produto x Depositante > botão Informações de Preparação.
Menu: Cadastro > Produto > Produto > botão: Depositante > Botão: Informações Associadas > sub menu: Coleta de Informações
- Cadastro Revisado: este parâmetro controla se houve a inserção da quantidade de embalagens que estão vinculadas a partir do botão Informações de Preparação, e só permite continuar com a Conferência de Entrada, se o cadastro do produto foi revisado, obrigando o usuário a marcar este parâmetro. (por padrão é cadastrado desmarcado).
- Coleta Número de Série (IS_SN_REQUIRED): obriga o usuário a informar o número de série durante a Conferência de Entrada.
Menu: Cadastro > Produto > Produto > botão: Depositante > Botão: Informações Associadas > sub menu: Regras de Expedição
- Utiliza Caixa Recomendada (SIOC): obriga o usuário a utilizar a mesma caixa do produto para expedição do Material Perigoso (Hazmat).
Menu: Cadastro > Produto > Produto > botão: Depositante > Botão: Informação de Preparação
Podemos vincular os itens de preparação, conforme o cadastro realizado na tela Informações de Preparação.
- IS_HAZMAT: alocar em setor específico para esse tipo.
- SIOC: caixa recomendada na expedição do produto.
- BAGGING: colocar Saco Plástico.
- BOXING: colocar em Caixa.
- BUBBLE_WRAP: plástico Bolha.
- SET_CREATION: montagem de Kit.
- SHARP_LBL_STICKERING: colocar Etiqueta de Produto Cortante.
- SHRINKWRAP: embalar em Plástico Filme.
- STUFFING: preenchimento de Caixa.
- SUFFOCATION_STICKERING: colocar Etiqueta de Risco de Sufocamento.
- IS_SN_REQUIRED: coleta Número de Série.
- IS_DATELOT_REQUIRED: coleta Data de Vencimento.
Na tela de Informações de Preparação a começar das versões 8.11.23.4 e 8.11.24.0, podemos vincular Foto ao PREP.
A começar da versão 8.11.21.0, adicionamos Controle de Validade como coleta de Data de Fabricação, Data de Vencimento, Configuração do Prazo de Validade, Prazo de Comercialização e Prazo Crítico. Essas informações de configuração de controle de validade dos produtos também são enviadas no arquivo TXT do Catalog Feed que já é integrado atualmente. Os campos mencionados acima determinam o controle de validade, qual tipo de data é coletada (data de fabricação ou data de vencimento), o prazo de validade, prazo de comercialização e prazo crítico do produto integrado. Abaixo segue algumas considerações:
- As informações de EXPIRATION_TYPE, SHELF_LIFE, RECEIVE_PAD_TIME, RECEIVE_PAD_TIME e SHELF_LIFE_PAD_TIME somente são integradas se o campo IS_DATELOT_REQUIRED vem marcado como “Y”;
- Caso o campo IS_DATELOT_REQUIRED está marcado como “N”, após já ter sido enviado uma vez como “Y”, as demais informações como: EXPIRATION_TYPE, SHELF_LIFE, RECEIVE_PAD_TIME, RECEIVE_PAD_TIME e SHELF_LIFE_PAD_TIME retornam aos seus valores padrões para que o produto deixe de realizar controle de validade;
- Quando for para coletar data de fabricação o campo EXPIRATION_TYPE vem preenchido desta forma Production Date Required, e quando for para coletar data de vencimento o campo EXPIRATION_TYPE vem preenchido desta forma Expiration on Package e,
- As informações SHELF_LIFE, RECEIVE_PAD_TIME, RECEIVE_PAD_TIME e SHELF_LIFE_PAD_TIME são enviadas em dias e com isso são convertidas para meses pois correspondem ao prazo de validade, comercialização e crítico de controle do WMS, não é permitido informar quantidade de dias menor que 30, pois o sistema não controla prazos menores que 1 mês.
Utiliza Data da Conferência na Data de Fabricação: este parâmetro foi ajustado desde a versão 8.11.22.0, e indica se utiliza somente a Data da Conferência na Data de Fabricaçãoignorando o cálculo da fabricação baseado no Prazo de Validade do cadastro do produto, isto se, a opção Coleta Data de Vencimento do campo Coletar Vencimento do Lote estiver setado.
Desde as versões 8.11.23.2 e 8.11.24.0 fizemos algumas adaptações no controle da
Data de Fabricação do Produto.
- Ajuste de entrada
- Menu: Movimentação > Ajuste > Ajuste de Movimentação
- Se o parâmetro Utiliza Data da Conferência na Data de Fabricação está ativado, ao informar a Data de Validade, a Data de Fabricação recebe a Data Atual, e ignora o valor informado em meses da tela do Cadastro de Produto. Porém se o produto x depositante está configurado para coletar Data de Vencimento e NÃO Utiliza Data da Conferência na Data de Fabricação: nada de diferente ocorre ao processo de ajuste, ou seja, o sistema continua calculando a data de fabricação conforme configurado no produto, e se o produto x depositante não coletar a Data de Vencimento os campos Datas de Fabricação e Vencimento continuam sem valor.
- Gerenciador de Lote
- Menu: Movimentação > Gerenciador de Lote
- Fica habilitado o botão Alterar Data de Fabricação quando o Produto x Depositante está configurado para Coletar Data de Fabricação;
- Da mesma forma o botão Alterar Data de Vencimento fica habilitado para o Produto x Depositante configurado para Coletar Data de Vencimento;
- E se o parâmetro Utiliza Data da Conferência na Data de Fabricação estiver habilitado, então, ao informar ou alterar uma data de validade, a data de fabricação recebe a Data Atual, ignorando o valor informado em meses na tela do Cadastro do Produto.
Relatório disponível a partir da versão 8.11.22.0, e foi criado para exibir a antiga e a nova classificação de material perigoso enviado para cada produto cadastrado | atualizado.
Atualmente no WMS a funcionalidade de controle de lote único no endereço permite não misturar produtos que possuem lote indústria e vencimento diferentes no mesmo endereço de armazenagem. Porém além dessas validações o sistema também não deixa misturar produtos e depositantes diferentes quando este recurso está ativo.
Desde a versão 8.11.22.0, o objetivo é somente validar lote indústria e vencimento diferente para o mesmo produto a ser alocado em determinado endereço, ou seja, se o produto e\ou depositante forem diferentes, a alocação é permitida. Essa validação de produtos iguais com lote indústria e\ou vencimento diferente é configurada por setor, onde uns realizam a checagem e outros não, conforme as parametrizações abaixo:
Menu: Cadastro > Produto > Produto > Botão: Depositante / Informações Associadas > Sub Menu: Regras para Alocação
Permite misturar Produto/Lote indústria/Vencimento no mesmo endereço, de acordo com a configuração do Setor: somente está habilitado para marcar ou não se o parâmetro: Lote único no Endereço estiver marcado. Permite misturar Lote indústria e Vencimento no mesmo endereço, desde que sejam produtos diferentes. Porém, é necessário configurar o parâmetro Permite misturar Produto/Lote indústria/Vencimento no mesmo endereço, apenas se forem produtos diferentes que consta no cadastro do Setor para que isto aconteça. Esta regra não se aplica para lotes danificados ou vencidos.
Menu: Cadastro > Armazém > Setor
Permite misturar Produto/Lote indústria/Vencimento no mesmo endereço, apenas se forem produtos diferentes: os endereços deste Setor permitem apenas o mesmo Lote indústria e Vencimento para o mesmo produto. Se for um produto diferente, então este pode ter o mesmo lote indústria e Vencimento do outro produto alocado no mesmo endereço. Para que esta regra seja aplicada, é necessário que o parâmetro Permite misturar Produto/Lote indústria/Vencimento no mesmo endereço, de acordo com a configuração do Setor esteja marcado no Cadastro do Produto x Depositante. Esta regra não se aplica para lotes danificados ou vencidos.
Menu: Depositante > botão: Padrão de Integração > Sub menu: Regras de negócio
E também adicionamos o parâmetro Permite misturar Produto/Lote indústria/Vencimento no mesmo endereço, de acordo com a configuração do Setorno Padrão de Integração do Depositante quando ocorrer a integração de um produto inexistente no cadastro, mas para que isso ocorra o parâmetro Lote Único no Endereço precisa estar marcado.
(Referente ao WMSCT4-520)
Alteramos a integração do Catalog Feed para quando o produto realiza controle de validade, o WMS recebe o comando para marcar no cadastro do Produto x Depositante o Lote Único no Endereço e o Permite misturar Produto/Lote indústria/Vencimento no mesmo endereço, de acordo com a configuração do Setor que valida se o produto e depositante são diferentes ou não.
O sistema somente valida o Lote Indústria e Vencimento diferentes no local para produtos iguais quando os parâmetros do Produto x Depositante: Permite misturar Produto/Lote indústria/Vencimento no mesmo endereço, de acordo com a configuração do Setor e do Cadastro do Setor: Permite misturar Produto/Lote indústria/Vencimento no mesmo endereço, apenas se forem produtos diferentes toda vez que houver mudança de estoque:
- Armazenagem / Recebimento;
- Remanejamento;
- Reabastecimento;
- Ajuste de entrada;
- Picking dinâmico;
- Avaria;
- Retorno de produto recuperado;
- Inventário;
- Cancelamento de onda / Região de Retorno de Armazenagem;
- Alteração de Data Vencimento / Fabricação no Gerenciador de Lote e,
- Alteração Lote Indústria no Gerenciador de Lote.
Consideração: a separação de produtos na onda não realiza a validação de lote único no endereço.
A começar das versões 8.11.23.1 e 8.11.24.0, adicionamos esta funcionalidade de classificação especial aos produtos, pois precisam ser vinculados \ armazenados em setores específicos no armazém. A definição de qual setor o produto deve ser vinculado é determinada pelo Tipo de Produto ao qual o mesmo se enquadra. Este comportamento é determinado pela integração do Catalog Feed através do campo GL_GROUP.
Adequamos o Cadastro de Setor com o parâmetro Produtos Especiais e somente recebe produtos cujo seu tipo esteja vinculado ao setor. Ressalva: Este novo parâmetro somente é ativado se o parâmetro Materiais Perigosos (HAZMAT) existente não estiver ativado pois são produtos que possuem características distintas e não podem ser armazenados no mesmo setor.
Ajustamos alguns pontos do WMS, tais como:
- Cadastro > Produto > Produto
- Campo: Tipo de Produto
- Botão: Setor
- Cadastro > Armazém > Setor
- Campo: Produtos Especiais
- Botão: Produtos
- Botão: Tipo de Produto
Observação: caso o cadastro do Setor existente contêm produtos + estoque vinculados e não sejam Materiais Perigosos (HAZMAT) e o parâmetro Produtos Especiais esteja desabilitado, assim que este parâmetro for marcado o sistema solicita ao usuário a autorização do Supervisor.
Mas se o usuário tentar desmarcar o parâmetro Produtos Especiais e houver produtos vinculados ao setor. O sistema exibe mensagem de advertência:
Adicionamos o botão Tipo de Produto ao cadastro de Setor, e este botão só pode ser utilizado se o parâmetro Produtos Especiais estiver marcado, e após setar um ou mais Tipos de Produtos, o botão: Produto começa a validar as checagens dos registros do Tipo de Produto.
Alguns comportamentos:
- Se o Tipo de Produto enviado estiver vinculado a pelo menos um ou mais setores definidos como setor padrão para o depositante do produto, o produto é vinculado a somente setores padrões que o tipo de produto está vinculado, desde que não sejam setores HAZMAT;
- Se o Tipo de Produto enviado não estiver vinculado a nenhum setor definido como setor padrão para o depositante do produto, o produto é vinculado a todos os setores definidos com setores padrões, desde que não sejam setores HAZMAT;
- Quando o Tipo de Produto for atualizado e não tiver estoque do produto, o sistema retira o vínculo do setor anterior e vincular ao novo setor correspondente o Tipo de Produto enviado;
- Quando o Tipo de Produto for atualizado e tiver movimentação de estoque do produto, o sistema mantém o vínculo nos setores anteriores e vincula ao novo setor correspondente o tipo de produto enviado;
- Se não encontrar o Tipo de Produto informado na TAG: gl_group, então o sistema realiza o cadastro do Tipo de Produto no WMS e vinculá-lo ao produto enviado e desde que o produto não seja HAZMAT:
- Existe um Tipo de Produto igual o GL_GROUP informado na integração?
- Se não existir, o sistema:
- Cadastra o Tipo de Produto, para o campo: Código = GL_GROUP e para o campo: Tipo = N/D )
- Vincula o Tipo de Produto ao produto.
- Vincula o produto a todos os Setores Padrões que não são Hazmat.
- Se existir, o sistema:
- Verifica o depositante e seus setores padrões e quais tem marcado o parâmetro Produtos Especiais.
- Se tiver setor marcado, dentre os setores padrões, qual deles está vinculado ao Tipo de Produto informado no campo GL_GROUP.
- O sistema vincula o Produto a todos os Setores de Produtos Especiais que tem vínculo com o Tipo de Produto informado.
- Se não tiver marcado o campo Produtos Especiais no Setor:
- O sistema vincular o produto a todos os Setores Padrões que não são HAZMAT.
- Se tiver setor marcado, dentre os setores padrões, qual deles está vinculado ao Tipo de Produto informado no campo GL_GROUP.
- Verifica o depositante e seus setores padrões e quais tem marcado o parâmetro Produtos Especiais.
- Se não existir, o sistema:
Observações:
- No momento da integração, caso o produto venha HAZMAT e também com GL_GROUP preenchido, o sistema prioriza a seguinte ordem:
- HAZMAT
- GL_GROUP
- Produto Normal
- Caso não encontre o Tipo de Produto informado na TAG: gl_group, o sistema realiza o cadastro do Tipo de Produto no WMS e vinculá-lo ao produto enviado. Cadastra o Tipo de Produto, no campo: Código = GL_GROUP e no campo: Tipo = N/D
- Existe um Tipo de Produto igual o GL_GROUP informado na integração?
Menu: Consulta > Produto > Alterações Catalog Hazmat e Controle de Lote
A partir das versões 8.11.23.4 e 8.11.24.0, criamos este relatório para exibir os produtos que tiveram preparações durante a Conferência de Entrada.