Integração TMS

Anterior
Próximo
Imprimir

Integração TMS

 Através da configuração de integração TMS é possível parametrizar os dados que serão enviados para o TMS, bem como o domínio e o Xid correspondente. É necessário que todas as informações enviadas ao TMS estejam devidamente parametrizadas, conforme a utilização de cada ambiente.

 

Configurações Gerais > Integração TMS

 

Tipo: Deve ser preenchido conforme uma das opções:

Custo Acessório: Define as opções de custos gerados pelo nddFrete para integrar com o TMS, os quais são integrados na estrutura ShipmentCost;

Status Emissão: Apresenta os status que serão integrados com o TMS no refnum CLL_STATUS_EMISSAO, conforme o processamento do shipment ocorre. Esta informação é integrada no nível InternalShipmentStatus

Qualificador: As informações complementares de cada processo são enviadas ao TMS através de refnums específicos, onde também devem ser configuradas, conforme as opções dispostas no campo elemento;

Observações (Remark): As observações são utilizadas para integrar comentários, onde podem ser utilizados por quaisquer processos dentro do TMS, ou até mesmo integrado com ERP, quando não houver refnum específico para isso. Para esta versão o remark é utilizado para integrar a mensagem legal.

Qualificador: Os qualificadores são listados conforme o preenchimento do campo Tipo.


CustoAcessorio

AD_VALOREM: Valor encontrado para o seguro Ad Valorem conforme o valor das Notas e a alíquota informada no embarque. Integrado na estrutura ShipmentCost;

GRIS: Valor encontrado para o seguro GRIS conforme o valor das Notas e a alíquota informada no embarque. Integrado na estrutura ShipmentCost;

PEDAGIO: O valor do pedágio é integrado com o TMS na estrtura de ShipmentCost, assim que o valor for enviado à ANTT e feito a reserva para que o cartão do motorista possa ser carregado.

 

StatusEmissao

EMISSAO_INICADA: Informa ao TMS que o nddFrete utilizará as informações recebidas no shipment até o momento para seus processos de geração de pré-documentos e saldo e emissão de vale-pedágio, RPA e CIOT. A partir do momento que o TMS recebe este status para o shipment, o mesmo não deve mais ser atualizado e enviado ao nddFrete, com exceção de custos acessórios não planejados.

DADOS_INCONSISTENTES: Será integrado esse status quando houver falha na emissão do vale-pedágio ou CIOT, pois irá destravar o TMS e permitir que o shipment seja atualizado, com isso, é possível enviar o shipment novamente ao nddFrete com a respectiva correção;

DPS_EMITIDO: O TMS será notificado com esse status quando o CIOT for emitido;

DADOS_DPS_RECEBIDO: Este status informa ao TMS que o CT-e foi recebido, conciliado e está disponível para o pagamento;

DADOS_DPS_FINALIZADO: Este status informa ao TMS que todos os documentos foram recebidos, e os valores dos custos planejados foram contemplados.

DADOS_DPS_ACESS_FINALIZADO:Este status informa ao TMS que todos os documentos foram recebidos, e os valores dos custos não planejados foram contemplados.

CANCELADO: Esta informação é enviada quando o embarque é cancelado.


Qualificadores

CLL_CTE_CHAVE_C: Chave do CT-e complementar, integrada na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_CHAVE_N: Chave do CT-e normal, integrada na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_CHAVE_S: Chave do CT-e de substituição, integrada na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_DATA_C: Data de emissão do CT-e complementar, integrada na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_DATA_N: Data de emissão do CT-e normal, integrada na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_DATA_S: Data de emissão do CT-e de substituição, integrada na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_NUMERO_C: Número do CT-e complementar, integrado na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_NUMERO_N: Número do CT-e normal, integrado na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_NUMERO_S: Número do CT-e de substituição, integrado na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_PROTOCOLO_C: Protocolo de autorização do CT-e complementar, integrado na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_PROTOCOLO_N: Protocolo de autorização do CT-e normal, integrado na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_PROTOCOLO_S: Protocolo de autorização do CT-e de substituição, integrado na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_SERIE_C: Série do CT-e complementar, integrada na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_SERIE_N: Série do CT-e normal, integrada na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CTE_SERIE_S: Série do CT-e de substituição, integrada na estrutura de ShipmentStop, após o pagamento do documento;

CLL_RPA_NUMERO: Número da RPA gerada, integrado na estrutura de ShipmentStop, assim que gerada

CLL_CIOT_NUMERO: Número do CIOT, integrado na estrutura de ShipmentStop, após o pagamento do documento;

CLL_CIOT_PROTOCOLO: Portocolo de autorização do CIOT, integrado na estrutura de ShipmentStop, após o pagamento do documento;

CLL_NFE_CHAVE: Chave de acesso da NF-e vinculada com a Ordem, integrada na estrutura de ReleaseRefnum ao realizar o vínculo;

CLL_PRE_ICMS: Valor encontrado para o ICMS no primeiro cálculo realizado, assim que recebido o shipment. Integrado por Relese no ReleaseRefnum;

CLL_VALOR_BASE: Valor alocado para a Ordem e utilizado como Base de Cálculo para o ICMS, integrado na estrutura de ReleaseRefnum;

CLL_VALOR_ALIQUOTA_SERVICO_TRANSP: Alíquota aplicada à Base de Cálculo para encontrar o pré-ICMS, integrada na estrutura de ReleseRefnum;

CLL_VALOR_SERVICO_TRANSP: Valor da Ordem mais o ICMS quando informado no Shipment que o imposto é somado (CLL_IMPOSTO_SOMADO = S). Também é integrado na estrutura de ReleaseRefnum;

CLL_STATUS_DO: Status referente ao cálculo do pré-ICMS, podendo ser COMPLETO ou NAO_VALIDADO_ERRO, conforme o resultado do processamento. Integrado juntamente com o valor do pré-ICMS na estrutura de ReleaseStatus.


Observacao

CLL_MSG_LEGAL: O envio dessa informação ao TMS ocorre por Ordem, juntamente com os valores encontrados para o pré-ICMS. É utilizada para informar a mensagem legal obrigatória na Nota Fiscal conforme a tributação utilizada em cada operação portanto, após a integração com o TMS, é necessário que essa informação seja também integrada com o ERP.

Domínio: Domínio configurado no TMS para cada um dos elementos configurados. Em caso de domínio com subdomínio, deve ser configurado por completo no seguinte formato: domínio/subdomínio, por exemplo: AMBDEV/DEV1;

XID: Esta informação é específica para os custos acessórios onde deve ser informado ao nddFrete a relação entre os custos de AD_VALOREM, GRIS e PEDAGIO que serão integrados com o respectivo código de identificação no TMS.