Anjun Express
A integração com a Anjun Express liga a sua conta na transportadora ao idworks. Com ela, o idworks envia os pedidos para a Anjun (EDI), recebe um código de rastreio para cada volume e consulta o rastreio dos pedidos enviados, trazendo também a foto do comprovante de entrega quando ela vem no rastreio.
Índice
Conceito
Cadastro e credenciais
- Como ativar a integração?
- Como ligar a transportadora à integração?
- O que preencher nos parâmetros da integração?
- Como o token de acesso é gerado e renovado?
- Como inativar ou excluir a integração?
Envio do pedido (EDI)
- Como o pedido é enviado para a Anjun Express?
- Quais dados do pedido vão para a Anjun?
- Onde fica o código de rastreio?
Rastreio
Problemas
Referência rápida
O que é a integração Anjun Express?
É a conexão entre a sua conta na Anjun Express e o idworks. Ela cobre três coisas:
- Envio do pedido (EDI) — o idworks cria o pedido na Anjun com os dados do destinatário, do remetente, da NF-e e dos volumes.
- Código de rastreio — a Anjun devolve um código por volume, que fica gravado nos volumes do pedido.
- Rastreio — o idworks consulta os eventos de entrega na Anjun e os mostra no pedido, com a foto do comprovante de entrega quando ela vem.
📍 Onde: tela Integrações (menu Configurações) → aba Integrações Disponíveis → procure Anjun Express no campo Buscar integração.
Como ativar a integração?
- Abra a tela Integrações e vá para a aba Integrações Disponíveis.
- Procure Anjun Express no campo Buscar integração e clique no botão + (Adicionar).
- Preencha:
- Conta — aparece só quando você tem mais de uma conta; escolha a empresa dona da integração.
- Nome da Integração — texto livre, obrigatório. Ajuda a distinguir integrações quando há mais de uma.
- Clique em Salvar.
A integração passa a aparecer na aba Minhas Integrações. A coluna STATUS mostra Ativo, Erro, Não Autenticado ou Inativo.
Atenção: a integração já nasce como Ativo, antes de você preencher as credenciais. Esse Ativo logo após o cadastro não confirma que as credenciais estão certas nem que o token já existe. A confirmação é o envio de um pedido não parar em "Falta o token da Anjun Express".
A aba Integrações Disponíveis só aparece para quem tem o privilégio de criar integrações (veja Privilégios da tela).
Depois de ativar, preencha as credenciais (O que preencher nos parâmetros da integração?) e ligue a transportadora à integração (Como ligar a transportadora à integração?).
Como ligar a transportadora à integração?
Ativar a integração não basta: o idworks só envia o EDI e consulta o rastreio dos pedidos de uma transportadora que esteja ligada à Anjun Express no cadastro dela.
- Vá em Logística (WMS) → Transportadoras e abra a transportadora que entrega pela Anjun (ou cadastre uma nova).
- Na aba Config. Transportadora, em Tipo integração, escolha Anjun Express.
- Em Integração, escolha a integração Anjun Express criada em Como ativar a integração?. O campo aparece depois que você escolhe o Tipo integração e é obrigatório: sem ele, o idworks avisa que o campo INTEGRAÇÃO precisa ser selecionado. Se você trocar o Tipo integração, o campo Integração é limpo. A lista só mostra integrações com status Ativo ou Não Autenticado. Se a Anjun Express estiver em Erro ou Inativo, ela não aparece e a lista mostra "Não há Integração.". Em Erro, corrija as credenciais e espere a próxima renovação do token (Como o token de acesso é gerado e renovado?). Em Inativo, ligue o Status em Editar (Como inativar ou excluir a integração?).
- Clique em Salvar no topo da ficha.
Atenção: pedido de transportadora com outro Tipo integração não é enviado nem rastreado pela Anjun. Em transportadora sem Tipo integração, o envio manual do EDI avisa "Transportadora não tem EDI configurado".
Os demais campos da aba estão em O que eu configuro na aba Config. Transportadora?.
O que preencher nos parâmetros da integração?
Na aba Minhas Integrações, abra os parâmetros da integração Anjun Express pelo botão Configuração (ícone de engrenagem) da linha ou com um duplo clique nela. Preencha e clique em Salvar. O idworks pede a confirmação "Confirma salvar alterações?".
A janela tem três campos, em dois grupos. Clique no nome do grupo para abrir os campos; o ícone ? ao lado do nome do campo mostra a descrição dele.
| Grupo | Campo | Para que serve |
|---|---|---|
| Credenciais de Acesso | ClientId | O ClientId obtido no portal da Anjun. |
| Credenciais de Acesso | ClientSecret | O ClientSecret obtido no portal da Anjun (campo de senha). |
| Status | Integração Tracking | Chave liga/desliga. Ative se quiser que o idworks consulte o rastreio dos pedidos enviados pela transportadora. Desligada, o idworks não consulta o rastreio. |
O ClientId e o ClientSecret geram o token de acesso; sem os dois, o token não é gerado.
A janela da Anjun não tem a chave Integração EDI, que a maioria das outras transportadoras tem, nem um campo para o código do cliente na Anjun. Por isso o envio automático do EDI da Anjun é só o da emissão da nota (veja Como o pedido é enviado para a Anjun Express?).
O token de acesso não é digitado por você: ele é preenchido sozinho pela rotina de renovação (veja a próxima seção).
Se um campo obrigatório ficar vazio, o aviso "O parâmetro: …, precisa ser preenchido." mostra o nome do campo.
Como o token de acesso é gerado e renovado?
Uma rotina do idworks usa as credenciais de API (ClientId e ClientSecret) para pedir um token à Anjun e grava esse token na integração. Todo envio de pedido e toda consulta de rastreio usam o token gravado.
O resultado muda o status da integração:
| Resultado da rotina | Status da integração |
|---|---|
| A Anjun devolve o token | Ativo |
| A Anjun recusa, não devolve o token ou não responde (fora do ar, sem conexão) | Erro (a dica do status diz "Erro de Autenticação verifique as credenciais de acesso.", mesmo quando a causa foi a Anjun fora do ar) |
| Faltam o ClientId ou o ClientSecret | O status não muda e nenhum token é gerado. A integração recém-criada continua como Ativo, mas sem token. |
A rotina só renova o token de integrações com status Ativo ou Erro. Integração Inativa ou Não Autenticada não tem o token renovado.
Se o status ficou em Erro, confira as credenciais com a Anjun e corrija nos parâmetros. Se as credenciais estiverem certas, o status volta para Ativo na próxima renovação bem-sucedida.
Como inativar ou excluir a integração?
Na aba Minhas Integrações, clique em Editar na linha da integração. Na janela Editar:
- Status — chave Ativo/Inativo. Com a integração Inativa, o idworks para de renovar o token, de enviar os pedidos (EDI) e de consultar o rastreio pela Anjun, mesmo que o token já esteja gravado. Para voltar a usar, ligue a chave de novo.
- Nome da integração — pode ser alterado aqui.
- Deletar — exclui a integração. Exige o privilégio de exclusão; sem ele, o botão fica desabilitado com a dica "Você não tem privilégio para executar esta ação".
Como o pedido é enviado para a Anjun Express?
O envio do pedido para a Anjun é o EDI. Ele segue as regras gerais de EDI do idworks, com envio automático e envio manual pela lista ou pela ficha do pedido. Veja Como enviar EDI para a transportadora?. Na Anjun, o envio automático só acontece na emissão da nota (primeiro item abaixo).
O que é próprio da Anjun Express:
- O envio automático acontece só na emissão da nota. A integração da Anjun não tem a chave Integração EDI que a maioria das outras transportadoras tem. Por isso o idworks não envia o pedido para a Anjun no despacho (quando o pedido passa para Enviado) nem pelo processo periódico. O envio na emissão da nota funciona quando a antecipação está ligada, pela parametrização Enviar EDI após emissão NF ou pela chave Enviar EDI após emissão da NF? da aba Config. Transportadora da transportadora. Sem a antecipação, o envio é manual.
- A transportadora precisa estar ligada à Anjun. O envio, automático ou manual, e o rastreio só pegam pedidos de transportadora com Tipo integração = Anjun Express (veja Como ligar a transportadora à integração?).
- A NF-e é obrigatória. Pedido sem nota emitida (sem chave de acesso ou sem número da nota) não é enviado. A mensagem é "Pedido sem NF-e emitida, obrigatória para a Anjun Express". Emita a nota e reenvie.
- O token precisa existir e a integração precisa estar ativa. Sem token, ou com a integração Inativa ou Não Autenticada, o envio para com "Falta o token da Anjun Express".
- Cada volume do pedido vira um volume na Anjun. Cadastre os volumes (pacotes) do pedido antes do envio: são eles que a Anjun recebe e que recebem os códigos de rastreio. O idworks não bloqueia pedido sem volume: ele envia mesmo assim, sem volumes e sem os dados da NF-e (que vão dentro de cada volume), e a Anjun tende a recusar. Volume sem peso ou sem medidas recebe os valores dos produtos do pacote.
- Falha não é tentada de novo. Quando a Anjun recusa o pedido ou não responde (fora do ar, sem conexão, demora), o envio automático não faz novas tentativas: o pedido vira alerta já na primeira falha. Corrija a causa (ou espere a Anjun voltar) e reenvie manualmente.
- Qual integração é usada. O envio usa a integração escolhida no campo Integração da aba Config. Transportadora da transportadora do pedido. Se a transportadora não tem integração vinculada, usa a integração Anjun Express da empresa do pedido.
Onde fica o resultado:
- Envio automático — o resultado fica na Timeline (Logs) do pedido, inclusive os bloqueios do idworks (sem NF-e, sem token).
- Envio manual — o envio aceito e a recusa da Anjun ficam na Timeline (Logs). Os bloqueios do idworks (sem NF-e, sem token) aparecem só no aviso da tela e não ficam na Timeline.
Quais dados do pedido vão para a Anjun?
| Grupo | O que vai |
|---|---|
| Destinatário | Endereço de entrega do pedido (quando há um endereço de entrega separado, ele é usado no lugar do endereço do cliente), nome de quem recebe (ou o nome do cliente), CPF/CNPJ, e-mail e telefone. |
| Remetente | Dados do cadastro da sua empresa: razão social, nome fantasia, endereço, CNPJ, telefone, e-mail e a inscrição estadual da empresa no estado dela (sem inscrição, vai ISENTO). |
| Nota fiscal | Chave de acesso, número, série e data de emissão da NF-e, repetidos em cada volume. Pedido sem volume vai sem esses dados. |
| Volumes | Peso e medidas de cada volume (altura, largura e comprimento arredondados para número inteiro), mais o peso total e a quantidade de volumes. |
| Valor declarado | A soma dos itens do pedido (ou o valor do pedido, se a soma der zero), dividida em partes iguais entre os volumes; o último volume fica com a diferença de centavos. |
| Referência | O número do pedido no idworks. |
O telefone do cliente não vai quando a parametrização Excluir telefone NF e EDI está ligada.
Onde fica o código de rastreio?
Quando a Anjun aceita o pedido, ela devolve um código de rastreio por volume. O primeiro código vai para o volume 1, o segundo para o volume 2, e assim por diante, na ordem em que a Anjun devolve.
Código provisório: no envio (e na emissão da nota), o idworks preenche os volumes sem código com um código provisório próprio, antes mesmo de falar com a Anjun. Esse código não serve para rastrear na Anjun. Ele só é trocado pelo código da Anjun quando ela aceita o pedido. Se o envio foi bloqueado ou recusado, o volume continua com o código provisório até um reenvio dar certo.
Se a Anjun aceitar o pedido mas não devolver nenhum código, o envio é registrado como erro com a mensagem "Erro ao obter o código de rastreamento da Anjun Express".
Como funciona o rastreio dos pedidos?
O idworks consulta na Anjun os eventos de rastreio dos códigos gravados nos volumes do pedido e registra os eventos no pedido. Depois de um evento de entrega, extravio ou devolução, os eventos seguintes são ignorados, menos os de devolução. Os eventos aparecem na aba Tracking da ficha do pedido — veja Aba Tracking.
Para o rastreio funcionar:
- O token precisa existir e a integração precisa estar ativa. Sem token, ou com a integração Inativa ou Não Autenticada, a consulta para com "Faltam credenciais da Anjun Express".
- A chave Integração Tracking precisa estar ligada nos parâmetros da integração (grupo Status). Desligada, a consulta para com "Integração de tracking da Anjun Express não está ativa. Verificar parametrizações". Essa mensagem só aparece quando a integração já tem token; sem token, aparece a mensagem de credenciais acima.
- Os volumes precisam ter o código da Anjun. Volume que ainda está com o código provisório do idworks não encontra nada na Anjun (veja Onde fica o código de rastreio?).
A integração usada na consulta segue a mesma regra do envio: a integração ligada à transportadora do pedido ou, se não houver, a integração Anjun Express da empresa.
O comprovante de entrega aparece no pedido?
Sim, quando a foto vem no rastreio da Anjun. O idworks aproveita só a foto do comprovante: nome e documento de quem recebeu não são trazidos. A foto é guardada apenas quando o idworks reconhece o evento como entrega; se o evento não for reconhecido como entrega, a foto não é guardada. Ela aparece na aba Tracking do pedido, nos comprovantes do evento de entrega.
Quais mensagens de erro podem aparecer e o que fazer?
| Mensagem | Quando aparece | O que fazer |
|---|---|---|
| "Pedido sem NF-e emitida, obrigatória para a Anjun Express" | Envio do pedido sem nota emitida. | Emita a NF-e do pedido e reenvie o EDI. |
| "Falta o token da Anjun Express" | Envio do pedido quando a integração ainda não tem token ou está Inativa/Não Autenticada. | Confira se a integração está ativa (Editar → Status), as credenciais de API nos parâmetros e o status da integração. O token é gerado pela rotina de renovação. |
| "Erro ao criar pedido Anjun Express" | A Anjun recusou o pedido sem explicar o motivo ou não respondeu (fora do ar, sem conexão). Quando ela explica, aparece a mensagem dela. | Confira os dados do pedido e dos volumes. O idworks não tenta de novo sozinho: reenvie manualmente. |
| "Erro ao obter o código de rastreamento da Anjun Express" | A Anjun aceitou o pedido, mas não devolveu código de rastreio. | Confira o pedido com a Anjun antes de reenviar. |
| "Integração de tracking da Anjun Express não está ativa. Verificar parametrizações" | Consulta de rastreio com Integração Tracking desligada, numa integração que já tem token. | Ligue Integração Tracking nos parâmetros da integração. |
| "Faltam credenciais da Anjun Express" | Consulta de rastreio quando a integração não tem token ou está Inativa/Não Autenticada. | Confira se a integração está ativa, as credenciais de API e o status da integração. |
| "Erro ao consultar rastreamento Anjun Express" | A consulta de rastreio falhou sem nenhuma resposta. Quando a Anjun manda uma mensagem própria, aparece a mensagem dela; quando responde sem mensagem própria, ou a conexão falha, pode aparecer um texto técnico da resposta ou do erro de conexão no lugar desta frase. | Aguarde a próxima consulta; se persistir, confira com a Anjun. |
Atenção: "Falta o token…" (no envio) e "Faltam credenciais…" (no rastreio) têm as mesmas causas: a integração está sem token de acesso ou não está ativa (Inativa ou Não Autenticada), mesmo com o token gravado.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados.
| Privilégio | Libera | Sem ele |
|---|---|---|
| Visualizar integrações | Acesso à tela Integrações. | A tela não abre. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). | A aba Integrações Disponíveis não aparece. |
| Editar parametrizações empresa | Editar nome e status da integração e configurar os parâmetros. | Os botões Editar e Configuração da linha não aparecem, e o duplo clique na linha não abre os parâmetros. |
| Deletar parametrizações empresa | Excluir a integração. | O botão Deletar da janela Editar fica desabilitado. |
Para o envio manual do EDI pelos pedidos, veja os privilégios em Como enviar EDI para a transportadora?.