Rastreabilidade padrão AWB Total Express
O sistema de Gestão de Armazenagem | WMS Senior agora inclui o cálculo para geração de códigos de rastreabilidade no padrão AWB Total Express (Air Waybill). Esse código é utilizado nas etiquetas de volume e no DANFE simplificado, garantindo identificação única e padronizada para cada unidade movimentada. Além disso, a rastreabilidade está integrada às confirmações de embarque, por meio de uma interface que detalha os volumes, facilitando o monitoramento e a consulta ao longo do processo logístico.
A funcionalidade está disponível para os fluxos Packing, Colmeia e Checkout Express.
Particularidades
Esta funcionalidade será compatível com as versões superiores a 8.12.7.440 do Gestão de Armazenagem | WMS Senior.
(Referente WMSCT3-3291)
Parametrizações
Acesse Cadastro > Depositante > botão Transp. e Rastreamento > botão Serviços da Transportadora > botão Cadastrar
- Código do Serviço: define o código de serviço que deve ser utilizado na integração Pedido.
- Código do Serviço - Exportação: define o código de serviço a ser preenchido na exportação do arquivo XTRK, correspondente as tags "cTipoEmbarque" e "xTipoEmbarque".
- Descrição: informe qual é a descrição do Serviço da Transportadora.
- Utiliza Código de Rastreabilidade: quando ativado, faz com que o sistema utilize o Código de Rastreabilidade, gerado no menu "Códigos de Rastreabilidade de Volumes". Nas impressões de etiquetas de volume em vez de exibir o código de volume padrão, o sistema apresenta o código de rastreabilidade nas etiquetas.
- Modelo de etiqueta: para esta funcionalidade, selecione a opção "Volume de Expedição por Serviço Transportadora com Conteúdo". Esse modelo de etiqueta será impresso no momento da geração do volume, caso o pedido ainda não esteja faturado.

- Utiliza DANFE Simplificado com Código de Rastreabilidade: quando habilitado, indica que o serviço de transporte utiliza o DANFE simplificado. Para impressão da etiqueta, é necessário configurar o modelo desejado no campo "Modelo Etiqueta DANFE".
- Modelo Etiqueta DANFE: selecione o modelo desejado para impressão da etiqueta DANFE simplificado. Esse modelo de etiqueta será impresso somente se o pedido estiver faturado.
Acesse Cadastro > Depositante > botão Transp. e Rastreamento > botão Serviços da Transportadora > botão Códigos de Rastreabilidade de Volumes > botão Gerar Códigos de Rastreabilidade
- Id Configuração: identificador interno da aplicação.
- Utilizar Dígito Verificador: define qual o tipo de Digito Verificador o sistema deve utilizar:
- Não utilizar: não será aplicado cálculo do digito verificador;
- Padrão WMS: será aplicado o cálculo padrão do WMS para o dígito verificador;
- Padrão AWB: será aplicado o cálculo Total Express AWB para o dígito verificador.
- Prefixo do Código de Rastreabilidade: define os quatro primeiros caracteres do código de rastreabilidade.
- Sufixo do Código de Rastreabilidade: define os dois últimos caracteres do código de rastreabilidade.
- Início do Intervalo: informe o número que inicia o intervalo do código de rastreabilidade.
- Fim do Intervalo: informe o número que finaliza o intervalo do código de rastreabilidade.
- Quantidade Total de Dígitos para o Intervalo: caso o campo Utilizar Dígito Verificador não esteja habilitado, é possível informar quantos dígitos compõem o intervalo, preenchendo com zeros a esquerda, o espaço do Início e Final do Intervalo.
Acesse Cadastro > Depositante > botão Alterar > guia Exportação
- Para exportação da confirmação do embarque, foi disponibilizado o modelo REST – Modelo Cabeçalho/Detalhe/Volume no campo Autorização de Embarque.
Integração
Acesse Cadastro > Depositante > guia Exportação > agrupamento Expedição > Autorização de Embarque > REST – Modelo Cabeçalho/Detalhe/Volume
Após o processamento da coleta, quando configurado o modelo REST – Modelo Cabeçalho/Detalhe/Volume no campo Autorização de Embarque, no cadastro do Depositante, o sistema gera automaticamente a exportação seguindo o layout abaixo:
tipointegração: EXP_CARGA_EMBARQUE_VOL_REST("Exportação do Volume da Autorização de embarque - Via Rest Cabeçalho/Detalhe/Volumes")
Request
{
"chavelayout": "vi_int_envio_confirEmbarqueCab",
"cabecalho": [
{
"cnpj_armazem": "",
"cnpj_depositante": "",
"cnpj_remetente": "",
"cnpj_destinatario": "",
"cnpj_transportadora": "",
"numeronf": "",
"serienf": "",
"numpedido": "",
"dataliberacao": "",
"idcarga": "",
"numcoleta": "",
"qtdevolume": "",
"pesovolume": "",
"rgmotorista": "",
"motorista": "",
"placa": "",
"dataembarque": "",
"embarqueliberado": "",
"finalizado": "",
"f": "",
"chaveacessonfe": "",
"itens": [
{
"cnpj_armazem": "",
"cnpj_depositante": "",
"cnpj_remetente": "",
"cnpj_destinatario": "",
"cnpj_transportadora": "",
"numeronf": "",
"serienf": "",
"numpedido": "",
"idcarga": "",
"dataliberacao": "",
"numcoleta": ",
"codproduto": "",
"codbarras": "",
"qtde": "",
"informacaoespecifica": "",
"f": "",
"codigoproduto": ""
}
],
"volumes": [
{
"nrovolume": "",
"qtdeprodutovolume": "",
"codigocaixavolume": "",
"pesocaixavolume": "",
"codbarravolume": "",
"pesovolume": "",
"data": "",
"altura": "",
"largura": "",
"comprimento": "",
"dimensoescaixavolume": "",
"codrastreio": ""
}
]
}
]
}
| Campo | Formato | Obrigatoriedade | Tamanho | Mascara | Descricão |
|---|---|---|---|---|---|
| CNPJ_ARMAZEM | 20 | 99.999.999/9999-99 | CNPJ do Armazem | ||
| CNPJ_DEPOSITANTE | 20 | 99.999.999/9999-99 | CNPJ do Depositante | ||
| CNPJ_REMETENTE | 20 | 99.999.999/9999-99 | CNPJ do Emitente | ||
| CNPJ_DESTINATARIO | 20 | CPF ou CNPJ do Destinatario | |||
| CNPJ_TRANSPORTADORA | 20 | CPF ou CNPJ da Transportadora | |||
| NUMERONF | 20 | 99999999999999999999 | Numero da Nota Fiscal | ||
| SERIENF | 20 | Serie da Nota Fiscal | |||
| NUMPEDIDO | 20 | 99999999999999999999 | Numero do Pedido | ||
| DATALIBERACAO | 10 | DD/MM/AAAA | Data Liberacão do Embarque | ||
| IDCARGA | 12 | 999999999999 | Id da Carga | ||
| NUMCOLETA | 20 | Numero da Coleta na Transportadora | |||
| QTDEVOLUME | 12 | 999999999999 | Qtde Volumes | ||
| PESOVOLUME | 12 | 999999999999 | Peso Bruto dos Volumes | ||
| RGMOTORISTA | 20 | RG do Motorista | |||
| MOTORISTA | 80 | Nome do Motorista | |||
| PLACA | 10 | Placa do Veiculo | |||
| DATAEMBARQUE | 10 | DD/MM/AAAA | Data do Embarque | ||
| EMBARQUELIBERADO | 1 | (S)im / (N)ão | Embarque Liberado | ||
| FINALIZADO | 1 | (S)im / (N)ão | Embarque Finalizado | ||
| f | 1 | * | Campo não devera ser utilizado como final de registro. NUNCA devera ser movido. | ||
| CHAVEACESSONFE | 44 | Indica a chave de acesso da NFe |
| Campo | Formato | Obrigatoriedade | Tamanho | Mascara | Descricão |
|---|---|---|---|---|---|
| cnpj_armazem | Texto | 20 | 99.999.999/9999-99 | CNPJ do Armazem | |
| cnpj_depositante | Texto | 20 | 99.999.999/9999-99 | CNPJ do depositante | |
| cnpj_remetente | Texto | 20 | 99.999.999/9999-99 | CNPJ do Emitente | |
| cnpj_destinatario | Texto | 20 | CNPJ ou CPF do destinatario | ||
| cnpj_transportadora | Texto | 20 | CNPJ ou CPF da transportadora | ||
| numeronf | Numero | 20 | 99999999999999999999 | Numero da nota fiscal | |
| serienf | Texto | 20 | Serie da Nota Fiscal | ||
| numpedido | Texto | 20 | 99999999999999999999 | Numero do pedido | |
| idcarga | Numero | 12 | 999999999999 | Id da carga | |
| dataliberacao | Data | 10 | DD/MM/AAAA | Data embarque liberado | |
| numcoleta | Texto | 20 | Numero da Coleta na Transportadora | ||
| codproduto | Texto | 20 | Codigo do produto | ||
| codbarras | Texto | 40 | Codigo de Barras Unitario do Produto | ||
| qtde | Numero | 20 | 999999999999 | Quantidade | |
| informacaoespecifica | Texto | 500 | Informac?es Especificas do Produto (As informac?es especificas serão gravadas separadas por virgula) | ||
| f | Texto | 1 | * | Campo não devera ser utilizado como final de registro. NUNCA devera ser movido. | |
| codigoproduto | Texto | 60 | Codigo Produto com maior precisão |
| Campo | Formato | Obrigatoriedade | Tamanho | Mascara | Descricão |
|---|---|---|---|---|---|
| NROVOLUME | 20 | Indica o numero do volume | |||
| QTDEPRODUTOVOLUME | 20 | Indica a quantidade de produto no volume (SKU) | |||
| CODIGOCAIXAVOLUME | 32 | Indica o codigo cadastrado no WMS da caixa do volume | |||
| PESOCAIXAVOLUME | 20 | Indidca o peso da caixa do volume em kg | |||
| CODBARRAVOLUME | 32 | Indica o codigo de barras cadastrado no WMS da caixa do volume | |||
| PESOVOLUME | 20 | 99999999999999999999 | Indica o peso do volume em kg | ||
| DATA | 19 | DD/MM/AAAA hh24:MI:SS | Indica a data de insercão | ||
| ALTURA | 20 | 99999999999999999999 | Indica a altura do volume em mm. | ||
| LARGURA | 20 | 99999999999999999999 | Indica a largura do volume em mm. | ||
| COMPRIMENTO | 20 | 99999999999999999999 | Indica a comprimento do volume em mm. | ||
| DIMENSOESCAIXAVOLUME | 20 | Indica a cubagem da caixa do volume em m3 | |||
| CODRASTREIO | 32 | Indica o codigo de rastreio do volume |
Fluxos
Para que o sistema associe corretamente um pedido ou nota fiscal a um dos códigos de rastreamento gerados, é essencial que os campos sejam preenchidos corretamente.
Na integração de Pedido, faz necessário o preenchimento dos campos:
- codigo_servicotransp: preencha com o valor cadastrado no campo Código do Serviço, localizado em Cadastro > Depositante > Transp. e Rastreamento > Serviços da Transportadora. Este campo define o serviço de transporte associado ao pedido.
- Roteiro: informe o roteiro de entrega relacionado ao pedido ou nota.
Acesse Nota Fiscal > Controle Nota Fiscal > guia Transportadora
- Para o cadastro manual de pedidos ou nota fiscal, faz necessário o preenchimento dos campos:
- Transportadora: selecione a transportadora que trabalhe com Serviço de Transporte.
- Serviço de Transportadora: selecione o serviço de transporte.
- Durante a conferência (para os fluxos como Packing, Checkout Express ou Colmeia), o sistema adota o seguinte comportamento de impressão de etiquetas conforme o status do pedido:
- Pedido não faturado: a etiqueta de volume é impressa conforme o modelo configurado no campo Modelo de Etiqueta, localizado no menu Cadastro > Depositante > Transp. e Rastreamento > Serviços da Transportadora.
- Pedido faturado: a etiqueta de volume DANFE Simplificado é impressa conforme o modelo configurado no campo Modelo Etiqueta DANFE, localizado no menu Cadastro > Depositante > Transp. e Rastreamento > Serviços da Transportadora.
Acesse Movimentação > Saída > Gerenciador de Volume.
- Para reimpressão de etiquetas de volume e o DANFE Simplificado, utilize o menu Impressos:
- Imprimir Etiqueta (Conf.Onda/Rastreabilidade): realiza a impressão da etiqueta conforme o modelo configurado no campo Modelo de Etiqueta, localizado no menu Cadastro > Depositante > Transp. e Rastreamento > Serviços da Transportadora.
- Imprimir Etiqueta Danfe Simplificado (Conf.Onda/Rastreabilidade): realiza a impressão da etiqueta DANFE, conforme o modelo configurado no campo Modelo Etiqueta DANFE, localizado no menu Cadastro > Depositante > Transp. e Rastreamento > Serviços da Transportadora. Esta etiqueta fica disponível somente quando o pedido está faturado.
Acompanhamentos
Para acompanhar os códigos de rastreio gerados e utilizados, acesse a tela Código de Rastreio, no menu Movimentação > Saída > Código de Rastreio. Nesta tela, é possível listar os códigos de rastreio conforme seu status:
- Disponível: códigos de rastreio que ainda não foram associados a pedidos ou volumes.
- Utilizado: códigos de rastreio que já foram associados a pedidos ou volumes.
- Cancelado: códigos que estavam associados a um volume, mas que foram cancelados posteriormente, seja por cancelamento do pedido ou do volume.
- Todos: exibe todos os códigos de rastreio gerados pelo sistema, independentemente do status.
Informações extras
Para calcular o dígito verificador, o sistema utiliza a informação gerada a partir dos campos Início do Intervalo e Fim do Intervalo, no cadastro do Código de Rastreabilidade.
Modelo do código de rastreio padrão AWB

Após informação do range coletado, deve:
- Cada número está disposto em uma posição, iniciando a contagem com 0 (zero);
- Calcular o fator para multiplicação de cada número:
- Para posições ímpares, o fator será 2;
- Para posições pares, o fator será 1.
- Multiplicar o fator obtido acima pelo número do sequencial;
- Os resultados acima deverão ser concatenados aos demais, gerando um novo número;
- Somar os elementos do número obtido acima;
- Calcular o resto da divisão do número obtido por 10;
- Subtrair de 10 o resultado obtido;
- Caso o resultado seja 10, o dígito verificador será 0.
Exemplo para o número 90000015
| Sequencial | 9 | 0 | 0 | 0 | 0 | 0 | 1 | 5 |
| 1. Posição | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
| 2. Fator | 1 | 2 | 1 | 2 | 1 | 2 | 1 | 2 |
| 3. Sequencial * Fator | 9 | 0 | 0 | 0 | 0 | 0 | 1 | 10 |
| 4. Concatenar Números | 900000110 | |||||||
| 5. Soma dos itens 4 | 9+0+0+0+0+0+1+1+0 = 11 | |||||||
| 6. Resto da divisão | 11 % 10 = 1 | |||||||
| 7. Subtração | 10 – 1 = 9 | |||||||
Assim, o dígito verificador é 9.
Segue outro exemplo, número 00000007
| Sequencial | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 7 |
| 1. Posição | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
| 2. Fator | 1 | 2 | 1 | 2 | 1 | 2 | 1 | 2 |
| 3. Sequencial * Fator | 9 | 0 | 0 | 0 | 0 | 0 | 0 | 14 |
| 4. Concatenar Números | 900000014 | |||||||
| 5. Soma dos itens 4 | 0+0+0+0+0+0+0+1+4 = 5 | |||||||
| 6. Resto da divisão | 5 % 10 = 5 | |||||||
| 7. Subtração | 10 – 5 = 5 | |||||||
Assim, o dígito verificador é 5
Com a finalização das parametrizações recomendadas, o sistema passa a gerar o código de rastreabilidade no padrão AWB Total Express, associando-o automaticamente ao pedido quando o serviço de transportadora é indicado no cadastro do pedido.
Durante a geração de volume, a etiqueta do volume é impressa com o novo código de rastreio. As etiquetas agora incluem o padrão AWB impresso tanto na Etiqueta de Volume quanto no DANFE Simplificado, proporcionando informações de rastreamento detalhadas para o cliente, a expedição e a transportadora.
![]() | Veja também: |
English
Español

English
Español


