Documentação Nero Sistemas

Bem-vindo à base de conhecimento oficial do sistema Nero.

Esta documentação foi projetada para apoiar parceiros logísticos, desenvolvedores e faturistas na integração de processos. O ecossistema Nero Sistemas não é apenas um software de transporte; é uma camada de inteligência que conecta o faturamento do embarcador diretamente ao manifesto de carga da transportadora.

Ao utilizar nossas ferramentas, sua operação elimina erros humanos de digitação, reduz o tempo de espera de motoristas em pátio e garante que a informação fiscal chegue à SEFAZ com 100% de integridade.

Primeiro Acesso e Configuração

O acesso ao Portal EDI é restrito a parceiros homologados. Se você ainda não possui credenciais, entre em contato com o setor de TI da Nero Sistemas ou com seu gerente de conta.

Passo a Passo da Ativação:

Recebimento de Token: Você receberá um e-mail contendo seu usuário (geralmente o CNPJ da matriz) e uma senha temporária.
Autenticação: Acesse o link login_edi.php através da nossa Central de Integração.
Homologação de Destino: No primeiro login, você visualizará as transportadoras cadastradas que estão aptas a receber seus arquivos. Caso falte alguma unidade, entre em contato com o suporte.

Segurança: Nosso sistema utiliza cookies de sessão criptografados. Após 30 minutos de inatividade, o sistema fará o log-off automático por segurança.

Requisitos Técnicos do XML (NF-e)

O motor de processamento do Nero Sistemas lê o schema XML da SEFAZ (versão 4.00). Para que o pré-processamento ocorra sem erros, o arquivo enviado deve seguir rigorosamente os padrões abaixo:

Estrutura do Arquivo:

O sistema aceita tanto o arquivo <NFe> isolado quanto o pacote <nfeProc> (que contém o protocolo de autorização). Recomendamos o envio do nfeProc para garantir a validade fiscal.

                    // Tags cruciais para a automação:

                    <ide> -> <nNF> (Número da Nota)

                    <emit> -> <CNPJ> (Deve ser o seu CNPJ cadastrado)

                    <dest> -> <CNPJ/CPF> (Dados do destinatário para roteirização)

                    <total> -> <vNF> (Valor da nota para cálculo de Ad Valorem)

Observação importante: Notas com status "Cancelada" ou "Denegada" na SEFAZ serão rejeitadas pelo nosso validador em tempo real.

Envio em Lote (Padrão ZIP)

Para operações de alto volume (acima de 50 notas/dia), o envio individual torna-se ineficiente. O Nero Sistemas suporta a descompactação nativa de arquivos .zip.

Como funciona o processamento de ZIP:

Ao realizar o upload de um arquivo compactado, nosso servidor cria um ambiente isolado (Sandbox) onde o arquivo é descompactado. O sistema percorre recursivamente todas as pastas, ignorando arquivos de sistema (como os do macOS ou pastas temporárias) e extraindo apenas os arquivos com extensão .xml.

Isso permite que você exporte o lote direto do seu ERP e faça o upload sem precisar "limpar" a pasta antes. O sistema faz a triagem para você.

Status de Processamento e Ciclo de Vida

Entender o status do seu arquivo é fundamental para a gestão da carga. Abaixo, detalhamos o ciclo de vida de uma nota dentro do ecossistema Nero:

1. Autorizado: A nota foi recebida pelo nosso servidor e validada com sucesso. Ela já está disponível na tela da nossa Recepção para emissão do CT-e.

2. Emissão em Processo: Nosso faturamento já iniciou a geração do Conhecimento de Transporte utilizando os dados do seu XML.

3. CT-e Emitido: O documento fiscal de transporte foi gerado. A partir deste momento, a chave da nota está vinculada a um frete oficial.

4. Entregue: Ciclo finalizado. O comprovante de entrega (canhoto digital) já foi processado.

Erros e Mensagens de Rejeição

Se o seu upload falhar, o sistema retornará uma mensagem específica. Aqui está o dicionário de erros:

[ERRO 403] CNPJ do Emissor Inválido:

O sistema detectou que o XML enviado pertence a outro CNPJ. Por questões de compliance e risco logístico, você só pode enviar notas emitidas pelo seu próprio grupo econômico cadastrado.

[ERRO 409] Nota Fiscal já Transmitida:

A chave de acesso desta nota já consta em nosso banco de dados. Isso evita a duplicidade de fretes e erros de cobrança duplicada.

[ERRO 500] XML Corrompido ou Malformado:

O arquivo não segue a estrutura XML básica ou está vazio. Tente exportar novamente do seu ERP.

Integração via API REST (Automação ERP)

Para grandes volumes, elimine o trabalho manual integrando o seu sistema de gestão (ERP) diretamente à nossa API. Basta configurar um Webhook para enviar a NF-e assim que ela for autorizada pela SEFAZ.

Endpoint e Autenticação

A API utiliza requisições POST e autenticação via cabeçalho (Header) utilizando o padrão Bearer Token. O Token é gerado no momento da liberação do seu acesso e enviado por e-mail.

                    POST https://usenero.com.br/api/api_edi

                    Headers Obrigatórios:

                    Authorization: Bearer SEU_TOKEN_DE_64_CARACTERES

Corpo da Requisição (Payload)

O envio deve ser feito no formato multipart/form-data, passando o arquivo físico na chave xml_file.

Exemplo de Requisição (cURL)

                    curl -X POST https://usenero.com.br/api/api_edi \
                    -H "Authorization: Bearer a1b2c3d4e5f6..." \
                    -F "xml_file=@/caminho/do/seu/sistema/NFe_000123.xml"
                

Respostas (JSON)

Status HTTP	Retorno (JSON)	Significado
200 OK	`{"success": true, "message": "Nota recebida e processada..."}`	Sucesso! O XML foi validado e já consta na transportadora.
409 Conflict	`{"success": false, "message": "Nota já enviada anteriormente."}`	A chave desta nota já existe no banco de dados. O envio foi ignorado para evitar duplicidade.
401 Unauthorized	`{"success": false, "message": "Token inválido."}`	Seu token está incorreto, ou o CNPJ emissor da nota não pertence à sua conta.

Como Rastrear sua Carga

O rastreamento do Nero Sistemas é público para destinatários e privado para remetentes (com mais detalhes).

Basta inserir o CPF ou CNPJ (apenas números) no campo de busca da página inicial ou na área de rastreio. O sistema retornará os últimos 5 eventos de cada carga vinculada àquele documento.

Privacidade: Nomes de pessoas físicas são parcialmente censurados (ex: M**** A****) em conformidade com a LGPD, garantindo a segurança dos dados dos seus clientes.