Interfaces

O TMS Embarcador | Senior GKO Frete permite a integração com CT-es Simplificados através da importação de XMLs. Essa funcionalidade possibilita a leitura e registro automático de informações provenientes dos documentos fiscais eletrônicos, agilizando a auditoria e conferência de fretes.

Para importar XMLs de CT-e Simplificado, é necessário primeiro criar uma interface de importação no TMS Embarcador | Senior GKO Frete. Siga os passos abaixo:

1. Acessar Gestão Logística > Ferramentas > Integrador > Interface de Transferência de Dados (P0039);
2. Clicar no botão para criação de estrutura do cadastro de interface, a tela Criação de estrutura do cadastro de interface (P0221) será aberta;
3. Para selecionar a interface INTNCXMLCTESIMP usar duplo clique no nome da interface;
4. Na coluna Tipo Arquivo escolher o tipo de arquivo XML;
5. Clicar no botão para executar
6. Se já houver uma interface desse tipo criada, alterar o número da versão para uma diferente das existentes.
7. Aguarde alguns minutos para que a interface seja criada.

Após a criação da interface, o TMS Embarcador | Senior GKO Frete estará pronto para importar os XMLs de CT-e Simplificado. Caso necessário, ajustes podem ser feitos no cadastro da interface.

Importação de XMLs de CT-e Simplificado

Com a interface criada, a importação dos XMLs pode ser realizada seguindo os passos abaixo:

1. Acessar Gestão Logística > Ferramentas > Transferência de Dados > Importação de Dados (P0103).
2. Selecione o(s) arquivo(s) XML desejado(s).
3. Clique no botão para executar

O procedimento de importação dos CT-es Simplificados é similar ao dos CT-es convencionais.

Consulta de CT-es Importados

Os CT-es importados podem ser consultados acessando:

• Gestão Logística > Atividades > Auditoria de Fretes > Documentos Pagamento > Conhecimento (P0244);
• Na aba CT-e, o campo Tipo CT-e indicará Simplificado para os documentos importados nesse formato.

Campos XML no TMS Embarcador | Senior GKO Frete

Os seguintes campos (tags XML) são reconhecidos pelo TMS Embarcador | Senior GKO Frete na importação de CT-es Simplificados. Nem todos os campos são obrigatórios, pois a interface os marcará conforme a necessidade:

Tag XML	Descrição
InfCte	informações do CT-e
versao	Versão do leiaute
Id	Identificador da tag a ser assinada
ide	identificação do CT-e
cUF	Código da UF do emitente
cCT	Código numérico da Chave de Acesso
CFOP	Código Fiscal de Operações
natOp	Natureza da Operação
mod	Modelo do documento fiscal
serie	Série do CT-e
nCT	Número do CT-e
dhEmi	Data e hora de emissão
tpImp	Formato de impressão do DACTE
tpEmis	Forma de emissão do CT-e
cDV	Dígito verificador da chave de acesso
tpAmb	Tipo do ambiente
tpCTe	Tipo do CT-e
procEmi	Identificador do processo de emissão
verProc	Versão do processo de emissão
cMunEnv	Código do Município de envio do CT-e (de onde o documento foi transmitido)
xMunEnv	Nome do Município de envio do CT-e (de onde o documento foi transmitido)
UFEnv	Sigla da UF de envio do CT-e (de onde o documento foi transmitido)
modal	Modal
tpServ	Tipo do Serviço
UFIni	UF do início da prestação
UFFim	UF do término da prestação
retira	Indicador se o Recebedor retira no Aeroporto, Filial, Porto ou Estação de Destino
xDetRetira	Detalhes do retira
compl	Dados complementares do CT-e para fins operacionais ou comerciais
xCaracAd	Característica adicional do transporte
xCaracSer	Característica adicional do serviço
fluxo	Previsão do fluxo de Carga
xOrig	- Sigla ou código interno da Filial/Porto/Estação/ Aeroporto de Origem
ObsCont	Campo de uso livre do contribuinte
xCampo	Identificação do campo
xTexto	Conteúdo do campo
ObsFisco	Campo de uso livre do contribuinte
xCampo	Identificação do campo
xTexto	Conteúdo do campo
emit	Identificação do emitente do CT-e
CNPJ	CNPJ do emitente
CPF	CPF do emitente
IE	Inscrição estadual do emitente
IEST	Inscrição estadual do substituto tributário
xNome	Razão social ou Nome do emitente
xFant	Nome fantasia
CRT	Código do regime tributário
enderEmit	Endereço do emitente
xLgr	Logradouro
nro	número
xCpl	complemento
xBairro	bairro
cMun	código do município (tabela IBGE)
xMun	Nome do município
CEP	CEP
UF	Sigla da UF
fone	telefone
toma	Identificação do tomador do serviço no CT-e
toma	tomador do serviço
indIEToma	Indicador do papel do tomador na prestação do serviço: 1 – Contribuinte ICMS; 2 – Contribuinte isento de inscrição; 9 – Não Contribuinte
CNPJ	Número do CNPJ
CPF	Número do CPF
IE	Inscrição estadual
xNome	Razão Social ou Nome
ISUF	Inscrição na SUFRAMA
fone	Telefone
email	endereço de email
enderToma	Dados do endereço
xLgr	Logradouro
nro	Número
xCpl	Complemento
xBairro	Bairro
cMun	Código do município (tabela IBGE)
xMun	Nome do município
CEP	CEP
UF	Sigla da UF
cPais	Código do país
xPais	Nome do país
infCarga	Informações da Carga do CT-e
vCarga	Valor total da carga
proPred	Produto predominante
xOutCat	Outras características da carga
infQ	Informações de quantidades da Carga do CT-e
cUnid	Código da Unidade de Medida
tpMed	Tipo da medida
qCarga	Quantidade
vCargaAverb	Valor da Carga para efeito de averbação
det	Detalhamento das entregas / prestações do CT-e Simplificado
nItem	Número identificador do item agrupador da prestação
cMunIni	Código do Município de início da prestação
xMunIni	Nome do Município do início da prestação
cMunFim	Código do Município de término da prestação
xMunFim	Nome do Município do término da prestação
vPrest	Valor da Prestação do Serviço
vRec	Valor a receber
comp	Componentes do Valor da Prestação
xNome	Nome do componente
vComp	valor do componente
infNfe	Informações das NF-e
chNFe	Chave de acesso da NF-e
pin	PIN SUFRAMA
dprev	Data prevista de entrega
infModal	Informações do modal
versaomodal	Versão do leiaute específico para o Modal
xs:any	XML do modal, Insira neste local o XML específico do modal (rodoviário, aéreo, ferroviário, aquaviário ou dutoviário).
Imp	Informações relativas aos Impostos
ICMS	Informações relativas ao ICMS
ICMS00	Prestação sujeito à tributação normal do ICMS
CST	Classificação Tributária do Serviço
vBC	Valor da base de cálculo do ICMS
pICMS	Alíquota do ICMS
vICMS	Valor do ICMS
ICMS20	Prestação sujeito à tributação com redução de BC do ICMS
CST	Classificação Tributária do Serviço
pRedBC	Percentual de redução da base de cálculo
vBC	Valor da base de cálculo do ICMS
pICMS	Alíquota do ICSM
vICMS	Valor do ICMS
vICMSDeson	Valor do ICMS de desoneração
cBenef	Código de Benefício Fiscal na UF
ICMS45	ICMS Isento, não tributado ou diferido
CST	Classificação Tributária do Serviço
vICMSDeson	Valor do ICMS de desoneração
cBenef	Código de benefício fiscal na UF
ICMS60	Tributação pelo ICMS60 - ICMS cobrado por substituição tributária. Responsabilidade do recolhimento do ICMS atribuído ao tomador ou 3º por ST
CST	Classificação tributária do serviço
vBCSTRet	Valor da BC do ICMS ST retido
vICMSSTRet	Valor do ICMS ST retido
pICMSSTRet	Alíquota do ICSM
vCred	Valor do crédito outorgado/presumido
vICMSDeson	Valor do ICMS de desoneração
cBenef	Código de benefício fiscal na UF
ICMS90	ICMS Outros
CST	Classificação tributária do serviço
pRedBC	Percentual de redução da base de cálculo
vBC	Valor da base de cálculo do ICMS
pICMS	Alíquota do ICMS
vICMS	Valor do ICMS
vCred	Valor do crédito outorgado/presumido
vICMSDeson	Valor do ICMS de desoneração
cBenef	Código de Benefício Fiscal na UF
ICMSOutraUF	ICMS devido à UF de origem da prestação, quando diferente da UF do emitente
CST	Classificação Tributária do Serviço
pRedBCOutraUF	Percentual de redução da base de cálculo
vBCOutraUF	Valor da BC do ICMS
pICMSOutraUF	Alíquota do ICMS
vICMSOutraUF	Valor do ICMS devido outra UF
vICMSDeson	Valor do ICMS de desoneração
cBenef	Código de Benefício Fiscal na UF
ICMSSN	Simples Nacional
CST	Classificação Tributária do Serviço
indSN	Indica se o contribuinte é Simples Nacional 1=Sim
ICMSUFFim	Informações do ICMS de partilha com a UF de término do serviço de transporte na operação interestadual
vBCUFFim	Valor da BC do ICMS na UF de término da prestação do serviço de transporte
pFCPUFFim	Percentual do ICMS relativo ao Fundo de Combate à pobreza (FCP) na UF de término da prestação do serviço de transporte
pICMSUFFim	Alíquota interna da UF de término da prestação do serviço de transporte
pICMSInter	Alíquota interestadual das UF envolvidas
vFCPUFFim	Valor do ICMS relativo ao Fundo de Combate á Pobreza (FCP) da UF de término da prestação
vICMSSUFFim	Valor do ICMS de partilha para a UF de término da prestação do serviço de transporte
vICMSUFIni	Valor do ICMS de partilha para a UF de início da prestação do serviço de transporte
total	Valores Totais do CT-e
vTPrest	Valor Total da Prestação do Serviço
vTRec	Valor total a Receber
autXML	Autorizados para download do XML do DF-e
CNPJ	CNPJ do autorizado
CPF	CPF do autorizado
infRespTec	Informações do Responsável Técnico pela emissão do DF-e
CNPJ	CNPJ da pessoa jurídica responsável técnica pelo sistema utilizado na emissão do documento fiscal eletrônico
xContato	Nome da pessoa a ser contatada
email	Email da pessoa jurídica a ser contatada
fone	Telefone da pessoa jurídica a ser contatada
idCSRT	Identificador do código de segurança do responsável técnico
hashCSRT	Hash do token do código de segurança do responsável técnico
infSolicNFF	Grupo de informações do pedido de emissão da Nota Fiscal Fácil
xSolic	Solicitação do pedido de emissão da NFF
infPAA	Grupo de Informação do Provedor de Assinatura e Autorização
CNPJPAA	CNPJ do Provedor de Assinatura e Autorização
PAASignature	Assinatura RSA do Emitente para DFe gerados por PAA
SignatureValue	Assinatura digital padrão RSA
RSAKeyValue	Chave Pública no padrão XML RSA Key
Modulus	-
Exponent	-
infCTeSupl	Informações suplementares do CT-e
qrCodCTe	Texto com o QR-Code impresso no DACTE
protCTe	Resposta processamento
tpAmb	Identificação do Ambiente
verAplic	Versão do Aplicativo que recebeu o CT-e
chcte	Chave de acesso do CT-e
dhRecbto	Data e Hora do Processamento
nProt	Número do protocolo de autorização do CT-e
cStat	Código do status da resposta para o CT-e
xMotivo	Descrição literal do status da resposta para o CT-e

Visão Geral e Finalidade

A mensagem DOCCOB - Documento de Cobrança no padrão TIVIT (Versão 5.0)é um arquivo eletrônico gerado pelas transportadoras para transmissão às empresas clientes (contratantes do frete ou embarcadoras). O objetivo principal é fornecer uma cópia digital da Nota Fiscal/Fatura de serviço emitida, automatizando a cobrança dos serviços de transporte de carga prestados.

Essa cobrança deve respeitar os critérios acordados entre as partes, como periodicidade (semanal, quinzenal, etc.) e as regras de negócio sobre o que deve ser faturado (entregas completas ou parciais).

Regras Gerais de Formatação do Arquivo

Para garantir a integridade da importação no sistema, o arquivo deve respeitar as seguintes normas técnicas de formatação:

• Tamanho dos Registros: Todos os registros que compõem o arquivo possuem tamanho fixo de 280 posições.
• Alinhamento Alfanumérico (A): O conteúdo deve ser alinhado à esquerda e completado com espaços em branco à direita até atingir o tamanho máximo do campo.
• Alinhamento Numérico (N): O conteúdo deve ser alinhado à direita e completado com zeros à esquerda até atingir o tamanho máximo do campo.
• Representação de Valores: Campos de valor utilizam a notação 9,2, indicando o número de casas inteiras e decimais. Não há representação explícita de ponto ou vírgula decimal no arquivo (exemplo: um valor de 150,00 em um campo N 13,2 será preenchido como 0000000015000).
• Campos Vazios: Quando não houver dados para preenchimento, campos numéricos devem ser preenchidos com zeros e campos alfanuméricos com espaços em branco.
• Status de Preenchimento:
  • M (Mandatório): O campo deve ser obrigatoriamente preenchido.
  • C (Condicional): O campo pode ou não ser preenchido, dependendo da situação ou da disponibilidade do dado.

Estrutura e Hierarquia de Registros

O arquivo DOCCOB Tivit (Versão 5.0) é estruturado em uma hierarquia de níveis, onde cada registro desempenha uma função específica na cadeia de cobrança. A tabela abaixo detalha a sequência obrigatória e a frequência de cada registro: