Pesquisar na Comunidade

Olá comunidade ACBr, Foram implementadas as alterações no CIOT para o eFrete, referentes à versão 8 disponibilizada pela integradora. Tivemos relatos de problemas de autenticação, antes e depois das implementações, e gostaríamos do auxílio da comunidade para saber se o serviço está funcionando em Produção e Homologação.

Olá comunidade ACBr, Este tópico tem o objetivo de auxiliar quem estiver com problemas nas integrações com o eFrete para geração do CIOT e demais métodos da integradora. Foram mapeados erros e documentadas dicas para solução. 1. Autenticação 1.1. Geral 1.1.1. Integrador não cadastrado * Integrador.Nao.Cadastrado * O HASH fornecido pelo eFrete não foi preenchido 1.1.2. Integrador de software não homologado para esta solicitação. * Preenchido HASH inválido 1.2. Método de Login 1.2.1. O retorno do método não gera token, mas não gera rejeição acusando o problema * Verificar se está preenchendo o Hash válido, mas usuário e/ou senha inválidos * Se for configurado certificado digital, este método não deve ser utizado, para geração de token deixar os dados de certificado sem preenchimento 1.2.2. Erro adicionando operação de transporte: Usuário não logado * Usuario.Nao.Logado * Consumo de qualquer método com um token antigo/encerrado 2. Adicionar Operação 2.1. Operação de transporte já cadastrada * IdCliente.Existente * Já existe um CIOT cadastrado, necessário encerrar a operação existente 2.2. '' não é um valor válido para TipoIndicadorPagamentoEnum * Nos dados de pagamentos, preencher a chave IndicadorPagamento com AVista ou APrazo 2.3. Código NCM deve se r entre 1 e 9999 * CodigoNCM.Fora.Da.Faixa * Preencher a chave CodigoNCMNaturezaCarga com o devido valor entre 1 e 9999 * Verificados locais informando que são os 4 primeiros dígitos do NCM do produto de maior valor da carga 2.4. Foi identificado pelo sistema diferentes valores para o campo TipoPagamento, verifique se foi informado o mesmo valor para o campo TipoPagamento na raiz da chamada, na raiz de Viagem e de Pagamento. * Caso não enviado algum campo o sistema assumirá a primeira posição dos itens que também pode não coincidir com o valor desejado. * Regra.Negocio * Preencher no cadastro do CIOT, Viagem e Pagamento, o mesmo valor nas chaves TipoPagamento > 1-TransferenciaBancaria, 2-eFRETE, 3-Parceiro, 4-Outros, 5-DepositoAgendado * Exemplo: TipoPagamento=1 2.5. Data de início da viagem deve ser maior ou igual à data atual * Data.Inicio.Viagem.Anterior.Ao.Dia.Atual * Preencher o valor correto na tag DataInicioViagem 2.6. Código do tipo de carga inválido. Deve ser maior que 0 e menor ou igual a 12 * Codigo.Tipo.Carga.Fora.Da.Faixa * Preencher a chave CodigoTipoCarga com valor entre 1 e 12: 0-tpNaoAplicavel, 1-tpGranelsolido, 2-tpGranelLiquido, 3-tpFrigorificada, 4-tpConteinerizada, 5-tpCargaGeral, 6-tpNeogranel, 7-tpPerigosaGranelSolido, 8-tpPerigosaGranelLiquido, 9-tpPerigosaCargaFrigorificada, 10-tpPerigosaConteinerizada, 11-tpPerigosaCargaGeral, 12-tpGranelPressurizada * Exemplo: CodigoTipoCarga=5 2.7. Erro validando Destinatário: Documento inválido(a) * Regra.Negocio * O mesmo ocorre para a seção Contratante * Preencher a chave CpfOuCnpj da respectiva seção com um documento válido 2.8. Erro validando Destinatário: Nome é obrigatório * Regra.Negocio * O mesmo ocorre para a seção Contratante * Preencher a chave NomeOuRazaoSocial da respectiva seção 2.9. Destinatario. Erro validando Destinatário: Rua não pode ser em branco - O mesmo para os demais campos de endereço * Regra.Negocio * O mesmo ocorre para a seção Contratante * Preencher as chaves de endereço na respectiva seção Bairro= Rua= Numero= Complemento= CEP= CodigoMunicipio= 2.10. Algum dos envolvidos na operação de transporte deve ser informado como o responsável pelo pagamento * Deve.Haver.Responsavel.Pelo.Pagamento * Preencher a chave ResponsavelPeloPagamento=1 em uma das seções: Contratante, SubContratante, Consignatario, TomadorServico, Remetente, ProprietarioCarga 2.11. Os dados bancários não foram informados, não são de uma conta válida ou estão em formato errado. [Formato Agencia: Numero-Digito (Se houver). Conta: Numero-Digito] * Conta.Bancaria.Invalida * Preencher as chaves a seguir nas seções Viagem e/ou Pagamento InstituicaoBancaria= Agencia= Conta= 2.12. Motorista não encontrado * Motorista.Nao.Encontrado * Preencher as chaves da seção Motorista, com valores válidos CpfOuCnpj= CNH= 2.13. Não foi encontrado nenhum transportador com CPF/CNPJ XXXXXXXXXXXXXXX e RNTRC XXXXXXXXX * Preencher com valores válidos as chaves a seguir da seção Contratado CpfOuCnpj= RNTRC= 2.14. Usuário não possui permissão na transportadora com CNPJ 04430502000103, ou permissão insuficiente * Usuario.Sem.Permissao.Na.Transportadora.Ou.Permissao.Insuficiente * Em HOMOLOGAÇÃO: Nos dados do CIOT, preencher as chaves a seguir com o CNPJ cadastrado na conta do portal dev MatrizCNPJ=XXXXXXXXXXXXXX FilialCNPJ=XXXXXXXXXXXXXX 2.14.1. Envio com token * As credenciais podem estar ativas logando com cpf ou e-mail, confirme as credenciais recebidas do suporte do e-frete * Mesmo gerando token válido, o usuário preenchido com cpf ou e-mail pode não ter permissão para emissão do CIOT * Validar o login com cpf ou e-mail e verificar se o token com uma das opções não cai na rejeição 2.15. O CNPJ do MatrizCNPJ deve ser igual do Contratado ou do Contratante * Matriz.Cnpj.Invalido * Preencher o mesmo CNPJ da chave MatrizCNPJ em CpfOuCnpj da seção Contratado ou Contratante 2.16. Veículo com placa: AAA1234 com RNTRC inválido * Veiculo.RNTRC.Invalido * Corrigir a chave Placa da seção Veículo 2.17. O valor do frete informado é menor do que o valor mínimo de frete estabelecido * Revisar as chaves de valores a seguir das seções Viagem e Pagamento * Viagem TotalOperacao= TotalViagem= TotalDeAdiantamento= TotalDeQuitacao= Combustivel= Pedagio= OutrosCreditos= Seguro= OutrosDebitos= * Pagamento Valor= 2.18. Operação de transporte já cadastrada * IdCliente.Existente * Mesmo IdOperacaoCliente já cadastrado em outro CIOT 3. Adicionar Viagem 3.1. Campo CepOrigem com o valor '' é inválido ou Campo CepDestino com o valor '' é inválido * Campo.Invalido * Preencher as chaves CepOrigem e CepDestino da seção Viagem 3.2. É obrigatório preencher os valores das viagens * Problema verificado em HOMOLOGAÇÃO, mas identificado o motivo * Viagem.Valores.Nulo * Revisar as chaves de valores a seguir da seção Viagem * Mesmo preenchendo todos os campos de valores, assim como feito na inclusão do CIOT, o problema persiste em HOMOLOGAÇÃO 4. Consultar Tipo de Carga * Este.Metodo.Foi.Desabilitado.Nao.Requerido.Emissa.oCiot * Método desabilitado pelo e-Frete 5. Erros em homologação que não acontecem em produção 5.1. Encerrar Operação 5.1.1. Erro 400 * Encerrar CIOT com DataInicioViagem futura * Erro ao enviar CIOT Código de erro: -10. Último retorno: Erro Interno: 0 * Erro HTTP: 400 * URL: https://dev.efrete.com.br/Services/PefServiceV2.asmx 5.2. Outros 5.2.1. A requisição não pode ser nula / Requisição inválida * Requisicao.Nao.Pode.Ser.Nula * Requisicao.Nula * Diversos métodos geram estas rejeições em Homologação, não foi identificado o motivo e não conseguimos suporte do efrete para identificação do problema * GravarAdicionarPagamentos, GravarAlterarDataLiberacaoPagamento, GravarCancelarPagamento, GravarRegistrarPagamentoQuitacao, GravarRegistrarQtdeMercadoriaDesembarque, GravarRetificarOperacao Contamos com a contribuição da comunidade: Caso encontrem a solução para algum dos erros acima ainda não identificados para atualizarmos este tópico e ajudar quem mais tiver problemas com essa integradora. Até mais!!!

Passo a passo para a integração Realize o pré-cadastrado no site Dev.eFrete. Após o preenchimento do e-mail, você vai receber um e-mail da eFrete que deve ser respondido com CNPJ da empresa e Nome fantasia do sistema, ERP ou TMS. Depois de enviar essas informações, você receberá as credências de acesso ao ambiente de homologação e os dados aceitos no ambiente. Obs: Devido ao aumento repentino no volume de integrações temos recebido relatos de que esse processo pode levar um tempo para ser concluído. Particularidades e dicas extras Operações com certificado x Login sem certificado Login sem certificado: Para qualquer operação sem o certificado digital no eFrete é preciso de um token de autenticação que é gerado ao realizar a operação de Login. A operação de Login é feita utilizando o hash, usuário, senha e não devem ser preenchidos os dados do certificado no componente, conforme exemplo: ACBrCIOT.Configuracoes.Certificados.ArquivoPFX := ''; ACBrCIOT.Configuracoes.Certificados.Senha := ''; ACBrCIOT.Configuracoes.Certificados.NumeroSerie := ''; // Atenção, desabilitar essa propriedade ACBrCIOT.SSL.UseCertificateHTTP := False; ACBrCIOT.Configuracoes.Geral.Usuario := 'usuario do eFrete'; ACBrCIOT.Configuracoes.Geral.Senha := 'senha do eFrete'; ACBrCIOT.Configuracoes.Geral.HashIntegrador := 'HashIntegrador do eFrete'; A operação de login irá gerar um token que deverá ser preenchido nas demais operações, conforme exemplo: with ACBrCIOT.Contratos.Add.CIOT do begin // Só é necessário se usar usuario e senha e não o certificado Integradora.Token := 'token recebido na operação de login'; end; Operações com certificado: Para as operações com o certificado digital no eFrete, o login não é necessário pois não será utilizado o token, bastando preencher os dados do certificado, conforme exemplo: // Não preencher o ArquivoPFX se preencher o NumeroSerie ACBrCIOT.Configuracoes.Certificados.ArquivoPFX := 'arquivo. pfx'; ACBrCIOT.Configuracoes.Certificados.Senha := 'senha do certificado'; // Não preencher o NumeroSerie se preencher o ArquivoPFX ACBrCIOT.Configuracoes.Certificados.NumeroSerie := 'número de série do certificado'; // Atenção, habilitar essa propriedade ACBrCIOT.SSL.UseCertificateHTTP := True; ACBrCIOT.Configuracoes.Geral.Usuario := ''; ACBrCIOT.Configuracoes.Geral.Senha := ''; ACBrCIOT.Configuracoes.Geral.HashIntegrador := ''; Campos de mesmo nome com valores diferentes Dada a relação com o MDF-e, alguns campos podem receber a mesma informação. É importante lembrar, no entanto, que cada documento tem seu próprio conjunto de valores aceitos. Um exemplo é o campo TipoRodado no eFrete e o campo tpRod no MDF-e. Ambos recebem a informação do tipo de rodado, mas cada documento aceita um conjunto de valores diferente: MDF-e: 01 - Truck; 02 - Toco; 03 - Cavalo Mecânico; 04 - VAN; 05 - Utilitário; 06 - Outros. eFrete: NaoAplicavel; Truck; Toco; Cavalo. Exemplo de preenchimento do tipo Rodado para o eFrete no ACBrCIOT: var lCIOT: TCIOT; begin lCIOT := ACBrCIOT.Contratos.Add.CIOT; lCIOT.Integradora.Operacao := opGravarVeiculo; //Valores válidos são trNaoAplicavel, trTruck, trToco, trCavalo lCIOT.GravarVeiculo.TipoRodado := trNaoAplicavel; //Demais informações... end; Valores e informações específicos para o ambiente de homologação O ambiente de homologação por padrão solicita o envio de um certificado digital, mas seu envio não é obrigatório. Em ambiente de homologação apenas os Integradores são cadastrados, informe seu próprio, CNPJ como MatrizCNPJ e como Contratante do Frete nas requisições relacionadas. Exemplo de preenchimento de MatrizCNPJ e Cnpj do contratente no ACBrCIOT para o eFrete: var lCIOT: TCIOT; begin lCIOT := ACBrCIOT.Contratos.Add.CIOT; lCIOT.Integradora.Operacao := opAdicionar; lCIOT.AdicionarOperacao.MatrizCNPJ := 'pseudoCNPJ'; lCIOT.AdicionarOperacao.Contratante.CpfOuCnpj := 'mesmopseudoCNPJ'; //Demais informações... end; Web Service Soap x API Rest A integradora eFrete disponibiliza tanto um web service SOAP que comunica com arquivos XMLs quanto uma API Rest que recebe arquivos JSON. O componente ACBrCIOT se comunica com o web service SOAP. Caso enfrente algum problema ou erro inesperado, é válido realizar um teste para a mesma operação na API Rest e conferir se o retorno diverge. Você pode utilizar uma ferramenta de IA para converter o XML gerado pelo componente no JSON correspondente e fazer o envio. Leia o manual do eFrete na integra AQUI.

Olá comunidade ACBr, Foram enviadas ao SVN, na Rev-46276, as implementações do eFrete referentes às novas regras do CIOT e Piso Mínimo de Frete, de acordo com a versão 8 do manual disponibilizado pela integradora. O que muda para o TMS nas novas resoluções: Endpoint Impacto Resumo da mudança Gravar Motorista Baixo Apenas desobrigação de campos. Gravar Proprietário Baixo Apenas desobrigação de campos. Gravar Veículo Baixo Atenção! NumeroDeEixos passa a ser dado crítico, uma vez que é usado pela ANTT para cálculo de piso mínimo. Revisar dado ao fazer atualização da informação no cadastro do veículo. AdicionarOperacaoTransporte Alto Atenção! Conjunto de campos necessários para emissão de CIOT por TipoViagem mudou. Avaliar orientações. Novo TipoViagem. Novos campos: RetornoVazio, ComposicaoVeicular, ContratantesCargaFracionada, IndicadorPagamento, TipoChavePix, ValorChavePix, IdentificadorPix, CpfCnpjCreditado, NumeroParcela, CodigoPagamento, LatitudeOrigem, LongitudeOrigem, LatitudeDestino, LongitudeDestino. AdicionarPagamento Médio Novos campos: IndicadorPagamento, TipoChavePix, ValorChavePix, IdentificadorPix, CpfCnpjCreditado, NumeroParcela. Retifica o CIOT para ANTT no caso de TipoViagem Fracionado. AdicionarViagem Médio Novos campos: CodigoMunicipioDestino, CodigoMunicipioOrigem, IndicadorPagamento, TipoChavePix, ValorChavePix, IdentificadorPix, CpfCnpjCreditado, NumeroParcela, LatitudeOrigem, LongitudeOrigem, LatitudeDestino, LongitudeDestino, PesoCarga. Retifica o CIOT para ANTT no caso de TipoViagem Fracionado e TAC_Agregado. CancelarOperacaoTransporte - Sem mudança estrutural. EncerrarOperacaoTransporte Médio Desobrigação de alguns campos. Até mais,

Bom tarde! Estou iniciando um teste no exemplo do acbr ciot e esta me retornando um erro. Erro gravando Veiculo:Usuário do certificado digital não encontrado. este erro ocorrem na maioria das operação. A empresa já esta cadastrada no E-Frete e o CNPJ é igual ao do certificado. Tem alguma configuração a mais no componente que tenho que fazer? alguem conseguiu validar o ciot com o e-frete pelo acbrciot?

Pessoal, boa tarde! Pesquisando o fórum, li alguns tópicos a respeito do CIOT e apesar de não ser um pré-requisito, a integração entre sistema e administradora agiliza bastante o trabalho operacional e gestão da informação. Analisando as administradoras homologadas no site da ANTT e confrontando com algumas indicações positivas aqui fórum, conversei com a e-Frete e de fato tem diferencial. Dentro disto, como o tempo está um pouco escasso, gostaria de saber se alguém já tem a integração funcionando e gostaria de vender. Quem tiver a solução e interesse, deixe post aqui no fórum ou entre em contato pelo e-mail [email protected] Abraço.