Integrações da retaguarda#

Como configurar o EasyAssist por loja#

O EasyAssist importa as vendas de cada loja. A publicação de catálogo e preços usa a seleção e a aprovação da própria loja.

1. Abra Administração > EasyAssist.
2. Localize a loja. Edite ID estabelecimento desta loja com o identificador liberado pela EasyAssist para ela.
3. Marque Integração ativa nesta loja e salve.
4. Use Sincronizar > Testar conexão.
5. Confira Formas de pagamento. Confirme a correspondência das formas da EasyAssist com o cadastro do ERP.
6. Para publicar catálogo ou preços, marque Envio de catálogo ativo na configuração da loja. Desmarcado, a integração só busca vendas.
7. Acompanhe Sincronizando, Com erro, A confirmar, A verificar e Precisa de você. O estado de cada loja corresponde à sua própria rodada.

Como conferir o catálogo antes de enviar#

1. Abra Catálogo do app e escolha a loja.
2. Salve a seleção de produtos, setores, categorias ou subcategorias que devem participar.
3. Abra Prévia do app para conferir o conteúdo atual.
4. Leia os produtos novos, já existentes, retidos e bloqueados. Os retidos e bloqueados mostram código e motivo.
5. Quando houver grupo novo elegível, use Aprovar e enviar o próximo grupo na prévia. Uma alteração posterior exige outra prévia.
6. Acompanhe a confirmação. Uma fila recebida ainda não comprova que os produtos chegaram ao app.

A prévia procura EAN válido e único e depois código interno. Assim, um produto reconhecido pelo EAN aparece em Já no app, mesmo quando seu código interno mudou na migração. Ele não é reenviado. Identidades em conflito ficam retidas.

Limites desta versão: a criação de produtos aguarda o contrato fiscal completo da EasyAssist. Produto novo em grupo já existente também fica retido. A seleção não libera produto bloqueado nem resolve essas retenções.

A opção de envio no modal Sincronizar orienta abrir a Prévia do app. Ela não publica diretamente o catálogo inteiro.

Como conferir os preços#

1. Na prévia da loja, use Conferir atualização de preços.
2. Confira preço e oferta atuais e propostos.
3. Use Confirmar atualização de preços para aprovar os valores apresentados.
4. Confira o resultado e os itens adiados ou retidos antes de outra confirmação.

Os preços usam a mesma tabela principal da subida do catálogo. O ERP identifica e confere essa tabela na EasyAssist. Se não conseguir confirmar sua identidade, retém a operação.

A atualização de preços não cria produtos nem altera a ficha fiscal. Produtos já existentes têm atualização própria de preço. Ofertas datadas em vigor ficam retidas, pois o destino ainda não aplica sua data de término.

Como importar ou reprocessar vendas#

Use Sincronizar > Importar vendas para buscar vendas da loja. Elas aparecem no caixa e no faturamento correspondentes.

Para conferir um período já importado, use Reprocessar vendas (conferir um período com a EasyAssist e corrigir). Informe data de movimento inicial e final. O PDV de origem é opcional; vazio inclui os caixas do período.

O reprocessamento importa vendas ausentes e confere pagamentos e valores das importadas. Ele preserva os itens fiscais e não apaga as vendas. Turnos ainda não conferidos são descartados e remontados; turnos e receitas já conferidos ficam preservados.

Cancelamentos dependem da conferência da origem e das proteções de reconciliação. Rodada parcial, ausência de documento ou resultado incerto não comprovam cancelamento. Pendências permanecem visíveis para conferência.

Se algo der errado

Como configurar o Catálogo Cosmos#

O Cosmos é o catálogo público da Bluesoft: com o token da sua conta, digitar o EAN na ficha de produto preenche nome, NCM, CEST e marca — e só nos campos vazios.

1. Abra Administração > Catálogo Cosmos.
2. Cole o Token da API Cosmos (preencha só ao configurar ou trocar).
3. Marque Integração ativa.
4. Salve.
5. Confira o KPI Estado (do token da sua conta) e o EANs no cache — as consultas ficam em cache e nunca se repetem.
6. No dia a dia, abra a ficha do produto em Operação e PDV > Produtos, bipe o EAN principal e deixe os campos vazios serem completados.

Campos e o que significam

Resultado esperado — digitar o EAN na ficha do produto preenche nome, NCM, CEST e marca nos campos ainda vazios, reduzindo digitação e erro de classificação.

Se algo der errado