Configurar o emissor Olist NF-e

Use sua conexão Olist (Tiny) para o Paylog criar e acompanhar as NF-e dos pedidos que chegam por ela.

#Antes de começar

Confira se:

1. sua conta possui permissão para gerenciar integrações;
2. a integração Olist está disponível no Paylog;
3. sua conta Olist (Tiny) já está conectada em Ferramentas > Integrações, na categoria ERP;
4. a inscrição estadual e a configuração fiscal da empresa estão corretas no Olist;
5. os produtos que emitirão nota estão aprovados no Paylog.

#1. Conecte o Olist (Tiny)

No menu principal, acesse Ferramentas > Integrações, use o filtro ERP e conclua a conexão da sua conta Olist (Tiny). O emissor não pede nenhuma chave de API: a credencial é essa mesma conexão.

#2. Abra o emissor Olist NF-e

Volte para Ferramentas > Integrações, use o filtro Emissor de Nota Fiscal e abra o cartão Olist NF-e. A página se chama Olist NF-e — Emissor de Nota Fiscal e tem duas abas: Configurações, onde ficam os passos abaixo, e Instruções, com o roteiro resumido dentro do Paylog.

Se o Paylog informar que não existe uma conexão ativa, use Conectar o Olist e conclua a etapa anterior.

#3. Ative o emissor

Clique em Ativar Olist NF-e e preencha:

• Inscrição Estadual: obrigatória — a mesma IE que aparece na sua nota fiscal, com 8 a 14 dígitos (pontos e traços são aceitos e ignorados). Ela vai no remetente da etiqueta: sem ela a transportadora recusa o envio e o pedido fica faturado sem etiqueta;
• Regime tributário (CRT): obrigatório — escolha entre 1 Simples Nacional, 2 Simples Nacional, com excesso de sublimite, 3 Regime Normal ou 4 MEI. É ele que define se a nota sai com CSOSN (Simples e MEI) ou com CST (Regime Normal e Simples com excesso de sublimite);
• Definir como padrão para novas emissões: marque se o Olist deve gerar as próximas notas.

Clique em Salvar Emissor. O Paylog confere a conexão existente antes de ativar; sem uma conexão Olist ativa a ativação é recusada com a mensagem Conecte o Olist primeiro.

#4. Escolha quem emite a nota fiscal

A seção Quem emite a nota fiscal aparece quando a conexão Olist está ativa e vale para os pedidos que chegam por ela:

• Ligado (padrão): o Paylog gera e autoriza a NF-e pelo próprio Olist antes da etiqueta — conferindo antes se a nota já existe, então nunca duplica;
• Desligado: você mesmo emite a nota no Olist e o Paylog apenas aguarda a sua NF-e para seguir com a etiqueta.

Confirme em Salvar preferência.

#5. Confira o status

No cartão de status, confirme se Olist NF-e aparece como Ativa (quando é o padrão) ou Ativo. Se houver outro emissor ativo e você quiser usar o Olist nas próximas notas, clique em Definir padrão.

O Paylog recebe as atualizações da nota pelo webhook do Olist e faz varreduras periódicas de segurança.

#6. Configure cada produto

Em Produtos e Configurações Fiscais, localize o produto e clique em Config. Informe:

• NCM: código fiscal com exatamente 8 dígitos;
• Nome fiscal: a descrição que aparece na nota (até 120 caracteres). Deixado em branco, o Paylog usa o nome do produto em caixa alta;
• Código fiscal (cProd): o código do item na nota. Precisa ser único entre os seus produtos — o emissor identifica cada item do catálogo por ele, e dois produtos com o mesmo código viram um só produto lá, passando a compartilhar a mesma tributação. Deixado em branco, o Paylog usa o código de barras do produto;
• É brinde: marque se o produto é entregue como bonificação. Ele sai na nota com o CFOP de brinde e com o valor de varejo — a lei não permite item zerado;
• É amostra grátis: marque se o produto é enviado como amostra. A nota sai com o CFOP de amostra em vez do CFOP de venda;
• Valor de varejo (base fiscal do brinde): quanto o produto vale no varejo, em reais. É esse valor que vai na linha da nota quando o produto sai como brinde — a lei exige o valor real do que foi entregue, e um item zerado é recusado. Sem ele, um brinde enviado a R$ 0 fica sem base fiscal e o pedido para em vez de emitir. Deixe em branco para não declarar;
• Início do faturamento: data e hora a partir das quais o produto pode entrar no fluxo;
• Tempo de espera em horas: intervalo depois do pagamento antes da emissão.

#Ordem da lista

Os produtos sem configuração fiscal aparecem no topo da lista, em ordem alfabética, seguidos pelos que já exibem o selo Fiscal OK — que reflete o NCM salvo no próprio produto. É o produto sem NCM que trava o pedido, então ele fica sempre à vista.

#Edite vários produtos de uma vez

Em catálogos grandes, marque a caixa de seleção na linha de cada produto — ou a caixa no cabeçalho da tabela, que marca e desmarca todos — e clique em Editar em lote.

No formulário, cada campo tem a própria ação:

• Não alterar: mantém o valor atual de cada produto (é o padrão);
• Definir para: grava o valor informado em todos os produtos selecionados;
• Limpar: remove o valor em todos os produtos selecionados.

Confirme em Aplicar aos selecionados. A PayLog altera somente produtos da sua própria conta.

#7. Ative a emissão do produto

Depois de salvar a configuração fiscal, ligue Emitir Nota na linha do produto.

O Paylog só liga o toggle quando as duas condições abaixo estão atendidas:

1. existe um emissor ativo e marcado como padrão na sua conta — ter o Olist NF-e ativo não basta se o padrão for outro emissor;
2. o produto tem um NCM válido de exatamente 8 dígitos salvo.

Se faltar alguma delas, o Paylog exibe Emissor Ativo Necessário ou NCM Necessário e o toggle volta ao estado anterior.

Essa ação configura automaticamente a emissão como produtor para consumidor final.

#O que acontece depois

• Pedidos da conexão Olist respeitam a data de início e o tempo de espera do produto.
• Com Usar Olist como emissor de NF-e ligado, o Paylog cria a NF-e pelo Olist antes da etiqueta, conferindo antes se a nota já existe.
• O estado da nota é atualizado pelo webhook do Olist, com varreduras periódicas de segurança.
• Desligar Emitir Nota impede novas emissões automáticas daquele produto, sem cancelar notas existentes.

#Se a integração não funcionar