FIMP0201
Parametrização Siscomex - Importação (FIMP0201)¶
A tela Parametrização Siscomex - Importação (FIMP0201) permite configurar os parâmetros de integração com o sistema Siscomex para o módulo de Importação. Esta configuração é essencial para estabelecer a comunicação entre o FoccoERP e a API do Siscomex.
O acesso pode ser feito pelo menu do FoccoERP no seguinte caminho: FoccoERP → Suprimentos → Importação → Parametrização Siscomex - Importação (FIMP0201).
Importante:
Para acessar esta funcionalidade, o usuário deve possuir **permissão de acesso ao módulo de Importação** e estar logado em uma **empresa filha** (não consolidada).
Utilização¶
Ao abrir a tela, o sistema carrega automaticamente a parametrização da empresa atual. Se já existir uma configuração cadastrada, os dados serão exibidos nos campos do formulário. Caso contrário, será apresentado um formulário em branco para cadastro de uma nova parametrização.
Campos de Configuração¶
URL Base¶
Define o endereço base da API do Siscomex que será utilizado nas requisições de integração.
- Campo obrigatório
- Deve conter a URL completa do servidor da API
Integração Ativa¶
Switch (liga/desliga) que permite ativar ou desativar a integração com o Siscomex sem a necessidade de remover os dados de configuração.
- Quando ativado: a integração com o Siscomex está habilitada
- Quando desativado: a integração fica inativa, mas os dados permanecem salvos
Client ID¶
Chave de identificação do cliente fornecida pelo Siscomex para autenticação na API.
- Campo obrigatório
- Campo sensível com opção de visualização
- Clique no ícone de olho para alternar entre visualização oculta e visível
Client Secret¶
Chave secreta fornecida pelo Siscomex utilizada em conjunto com o Client ID para autenticação.
- Campo obrigatório
- Campo sensível com opção de visualização
- Clique no ícone de olho para alternar entre visualização oculta e visível
Importante:
Os campos **Client ID** e **Client Secret** são informações sensíveis. Por padrão, ficam ocultos por segurança. Utilize o ícone de olho apenas quando necessário visualizar o conteúdo.
Role Type¶
Indicador do perfil de usuário utilizado na integração com o Siscomex.
- Campo obrigatório
- Define o tipo de acesso e permissões na API
Token de Acesso¶
Token gerado automaticamente após autenticação bem-sucedida com a API do Siscomex.
- Campo somente leitura
- Exibe o token de forma mascarada por segurança (mostra apenas os primeiros e últimos 4 caracteres)
- É atualizado automaticamente pelo sistema após conexões bem-sucedidas
Ações Disponíveis¶
Testar Conexão¶
Botão secundário localizado no rodapé da tela que permite validar se as credenciais e configurações estão corretas.
- Testa a conectividade com a API do Siscomex
- Valida as credenciais fornecidas (Client ID e Client Secret)
- Retorna mensagem de sucesso ou erro da tentativa de conexão
Salvar¶
Botão principal localizado no rodapé da tela que salva as configurações de parametrização.
- Valida todos os campos obrigatórios antes de salvar
- Exibe mensagem de confirmação após salvar com sucesso
- Atualiza automaticamente os dados na tela após o salvamento
Comportamento da Parametrização¶
Cadastro Único por Empresa¶
Cada empresa pode ter apenas uma parametrização do Siscomex. Ao salvar:
- Se for a primeira vez: cria um novo registro de parametrização
- Se já existir: atualiza o registro existente
Vínculo com a Empresa¶
A parametrização fica automaticamente vinculada à empresa em que o usuário está logado no momento do cadastro. Não é possível vincular uma parametrização a outra empresa.
Exemplo de Uso¶
- Acesse o menu Suprimentos → Importação → Parametrização Siscomex - Importação.
- Certifique-se de estar logado na empresa filha desejada.
- Preencha os campos obrigatórios:
- URL Base: Informe a URL da API do Siscomex
- Client ID: Cole a chave de identificação fornecida
- Client Secret: Cole a chave secreta fornecida
- Role Type: Informe o tipo de perfil conforme orientação do Siscomex
- Utilize os ícones de olho nos campos Client ID e Client Secret para visualizar e confirmar os valores inseridos.
- Ative o switch Integração Ativa para habilitar a integração.
- Clique no botão Salvar para confirmar as configurações.
- Após a confirmação de salvamento, utilize o botão Testar Conexão (quando disponível) para validar a integração.