Rastreabilidade por Chassi — Importação por NF-e, Expedição e Emissão de Retorno
Este documento tem como objetivo apresentar as funcionalidades e parametrizações relacionadas à integração de XML de Nota Fiscal eletrônica (NF-e) com o tratamento da tag Chassi e da Declaração de Importação (DI) no Gestão de Armazenagem | WMS Senior.
As funcionalidades contemplam dois grandes fluxos:
- Importação de NF-e (Entrada)
O sistema extrai automaticamente as informações de Chassi e DI do XML da NF-e durante o processo de importação, vinculando-as aos produtos para fins de rastreabilidade. - NF de Retorno de Armazenagem (Saída)
O sistema compõe a Nota Fiscal de Retorno incorporando as informações de Chassi e DI na descrição dos itens (tag ‹xProd›) e nas Informações Complementares (tag ‹infCpl›), conforme parametrização do Depositante.
Particularidades
Para que a funcionalidade seja realizada com sucesso, é necessário que:
- Exista cadastro de Informação de Material com descrição "CHASSI" associado aos produtos que utilizam rastreabilidade por chassi.
- O produto possua vínculo com a Informação de Material "Chassi" no cadastro de Informação de Material por Depositante.
- A integração Importação Conferência de Entrada não está compatível com esse fluxo.
Com o Gestão de Armazenagem | WMS Senior.
| Funcionalidade | Versão | Referência |
|---|---|---|
| Rastreabilidade por Chassi — Importação por NF-e, Expedição e Emissão de Retorno | 8.12.8.256 | ADO-69755 |
Parametrizações
Acesse Cadastro > Depositante > guia Integração
- Considerar informação específica pela tag <chassi> ao importar Pedido / NF: quando habilitado, o sistema considera a tag ‹chassi› presente no grupo ‹veicProd› do XML da NF-e durante a importação. O valor do chassi é extraído automaticamente e gravado como Informação Específica do item.
Acesse Cadastro > Depositante > guia Nota Fiscal
- Enviar Inf. do Produto na tag ‹xProd›: este parâmetro é o agrupador que controla a exibição dos campos de informações complementares na descrição dos itens da NF de Retorno. Quando habilitado, serão listados novos campos:
- Chassi (Inf. Específica): quando habilitado, o sistema insere o número do chassi na tag ‹xProd› da NF-e de retorno. Exige o preenchimento do campo Prefixo do chassi.
- Declaração de Importação (DI): quando habilitado, o sistema insere o número da DI na tag ‹xProd› da NF-e de retorno. Exige o preenchimento do campo Prefixo da DI.
- Enviar Chassi na Inf. Complementar (infCpl): quando habilitado, o sistema concatena todos os números de chassi dos itens da NF de retorno (operações de Retorno de Armazenagem e Retorno Simbólico) na tag ‹infCpl› (Informações Complementares) da NF-e. Formato: "CHASSI: ABC123, DEF456".
Acesse Cadastro > Entrada > Tipo de Recebimento > guia Dados do Tipo de Recebimento
- Permite geração de conferência automática com chassi: quando habilitado, permite que a geração automática da conferência de recebimento atribua o chassi importado do XML da nota fiscal de entrada como informação específica da mercadoria, eliminando a necessidade de coleta manual.
Fluxos
Leitura tag <chassi>
O sistema realiza a leitura do número do chassi do veículo a partir do grupo veicProd, localizado dentro da tag prod, referente ao item da nota fiscal (det).
Exemplo de referência no XML
<det nItem="1">
<prod>
...
<veicProd>
<chassi>2CJg7d8DT2bvW2243</chassi>
</veicProd>
</prod>
...
</det>
Validações durante a Importação (Chassi):
Quando o parâmetro do Depositante Considerar informação específica pela tag <chassi> ao importar Pedido / NF estiver habilitado e o XML contiver a tag ‹chassi›, o sistema aplica as seguintes validações:
| Validação | Regra |
|---|---|
| Produto vinculado à Informação de Material | O produto deve possuir vínculo com a Informação de Material "Chassi" no cadastro |
| Formato alfanumérico | O chassi deve conter apenas caracteres alfanuméricos (a-z, A-Z, 0-9) |
| Tamanho máximo | O chassi deve possuir no máximo 17 caracteres |
| Quantidade unitária | O item com chassi informado não permite quantidade (qCom) maior que 1 |
| Fator de conversão | Produto com fator de conversão maior que 1 não é permitido |
| Duplicidade | O mesmo chassi não pode aparecer em mais de um item na mesma NF |
Leitura tag <nDI>
O sistema realiza a leitura do número da Declaração de Importação a partir do grupo DI, localizado dentro da tag prod, referente ao item da nota fiscal (det).
Exemplo de referência no XML
<det nItem="1">
<prod>
...
<DI>
<nDI>1234567890</nDI>
</DI>
</prod>
...
</det>
Validações durante a Importação (DI)
| Validação | Regra |
|---|---|
| Formato alfanumérico | O nDI deve conter apenas caracteres alfanuméricos |
| Tamanho máximo | O nDI deve possuir no máximo 15 caracteres |
Quando uma Ordem de Recebimento estiver cadastrada e possuir Tipo de Recebimento com o parâmetro Permite geração de conferência automática com chassi habilitado, o sistema realiza validações adicionais ao vincular uma NF à Ordem de Recebimento:
| Validações | Resultado |
|---|---|
| Depositante utiliza BackList | O sistema não permite vincular a NF |
| Produto coleta Lote Indústria, Lote Adicional ou Data de Vencimento | O sistema não permite vincular a NF |
| Produto possui Informação Específica não exclusivamente de Chassi | O sistema não permite vincular a NF |
| Item da NF com informação de material diferente de "Chassi" | O sistema não permite vincular a NF |
| Produto com info específica exclusiva de Chassi + Depositante não utiliza BackList + sem lotes adicionais/lote indústria | O sistema permite vincular a NF |
Ao clicar no botão Gerar para gerar conferência automática, o sistema valida se:
- No cadastro do Depositante, o parâmetro Considerar informação específica pela tag <chassi> ao importar Pedido / NF está habilitado.
- No Tipo de Recebimento, o parâmetro Permite geração de conferência automática com chassi está habilitado.
Quando ambos parâmetros estiverem habilitados, o sistema permite gera a conferência automática, coletando a informação do chassi informado na tag como informação especifica para o produto da nota.
Antes de gerar a conferência, no entanto, o sistema realiza novamente as validações de vínculo da NF à Ordem de Recebimento. Caso haja qualquer alteração nas parametrizações que invalide esse vínculo, o sistema não permitirá a geração automática da conferência, e a coleta das informações passará a ser realizada manualmente, por meio do coletor de dados, no menu Conferência de Entrada.
Quando não for realizada a conferência automática, o sistema seguirá o padrão de conferência com rastreabilidade, ou seja, informará o produto e solicitará a informação específica ao usuário.
Importante: quando a conferência for realizada manualmente, o sistema não validará a informação do chassi presente no XML em relação à informação coletada manualmente. O sistema passará a acatar a informação preenchida pelo usuário, mesmo que divergente do chassi informado no XML.
Quando um XML de saída é importado no sistema e contém a tag ‹chassi› no grupo ‹veicProd›, o sistema realiza a leitura do chassi da mesma forma que no fluxo de entrada — extraindo o valor e salvando os dados. A partir dessa gravação, o sistema pode gerar automaticamente a Separação Específica, reservando o lote em estoque que possui aquele chassi para o item da NF de saída.
Para que a separação específica com chassi funcione:
- O parâmetro Considerar informação específica pela tag <chassi> ao importar Pedido / NF deve estar habilitado no Depositante.
- O XML de saída deve conter a tag <veicProd> <chassi> preenchida no item.
- O produto deve possuir vínculo com a Informação de Material "CHASSI" no cadastro de Informação de Material por Depositante.
- O produto deve possuir rastreabilidade configurada como Coletar no Rec. e Rastrear na Mov. — ou seja, o chassi já deve ter sido coletado na entrada e estar vinculado ao lote/estoque
- Deve existir estoque disponível com o chassi correspondente.
- O lote deve estar liberado e o local ativo.
O fluxo de saída contempla a emissão de Notas Fiscais de Retorno (operações Retorno de Armazenagem(TA) e Retorno Simbólico de Armazenagem(TS), onde as informações de Chassi e DI armazenadas no sistema são incorporadas na NF-e emitida.
Composição da tag ‹xProd›
- Quando o parâmetro Enviar Inf. do Produto na tag ‹xProd› estiver habilitado no Depositante, o sistema compõe a descrição dos itens da NF de retorno com informações adicionais
Composição da tag ‹infCpl› (Informações Complementares)
- Quando o parâmetro Enviar Chassi na Inf. Complementar (infCpl) estiver habilitado no Depositante, o sistema concatena todos os números de chassi dos itens da NF de retorno na tag ‹infCpl›.
Regras de composição:
- Os chassis são concatenados em sequência, separados por vírgula e espaço
- O prefixo "CHASSI: " é adicionado automaticamente no início
- A informação é inserida no início da tag ‹infCpl›, antes das demais informações complementares (mensagem de operação, mensagem de retorno, NF de cobertura, etc.)
- Apenas itens cujo produto possui a informação de material "CHASSI" vinculada e com valor preenchido são considerados
|
Veja também: |
English
Español
English
Español


