Integração com fornecedor de impressão

Icaro

Icaro

Última atualização em Aug 16, 2026

Integração com fornecedor de impressão

Vincule itens aos pedidos externos do fornecedor e atualize automaticamente seus status dentro da Nortgraf.

Para que serve este módulo?

A integração consulta o andamento de trabalhos comprados em fornecedores externos de impressão. Depois que um item é vinculado ao número externo, os retornos do fornecedor podem atualizar o status interno conforme o mapeamento configurado.

1 - O que a integração faz

  • Consulta o status de um pedido ou item no fornecedor.
  • Relaciona o retorno externo a um status interno do item.
  • Atualiza automaticamente itens vinculados.
  • Interrompe consultas quando o retorno chega a um status final.
  • Pode oferecer atalho para abrir o pedido no painel do fornecedor.

A integração acompanha pedidos já feitos no fornecedor; ela não cria automaticamente a compra externa.

2 - Pré-requisitos

  • Integração disponível no plano da loja.
  • Conta ativa no fornecedor.
  • Token de acesso e código do cliente fornecidos por ele.
  • Status internos dos itens já cadastrados.
  • Números externos dos pedidos que serão vinculados.

3 - Configurando a conexão

  1. Acesse Configurações > Integrações.
  2. Abra o fornecedor de impressão.
  3. Informe o token e o código do cliente.
  4. Se desejar, preencha a URL-base para abrir pedidos no painel externo.
  5. Ative a integração e salve.
  6. Clique em Testar conexão e informe um pedido externo válido.

Se o fornecedor exigir número do item além do número do pedido, habilite essa opção quando ela estiver disponível.

4 - Mapeando os status

  1. Na seção Mapeamento de status, localize cada retorno do fornecedor.
  2. Escolha o status interno que o item deve assumir.
  3. Deixe em branco os retornos que não devem alterar o item.
  4. Marque Parar de consultar para estados finais, como entregue ou cancelado.
  5. Salve o mapeamento.

Revise cuidadosamente este quadro: um mapeamento incorreto pode mover itens para uma etapa indevida.

5 - Vinculando um item

  1. Abra o pedido na Nortgraf.
  2. Localize o item que foi comprado no fornecedor.
  3. Selecione a integração correspondente.
  4. Informe o número do pedido externo e, quando solicitado, o número do item.
  5. Salve o vínculo.

Não vincule dois trabalhos diferentes ao mesmo número sem confirmar como o fornecedor identifica cada item.

6 - Atualização automática e manual

Após o vínculo, a sincronização consulta o fornecedor e aplica o mapeamento. Enquanto o status automático estiver ativo, uma alteração manual poderá ser sobrescrita na próxima consulta.

Se precisar corrigir manualmente, leia o aviso da tela e confirme que a intervenção é realmente necessária.

7 - Problemas comuns

Teste com erro

Confirme token, código do cliente, número do pedido e disponibilidade da API.

Status não muda

Verifique o vínculo do item e se o retorno externo possui um status interno mapeado.

Consultas continuam após conclusão

Marque o retorno final como Parar de consultar.

Atalho externo abre endereço errado

Revise a URL-base sem incluir o número do pedido no final.

8 - Boas práticas

  • Teste com um pedido real conhecido antes de ativar em escala.
  • Mapeie somente estados compreendidos pela equipe.
  • Marque corretamente os estados terminais.
  • Não compartilhe o token.
  • Revise periodicamente o último teste da conexão.

Atenção: A sincronização pode alterar automaticamente o status dos itens. Valide todo o mapeamento antes de ativar a integração para a equipe.