English
Español
Interfaces
As interfaces referem-se aos meios de comunicação e troca de informações entre o sistema , os sistemas dos transportadores e os ERPs corporativos.
Mais especificamente, elas dizem respeito aos arquivos EDI (Electronic Data Interchange) usados para integrar documentos importantes, como:
- Documentos enviados pelos transportadores: como os Conhecimentos de Transporte Eletrônico (CT-e), que são usados para escrituração fiscal e contabilização nos ERPs.
- Documentos enviados aos transportadores: como Notas Fiscais (NF-e) e pré-faturas para conferência de frete.
As interfaces são mecanismos de integração que garantem que os dados fluam corretamente entre diferentes sistemas (, ERPs, transportadoras), evitando erros manuais e garantindo conformidade fiscal. Sendo assim elas facilitam a troca automatizada de dados entre o e os demais sistemas envolvidos na gestão de transporte e escrituração fiscal, garantindo eficiência operacional e redução de erros.
As principais informações envolvidas são:
- Notas Fiscais (NF-e) → Compartilhadas com transportadoras para garantir que os fretes sejam calculados corretamente.
- Conhecimentos de Transporte Eletrônico (CT-e) → Documentos emitidos pelas transportadoras e integrados ao ERP para escrituração fiscal.
- Arquivos EDI → São os arquivos-padrão usados para a troca dessas informações, permitindo a comunicação entre os sistemas.
- Pré-faturas e faturas de frete → Documentos enviados aos transportadores para validação e posterior pagamento.
- Dados de frete para contabilização → Integração com o ERP para lançamento de custos e obrigações fiscais.
Essas interfaces garantem que os dados fluam corretamente entre os sistemas envolvidos no transporte e na gestão de fretes, automatizando processos e evitando a necessidade de lançamentos manuais.
Interface de Importação de XML de CT-e Simplificado
O 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 . Siga os passos abaixo:
- Acessar Gestão Logística > Ferramentas > Integrador > Interface de Transferência de Dados (P0039);
- 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; - Para selecionar a interface INTNCXMLCTESIMP usar duplo clique no nome da interface;
- Na coluna Tipo Arquivo escolher o tipo de arquivo XML;
- Clicar no botão
para executar - Se já houver uma interface desse tipo criada, alterar o número da versão para uma diferente das existentes.
- Aguarde alguns minutos para que a interface seja criada.
Após a criação da interface, o 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:
- Acessar Gestão Logística > Ferramentas > Transferência de Dados > Importação de Dados (P0103).
- Selecione o(s) arquivo(s) XML desejado(s).
- 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
Os seguintes campos (tags XML) são reconhecidos pelo 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 |
| 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 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 |
English
Español
