# 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.